SIP_PROCESS_NEW_PACKET(3SIP) Session Initiation Protocol Library Functions

NAME

sip_process_new_packet - send an inbound message to the SIP stack for
processing

SYNOPSIS

cc [ flag ... ] file ... -lsip [ library ... ]
#include <sip.h>

void sip_process_new_packet(sip_conn_object_t conn_object,
void *msgstr, size_t msgstr);

DESCRIPTION

The sip_process_new_packet() function receives incoming message,
creates a SIP message, processes it and passes it on to the
application. For a byte-stream protocol like TCP
sip_process_new_packet() also takes care of breaking the byte stream
into message boundaries using the CONTENT-LENGTH header in the SIP
message. If the SIP message arriving on TCP does not contain a
CONTENT-LENGTH header, the behavior is unspecified.
sip_process_new_packet() deletes the SIP message on return from the
application's receive function, thus if the application wishes to
retain the SIP message for future use, it must use sip_hod_msg() so
that the message is not freed by sip_process_new_packet().

RETURN VALUES

The value of errno is not changed by these calls in the event of an
error.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

libsip(3LIB)

January 25, 2007 SIP_PROCESS_NEW_PACKET(3SIP)