Main Page | Modules | Class List | Directories | File List | Class Members | File Members | Related Pages

oSIP fsm Handling
[State Machines]


Classes

struct  osip_ict
struct  osip_nict
struct  osip_ist
struct  osip_nist
struct  osip_transaction
struct  ixt_t
struct  osip
struct  osip_event
struct  osip_ict
struct  osip_nict
struct  osip_ist
struct  osip_nist
struct  osip_transaction
struct  ixt
struct  osip
struct  osip_event

Defines

#define DEFAULT_T1   500
#define DEFAULT_T2   4000
#define DEFAULT_T4   5000
#define EVT_IS_RCV_INVITE(event)   (event->type==RCV_REQINVITE)
#define EVT_IS_RCV_ACK(event)   (event->type==RCV_REQACK)
#define EVT_IS_RCV_REQUEST(event)   (event->type==RCV_REQUEST)
#define EVT_IS_RCV_STATUS_1XX(event)   (event->type==RCV_STATUS_1XX)
#define EVT_IS_RCV_STATUS_2XX(event)   (event->type==RCV_STATUS_2XX)
#define EVT_IS_RCV_STATUS_3456XX(event)   (event->type==RCV_STATUS_3456XX)
#define EVT_IS_SND_INVITE(event)   (event->type==SND_REQINVITE)
#define EVT_IS_SND_ACK(event)   (event->type==SND_REQACK)
#define EVT_IS_SND_REQUEST(event)   (event->type==SND_REQUEST)
#define EVT_IS_SND_STATUS_1XX(event)   (event->type==SND_STATUS_1XX)
#define EVT_IS_SND_STATUS_2XX(event)   (event->type==SND_STATUS_2XX)
#define EVT_IS_SND_STATUS_3456XX(event)   (event->type==SND_STATUS_3456XX)
#define EVT_IS_INCOMINGMSG(event)
#define EVT_IS_INCOMINGREQ(event)
#define EVT_IS_INCOMINGRESP(event)
#define EVT_IS_OUTGOINGMSG(event)
#define EVT_IS_OUTGOINGREQ(event)
#define EVT_IS_OUTGOINGRESP(event)
#define EVT_IS_MSG(event)
#define EVT_IS_KILL_TRANSACTION(event)   (event->type==KILL_TRANSACTION)

Typedefs

typedef enum _state_t state_t
typedef enum type_t type_t
typedef enum osip_fsm_type_t osip_fsm_type_t
typedef osip_ict osip_ict_t
typedef osip_nict osip_nict_t
typedef osip_ist osip_ist_t
typedef osip_nist osip_nist_t
typedef osip_transaction osip_transaction_t
typedef enum osip_message_callback_type osip_message_callback_type_t
typedef enum osip_kill_callback_type osip_kill_callback_type_t
typedef enum osip_transport_error_callback_type osip_transport_error_callback_type_t
typedef void(* osip_message_cb_t )(int type, osip_transaction_t *, osip_message_t *)
typedef void(* osip_kill_transaction_cb_t )(int type, osip_transaction_t *)
typedef void(* osip_transport_error_cb_t )(int type, osip_transaction_t *, int error)
typedef ixt_t ixt_t
typedef osip osip_t
typedef osip_event osip_event_t

Enumerations

