mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-23 14:44:28 +00:00
cd4ebd336f
This adds a generic API for accommodating IPv6 and IPv4 addresses within Asterisk. While many files have been updated to make use of the API, chan_sip and the RTP code are the files which actually support IPv6 addresses at the time of this commit. The way has been paved for easier upgrading for other files in the near future, though. Big thanks go to Simon Perrault, Marc Blanchet, and Jean-Philippe Dionne for their hard work on this. (closes issue #17565) Reported by: russell Patches: asteriskv6-test-report.pdf uploaded by russell (license 2) Review: https://reviewboard.asterisk.org/r/743 git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@274783 65c4cc65-6c06-0410-ace0-fbb531ad65f3
146 lines
4.3 KiB
C
146 lines
4.3 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 2010, Digium, Inc.
|
|
*
|
|
* See http://www.asterisk.org for more information about
|
|
* the Asterisk project. Please do not directly contact
|
|
* any of the maintainers of this project for assistance;
|
|
* the project provides a web site, mailing lists and IRC
|
|
* channels for your use.
|
|
*
|
|
* This program is free software, distributed under the terms of
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
* at the top of the source tree.
|
|
*/
|
|
|
|
/*!
|
|
* \file
|
|
* \brief sip request response parser header file
|
|
*/
|
|
|
|
#ifndef _SIP_REQRESP_H
|
|
#define _SIP_REQRESP_H
|
|
|
|
/*!
|
|
* \brief parses a URI in its components.
|
|
*
|
|
* \note
|
|
* - Multiple scheme's can be specified ',' delimited. ex: "sip:,sips:"
|
|
* - If a component is not requested, do not split around it. This means
|
|
* that if we don't have domain, we cannot split name:pass.
|
|
* - It is safe to call with ret_name, pass, domain, port pointing all to
|
|
* the same place.
|
|
* - If no secret parameter is provided, ret_name will return with both parts, user:secret
|
|
* - If no port parameter is provided, domain will return with both parts, domain:port
|
|
* - This function overwrites the the uri string.
|
|
*
|
|
* \retval 0 on success
|
|
* \retval -1 on error.
|
|
*
|
|
* \verbatim
|
|
* general form we are expecting is sip:user:password;user-parameters@host:port;uri-parameters?headers
|
|
* \endverbatim
|
|
*/
|
|
int parse_uri(char *uri, const char *scheme, char **ret_name, char **pass,
|
|
char **domain, char **transport);
|
|
|
|
/*!
|
|
* \brief parses a URI in to all of its components and any trailing residue
|
|
*
|
|
* \retval 0 on success
|
|
* \retval -1 on error.
|
|
*
|
|
*/
|
|
int parse_uri_full(char *uri, const char *scheme, char **user, char **pass,
|
|
char **domain, struct uriparams *params, char **headers,
|
|
char **residue);
|
|
|
|
/*!
|
|
* \brief Get caller id name from SIP headers, copy into output buffer
|
|
*
|
|
* \retval input string pointer placed after display-name field if possible
|
|
*/
|
|
const char *get_calleridname(const char *input, char *output, size_t outputsize);
|
|
|
|
/*!
|
|
* \brief Get name and number from sip header
|
|
*
|
|
* \note name and number point to malloced memory on return and must be
|
|
* freed. If name or number is not found, they will be returned as NULL.
|
|
*
|
|
* \retval 0 success
|
|
* \retval -1 failure
|
|
*/
|
|
int get_name_and_number(const char *hdr, char **name, char **number);
|
|
|
|
/*! \brief Pick out text in brackets from character string
|
|
* \return pointer to terminated stripped string
|
|
* \param tmp input string that will be modified
|
|
*
|
|
* Examples:
|
|
* \verbatim
|
|
* "foo" <bar> valid input, returns bar
|
|
* foo returns the whole string
|
|
* < "foo ... > returns the string between brackets
|
|
* < "foo... bogus (missing closing bracket), returns the whole string
|
|
* \endverbatim
|
|
*/
|
|
char *get_in_brackets(char *tmp);
|
|
|
|
/*! \brief Get text in brackets and any trailing residue
|
|
*
|
|
* \retval 0 success
|
|
* \retval -1 failure
|
|
* \retval 1 no brackets so got all
|
|
*/
|
|
int get_in_brackets_full(char *tmp, char **out, char **residue);
|
|
|
|
/*! \brief Parse the ABNF structure
|
|
* name-andor-addr = name-addr / addr-spec
|
|
* into its components and return any trailing message-header parameters
|
|
*
|
|
* \retval 0 success
|
|
* \retval -1 failure
|
|
*/
|
|
int parse_name_andor_addr(char *uri, const char *scheme, char **name,
|
|
char **user, char **pass, char **domain,
|
|
struct uriparams *params, char **headers,
|
|
char **remander);
|
|
|
|
/*! \brief Parse all contact header contacts
|
|
* \retval 0 success
|
|
* \retval -1 failure
|
|
* \retval 1 all contacts (star)
|
|
*/
|
|
|
|
int get_comma(char *parse, char **out);
|
|
|
|
int parse_contact_header(char *contactheader, struct contactliststruct *contactlist);
|
|
|
|
/*!
|
|
* \brief register request parsing tests
|
|
*/
|
|
void sip_request_parser_register_tests(void);
|
|
|
|
/*!
|
|
* \brief unregister request parsing tests
|
|
*/
|
|
void sip_request_parser_unregister_tests(void);
|
|
|
|
/*!
|
|
* \brief Parse supported header in incoming packet
|
|
*
|
|
* \details This function parses through the options parameters and
|
|
* builds a bit field representing all the SIP options in that field. When an
|
|
* item is found that is not supported, it is copied to the unsupported
|
|
* out buffer.
|
|
*
|
|
* \param option list
|
|
* \param unsupported out buffer (optional)
|
|
* \param unsupported out buffer length (optional)
|
|
*/
|
|
unsigned int parse_sip_options(const char *options, char *unsupported, size_t unsupported_len);
|
|
|
|
#endif
|