Session Initiation Protocol Library Functions
sip_create_response(3SIP)
NAME
sip_create_response - create a response for a SIP request
SYNOPSIS
cc [ flag ... ] file ... -lsip [ library ... ]
#include
sip_msg_t sip_create_response(sip_msg_t sip_request,
int response_code, char *response_phase,
char *totag, char *contact_uri);
DESCRIPTION
The sip_create_response() function creates and returns a SIP
message in response to the SIP request sip_request. The
response line in the resulting SIP message is created usingthe response code in response_code and the phrase in
response_phrase. The response line has the SIP-Version of
"2.0". If a non-null totag is specified, the resulting SIP
response has a TO header with a tag value from totag. Iftotag is null and the response_code is anything other than
100 (TRYING), sip_create_response() adds a TO header with a
randomly generated tag value. If the response_code is 100
and totag is null, the SIP response has a TO header withouta tag parameter. If contact_uri is non-null, a CONTACT
header is added to the SIP response with the URI specifiedin contact_uri. The SIP response has the following headers
copied from sip_request:
All VIA headers FROM header TO header (with tag added, if required, as stated above)CALL-ID header
CSEQ headerAll RECORD-ROUTE headers
RETURN VALUES
The sip_create_response() function returns the resulting SIP
message on success and NULL on failure. 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 attri-
butes:SunOS 5.11 Last change: 25 Jan 2007 1
Session Initiation Protocol Library Functionssip_create_response(3SIP)
______________________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | MT-Safe |
|_____________________________|_____________________________|
SEE ALSO
libsip(3LIB)SunOS 5.11 Last change: 25 Jan 2007 2
Session Initiation Protocol Library Functionssip_create_response(3SIP)
SunOS 5.11 Last change: 25 Jan 2007 3