utils.h: Deprecate `ast_gethostbyname()`. (#79)

Deprecate `ast_gethostbyname()` in favor of `ast_sockaddr_resolve()` and
`ast_sockaddr_resolve_first_af()`. `ast_gethostbyname()` has not been
used by any in-tree code since 2021.

This function will be removed entirely in Asterisk 23.

Resolves: #78

UpgradeNote: ast_gethostbyname() has been deprecated and will be removed
in Asterisk 23. New code should use `ast_sockaddr_resolve()` and
`ast_sockaddr_resolve_first_af()`.
This commit is contained in:
Sean Bright 2023-05-11 15:05:49 -04:00 committed by GitHub
parent d59a8ef59e
commit f414815159
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 1 deletions

View File

@ -210,7 +210,12 @@ struct ast_hostent {
char buf[1024];
};
/*! \brief Thread-safe gethostbyname function to use in Asterisk */
/*!
* \brief Thread-safe gethostbyname function to use in Asterisk
*
* \deprecated Replaced by \c ast_sockaddr_resolve() and \c ast_sockaddr_resolve_first_af()
* \note To be removed in Asterisk 23.
*/
struct hostent *ast_gethostbyname(const char *host, struct ast_hostent *hp);
/*! \brief Produces MD5 hash based on input string */