主要类型定义：
１、struct eXtl_protocol
struct eXtl_protocol { int enabled; int proto_port; char proto_name[10]; char proto_ifs[20]; int proto_num; int proto_family; int proto_secure; int proto_reliable; int (*tl_init) (void); int (*tl_free) (void); int (*tl_open) (void); int (*tl_set_fdset) (fd_set * osip_fdset, fd_set * osip_wrset, int *fd_max); int (*tl_read_message) (fd_set * osip_fdset, fd_set * osip_wrset); int (*tl_send_message) (osip_transaction_t * tr, osip_message_t * sip, char *host, int port, int out_socket); int (*tl_keepalive) (void); int (*tl_set_socket) (int socket); int (*tl_masquerade_contact) (const char *ip, int port); int (*tl_get_masquerade_contact) (char *ip, int ip_size, char *port, int port_size); }; struct eXtl_protocol eXtl_udp = { 1, 5060, "UDP", "0.0.0.0", IPPROTO_UDP, AF_INET, 0, 0, &udp_tl_init, &udp_tl_free, &udp_tl_open, &udp_tl_set_fdset, &udp_tl_read_message, &udp_tl_send_message, &udp_tl_keepalive, &udp_tl_set_socket, &udp_tl_masquerade_contact, &udp_tl_get_masquerade_contact }; struct eXtl_protocol eXtl_tcp = { 1, 5060, "TCP", "0.0.0.0", IPPROTO_TCP, AF_INET, 0, 0, &tcp_tl_init, &tcp_tl_free, &tcp_tl_open, &tcp_tl_set_fdset, &tcp_tl_read_message, &tcp_tl_send_message, &tcp_tl_keepalive, &tcp_tl_set_socket, &tcp_tl_masquerade_contact, &tcp_tl_get_masquerade_contact }; struct eXtl_protocol eXtl_dtls = { 1, 5061, "DTLS-UDP", "0.0.0.0", IPPROTO_UDP, AF_INET, 0, 0, &dtls_tl_init, &dtls_tl_free, &dtls_tl_open, &dtls_tl_set_fdset, &dtls_tl_read_message, &dtls_tl_send_message, &dtls_tl_keepalive, &dtls_tl_set_socket, &dtls_tl_masquerade_contact, &dtls_tl_get_masquerade_contact }; struct eXtl_protocol eXtl_tls = { 1, 5061, "TLS", "0.0.0.0", IPPROTO_TCP, AF_INET, 0, 0, &tls_tl_init, &tls_tl_free, &tls_tl_open, &tls_tl_set_fdset, &tls_tl_read_message, &tls_tl_send_message, &tls_tl_keepalive, &tls_tl_set_socket, &tls_tl_masquerade_contact, &tls_tl_get_masquerade_contact };
2、typedef struct eXosip_t eXosip_t;
struct eXosip_t { struct eXtl_protocol *eXtl; char transport[10]; char *user_agent; eXosip_call_t *j_calls; /* my calls */ #ifndef MINISIZE eXosip_subscribe_t *j_subscribes; /* my friends */ eXosip_notify_t *j_notifies; /* my susbscribers */ #endif osip_list_t j_transactions; eXosip_reg_t *j_reg; /* my registrations */ #ifndef MINISIZE eXosip_pub_t *j_pub; /* my publications */ #endif #ifdef OSIP_MT void *j_cond; void *j_mutexlock; #endif osip_t *j_osip; int j_stop_ua; #ifdef OSIP_MT void *j_thread; jpipe_t *j_socketctl; jpipe_t *j_socketctl_event; #endif osip_fifo_t *j_events; jauthinfo_t *authinfos; int keep_alive; int keep_alive_options; int learn_port; #ifndef MINISIZE int http_port; char http_proxy[256]; char http_outbound_proxy[256]; int dontsend_101; #endif int use_rport; int dns_capabilities; int dscp; char ipv4_for_gateway[256]; char ipv6_for_gateway[256]; #ifndef MINISIZE char event_package[256]; #endif struct eXosip_dns_cache dns_entries[MAX_EXOSIP_DNS_ENTRY]; struct eXosip_account_info account_entries[MAX_EXOSIP_ACCOUNT_INFO]; struct eXosip_http_auth http_auths[MAX_EXOSIP_HTTP_AUTH]; CbSipCallback cbsipCallback; };
3、eXosip_event_t
/**
* Structure for event description
* @struct eXosip_event
*/
struct eXosip_event
{
eXosip_event_type_t type; /**< type of the event */
char textinfo[256]; /**< text description of event */
void *external_reference; /**< external reference (for calls) */
osip_message_t *request; /**< request within current transaction */
osip_message_t *response; /**< last response within current transaction */
osip_message_t *ack; /**< ack within current transaction */
int tid; /**< unique id for transactions (to be used for answers) */
int did; /**< unique id for SIP dialogs */
int rid; /**< unique id for registration */
int cid; /**< unique id for SIP calls (but multiple dialogs!) */
int sid; /**< unique id for outgoing subscriptions */
int nid; /**< unique id for incoming subscriptions */
int ss_status; /**< current Subscription-State for subscription */
int ss_reason; /**< current Reason status for subscription */
};
主要函数说明：
1、eXosip_init
/** * Initiate the eXtented oSIP library. * */ int eXosip_init (void);
2、eXosip_listen_addr
/** * Listen on a specified socket. * * @param transport IPPROTO_UDP for udp. (soon to come: TCP/TLS?) * @param addr the address to bind (NULL for all interface) * @param port the listening port. (0 for random port) * @param family the IP family (AF_INET or AF_INET6). * @param secure 0 for UDP or TCP, 1 for TLS (with TCP). */ int eXosip_listen_addr (int transport, const char *addr, int port, int family, int secure);
3、eXosip_execute
/** * Process (non-threaded mode ONLY) eXosip events. * */ int eXosip_execute (void);
4、eXosip_lock、eXosip_unlock
#ifdef OSIP_MT /** * Lock the eXtented oSIP library. * */ int eXosip_lock (void); /** * UnLock the eXtented oSIP library. * */ int eXosip_unlock (void); #else
5、__eXosip_wakeup_event
/** * Wake Up the eXosip_event_wait method. * */ #ifdef OSIP_MT void __eXosip_wakeup_event (void); #else #define __eXosip_wakeup_event() ; #endif
6、eXosip_event_wait
/** * Wait for an eXosip event. * * @param tv_s timeout value (seconds). * @param tv_ms timeout value (mseconds). */ eXosip_event_t *eXosip_event_wait (int tv_s, int tv_ms);
aa