1sip_add_header(3SISPe)ssion Initiation Protocol Library Functisoinps_add_header(3SIP)
2
3
4

NAME

6       sip_add_header - add a SIP header to the SIP message
7

SYNOPSIS

9       cc [ flag ... ] file ... -lsip [ library ... ]
10       #include <sip.h>
11
12       int sip_add_header(sip_msg_t sip_msg, char *header_string);
13
14

DESCRIPTION

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

RETURN VALUES

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

ERRORS

26       On failure, the sip_add_header() function can return one of the follow‐
27       ing error values:
28
29       EINVAL    Mandatory parameters are not provided, i.e. null.
30
31
32       EPERM     The message cannot be modified.
33
34
35       ENOMEM    Error allocating memory for creating headers/parameters.
36
37

ATTRIBUTES

39       See attributes(5) for descriptions of the following attributes:
40
41
42
43
44       ┌─────────────────────────────┬─────────────────────────────┐
45       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
46       ├─────────────────────────────┼─────────────────────────────┤
47       │Interface Stability          │Committed                    │
48       ├─────────────────────────────┼─────────────────────────────┤
49       │MT-Level                     │MT-Safe                      │
50       └─────────────────────────────┴─────────────────────────────┘
51

SEE ALSO

53       libsip(3LIB)
54
55
56
57SunOS 5.11                        09 Feb 2007             sip_add_header(3SIP)
Impressum