Go to main content

man pages section 3: Networking Library Functions

Exit Print View

Updated: July 2017
 
 

sip_process_new_packet(3SIP)

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(5) for descriptions of the following attributes:

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

See Also

libsip(3LIB)