enum  _state_t {
  ICT_PRE_CALLING, ICT_CALLING, ICT_PROCEEDING, ICT_COMPLETED,
  ICT_TERMINATED, IST_PRE_PROCEEDING, IST_PROCEEDING, IST_COMPLETED,
  IST_CONFIRMED, IST_TERMINATED, NICT_PRE_TRYING, NICT_TRYING,
  NICT_PROCEEDING, NICT_COMPLETED, NICT_TERMINATED, NIST_PRE_TRYING,
  NIST_TRYING, NIST_PROCEEDING, NIST_COMPLETED, NIST_TERMINATED
}
enum  type_t {
  TIMEOUT_A, TIMEOUT_B, TIMEOUT_D, TIMEOUT_E,
  TIMEOUT_F, TIMEOUT_K, TIMEOUT_G, TIMEOUT_H,
  TIMEOUT_I, TIMEOUT_J, RCV_REQINVITE, RCV_REQACK,
  RCV_REQUEST, RCV_STATUS_1XX, RCV_STATUS_2XX, RCV_STATUS_3456XX,
  SND_REQINVITE, SND_REQACK, SND_REQUEST, SND_STATUS_1XX,
  SND_STATUS_2XX, SND_STATUS_3456XX, KILL_TRANSACTION, UNKNOWN_EVT
}
enum  osip_fsm_type_t { ICT, IST, NICT, NIST }
enum  osip_message_callback_type {
  OSIP_ICT_INVITE_SENT = 0, OSIP_ICT_INVITE_SENT_AGAIN, OSIP_ICT_ACK_SENT, OSIP_ICT_ACK_SENT_AGAIN,
  OSIP_ICT_STATUS_1XX_RECEIVED, OSIP_ICT_STATUS_2XX_RECEIVED, OSIP_ICT_STATUS_2XX_RECEIVED_AGAIN, OSIP_ICT_STATUS_3XX_RECEIVED,
  OSIP_ICT_STATUS_4XX_RECEIVED, OSIP_ICT_STATUS_5XX_RECEIVED, OSIP_ICT_STATUS_6XX_RECEIVED, OSIP_ICT_STATUS_3456XX_RECEIVED_AGAIN,
  OSIP_IST_INVITE_RECEIVED, OSIP_IST_INVITE_RECEIVED_AGAIN, OSIP_IST_ACK_RECEIVED, OSIP_IST_ACK_RECEIVED_AGAIN,
  OSIP_IST_STATUS_1XX_SENT, OSIP_IST_STATUS_2XX_SENT, OSIP_IST_STATUS_2XX_SENT_AGAIN, OSIP_IST_STATUS_3XX_SENT,
  OSIP_IST_STATUS_4XX_SENT, OSIP_IST_STATUS_5XX_SENT, OSIP_IST_STATUS_6XX_SENT, OSIP_IST_STATUS_3456XX_SENT_AGAIN,
  OSIP_NICT_REGISTER_SENT, OSIP_NICT_BYE_SENT, OSIP_NICT_OPTIONS_SENT, OSIP_NICT_INFO_SENT,
  OSIP_NICT_CANCEL_SENT, OSIP_NICT_NOTIFY_SENT, OSIP_NICT_SUBSCRIBE_SENT, OSIP_NICT_UNKNOWN_REQUEST_SENT,
  OSIP_NICT_REQUEST_SENT_AGAIN, OSIP_NICT_STATUS_1XX_RECEIVED, OSIP_NICT_STATUS_2XX_RECEIVED, OSIP_NICT_STATUS_2XX_RECEIVED_AGAIN,
  OSIP_NICT_STATUS_3XX_RECEIVED, OSIP_NICT_STATUS_4XX_RECEIVED, OSIP_NICT_STATUS_5XX_RECEIVED, OSIP_NICT_STATUS_6XX_RECEIVED,
  OSIP_NICT_STATUS_3456XX_RECEIVED_AGAIN, OSIP_NIST_REGISTER_RECEIVED, OSIP_NIST_BYE_RECEIVED, OSIP_NIST_OPTIONS_RECEIVED,
  OSIP_NIST_INFO_RECEIVED, OSIP_NIST_CANCEL_RECEIVED, OSIP_NIST_NOTIFY_RECEIVED, OSIP_NIST_SUBSCRIBE_RECEIVED,
  OSIP_NIST_UNKNOWN_REQUEST_RECEIVED, OSIP_NIST_REQUEST_RECEIVED_AGAIN, OSIP_NIST_STATUS_1XX_SENT, OSIP_NIST_STATUS_2XX_SENT,
  OSIP_NIST_STATUS_2XX_SENT_AGAIN, OSIP_NIST_STATUS_3XX_SENT, OSIP_NIST_STATUS_4XX_SENT, OSIP_NIST_STATUS_5XX_SENT,
  OSIP_NIST_STATUS_6XX_SENT, OSIP_NIST_STATUS_3456XX_SENT_AGAIN, OSIP_MESSAGE_CALLBACK_COUNT
}
enum  osip_kill_callback_type {
  OSIP_ICT_KILL_TRANSACTION, OSIP_IST_KILL_TRANSACTION, OSIP_NICT_KILL_TRANSACTION, OSIP_NIST_KILL_TRANSACTION,
  OSIP_KILL_CALLBACK_COUNT
}
enum  osip_transport_error_callback_type {
  OSIP_ICT_TRANSPORT_ERROR, OSIP_IST_TRANSPORT_ERROR, OSIP_NICT_TRANSPORT_ERROR, OSIP_NIST_TRANSPORT_ERROR,
  OSIP_TRANSPORT_ERROR_CALLBACK_COUNT
}

Functions

