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

AltStyle によって変換されたページ (->オリジナル) /