eX_setup.h

Go to the documentation of this file.

/*
  eXosip - This is the eXtended osip library.
  Copyright (C) 2001-2012 Aymeric MOIZARD amoizard@antisip.com
  
  eXosip is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.
  
  eXosip is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.
  
  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/


#ifdef ENABLE_MPATROL
#include <mpatrol.h>
#endif

#ifndef __EX_SETUP_H__
#define __EX_SETUP_H__

#include <eXosip2/eXosip.h>
#include <osipparser2/osip_message.h>

#include <time.h>

#ifdef __cplusplus
extern "C" {
#endif

  struct eXosip_t;
  struct osip_srv_record;
  struct osip_naptr;

  struct eXosip_t *eXosip_malloc (void);

  int eXosip_init (struct eXosip_t *excontext);

  void eXosip_quit (struct eXosip_t *excontext);

  int eXosip_lock (struct eXosip_t *excontext);

  int eXosip_unlock (struct eXosip_t *excontext);

  int eXosip_execute (struct eXosip_t *excontext);

#define EXOSIP_OPT_BASE_OPTION 0
#define EXOSIP_OPT_UDP_KEEP_ALIVE (EXOSIP_OPT_BASE_OPTION+1) 
#define EXOSIP_OPT_UDP_LEARN_PORT (EXOSIP_OPT_BASE_OPTION+2) 
#define EXOSIP_OPT_USE_RPORT (EXOSIP_OPT_BASE_OPTION+7) 
#define EXOSIP_OPT_SET_IPV4_FOR_GATEWAY (EXOSIP_OPT_BASE_OPTION+8) 
#define EXOSIP_OPT_ADD_DNS_CACHE (EXOSIP_OPT_BASE_OPTION+9) 
#define EXOSIP_OPT_DELETE_DNS_CACHE (EXOSIP_OPT_BASE_OPTION+10) 
#define EXOSIP_OPT_SET_IPV6_FOR_GATEWAY (EXOSIP_OPT_BASE_OPTION+12) 
#define EXOSIP_OPT_ADD_ACCOUNT_INFO (EXOSIP_OPT_BASE_OPTION+13) 
#define EXOSIP_OPT_DNS_CAPABILITIES (EXOSIP_OPT_BASE_OPTION+14) 
#define EXOSIP_OPT_SET_DSCP (EXOSIP_OPT_BASE_OPTION+15) 
#define EXOSIP_OPT_REGISTER_WITH_DATE (EXOSIP_OPT_BASE_OPTION+16) 
#define EXOSIP_OPT_SET_HEADER_USER_AGENT (EXOSIP_OPT_BASE_OPTION+17) 
#define EXOSIP_OPT_SET_TLS_VERIFY_CERTIFICATE (EXOSIP_OPT_BASE_OPTION+500) 
#define EXOSIP_OPT_SET_TLS_CERTIFICATES_INFO (EXOSIP_OPT_BASE_OPTION+501) 
#define EXOSIP_OPT_SET_TLS_CLIENT_CERTIFICATE_NAME (EXOSIP_OPT_BASE_OPTION+502) 
#define EXOSIP_OPT_SET_TLS_SERVER_CERTIFICATE_NAME (EXOSIP_OPT_BASE_OPTION+503) 
  /* non standard option: need a compilation flag to activate */
#define EXOSIP_OPT_KEEP_ALIVE_OPTIONS_METHOD (EXOSIP_OPT_BASE_OPTION+1000)

  struct eXosip_dns_cache {
    char host[1024];
    char ip[256];
  };

  struct eXosip_account_info {
    char proxy[1024];
    char nat_ip[256];
    int nat_port;
  };

  struct eXosip_http_auth {
    char pszCallId[64];
    osip_proxy_authenticate_t *wa;
    char pszCNonce[64];
    int iNonceCount;
    int answer_code;
  };

  int eXosip_set_option (struct eXosip_t *excontext, int opt, const void *value);


  typedef struct eXosip_tls_credentials_s {
    char priv_key[1024];
    char priv_key_pw[1024];
    char cert[1024];
  } eXosip_tls_credentials_t;

  typedef struct eXosip_tls_ctx_s {
    char random_file[1024];                                             
    char dh_param[1024];                                                
    char root_ca_cert[1024];                                            
    eXosip_tls_credentials_t client;            
    eXosip_tls_credentials_t server;            
  } eXosip_tls_ctx_t;

  typedef enum {
    TLS_OK = 0,                                                         
    TLS_ERR_NO_RAND = -1,                               
    TLS_ERR_NO_DH_PARAM = -2,                           
    TLS_ERR_NO_PW = -3,                                         
    TLS_ERR_NO_ROOT_CA = -4,                            
    TLS_ERR_MISSING_AUTH_PART = -5              
  } eXosip_tls_ctx_error;

  struct osip_naptr *eXosip_dnsutils_naptr (struct eXosip_t *excontext, const char *domain, const char *protocol, const char *transport, int keep_in_cache);

  int eXosip_dnsutils_dns_process (struct osip_naptr *output_record, int force);

  int eXosip_dnsutils_rotate_srv (struct osip_srv_record *output_record);

  int eXosip_listen_addr (struct eXosip_t *excontext, int transport, const char *addr, int port, int family, int secure);

  int eXosip_reset_transports (struct eXosip_t *excontext);


  int eXosip_set_socket (struct eXosip_t *excontext, int transport, int socket, int port);

  void eXosip_set_user_agent (struct eXosip_t *excontext, const char *user_agent);

  const char *eXosip_get_version (void);

  typedef void (*CbSipCallback) (osip_message_t * msg, int received);

  int eXosip_set_cbsip_message (struct eXosip_t *excontext, CbSipCallback cbsipCallback);

  void eXosip_enable_ipv6 (int ipv6_enable);

  void eXosip_masquerade_contact (struct eXosip_t *excontext, const char *public_address, int port);

  int eXosip_find_free_port (struct eXosip_t *excontext, int free_port, int transport);

#ifndef DOXYGEN

#ifndef OSIP_MONOTHREAD
  void eXosip_wakeup_event (struct eXosip_t *excontext);
#else
#define eXosip_wakeup_event(A)   ;
#endif

#endif

  int eXosip_transport_set (osip_message_t * msg, const char *transport);

  int eXosip_guess_localip (struct eXosip_t *excontext, int family, char *address, int size);

#ifdef __cplusplus
}
#endif
#endif