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

oSIP message API
[The parser modules]


Classes

struct  osip_message
struct  osip_message

Defines

#define SIP_MESSAGE_MAX_LENGTH   4000
#define BODY_MESSAGE_MAX_SIZE   1000
#define MSG_IS_RESPONSE(msg)   ((msg)->status_code!=0)
#define MSG_IS_REQUEST(msg)   ((msg)->status_code==0)
#define MSG_IS_INVITE(msg)
#define MSG_IS_ACK(msg)
#define MSG_IS_REGISTER(msg)
#define MSG_IS_BYE(msg)
#define MSG_IS_OPTIONS(msg)
#define MSG_IS_INFO(msg)
#define MSG_IS_CANCEL(msg)
#define MSG_IS_REFER(msg)
#define MSG_IS_NOTIFY(msg)
#define MSG_IS_SUBSCRIBE(msg)
#define MSG_IS_MESSAGE(msg)
#define MSG_IS_PRACK(msg)
#define MSG_IS_UPDATE(msg)
#define MSG_IS_PUBLISH(msg)
#define MSG_IS_STATUS_1XX(msg)
#define MSG_IS_STATUS_2XX(msg)
#define MSG_IS_STATUS_3XX(msg)
#define MSG_IS_STATUS_4XX(msg)
#define MSG_IS_STATUS_5XX(msg)
#define MSG_IS_STATUS_6XX(msg)
#define MSG_TEST_CODE(msg, code)
#define MSG_IS_RESPONSE_FOR(msg, requestname)
#define osip_generic_param_init(GP)   osip_uri_param_init(GP)
#define osip_generic_param_free(GP)   osip_uri_param_free(GP)
#define osip_generic_param_set(GP, NAME, VALUE)   osip_uri_param_set(GP, NAME, VALUE)
#define osip_generic_param_clone(GP, DEST)   osip_uri_param_clone(GP,DEST)
#define osip_generic_param_add(LIST, NAME, VALUE)   osip_uri_param_add(LIST,NAME,VALUE)
#define osip_generic_param_get_byname(LIST, NAME, DEST)   osip_uri_param_get_byname(LIST,NAME,DEST)

Typedefs

typedef osip_message osip_message_t

Functions

int osip_message_init (osip_message_t **sip)
void osip_message_free (osip_message_t *sip)
int osip_message_parse (osip_message_t *sip, const char *buf, size_t length)
int osip_message_to_str (osip_message_t *sip, char **dest, size_t *message_length)
int osip_message_clone (const osip_message_t *sip, osip_message_t **dest)
void osip_message_set_reason_phrase (osip_message_t *sip, char *reason)
char * osip_message_get_reason_phrase (const osip_message_t *sip)
void osip_message_set_status_code (osip_message_t *sip, int statuscode)
int osip_message_get_status_code (const osip_message_t *sip)
void osip_message_set_method (osip_message_t *sip, char *method)
char * osip_message_get_method (const osip_message_t *sip)
void osip_message_set_version (osip_message_t *sip, char *version)
char * osip_message_get_version (const osip_message_t *sip)
void osip_message_set_uri (osip_message_t *sip, osip_uri_t *uri)
osip_uri_t * osip_message_get_uri (const osip_message_t *sip)
void osip_generic_param_set_name (osip_generic_param_t *generic_param, char *name)
char * osip_generic_param_get_name (const osip_generic_param_t *generic_param)
void osip_generic_param_set_value (osip_generic_param_t *generic_param, char *value)
char * osip_generic_param_get_value (const osip_generic_param_t *generic_param)

Define Documentation

#define BODY_MESSAGE_MAX_SIZE   1000
 

You can define the maximum length for a body inside a SIP message.

#define MSG_IS_ACK (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"ACK"))
Test if the message is an ACK REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_BYE (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"BYE"))
Test if the message is a BYE REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_CANCEL (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"CANCEL"))
Test if the message is a CANCEL REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_INFO (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"INFO"))
Test if the message is an INFO REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_INVITE (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"INVITE"))
Test if the message is an INVITE REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_MESSAGE (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"MESSAGE"))
Test if the message is a MESSAGE REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_NOTIFY (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"NOTIFY"))
Test if the message is a NOTIFY REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_OPTIONS (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"OPTIONS"))
Test if the message is an OPTIONS REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_PRACK (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"PRACK"))
Test if the message is a PRACK REQUEST (!! PRACK IS NOT SUPPORTED by the fsm!!)
Parameters:
msg the SIP message.

