1sip_delete_start_lSienses(i3oSnIPI)nitiation Protocol LibrarysiFpu_ndcetlieotnes_start_line(3SIP)
2
3
4

NAME

6       sip_delete_start_line,   sip_delete_header,  sip_delete_header_by_name,
7       sip_delete_value - delete a SIP header or a header value
8

SYNOPSIS

10       cc [ flag ... ] file ... -lsip [ library ... ]
11       #include <sip.h>
12
13       int sip_delete_start_line(sip_msg_t sip_msg);
14
15
16       int sip_delete_header(sip_msg_t sip_header);
17
18
19       int sip_delete_header_by_name(sip_msg_t msg,
20            char *header_name);
21
22
23       int sip_delete_value(sip_header_t sip_header,
24            sip_header_value_t sip_header_value);
25
26

DESCRIPTION

28       The sip_delete_start_line() function deletes the start line, a  request
29       or a response line, from the SIP message sip_msg.
30
31
32       The  sip_delete_header()  function  deletes the SIP header specified by
33       sip_header from the associated SIP message sip_msg.
34
35
36       The sip_delete_header_by_name() function deletes the  SIP  header  name
37       specified  by  header_name  (long or compact form) from the SIP message
38       sip_msg.
39
40
41       The sip_delete_value()  deletes  the  SIP  header  value  specified  by
42       sip_header_value from the SIP header sip_header.
43
44
45       When  a  SIP  header  or  value is deleted, the corresponding header or
46       value is marked as deleted.  Lookups ignore headers or values that  are
47       marked as deleted.
48

RETURN VALUES

50       These  functions return 0 on success and the appropriate error on fail‐
51       ure.
52
53
54       The value of errno is not changed by these calls in  the  event  of  an
55       error.
56

ERRORS

58       On failure, the returned error could be one of the following:
59
60       EINVAL    If any of the required input is NULL.
61
62                 If the header or value to be deleted does not exist.
63
64                 If  the  header  or  value  to  be  deleted  has already been
65                 deleted.
66
67
68       EPERM     If the SIP message cannot be modified.
69
70

ATTRIBUTES

72       See attributes(5) for descriptions of the following attributes:
73
74
75
76
77       ┌─────────────────────────────┬─────────────────────────────┐
78       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │Interface Stability          │Committed                    │
81       ├─────────────────────────────┼─────────────────────────────┤
82       │MT-Level                     │MT-Safe                      │
83       └─────────────────────────────┴─────────────────────────────┘
84

SEE ALSO

86       libsip(3LIB)
87
88
89
90SunOS 5.11                        20 Jan 2007      sip_delete_start_line(3SIP)
Impressum