1sip_add_param(3SIPS)ession Initiation Protocol Library Functiosnisp_add_param(3SIP)
2
3
4

NAME

6       sip_add_param - add a parameter to the SIP header
7

SYNOPSIS

9       cc [ flag ... ] file ... -lsip [ library ... ]
10       #include <sip.h>
11
12       sip_header_t sip_add_param(sip_header_t sip_header, char *param,
13            int *error);
14
15

DESCRIPTION

17       The  sip_add_param()  function  adds the parameter provided in param to
18       the SIP header sip_header. The function returns  the  header  with  the
19       parameter  added.  A  new  header  is created as a result of adding the
20       parameter and the old header is marked deleted. Applications with  mul‐
21       tiple threads working on the same SIP header need to take note of this.
22       If error is non-null, it (the location pointer by the variable) is  set
23       to 0 on success and the appropriate error value on error.
24

RETURN VALUES

26       The sip_add_param() function returns the new header on success and null
27       on failure. Further, if error is non-null, then on success the value in
28       the  location  pointed by error is 0 and the appropriate error value on
29       failure.
30

ERRORS

32       On failure, functions that return an error value may return one of  the
33       following:
34
35       EINVAL    Mandatory parameters are not provided, i.e. null.
36
37                 For  sip_add_param(),  the  header  to  be modified is marked
38                 deleted.
39
40
41       EPERM     The message cannot be modified.
42
43
44       ENOMEM    There is  an  error  allocating  memory  for  creating  head‐
45                 ers/parameters.
46
47

ATTRIBUTES

49       See attributes(5) for descriptions of the following attributes:
50
51
52
53
54       ┌─────────────────────────────┬─────────────────────────────┐
55       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
56       ├─────────────────────────────┼─────────────────────────────┤
57       │Interface Stability          │Committed                    │
58       ├─────────────────────────────┼─────────────────────────────┤
59       │MT-Level                     │MT-Safe                      │
60       └─────────────────────────────┴─────────────────────────────┘
61

SEE ALSO

63       libsip(3LIB)
64
65
66
67SunOS 5.11                        25 Jan 2007              sip_add_param(3SIP)
Impressum