1sip_register_sent_Sbeys(s3iSoInP)Initiation Protocol LibrarysFiupn_crteigoinsster_sent_by(3SIP)
2
3
4
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
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
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
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
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
62 libsip(3LIB)
63
64
65
66SunOS 5.11 25 Jan 2007 sip_register_sent_by(3SIP)