int osip_set_message_callback (osip_t *osip, int type, osip_message_cb_t cb)
int osip_set_kill_transaction_callback (osip_t *osip, int type, osip_kill_transaction_cb_t cb)
int osip_set_transport_error_callback (osip_t *osip, int type, osip_transport_error_cb_t cb)
int osip_transaction_init (osip_transaction_t **transaction, osip_fsm_type_t ctx_type, osip_t *osip, osip_message_t *request)
int osip_transaction_free (osip_transaction_t *transaction)
int osip_transaction_free2 (osip_transaction_t *transaction)
void osip_response_get_destination (osip_message_t *response, char **address, int *portnum)
int osip_ict_set_destination (osip_ict_t *ict, char *destination, int port)
int osip_nict_set_destination (osip_nict_t *nict, char *destination, int port)
int osip_transaction_add_event (osip_transaction_t *transaction, osip_event_t *evt)
int osip_transaction_execute (osip_transaction_t *transaction, osip_event_t *evt)
int osip_transaction_set_your_instance (osip_transaction_t *transaction, void *instance)
void * osip_transaction_get_your_instance (osip_transaction_t *transaction)
int osip_transaction_get_destination (osip_transaction_t *transaction, char **ip, int *port)
int osip_transaction_set_in_socket (osip_transaction_t *transaction, int sock)
int osip_transaction_set_out_socket (osip_transaction_t *transaction, int sock)
int osip_init (osip_t **osip)
void osip_release (osip_t *osip)
void osip_set_application_context (osip_t *osip, void *pointer)
void * osip_get_application_context (osip_t *osip)
int osip_remove_transaction (osip_t *osip, osip_transaction_t *ict)
int osip_ict_execute (osip_t *osip)
int osip_ist_execute (osip_t *osip)
int osip_nict_execute (osip_t *osip)
int osip_nist_execute (osip_t *osip)
void osip_timers_gettimeout (osip_t *osip, struct timeval *lower_tv)
void osip_timers_ict_execute (osip_t *osip)
void osip_timers_ist_execute (osip_t *osip)
void osip_timers_nict_execute (osip_t *osip)
void osip_timers_nist_execute (osip_t *osip)
osip_transaction_tosip_transaction_find (osip_list_t *transactions, osip_event_t *evt)
int osip_find_transaction_and_add_event (osip_t *osip, osip_event_t *evt)
osip_transaction_tosip_create_transaction (osip_t *osip, osip_event_t *evt)
osip_event_tosip_parse (const char *buf, size_t length)
void osip_retransmissions_execute (osip_t *osip)
void osip_start_200ok_retransmissions (osip_t *osip, struct osip_dialog *dialog, osip_message_t *msg200ok, int sock)
void osip_start_ack_retransmissions (osip_t *osip, struct osip_dialog *dialog, osip_message_t *ack, char *dest, int port, int sock)
osip_dialogosip_stop_200ok_retransmissions (osip_t *osip, osip_message_t *ack)
void osip_stop_retransmissions_from_dialog (osip_t *osip, struct osip_dialog *dialog)
osip_event_tosip_new_outgoing_sipmessage (osip_message_t *sip)
void osip_event_free (osip_event_t *event)
void osip_set_cb_send_message (osip_t *cf, int(*cb)(osip_transaction_t *, osip_message_t *, char *, int, int))

Define Documentation

#define DEFAULT_T1   500
 

You can re-define the default value for T1. (T1 is defined in rfcxxxx) The default value is 500ms.

#define DEFAULT_T2   4000
 

You can re-define the default value for T2. (T2 is defined in rfcxxxx) The default value is 4000ms.

#define DEFAULT_T4   5000
 

You can re-define the default value for T4. (T1 is defined in rfcxxxx) The default value is 5000ms.

#define EVT_IS_INCOMINGMSG event   ) 
 

Value:

(event->type>=RCV_REQINVITE \
                                       &&event->type<=RCV_STATUS_3456XX)
Check if the sipevent is of an incoming SIP MESSAGE.
Parameters:
event the event to check.

#define EVT_IS_INCOMINGREQ event   ) 
 

Value:

(EVT_IS_RCV_INVITE(event) \
                                       ||EVT_IS_RCV_ACK(event) \
                                       ||EVT_IS_RCV_REQUEST(event))
Check if the sipevent is of an incoming SIP REQUEST.
Parameters:
event the event to check.

#define EVT_IS_INCOMINGRESP event   ) 
 

Value:

Check if the sipevent is of an incoming SIP RESPONSE.
Parameters:
event the event to check.

#define EVT_IS_KILL_TRANSACTION event   )     (event->type==KILL_TRANSACTION)
 

Check if the sipevent is of type KILL_TRANSACTION. NOTE: THIS IS AN INTERNAL METHOD ONLY

Parameters:
event the event to check.

#define EVT_IS_MSG event   ) 
 

Value:

(event->type>=RCV_REQINVITE \
                                       &&event->type<=SND_STATUS_3456XX)
Check if the sipevent is a SIP MESSAGE.
Parameters:
event the event to check.

#define EVT_IS_OUTGOINGMSG event   ) 
 

Value:

(event->type>=SND_REQINVITE \
                                       &&event->type<=SND_STATUS_3456XX)
Check if the sipevent is of an outgoing SIP MESSAGE.
Parameters:
event the event to check.

#define EVT_IS_OUTGOINGREQ event   ) 
 

Value:

(EVT_IS_SND_INVITE(event) \
                                       ||EVT_IS_SND_ACK(event) \
                                       ||EVT_IS_SND_REQUEST(event))
