1sip_create_dialog_Sreesqs(i3oSnIPI)nitiation Protocol LibrarysiFpu_nccrteiaotnes_dialog_req(3SIP)
2
3
4

NAME

6       sip_create_dialog_req,  sip_create_dialog_req_nocontact - create an in-
7       dialog request
8

SYNOPSIS

10       cc [ flag ... ] file ... -lsip [ library ... ]
11       #include <sip.h>
12
13       sip_msg_t sip_create_dialog_req(sip_method_t method,
14            sip_dialog_t dialog, char *transport, char *sent_by,
15            int sent_by_port, char *via_param, uint32_t smaxforward,
16            int cseq);
17
18
19       sip_msg_t sip_create_dialog_req_nocontact(sip_method_t method,
20            sip_dialog_t dialog, char *transport, char *sent_by,
21            int sent_by_port, char *via_param, uint32_t smaxforward,
22            int cseq);
23
24

DESCRIPTION

26       The sip_create_dialog_req() function creates and returns a SIP  request
27       with  the  state  information  contained  in  dialog. The method in the
28       resulting request is from method. The method can be one of the  follow‐
29       ing:
30         INVITE
31         ACK
32         OPTIONS
33         BYE
34         CANCEL
35         REGISTER
36         REFER
37         INFO
38         SUBSCRIBE
39         NOTIFY
40         PRACK
41
42
43       The  resulting  request  line in the SIP message has the SIP-Version of
44       "2.0". The URI in the request line is from the  remote  target  in  the
45       dialog  or  from  the route set in the dialog, if present. See RFC 3261
46       (section 12.2) for details. The FROM, TO, and CALL-ID headers are added
47       from  the  dialog.  The MAX-FORWARDS header is added using the value in
48       maxforward. The CSEQ header is added using the SIP method in method and
49       the  sequence  number value in cseq. If cseq is -1, the sequence number
50       is obtained from the local sequence number in  the  dialog.  The  local
51       sequence  number  in  the dialog is incremented and is used in the CSEQ
52       header. The VIA header added is created using the  transport,  sent_by,
53       sent_by_port  (if  non-zero),  and  via_param (if any). If dialog has a
54       non-empty route set, the resulting SIP request has the route  set  from
55       the dialog.
56
57
58       The  sip_create_dialog_req_nocontact()  function is similar to sip_cre‐
59       ate_dialog_req(), except that it does not add the contact header.
60

RETURN VALUES

62       The sip_create_dialog_req() and sip_create_dialog_req_nocontact() func‐
63       tions return the resulting SIP message on success and NULL on failure.
64
65
66       The  value  of  errno  is not changed by these calls in the event of an
67       error.
68

ATTRIBUTES

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

SEE ALSO

84       libsip(3LIB), attributes(5)
85
86
87
88SunOS 5.11                        6 Aug 2007       sip_create_dialog_req(3SIP)
Impressum