1sip_add_header(3SISPe)ssion Initiation Protocol Library Functisoinps_add_header(3SIP)
2
3
4
6 sip_add_header - add a SIP header to the SIP message
7
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
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
22 The sip_add_header() function returns 0 on success and the appropriate
23 error value on failure.
24
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
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
53 libsip(3LIB)
54
55
56
57SunOS 5.11 09 Feb 2007 sip_add_header(3SIP)