Check if the sipevent is of an outgoing SIP REQUEST.
Parameters:
event the event to check.

#define EVT_IS_OUTGOINGRESP event   ) 
 

Value:

Check if the sipevent is of an outgoing SIP RESPONSE.
Parameters:
event the event to check.

#define EVT_IS_RCV_ACK event   )     (event->type==RCV_REQACK)
 

Check if the sipevent is of type RCV_REQACK.

Parameters:
event the event to check.

#define EVT_IS_RCV_INVITE event   )     (event->type==RCV_REQINVITE)
 

Check if the sipevent is of type RCV_REQINVITE.

Parameters:
event the event to check.

#define EVT_IS_RCV_REQUEST event   )     (event->type==RCV_REQUEST)
 

Check if the sipevent is of type RCV_REQUEST.

Parameters:
event the event to check.

#define EVT_IS_RCV_STATUS_1XX event   )     (event->type==RCV_STATUS_1XX)
 

Check if the sipevent is of type RCV_STATUS_1XX.

Parameters:
event the event to check.

#define EVT_IS_RCV_STATUS_2XX event   )     (event->type==RCV_STATUS_2XX)
 

Check if the sipevent is of type RCV_STATUS_2XX.

Parameters:
event the event to check.

#define EVT_IS_RCV_STATUS_3456XX event   )     (event->type==RCV_STATUS_3456XX)
 

Check if the sipevent is of type RCV_STATUS_3456XX.

Parameters:
event the event to check.

#define EVT_IS_SND_ACK event   )     (event->type==SND_REQACK)
 

Check if the sipevent is of type SND_REQACK.

Parameters:
event the event to check.

#define EVT_IS_SND_INVITE event   )     (event->type==SND_REQINVITE)
 

Check if the sipevent is of type SND_REQINVITE.

Parameters:
event the event to check.

#define EVT_IS_SND_REQUEST event   )     (event->type==SND_REQUEST)
 

Check if the sipevent is of type SND_REQUEST.

Parameters:
event the event to check.

#define EVT_IS_SND_STATUS_1XX event   )     (event->type==SND_STATUS_1XX)
 

Check if the sipevent is of type SND_STATUS_1XX.

Parameters:
event the event to check.

#define EVT_IS_SND_STATUS_2XX event   )     (event->type==SND_STATUS_2XX)
 

Check if the sipevent is of type SND_STATUS_2XX.

Parameters:
event the event to check.

#define EVT_IS_SND_STATUS_3456XX event   )     (event->type==SND_STATUS_3456XX)
 

Check if the sipevent is of type SND_STATUS_3456XX.

Parameters:
event the event to check.


Typedef Documentation

ixt_t
 

Structure for 2XX retransmission management.

osip_event_t
 

Structure for osip event handling. A osip_event_t element will have a type and will be related to a transaction. In the general case, it is used by the application layer to give SIP messages to the oSIP finite state machine.

typedef enum osip_fsm_type_t osip_fsm_type_t
 

Enumeration for transaction type. A transaction can be either of: ICT, IST, NICT, NIST,

osip_ict_t
 

Structure for INVITE CLIENT TRANSACTION (outgoing INVITE transaction).

osip_ist_t
 

Structure for INVITE SERVER TRANSACTION (incoming INVITE transaction).

typedef enum osip_kill_callback_type osip_kill_callback_type_t
 

Enumeration for callback type used when transaction is over.

osip_kill_transaction_cb_t
 

Callback definition for end of transaction announcements.

typedef enum osip_message_callback_type osip_message_callback_type_t
 

Enumeration for callback type.

osip_message_cb_t
 

Callback definition for message announcements.

osip_nict_t
 

Structure for NON-INVITE CLIENT TRANSACTION (outgoing NON-INVITE transaction).

osip_nist_t
 

Structure for NON-INVITE SERVER TRANSACTION (incoming SERVER transaction).

osip_t
 

Structure for osip handling. In order to use osip, you have to manage at least one global instance of an osip_t element. Then, you'll register a set of required callbacks and a set of optional ones.

osip_transaction_t
 

Structure for transaction handling.

typedef enum osip_transport_error_callback_type osip_transport_error_callback_type_t
 

Enumeration for callback type used when a transport error is detected.

osip_transport_error_cb_t
 

Callback definition for transport error announcements.

typedef enum _state_t state_t
 

Enumeration for transaction state. Those states are extracted from the diagram found in rfc3261.txt

typedef enum type_t type_t
 

Enumeration for event type.
The list of values that you need to know is reduced to this:
RCV_REQINVITE,
RCV_REQACK,
RCV_REQUEST,
RCV_STATUS_1XX,
RCV_STATUS_2XX,
RCV_STATUS_3456XX,

