sip_add_header(3SIP)

Name

sip_add_header - add a SIP header to the SIP message

Synopsis

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

int sip_add_header(sip_msg_t sip_msg, char *header_string);

Description

The sip_add_header() function takes the SIP header header_string, adds a CRLF (carriage return/line feed) and appends it to the SIP message sip_msg. The sip_add_header () function is typically used when adding a SIP header with multiple values.

Return Values

The sip_add_header() function returns 0 on success and the appropriate error value on failure.

Errors

On failure, the sip_add_header() function can return one of the following error values:

EINVAL

Mandatory parameters are not provided, i.e. null.

EPERM

The message cannot be modified.

ENOMEM

Error allocating memory for creating headers/parameters.

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)