Fix Record-Route parsing for large headers.
[asterisk/asterisk.git] / channels / sip / include / reqresp_parser.h
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2010, Digium, Inc.
5  *
6  * See http://www.asterisk.org for more information about
7  * the Asterisk project. Please do not directly contact
8  * any of the maintainers of this project for assistance;
9  * the project provides a web site, mailing lists and IRC
10  * channels for your use.
11  *
12  * This program is free software, distributed under the terms of
13  * the GNU General Public License Version 2. See the LICENSE file
14  * at the top of the source tree.
15  */
16
17 /*!
18  * \file
19  * \brief sip request response parser header file
20  */
21
22 #ifndef _SIP_REQRESP_H
23 #define _SIP_REQRESP_H
24
25 /*!
26  * \brief parses a URI in its components.
27  *
28  * \note
29  * - Multiple scheme's can be specified ',' delimited. ex: "sip:,sips:"
30  * - If a component is not requested, do not split around it. This means
31  *   that if we don't have domain, we cannot split name:pass.
32  * - It is safe to call with ret_name, pass, hostport pointing all to
33  *   the same place.
34  * - If no secret parameter is provided, ret_name will return with both
35  *   parts, user:secret.
36  * - If the URI contains a port number, hostport will return with both
37  *   parts, host:port.
38  * - This function overwrites the the URI string.
39  * 
40  * \retval 0 on success
41  * \retval -1 on error.
42  *
43  * \verbatim
44  * general form we are expecting is sip:user:password;user-parameters@host:port;uri-parameters?headers
45  * \endverbatim
46  */
47 int parse_uri(char *uri, const char *scheme, char **ret_name, char **pass,
48               char **hostport, char **transport);
49
50 /*!
51  * \brief parses a URI in to all of its components and any trailing residue
52  *
53  * \retval 0 on success
54  * \retval -1 on error.
55  *
56  */
57 int parse_uri_full(char *uri, const char *scheme, char **user, char **pass,
58                    char **hostport, struct uriparams *params, char **headers,
59                    char **residue);
60
61 /*!
62  * \brief  Get caller id name from SIP headers, copy into output buffer
63  *
64  * \retval input string pointer placed after display-name field if possible
65  */
66 const char *get_calleridname(const char *input, char *output, size_t outputsize);
67
68 /*!
69  * \brief  Get name and number from sip header
70  *
71  * \note name and number point to malloced memory on return and must be
72  * freed. If name or number is not found, they will be returned as NULL.
73  *
74  * \retval 0 success
75  * \retval -1 failure
76  */
77 int get_name_and_number(const char *hdr, char **name, char **number);
78
79 /*! \brief Pick out text in brackets from character string
80  * \return pointer to terminated stripped string
81  * \param tmp input string that will be modified
82  *
83  * Examples:
84  * \verbatim
85  * "foo" <bar>  valid input, returns bar
86  *  foo returns the whole string
87  * < "foo ... > returns the string between brackets
88  * < "foo...    bogus (missing closing bracket), returns the whole string
89  * \endverbatim
90  */
91 char *get_in_brackets(char *tmp);
92
93 /*! \brief Get text in brackets on a const without copy
94  *
95  * \param src String to search
96  * \param[out] start Set to first character inside left bracket.
97  * \param[out] length Set to lenght of string inside brackets
98  * \retval 0 success
99  * \retval -1 failure
100  * \retval 1 no brackets so got all
101  */
102 int get_in_brackets_const(const char *src,const char **start,int *length);
103
104 /*! \brief Get text in brackets and any trailing residue
105  *
106  * \retval 0 success
107  * \retval -1 failure
108  * \retval 1 no brackets so got all
109  */
110 int get_in_brackets_full(char *tmp, char **out, char **residue);
111
112 /*! \brief Parse the ABNF structure
113  * name-andor-addr = name-addr / addr-spec
114  * into its components and return any trailing message-header parameters
115  *
116  * \retval 0 success
117  * \retval -1 failure
118  */
119 int parse_name_andor_addr(char *uri, const char *scheme, char **name,
120                           char **user, char **pass, char **domain,
121                           struct uriparams *params, char **headers,
122                           char **remander);
123
124 /*! \brief Parse all contact header contacts
125  * \retval 0 success
126  * \retval -1 failure
127  * \retval 1 all contacts (star)
128  */
129
130 int get_comma(char *parse, char **out);
131
132 int parse_contact_header(char *contactheader, struct contactliststruct *contactlist);
133
134 /*!
135  * \brief register request parsing tests
136  */
137 void sip_request_parser_register_tests(void);
138
139 /*!
140  * \brief unregister request parsing tests
141  */
142 void sip_request_parser_unregister_tests(void);
143
144 /*!
145  * \brief Parse supported header in incoming packet
146  *
147  * \details This function parses through the options parameters and
148  * builds a bit field representing all the SIP options in that field. When an
149  * item is found that is not supported, it is copied to the unsupported
150  * out buffer.
151  *
152  * \param option list
153  * \param unsupported out buffer (optional)
154  * \param unsupported out buffer length (optional)
155  */
156 unsigned int parse_sip_options(const char *options, char *unsupported, size_t unsupported_len);
157
158 /*!
159  * \brief Compare two URIs as described in RFC 3261 Section 19.1.4
160  *
161  * \param input1 First URI
162  * \param input2 Second URI
163  * \retval 0 URIs match
164  * \retval nonzero URIs do not match or one or both is malformed
165  */
166 int sip_uri_cmp(const char *input1, const char *input2);
167
168 /*!
169  * \brief initialize request and response parser data
170  *
171  * \retval 0 Success
172  * \retval -1 Failure
173  */
174 int sip_reqresp_parser_init(void);
175
176 /*!
177  * \brief Free resources used by request and response parser
178  */
179 void sip_reqresp_parser_exit(void);
180
181 /*!
182  * \brief Parse a Via header
183  *
184  * This function parses the Via header and processes it according to section
185  * 18.2 of RFC 3261 and RFC 3581. Since we don't have a transport layer, we
186  * only care about the maddr and ttl parms.  The received and rport params are
187  * not parsed.
188  *
189  * \note This function fails to parse some odd combinations of SWS in parameter
190  * lists.
191  *
192  * \code
193  * VIA syntax. RFC 3261 section 25.1
194  * Via               =  ( "Via" / "v" ) HCOLON via-parm *(COMMA via-parm)
195  * via-parm          =  sent-protocol LWS sent-by *( SEMI via-params )
196  * via-params        =  via-ttl / via-maddr
197  *                   / via-received / via-branch
198  *                   / via-extension
199  * via-ttl           =  "ttl" EQUAL ttl
200  * via-maddr         =  "maddr" EQUAL host
201  * via-received      =  "received" EQUAL (IPv4address / IPv6address)
202  * via-branch        =  "branch" EQUAL token
203  * via-extension     =  generic-param
204  * sent-protocol     =  protocol-name SLASH protocol-version
205  *                   SLASH transport
206  * protocol-name     =  "SIP" / token
207  * protocol-version  =  token
208  * transport         =  "UDP" / "TCP" / "TLS" / "SCTP"
209  *                   / other-transport
210  * sent-by           =  host [ COLON port ]
211  * ttl               =  1*3DIGIT ; 0 to 255
212  * \endcode
213  */
214 struct sip_via *parse_via(const char *header);
215
216 /*
217  * \brief Free parsed Via data.
218  */
219 void free_via(struct sip_via *v);
220
221 #endif