SND_REQINVITE,
SND_REQACK,
SND_REQUEST,
SND_STATUS_1XX,
SND_STATUS_2XX,
SND_STATUS_3456XX,


Enumeration Type Documentation

enum _state_t
 

Enumeration for transaction state. Those states are extracted from the diagram found in rfc3261.txt

enum osip_fsm_type_t
 

Enumeration for transaction type. A transaction can be either of: ICT, IST, NICT, NIST,

Enumeration values:
ICT  Invite Client (outgoing) Transaction
IST  Invite Server (incoming) Transaction
NICT  Non-Invite Client (outgoing) Transaction
NIST  Non-Invite Server (incoming) Transaction

enum osip_kill_callback_type
 

Enumeration for callback type used when transaction is over.

Enumeration values:
OSIP_ICT_KILL_TRANSACTION  end of Client INVITE transaction
OSIP_IST_KILL_TRANSACTION  end of Server INVITE transaction
OSIP_NICT_KILL_TRANSACTION  end of Client Non-INVITE transaction
OSIP_NIST_KILL_TRANSACTION  end of Server Non-INVITE transaction
OSIP_KILL_CALLBACK_COUNT  END OF ENUM

enum osip_message_callback_type
 

Enumeration for callback type.

Enumeration values:
OSIP_ICT_INVITE_SENT  INVITE MESSAGE SENT
OSIP_ICT_INVITE_SENT_AGAIN  INVITE MESSAGE RETRANSMITTED
OSIP_ICT_ACK_SENT  ACK MESSAGE SENT
OSIP_ICT_ACK_SENT_AGAIN  ACK MESSAGE RETRANSMITTED
OSIP_ICT_STATUS_1XX_RECEIVED  1XX FOR INVITE RECEIVED
OSIP_ICT_STATUS_2XX_RECEIVED  2XX FOR INVITE RECEIVED
OSIP_ICT_STATUS_2XX_RECEIVED_AGAIN  2XX FOR INVITE RECEIVED AGAIN
OSIP_ICT_STATUS_3XX_RECEIVED  3XX FOR INVITE RECEIVED
OSIP_ICT_STATUS_4XX_RECEIVED  4XX FOR INVITE RECEIVED
OSIP_ICT_STATUS_5XX_RECEIVED  5XX FOR INVITE RECEIVED
OSIP_ICT_STATUS_6XX_RECEIVED  6XX FOR INVITE RECEIVED
OSIP_ICT_STATUS_3456XX_RECEIVED_AGAIN  RESPONSE RECEIVED AGAIN
OSIP_IST_INVITE_RECEIVED  INVITE MESSAGE RECEIVED
OSIP_IST_INVITE_RECEIVED_AGAIN  INVITE MESSAGE RECEIVED AGAN
OSIP_IST_ACK_RECEIVED  ACK MESSAGE RECEIVED
OSIP_IST_ACK_RECEIVED_AGAIN  ACK MESSAGE RECEIVED AGAIN
OSIP_IST_STATUS_1XX_SENT  1XX FOR INVITE SENT
OSIP_IST_STATUS_2XX_SENT  2XX FOR INVITE SENT
OSIP_IST_STATUS_2XX_SENT_AGAIN  2XX FOR INVITE RETRANSMITTED
OSIP_IST_STATUS_3XX_SENT  3XX FOR INVITE SENT
OSIP_IST_STATUS_4XX_SENT  4XX FOR INVITE SENT
OSIP_IST_STATUS_5XX_SENT  5XX FOR INVITE SENT
OSIP_IST_STATUS_6XX_SENT  6XX FOR INVITE SENT
OSIP_IST_STATUS_3456XX_SENT_AGAIN  RESPONSE RETRANSMITTED
OSIP_NICT_REGISTER_SENT  REGISTER MESSAGE SENT
OSIP_NICT_BYE_SENT  BYE MESSAGE SENT
OSIP_NICT_OPTIONS_SENT  OPTIONS MESSAGE SENT
OSIP_NICT_INFO_SENT  INFO MESSAGE SENT
OSIP_NICT_CANCEL_SENT  CANCEL MESSAGE SENT
OSIP_NICT_NOTIFY_SENT  NOTIFY MESSAGE SENT
OSIP_NICT_SUBSCRIBE_SENT  SUBSCRIBE MESSAGE SENT
OSIP_NICT_UNKNOWN_REQUEST_SENT  UNKNOWN REQUEST MESSAGE SENT
OSIP_NICT_REQUEST_SENT_AGAIN  REQUEST MESSAGE RETRANMITTED
OSIP_NICT_STATUS_1XX_RECEIVED  1XX FOR MESSAGE RECEIVED
OSIP_NICT_STATUS_2XX_RECEIVED  2XX FOR MESSAGE RECEIVED
OSIP_NICT_STATUS_2XX_RECEIVED_AGAIN  2XX FOR MESSAGE RECEIVED AGAIN
OSIP_NICT_STATUS_3XX_RECEIVED  3XX FOR MESSAGE RECEIVED
OSIP_NICT_STATUS_4XX_RECEIVED  4XX FOR MESSAGE RECEIVED
OSIP_NICT_STATUS_5XX_RECEIVED  5XX FOR MESSAGE RECEIVED
OSIP_NICT_STATUS_6XX_RECEIVED  6XX FOR MESSAGE RECEIVED
OSIP_NICT_STATUS_3456XX_RECEIVED_AGAIN  RESPONSE RECEIVED AGAIN
OSIP_NIST_REGISTER_RECEIVED  REGISTER RECEIVED
OSIP_NIST_BYE_RECEIVED  BYE RECEIVED
OSIP_NIST_OPTIONS_RECEIVED  OPTIONS RECEIVED
OSIP_NIST_INFO_RECEIVED  INFO RECEIVED
OSIP_NIST_CANCEL_RECEIVED  CANCEL RECEIVED
OSIP_NIST_NOTIFY_RECEIVED  NOTIFY RECEIVED
OSIP_NIST_SUBSCRIBE_RECEIVED  SUBSCRIBE RECEIVED
OSIP_NIST_UNKNOWN_REQUEST_RECEIVED  UNKNWON REQUEST RECEIVED
OSIP_NIST_REQUEST_RECEIVED_AGAIN  UNKNWON REQUEST RECEIVED AGAIN
OSIP_NIST_STATUS_1XX_SENT  1XX FOR MESSAGE SENT
OSIP_NIST_STATUS_2XX_SENT  2XX FOR MESSAGE SENT
OSIP_NIST_STATUS_2XX_SENT_AGAIN  2XX FOR MESSAGE RETRANSMITTED
OSIP_NIST_STATUS_3XX_SENT  3XX FOR MESSAGE SENT
OSIP_NIST_STATUS_4XX_SENT  4XX FOR MESSAGE SENT
OSIP_NIST_STATUS_5XX_SENT  5XX FOR MESSAGE SENT
OSIP_NIST_STATUS_6XX_SENT  6XX FOR MESSAGE SENT
OSIP_NIST_STATUS_3456XX_SENT_AGAIN  RESPONSE RETRANSMITTED
OSIP_MESSAGE_CALLBACK_COUNT  END OF ENUM

