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)