#define MSG_IS_PUBLISH (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"PUBLISH"))
Test if the message is an UPDATE REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_REFER (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"REFER"))
Test if the message is a REFER REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_REGISTER (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"REGISTER"))
Test if the message is a REGISTER REQUEST
Parameters:
msg the SIP message.

#define MSG_IS_REQUEST (  msg   )     ((msg)->status_code==0)
 

Test if the message is a SIP REQUEST

Parameters:
msg the SIP message.

#define MSG_IS_RESPONSE (  msg   )     ((msg)->status_code!=0)
 

Test if the message is a SIP RESPONSE

Parameters:
msg the SIP message.

#define MSG_IS_RESPONSE_FOR (  msg,
requestname   ) 
 

Value:

(MSG_IS_RESPONSE(msg) && \
                                 0==strcmp((msg)->cseq->method,(requestname)))
Test if the message is a response for a REQUEST of certain type
Parameters:
msg the SIP message.
requestname the method name to match.

#define MSG_IS_STATUS_1XX (  msg   ) 
 

Value:

((msg)->status_code >= 100 && \
                                (msg)->status_code < 200)
Test if the message is a response with status between 100 and 199
Parameters:
msg the SIP message.

#define MSG_IS_STATUS_2XX (  msg   ) 
 

Value:

((msg)->status_code >= 200 && \
                                (msg)->status_code < 300)
Test if the message is a response with status between 200 and 299
Parameters:
msg the SIP message.

#define MSG_IS_STATUS_3XX (  msg   ) 
 

Value:

((msg)->status_code >= 300 && \
                                (msg)->status_code < 400)
Test if the message is a response with status between 300 and 399
Parameters:
msg the SIP message.

#define MSG_IS_STATUS_4XX (  msg   ) 
 

Value:

((msg)->status_code >= 400 && \
                                (msg)->status_code < 500)
Test if the message is a response with status between 400 and 499
Parameters:
msg the SIP message.

#define MSG_IS_STATUS_5XX (  msg   ) 
 

Value:

((msg)->status_code >= 500 && \
                                (msg)->status_code < 600)
Test if the message is a response with status between 500 and 599
Parameters:
msg the SIP message.

#define MSG_IS_STATUS_6XX (  msg   ) 
 

Value:

((msg)->status_code >= 600 && \
                                (msg)->status_code < 700)
Test if the message is a response with status between 600 and 699
Parameters:
msg the SIP message.

#define MSG_IS_SUBSCRIBE (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"SUBSCRIBE"))
Test if the message is a SUBSCRIBE REQUEST

Parameters:
msg the SIP message.

#define MSG_IS_UPDATE (  msg   ) 
 

Value:

(MSG_IS_REQUEST(msg) && \
                              0==strcmp((msg)->sip_method,"UPDATE"))
Test if the message is an UPDATE REQUEST
Parameters:
msg the SIP message.

#define MSG_TEST_CODE (  msg,
code   ) 
 

Value:

(MSG_IS_RESPONSE(msg) && \
                                 (code)==(msg)->status_code)
Test if the message is a response with a status set to the code value.
Parameters:
msg the SIP message.
code the status code.

#define osip_generic_param_add (  LIST,
NAME,
VALUE   )     osip_uri_param_add(LIST,NAME,VALUE)
 

Allocate and add a generic parameter element in a list.

Parameters:
LIST The list of generic parameter element to work on.
NAME The token name.
VALUE The token value.

#define osip_generic_param_clone (  GP,
DEST   )     osip_uri_param_clone(GP,DEST)
 

Clone a generic parameter element.

Parameters:
GP The element to work on.
DEST The resulting new allocated buffer.

#define osip_generic_param_free (  GP   )     osip_uri_param_free(GP)
 

Free a generic parameter element.

Parameters:
GP The element to work on.

#define osip_generic_param_get_byname (  LIST,
NAME,
DEST   )     osip_uri_param_get_byname(LIST,NAME,DEST)
 