enum osip_transport_error_callback_type
 

Enumeration values:
OSIP_ICT_TRANSPORT_ERROR  transport error for ICT
OSIP_IST_TRANSPORT_ERROR  transport error for IST
OSIP_NICT_TRANSPORT_ERROR  transport error for NICT
OSIP_NIST_TRANSPORT_ERROR  transport error for NIST
OSIP_TRANSPORT_ERROR_CALLBACK_COUNT  END OF ENUM

enum type_t
 

Enumeration for event type.
The list of values that you need to know is reduced to this:
RCV_REQINVITE,
RCV_REQACK,
RCV_REQUEST,
RCV_STATUS_1XX,
RCV_STATUS_2XX,
RCV_STATUS_3456XX,

SND_REQINVITE,
SND_REQACK,
SND_REQUEST,
SND_STATUS_1XX,
SND_STATUS_2XX,
SND_STATUS_3456XX,

Enumeration values:
TIMEOUT_A  Timer A
TIMEOUT_B  Timer B
TIMEOUT_D  Timer D
TIMEOUT_E  Timer E
TIMEOUT_F  Timer F
TIMEOUT_K  Timer K
TIMEOUT_G  Timer G
TIMEOUT_H  Timer H
TIMEOUT_I  Timer I
TIMEOUT_J  Timer J
RCV_REQINVITE  Event is an incoming INVITE request
RCV_REQACK  Event is an incoming ACK request
RCV_REQUEST  Event is an incoming NON-INVITE and NON-ACK request
RCV_STATUS_1XX  Event is an incoming informational response
RCV_STATUS_2XX  Event is an incoming 2XX response
RCV_STATUS_3456XX  Event is an incoming final response (not 2XX)
SND_REQINVITE  Event is an outgoing INVITE request
SND_REQACK  Event is an outgoing ACK request
SND_REQUEST  Event is an outgoing NON-INVITE and NON-ACK request
SND_STATUS_1XX  Event is an outgoing informational response
SND_STATUS_2XX  Event is an outgoing 2XX response
SND_STATUS_3456XX  Event is an outgoing final response (not 2XX)
KILL_TRANSACTION  Event to 'kill' the transaction before termination


Function Documentation

osip_transaction_t* osip_create_transaction osip_t osip,
osip_event_t evt
 

Create a transaction for this event (MUST be a SIP REQUEST event).

Parameters:
osip The element to work on.
evt The element representing the new SIP REQUEST.

void osip_event_free osip_event_t event  ) 
 

Free all ressource in a sipevent.

