1sip_register_sent_Sbeys(s3iSoInP)Initiation Protocol LibrarysFiupn_crteigoinsster_sent_by(3SIP)
2
3
4

NAME

6       sip_register_sent_by,        sip_unregister_sent_by,       sip_unregis‐
7       ter_all_sent_by - allows registering and un-registering sent-by values
8

SYNOPSIS

10       cc [ flag ... ] file ... -lsip [ library ... ]
11       #include <sip.h>
12
13       int sip_register_sent_by(char *val);
14
15
16       void sip_unregister_sent_by(char *val);
17
18
19       void sip_unregister_all_sent_by(int *error);
20
21

DESCRIPTION

23       The sip_register_sent_by() function can be used to register a  list  of
24       hostnames or IP addresses that the application may add to the VIA head‐
25       ers. The val is a comma separated list of such sent-by values.  If  any
26       value  is  registered using sip_register_sent_by(), the SIP stack vali‐
27       dates incoming responses to check if the sent-by parameter in the  top‐
28       most VIA header is part of the registered list. If the check fails, the
29       response is dropped. If there are no sent-by values  registered,  there
30       is no check done on incoming responses.
31
32
33       The sip_unregister_sent_by() and sip_unregister_all_sent_by() functions
34       are used to  un-register  sent-by  values.  The  val  for  sip_unregis‐
35       ter_sent_by()  is a comma separated list of sent-by values that need to
36       be un-registered.  sip_unregister_all_sent_by()  un-registers  all  the
37       values that have been registered.
38

RETURN VALUES

40       The sip_register_sent_by() function returns 0 on success and the appro‐
41       priate error value on failure.
42
43
44       The value of errno is not changed by these calls in  the  event  of  an
45       error.
46

ATTRIBUTES

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

SEE ALSO

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