Find in a generic parameter element in a list.

Parameters:
LIST The list of generic parameter element to work on.
NAME The name of the parameter element to find.
DEST A pointer on the element found.

#define osip_generic_param_init (  GP   )     osip_uri_param_init(GP)
 

Allocate a generic parameter element.

Parameters:
GP The element to work on.

#define osip_generic_param_set (  GP,
NAME,
VALUE   )     osip_uri_param_set(GP, NAME, VALUE)
 

Set values of a generic parameter element.

Parameters:
GP The element to work on.
NAME The token name.
VALUE The token value.

#define SIP_MESSAGE_MAX_LENGTH   4000
 

You can re-define your own maximum length for SIP message.

Typedef Documentation

osip_message_t
 

Structure for SIP Message (REQUEST and RESPONSE).

Function Documentation

char* osip_generic_param_get_name (  const osip_generic_param_t *  generic_param  ) 
 

Get the name of a generic parameter element.

Parameters:
generic_param The element to work on.

char* osip_generic_param_get_value (  const osip_generic_param_t *  generic_param  ) 
 

Get the value of a generic parameter element.

Parameters:
generic_param The element to work on.

void osip_generic_param_set_name (  osip_generic_param_t *  generic_param,
char *  name
) 
 

Set the name of a generic parameter element.

Parameters:
generic_param The element to work on.
name the token name to set.

void osip_generic_param_set_value (  osip_generic_param_t *  generic_param,
char *  value
) 
 

Set the value of a generic parameter element.

Parameters:
generic_param The element to work on.
value the token name to set.

int osip_message_clone (  const osip_message_t *  sip,
osip_message_t **  dest
) 
 

Clone a osip_message_t element.

Parameters:
sip The element to clone.
dest The new allocated element cloned.

void osip_message_free (  osip_message_t *  sip  ) 
 

Free all resource in a osip_message_t element.

Parameters:
sip The element to free.

char* osip_message_get_method (  const osip_message_t *  sip  ) 
 

Get the method name.

Parameters:
sip The element to work on.

char* osip_message_get_reason_phrase (  const osip_message_t *  sip  ) 
 

Get the reason phrase. This is entirely free in SIP.

Parameters:
sip The element to work on.

int osip_message_get_status_code (  const osip_message_t *  sip  ) 
 

Get the status code.

Parameters:
sip The element to work on.

osip_uri_t* osip_message_get_uri (  const osip_message_t *  sip  ) 
 

Get the Request-URI.

Parameters:
sip The element to work on.

char* osip_message_get_version (  const osip_message_t *  sip  ) 
 

Get the SIP version.

Parameters:
sip The element to work on.

int osip_message_init (  osip_message_t **  sip  ) 
 

Allocate a osip_message_t element.

Parameters:
sip The element to allocate.

int osip_message_parse (  osip_message_t *  sip,
const char *  buf,
size_t  length
) 
 

Parse a osip_message_t element.

Parameters:
sip The resulting element.
buf The buffer to parse.
length The length of the buffer to parse.

void osip_message_set_method (  osip_message_t *  sip,
char *  method
) 
 

Set the method. You can set any string here.

Parameters:
sip The element to work on.
method The method name.

void osip_message_set_reason_phrase (  osip_message_t *  sip,
char *  reason
) 
 

Set the reason phrase. This is entirely free in SIP.

Parameters:
sip The element to work on.
reason The reason phrase.

void osip_message_set_status_code (  osip_message_t *  sip,
int  statuscode
) 
 

Set the status code. This is entirely free in SIP.

Parameters:
sip The element to work on.
statuscode The status code.

void osip_message_set_uri (  osip_message_t *  sip,
osip_uri_t *  uri
) 
 

Set the Request-URI.

Parameters:
sip The element to work on.
uri The uri to set.

void osip_message_set_version (  osip_message_t *  sip,
char *  version
) 
 

Set the SIP version used. (default is "SIP/2.0")

Parameters:
sip The element to work on.
version The version of SIP.

int osip_message_to_str (  osip_message_t *  sip,
char **  dest,
size_t *  message_length
) 
 

Get a string representation of a osip_message_t element.

Parameters:
sip The element to work on.
dest new allocated buffer returned.
message_length The length of the returned buffer.

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