Parameters:
event The event to free.

int osip_find_transaction_and_add_event osip_t osip,
osip_event_t evt
 

Search for a transaction that match this event (MUST be a MESSAGE event) and add this event if a transaction is found..

Parameters:
osip The element to work on.
evt The element representing the SIP MESSAGE.

void* osip_get_application_context osip_t osip  ) 
 

Get a pointer in a osip_t element. This help to find your application layer in callbacks.

Parameters:
osip The element to work on.

int osip_ict_execute osip_t osip  ) 
 

Consume ALL pending osip_event_t previously added in the fifos of ict transactions.

Parameters:
osip The element to work on.

int osip_ict_set_destination osip_ict_t ict,
char *  destination,
int  port
 

Set the host and port destination used for sending the SIP message. This can be useful for an application with 'DIRECT ROOTING MODE' NOTE: Instead, you should use the 'Route' header facility which leads to the same behaviour.

Parameters:
ict The element to work on.
destination The destination host.
port The destination port.

int osip_init osip_t **  osip  ) 
 

Allocate an osip_t element.

Parameters:
osip the element to allocate.

int osip_ist_execute osip_t osip  ) 
 

Consume ALL pending osip_event_t previously added in the fifos of ist transactions.

Parameters:
osip The element to work on.

osip_event_t* osip_new_outgoing_sipmessage osip_message_t sip  ) 
 

Allocate a sipevent (we know this message is an OUTGOING SIP message).

Parameters:
sip The SIP message we want to send.

int osip_nict_execute osip_t osip  ) 
 

Consume ALL pending osip_event_t previously added in the fifos of nict transactions.

Parameters:
osip The element to work on.

int osip_nict_set_destination osip_nict_t nict,
char *  destination,
int  port
 

Set the host and port destination used for sending the SIP message. This can be useful for an application with 'DIRECT ROOTING MODE' NOTE: Instead, you should use the 'Route' header facility which leads to the same behaviour.

Parameters:
nict The element to work on.
destination The destination host.
port The destination port.

int osip_nist_execute osip_t osip  ) 
 

Consume ALL pending osip_event_t previously added in the fifos of nist transactions.

Parameters:
osip The element to work on.

osip_event_t* osip_parse const char *  buf,
size_t  length
 

Create a sipevent from a SIP message string.

Parameters:
buf The SIP message as a string.
length The length of the buffer to parse.

void osip_release osip_t osip  ) 
 

Free all resource in a osip_t element.

Parameters:
osip The element to release.

int osip_remove_transaction osip_t osip,
osip_transaction_t ict
 

Remove a transaction from the osip stack.

Parameters:
osip The element to work on.
ict The transaction to add.

void osip_response_get_destination osip_message_t response,
char **  address,
int *  portnum
 

Search in a SIP response the destination where the message should be sent.

Parameters:
response the message to work on.
address a pointer to receive the allocated host address.
portnum a pointer to receive the host port.

void osip_retransmissions_execute osip_t osip  ) 
 

Send required retransmissions

Parameters:
osip The element to work on.

void osip_set_application_context osip_t osip,
void *  pointer
 

Set a pointer in a osip_t element. This help to find your application layer in callbacks.

Parameters:
osip The element to work on.
pointer The element to set.

void osip_set_cb_send_message osip_t cf,
int(*)(osip_transaction_t *, osip_message_t *, char *, int, int)  cb
 

Register the callback used to send SIP message.

Parameters:
cf The osip element attached to the transaction.
cb The method we want to register.

int osip_set_kill_transaction_callback osip_t osip,
int  type,
osip_kill_transaction_cb_t  cb
 

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

Parameters:
osip The element to work on.
type The event type to hook on.
cb The method to be called upon the event.

int osip_set_message_callback osip_t osip,
int  type,
osip_message_cb_t  cb
 

Set a callback for each transaction operation.

Parameters:
osip The element to work on.
type The event type to hook on.
cb The method to be called upon the event.

int osip_set_transport_error_callback osip_t osip,
int  type,
osip_transport_error_cb_t  cb
 

Set a callback for each transaction operation related to network error.

Parameters:
osip The element to work on.
type The event type to hook on.
cb The method to be called upon the event.

void osip_start_200ok_retransmissions osip_t osip,
struct osip_dialog dialog,
osip_message_t msg200ok,
int  sock
 

Start out of fsm 200 Ok retransmissions. This is usefull for user-agents.

Parameters:
osip The osip_t structure.
dialog The dialog the 200 Ok is part of.
msg200ok The 200 ok response.
sock The socket to be used to send the message. (optional).

void osip_start_ack_retransmissions osip_t osip,
struct osip_dialog dialog,
osip_message_t ack,
char *  dest,
int  port,
int  sock
 

Start out of fsm ACK retransmissions. This is usefull for user-agents.

