libosip2 / libexosip 李思銳 [email protected]

libosip2 / libexosip

李思銳[email protected]

大綱編譯 libosip2 Description Features src directory

編譯 libosip2

# tar xvfz libosip2-2.2.1.tar.gz # cd libosip2-2.2.1 # ./configure # make # make install

Description

The GNU oSIP library is an implementation of SIP - rfc3261

http://www.gnu.org/software/osip/osip.html

Features

SIP parser1. SIP header parser2. SDP parser

SIP transaction state machines1. ICT : Invite Client Transaction2. NICT: Non Invite Client Transaction3. IST : Invite Server Transaction4. NIST: Non Invite Server Transaction

src directory

src/osip2SIP transaction state machines

src/osipparser2SIP parser

src/testtest programs

大綱 - How-To initialize libosip2

Allocate an osip_t element Register the callback used to send SIP

message Set a callback for transaction operation

related to the end of transactions

Set a callback for each transaction operation related to network error

Set a callback for each transaction operation

Allocate an osip_t element

#include <sys/time.h> #include <osip2/osip.h> int i; osip_t *osip; i=osip_init(&osip); if (i!=0) return -1;

Register the callback used to send SIP message

osip_set_cb_send_message(osip, &cb_udp_snd_message);

Set a callback for transaction operation related to the end of transactions

osip_set_kill_transaction_callback(osip, OSIP_ICT_KILL_TRANSACTION, &cb_ict_kill_transaction);

osip_set_kill_transaction_callback(osip, OSIP_IST_KILL_TRANSACTION, &cb_ist_kill_transaction);

osip_set_kill_transaction_callback(osip, OSIP_NICT_KILL_TRANSACTION, &cb_nict_kill_transaction);

osip_set_kill_transaction_callback(osip, OSIP_NIST_KILL_TRANSACTION, &cb_nist_kill_transaction);

Set a callback for each transaction operation related to network error

osip_set_transport_error_callback(osip, OSIP_ICT_TRANSPORT_ERROR, &cb_transport_error);

osip_set_transport_error_callback(osip, OSIP_IST_TRANSPORT_ERROR, &cb_transport_error);

osip_set_transport_error_callback(osip, OSIP_NICT_TRANSPORT_ERROR, &cb_transport_error);

osip_set_transport_error_callback(osip, OSIP_NIST_TRANSPORT_ERROR, &cb_transport_error);

Set a callback for each transaction operation

osip_set_message_callback(osip, OSIP_ICT_STATUS_1XX_RECEIVED, &cb_rcv1xx);


osip_set_message_callback(osip, OSIP_NICT_STATUS_1XX_RECEIVED, &cb_rcv1xx);


osip_set_message_callback(osip, OSIP_IST_INVITE_RECEIVED, &cb_rcvreq);

osip_set_message_callback(osip, OSIP_IST_ACK_RECEIVED, &cb_rcvreq);

osip_set_message_callback(osip, OSIP_NIST_REGISTER_RECEIVED, &cb_rcvreq);

osip_set_message_callback(osip, OSIP_NIST_BYE_RECEIVED, &cb_rcvreq);

osip_set_message_callback(osip, OSIP_NIST_CANCEL_RECEIVED, &cb_rcvreq);

osip_set_message_callback(osip, OSIP_NIST_UNKNOWN_REQUEST_RECEIVED, &cb_rcvreq);

大綱 - How-To parse URI

Allocate/Free/Parse a header element Get a string representation of a header

element Parse Via header, for example

Allocate/Free/Parse a header element

osip_xxx_init(osip_xxx_t **header); osip_xxx_free(osip_xxx_t *header); osip_xxx_parse(osip_xxx_t *header,

char *buffer);

Get a string representation of a header element

osip_xxx_to_str(osip_xxx_t *header, char **dest);

Parse Via header, for example

osip_via_t *via; char *a_via; char *dest; osip_via_init(&via); osip_via_parse(via, a_via); osip_via_to_str(via, &dest); osip_via_free(via);

大綱 - How-To parse SIP message

Parse a given buffer containing a sip request or response

Convert the message into a printable string

Parse a given buffer containing a sip request or response

