diff options
| author | Joshua Colp <jcolp@digium.com> | 2015-08-25 09:17:34 -0300 |
|---|---|---|
| committer | Joshua Colp <jcolp@digium.com> | 2015-08-25 13:54:26 -0300 |
| commit | 2a4eee0cd9df5db7fd0e7bcf20c72f920003bd07 (patch) | |
| tree | d8c50aba656e9baee92cd859f25d22496d8702fa /include/asterisk | |
| parent | d238cf33a9bfe86f9ebdb204384df820098c2670 (diff) | |
res_pjsip: Add common ast_sip_get_host_ip API.
Modules commonly used the pj_gethostip function for retrieving the
IP address of the host. This function does not cache the result and may
result in a DNS lookup occurring, or additional work. If the DNS
server is unreachable or network issues arise this can cause the
pj_gethostip function to block for a period of time.
This change adds an ast_sip_get_host_ip and ast_sip_get_host_ip_string
function which does the same thing but caches the host IP address at
module load time. This results in no additional work being done each
time the local host IP address is needed.
ASTERISK-25342 #close
Change-Id: I3205deb679b01fa5ac05a94b623bfd620a2abe1e
Diffstat (limited to 'include/asterisk')
| -rw-r--r-- | include/asterisk/res_pjsip.h | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/include/asterisk/res_pjsip.h b/include/asterisk/res_pjsip.h index 7c7b058cf..d1bf38871 100644 --- a/include/asterisk/res_pjsip.h +++ b/include/asterisk/res_pjsip.h @@ -2071,4 +2071,31 @@ unsigned int ast_sip_get_max_initial_qualify_time(void); const char *ast_sip_get_contact_status_label(const enum ast_sip_contact_status_type status); const char *ast_sip_get_contact_short_status_label(const enum ast_sip_contact_status_type status); +/*! + * \brief Retrieve the local host address in IP form + * + * \param af The address family to retrieve + * \param addr A place to store the local host address + * + * \retval 0 success + * \retval -1 failure + * + * \since 13.6.0 + */ +int ast_sip_get_host_ip(int af, pj_sockaddr *addr); + +/*! + * \brief Retrieve the local host address in string form + * + * \param af The address family to retrieve + * + * \retval non-NULL success + * \retval NULL failure + * + * \since 13.6.0 + * + * \note An empty string may be returned if the address family is valid but no local address exists + */ +const char *ast_sip_get_host_ip_string(int af); + #endif /* _RES_PJSIP_H */ |