Parameters:
osip The osip_t structure.
dialog The dialog the ACK is part of.
ack The ACK that has just been sent in response to a 200 Ok.
dest The destination host.
port The destination port.
sock The socket to be used to send the message. (optional).

struct osip_dialog* osip_stop_200ok_retransmissions osip_t osip,
osip_message_t ack
 

Stop the out of fsm 200 Ok retransmissions matching an incoming ACK.

Parameters:
osip The osip_t structure.
ack The ack that has just been received.

void osip_stop_retransmissions_from_dialog osip_t osip,
struct osip_dialog dialog
 

Stop out of fsm retransmissions (ACK or 200 Ok) associated to a given dialog. This function must be called before freeing a dialog if out of fsm retransmissions have been scheduled.

Parameters:
osip The osip_t structure
dialog The dialog.

void osip_timers_gettimeout osip_t osip,
struct timeval *  lower_tv
 

Retreive the minimum timer value to be used by an application so that the osip_timer_*_execute method don't have to be called often.

Parameters:
osip The element to work on.
lower_tv The minimum timer when the application should wake up.

void osip_timers_ict_execute osip_t osip  ) 
 

Check if an ict transactions needs a timer event.

Parameters:
osip The element to work on.

void osip_timers_ist_execute osip_t osip  ) 
 

Check if an ist transactions needs a timer event.

Parameters:
osip The element to work on.

void osip_timers_nict_execute osip_t osip  ) 
 

Check if a nict transactions needs a timer event.

Parameters:
osip The element to work on.

void osip_timers_nist_execute osip_t osip  ) 
 

Check if a nist transactions needs a timer event.

Parameters:
osip The element to work on.

int osip_transaction_add_event osip_transaction_t transaction,
osip_event_t evt
 

Add a SIP event in the fifo of a osip_transaction_t element.

Parameters:
transaction The element to work on.
evt The event to add.

int osip_transaction_execute osip_transaction_t transaction,
osip_event_t evt
 

Consume one osip_event_t element previously added in the fifo. NOTE: This method MUST NEVER be called within another call of this method. (For example, you can't call osip_transaction_execute() in a callback registered in the osip_t element.)

Parameters:
transaction The element to free.
evt The element to consume.

osip_transaction_t* osip_transaction_find osip_list_t transactions,
osip_event_t evt
 

Search for a transaction that match this event (MUST be a MESSAGE event).

Parameters:
transactions The list of transactions to work on.
evt The element representing the SIP MESSAGE.

int osip_transaction_free osip_transaction_t transaction  ) 
 

Free all resource in a osip_transaction_t element.

Parameters:
transaction The element to free.

int osip_transaction_free2 osip_transaction_t transaction  ) 
 

Free all resource in a osip_transaction_t element. This method does the same than osip_transaction_free() but it assumes that the transaction is already removed from the list of transaction in the osip stack. (to remove it use osip_xixt_remove(osip, transaction);

Parameters:
transaction The element to free.

int osip_transaction_get_destination osip_transaction_t transaction,
char **  ip,
int *  port
 

Get target ip and port for this request. (automaticly set by osip_transaction_init() for ict and nict)

Parameters:
transaction The element to work on.
ip The ip of host where to send initial request.
port The port where to send initial request.

void* osip_transaction_get_your_instance osip_transaction_t transaction  ) 
 

Get a pointer to your personal context associated with this transaction.

Parameters:
transaction The element to work on.

int osip_transaction_init osip_transaction_t **  transaction,
osip_fsm_type_t  ctx_type,
osip_t osip,
osip_message_t request
 

Allocate an osip_transaction_t element.

Parameters:
transaction The element to allocate.
ctx_type The type of transaction. (ICT, IST, NICT, NIST)
osip The global instance of oSIP.
request The SIP request that initiate the transaction.

int osip_transaction_set_in_socket osip_transaction_t transaction,
int  sock
 

Set the socket for incoming message. NOTE: THIS HAS NEVER TESTED! Please send feedback.

Parameters:
transaction The element to work on.
sock The socket for incoming message.

int osip_transaction_set_out_socket osip_transaction_t transaction,
int  sock
 

Set the socket for outgoing message. NOTE: THIS HAS NEVER TESTED! Please send feedback.

Parameters:
transaction The element to work on.
sock The socket for outgoing message.

int osip_transaction_set_your_instance osip_transaction_t transaction,
void *  instance
 

Set a pointer to your personal context associated with this transaction. NOTE: this is a very useful method that allow you to avoid searching for your personal context inside the registered callbacks. You can initialise this pointer to your context right after the creation of the osip_transaction_t element. Then, you'll be able to get the address of your context by calling osip_transaction_get_your_instance().

Parameters:
transaction The element to work on.
instance The address of your context.


Generated on Tue Feb 22 00:59:47 2005 for libosip by  doxygen 1.4.1