mirror of
https://github.com/asterisk/asterisk.git
synced 2025-10-03 11:11:05 +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
109 lines
3.4 KiB
C
109 lines
3.4 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 1999 - 2005, Digium, Inc.
|
|
*
|
|
* Kevin P. Fleming <kpfleming@digium.com>
|
|
*
|
|
* 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 Background DNS update manager
|
|
*/
|
|
|
|
#ifndef _ASTERISK_DNSMGR_H
|
|
#define _ASTERISK_DNSMGR_H
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "asterisk/netsock2.h"
|
|
#include "asterisk/srv.h"
|
|
|
|
/*!
|
|
* \brief A DNS manager entry
|
|
*
|
|
* This is an opaque type.
|
|
*/
|
|
struct ast_dnsmgr_entry;
|
|
|
|
/*!
|
|
* \brief Allocate a new DNS manager entry
|
|
*
|
|
* \param name the hostname
|
|
* \param result where the DNS manager should store the IP address as it refreshes it.
|
|
* \param service
|
|
*
|
|
* This function allocates a new DNS manager entry object, and fills it with the
|
|
* provided hostname and IP address. This function does not force an initial lookup
|
|
* of the IP address. So, generally, this should be used when the initial address
|
|
* is already known.
|
|
*
|
|
* \return a DNS manager entry
|
|
* \version 1.6.1 result changed from struct in_addr to struct sockaddr_in to store port number
|
|
* \version 1.8.0 result changed from struct ast_sockaddr_in to ast_sockaddr for IPv6 support
|
|
*/
|
|
struct ast_dnsmgr_entry *ast_dnsmgr_get(const char *name, struct ast_sockaddr *result, const char *service);
|
|
|
|
/*!
|
|
* \brief Free a DNS manager entry
|
|
*
|
|
* \param entry the DNS manager entry to free
|
|
*
|
|
* \return nothing
|
|
*/
|
|
void ast_dnsmgr_release(struct ast_dnsmgr_entry *entry);
|
|
|
|
/*!
|
|
* \brief Allocate and initialize a DNS manager entry
|
|
*
|
|
* \param name the hostname
|
|
* \param result where to store the IP address as the DNS manager refreshes it. The address family
|
|
* is used as an input parameter to filter the returned adresses. if it is 0, both IPv4 * and IPv6 addresses can be returned.
|
|
* \param dnsmgr Where to store the allocate DNS manager entry
|
|
* \param service
|
|
*
|
|
* This function allocates a new DNS manager entry object, and fills it with
|
|
* the provided hostname and IP address. This function _does_ force an initial
|
|
* lookup, so it may block for some period of time.
|
|
*
|
|
* \retval 0 success
|
|
* \retval non-zero failure
|
|
* \version 1.6.1 result changed from struct in_addr to struct aockaddr_in to store port number
|
|
*/
|
|
int ast_dnsmgr_lookup(const char *name, struct ast_sockaddr *result, struct ast_dnsmgr_entry **dnsmgr, const char *service);
|
|
|
|
/*!
|
|
* \brief Force a refresh of a dnsmgr entry
|
|
*
|
|
* \retval non-zero if the result is different than the previous result
|
|
* \retval zero if the result is the same as the previous result
|
|
*/
|
|
int ast_dnsmgr_refresh(struct ast_dnsmgr_entry *entry);
|
|
|
|
/*!
|
|
* \brief Check is see if a dnsmgr entry has changed
|
|
*
|
|
* \retval non-zero if the dnsmgr entry has changed since the last call to
|
|
* this function
|
|
* \retval zero if the dnsmgr entry has not changed since the last call to
|
|
* this function
|
|
*/
|
|
int ast_dnsmgr_changed(struct ast_dnsmgr_entry *entry);
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
}
|
|
#endif /* c_plusplus */
|
|
|
|
#endif /* ASTERISK_DNSMGR_H */
|