osip_message_t *sip; osip_message_init(&sip); osip_message_parse(sip, msg,

strlen(msg); osip_message_free(sip);

Convert the message into a printable string

char *dest; size_t length; osip_message_to_str(sip, &result,

&length); osip_free(dest);

大綱 - How-To use the sdp negotiator

How-to initialize the SDP negotiator How-to add support for medias

How-to initialize the SDP negotiator

struct osip_rfc3264 *cnf; osip_rfc3264_init(&cnf);

How-to add support for medias

sdp_media_t *med; sdp_attribute_t *attr; sdp_media_init(&med); med->m_proto = strdup("RTP/AVP"); osip_list_add(med->m_payloads, tmp, -

1);

sdp_attribute_init(&attr); attr->a_att_field = strdup("rtpmap"); attr->a_att_value = strdup("0

PCMU/8000"); osip_list_add(med->a_attributes, attr, -1); osip_rfc3264_add_audio_media(cnf, med,

-1);

大綱編譯 libexosip Configure option Description Features

編譯 libexosip

# tar xvfz libeXosip-0.9.0.tar.gz # cd libeXosip-0.9.0 # ./configure # make # make install

Configure option

--disable-phapi --disable-miniua --disable-josua --disable-glib

--disable-ms --disable-ortp --disable-gsm --disable-ilbc

Description

eXosip is a GPL library that extend the capability of the oSIP library

It aims to implement a simple high layer API to control the SIP for sessions establishements and common extensions

http://savannah.gnu.org/projects/exosip/

Features

rfc3261: SIP rfcxxxx: MESSAGE request rfcxxxx: SIMPLE support

大綱 - How-To initialize libexosip

Initiate the eXtented oSIP library Force eXosip to use a specific local ip

address in all its SIP message Set the SIP User-Agent: header string Release ressource used by the eXtented

oSIP library

Initiate the eXtented oSIP library

int eXosip_init(FILE *input, FILE *output, int port);

eXosip_init(NULL, NULL, 5060);

Force eXosip to use a specific local ip address in all its SIP message

int eXosip_force_localip(const char *localip);

eXosip_force_localip(“127.0.0.1”);

Set the SIP User-Agent: header string

void eXosip_set_user_agent(const char *user_agent);

eXosip_set_user_agent(“mysip”);

Release ressource used by the eXtented oSIP library

void eXosip_quit(void);

大綱 – How to Process Event

Wait for an eXosip event Free ressource in an eXosip event eXosip event Management

Wait for an eXosip event

eXosip_event_t *eXosip_event_wait(int tv_s, int tv_ms);

eXosip_event_t *event; event = eXosip_event_wait(0, 0);

Free ressource in an eXosip event

void eXosip_event_free(eXosip_event_t *je);

eXosip_event_free(event);

eXosip event Management

switch(event->type) Registration Info UAC events UAS events both UAS & UAC events

Registration Info

EXOSIP_REGISTRATION_NEW EXOSIP_REGISTRATION_SUCCESS EXOSIP_REGISTRATION_FAILURE EXOSIP_REGISTRATION_REFRESHED EXOSIP_REGISTRATION_TERMINATED

UAC events

EXOSIP_CALL_NOANSWER EXOSIP_CALL_PROCEEDING EXOSIP_CALL_RINGING EXOSIP_CALL_ANSWERED EXOSIP_CALL_REDIRECTED EXOSIP_CALL_REQUESTFAILURE EXOSIP_CALL_SERVERFAILURE EXOSIP_CALL_GLOBALFAILURE

UAS events

EXOSIP_CALL_NEW EXOSIP_CALL_ACK EXOSIP_CALL_CANCELLED EXOSIP_CALL_TIMEOUT EXOSIP_CALL_HOLD EXOSIP_CALL_OFFHOLD EXOSIP_CALL_CLOSED

both UAS & UAC events

EXOSIP_CALL_STARTAUDIO EXOSIP_CALL_RELEASED

大綱 – Sample Programs

sip_reg testing Modify sip_call Compile sip_call sip_call testing

sip_reg testing

# sip_reg \-r sip:aaa.bbb.ccc.ddd \-u sip:[email protected] \-c sip:[email protected] \-p 5060 -U 1000 -P 1000 –d

Modify sip_call

modify include header change getch() to be getchar()

Include header

#include <stdio.h> #include <stdlib.h> #include <unistd.h> #include <netdb.h> #include <syslog.h> #include <pthread.h>

_getch() getchar()

//if ( _kbhit() ) //switch ( _getch() ) switch ( getchar() )

Compile sip_call

# g++ \-losip2 -losipparser2 -leXosip \-o sip_call sip_call.cxx

Link error?

sip_call testing

eXosip_build_initial_invite( osip_message_t **invite, char *to, char *from, char *route, char *subject);

a - answering call h - hangup r - ringing c - call q - quit

作業整合 sip_reg 和 sip_call 兩個 demo 程式修正 sip_call 程式的 bug, 例如無法掛斷

的問題等

libosip2 / libexosip 李思銳 [email protected]

Documents