te
Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
sip_get_request_method, sip_get_response_code, sip_get_response_phrase, sip_get_sip_version - obtain attributes from the start line in a SIP message

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

sip_method_t sip_get_request_method(const sip_msg_t sip_msg,
 int *error);

int sip_get_response_code(sip_msg_t sip_msg,
 int *error);

const sip_str_t *sip_get_response_phrase(sip_msg_t sip_msg,
 int *error);

const sip_str_t*sip_get_sip_version(sip_msg_t sip_msg,
 int *error);

For functions that return a pointer of type sip_str_t, sip_str_t is supplied by:

typedef struct sip_str {
 char *sip_str_ptr;
 int sip_str_len;
}sip_str_t;

The sip_str_ptr parameter points to the start of the returned value and sip_str_len supplies the length of the returned value.

For example, given the following request line in a SIP message sip_msg that is input to sip_get_request_uri_str():

FROM : <Alice sip:alice@atlanta.com>;tag=1928301774

the return is a pointer to sip_str_t with the sip_str_ptr member pointing to "A" of Alice and sip_str_len being set to 5, the length of Alice.

Access functions for headers that can have multiple values take the value as the input, while those that can have only one value take the SIP message sip_msg as the input.

The sip_get_request_method() function will return the SIP method from the request line in the SIP message sip_msg. The method can be one of the following:

INVITE

ACK

OPTIONS

BYE

CANCEL

REGISTER

REFER

INFO

SUBSCRIBE

NOTIFY

PRACK

UNKNOWN

The sip_get_response_code() function will return the response code response from the request line in the SIP message sip_msg.

The sip_get_respose_phrase() function will return the response phrase response from the request line in the SIP message sip_msg.

The sip_get_sip_version() function will return the version of the SIP protocol from the request or the response line in the SIP message sip_msg.

For functions that return a pointer to sip_str_t, the return value is the specified value on success or NULL in case of error. For functions that return an integer, the return value is the specified value on success and -1 on error.

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

These functions take a pointer to an integer error as an argument. If the error is non-null, one of the following values is set: EINVAL

EPROTO ENOMEM

On success, the value of the location pointed to by error is set to 0.

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

ATTRIBUTE TYPE ATTRIBUTE VALUE

Interface Stability Committed

MT-Level MT-Safe

libsip(3LIB)