pjsip_resolver.c

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 2015, Digium, Inc.
 *
 * Joshua Colp <[email protected]>
 *
 * 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.
 */

#include "asterisk.h"

#include <pjsip.h>
#include <pjlib-util/errno.h>

#include <arpa/nameser.h>

#include "asterisk/astobj2.h"
#include "asterisk/dns_core.h"
#include "asterisk/dns_query_set.h"
#include "asterisk/dns_srv.h"
#include "asterisk/dns_naptr.h"
#include "asterisk/res_pjsip.h"
#include "include/res_pjsip_private.h"
#include "asterisk/taskprocessor.h"
#include "asterisk/threadpool.h"

#ifdef HAVE_PJSIP_EXTERNAL_RESOLVER

/*! \brief Structure which contains transport+port information for an active query */
struct sip_target {
   /*! \brief The transport to be used */
   pjsip_transport_type_e transport;
   /*! \brief The port */
   int port;
};

/*! \brief The vector used for current targets */
AST_VECTOR(targets, struct sip_target);

/*! \brief Structure which keeps track of resolution */
struct sip_resolve {
   /*! \brief Addresses currently being resolved, indexed based on index of queries in query set */
   struct targets resolving;
   /*! \brief Active queries */
   struct ast_dns_query_set *queries;
   /*! \brief Current viable server addresses */
   pjsip_server_addresses addresses;
   /*! \brief Serializer to run async callback into pjlib. */
   struct ast_taskprocessor *serializer;
   /*! \brief Callback to invoke upon completion */
   pjsip_resolver_callback *callback;
   /*! \brief User provided data */
   void *token;
};

/*! \brief Our own defined transports, reduces the size of sip_available_transports */
enum sip_resolver_transport {
   SIP_RESOLVER_TRANSPORT_UDP,
   SIP_RESOLVER_TRANSPORT_TCP,
   SIP_RESOLVER_TRANSPORT_TLS,
   SIP_RESOLVER_TRANSPORT_UDP6,
   SIP_RESOLVER_TRANSPORT_TCP6,
   SIP_RESOLVER_TRANSPORT_TLS6,
};

/*! \brief Available transports on the system */
static int sip_available_transports[] = {
   /* This is a list of transports with whether they are available as a valid transport
    * stored. We use our own identifier as to reduce the size of sip_available_transports.
    * As this array is only manipulated at startup it does not require a lock to protect
    * it.
    */
   [SIP_RESOLVER_TRANSPORT_UDP] = 0,
   [SIP_RESOLVER_TRANSPORT_TCP] = 0,
   [SIP_RESOLVER_TRANSPORT_TLS] = 0,
   [SIP_RESOLVER_TRANSPORT_UDP6] = 0,
   [SIP_RESOLVER_TRANSPORT_TCP6] = 0,
   [SIP_RESOLVER_TRANSPORT_TLS6] = 0,
};

/*!
 * \internal
 * \brief Destroy resolution data
 *
 * \param data The resolution data to destroy
 *
 * \return Nothing
 */
static void sip_resolve_destroy(void *data)
{
   struct sip_resolve *resolve = data;

   AST_VECTOR_FREE(&resolve->resolving);
   ao2_cleanup(resolve->queries);
   ast_taskprocessor_unreference(resolve->serializer);
}

/*!
 * \internal
 * \brief Check whether a transport is available or not
 *
 * \param transport The PJSIP transport type
 *
 * \return 1 success (transport is available)
 * \return 0 failure (transport is not available)
 */
static int sip_transport_is_available(enum pjsip_transport_type_e transport)
{
   enum sip_resolver_transport resolver_transport;

   if (transport == PJSIP_TRANSPORT_UDP) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_UDP;
   } else if (transport == PJSIP_TRANSPORT_TCP) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_TCP;
   } else if (transport == PJSIP_TRANSPORT_TLS) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_TLS;
   } else if (transport == PJSIP_TRANSPORT_UDP6) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_UDP6;
   } else if (transport == PJSIP_TRANSPORT_TCP6) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_TCP6;
   } else if (transport == PJSIP_TRANSPORT_TLS6) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_TLS6;
   } else {
      return 0;
   }

   return sip_available_transports[resolver_transport];
}

/*!
 * \internal
 * \brief Add a query to be resolved
 *
 * \param resolve The ongoing resolution
 * \param name What to resolve
 * \param rr_type The type of record to look up
 * \param rr_class The type of class to look up
 * \param transport The transport to use for any resulting records
 * \param port The port to use for any resulting records - if not specified the
 *             default for the transport is used
 *
 * \retval 0 success
 * \retval -1 failure
 */
static int sip_resolve_add(struct sip_resolve *resolve, const char *name, int rr_type, int rr_class, pjsip_transport_type_e transport, int port)
{
   struct sip_target target = {
      .transport = transport,
      .port = port,
   };

   if (!resolve->queries) {
      resolve->queries = ast_dns_query_set_create();
      if (!resolve->queries) {
         return -1;
      }
   }

   if (!port) {
      target.port = pjsip_transport_get_default_port_for_type(transport);
   }

   if (AST_VECTOR_APPEND(&resolve->resolving, target)) {
      return -1;
   }

   ast_debug(2, "[%p] Added target '%s' with record type '%d', transport '%s', and port '%d'\n",
      resolve, name, rr_type, pjsip_transport_get_type_desc(transport), target.port);

   return ast_dns_query_set_add(resolve->queries, name, rr_type, rr_class);
}

/*!
 * \internal
 * \brief Task used to invoke the user specific callback
 *
 * \param data The complete resolution
 *
 * \return Nothing
 */
static int sip_resolve_invoke_user_callback(void *data)
{
   struct sip_resolve *resolve = data;

   if (DEBUG_ATLEAST(2)) {
      /* This includes space for the IP address, [, ], :, and the port */
      char addr[PJ_INET6_ADDRSTRLEN + 10];
      int idx;

      for (idx = 0; idx < resolve->addresses.count; ++idx) {
         pj_sockaddr_print(&resolve->addresses.entry[idx].addr, addr, sizeof(addr), 3);
         ast_log(LOG_DEBUG, "[%p] Address '%d' is %s with transport '%s'\n",
            resolve, idx, addr,
            pjsip_transport_get_type_desc(resolve->addresses.entry[idx].type));
      }
   }

   ast_debug(2, "[%p] Invoking user callback with '%d' addresses\n", resolve, resolve->addresses.count);
   resolve->callback(resolve->addresses.count ? PJ_SUCCESS : PJLIB_UTIL_EDNSNOANSWERREC, resolve->token, &resolve->addresses);

   ao2_ref(resolve, -1);

   return 0;
}

/*!
 * \internal
 * \brief Handle a NAPTR record according to RFC3263
 *
 * \param resolve The ongoing resolution
 * \param record The NAPTR record itself
 * \param service The service to look for
 * \param transport The transport to use for resulting queries
 *
 * \retval 0 success
 * \retval -1 failure (record not handled / supported)
 */
static int sip_resolve_handle_naptr(struct sip_resolve *resolve, const struct ast_dns_record *record,
   const char *service, pjsip_transport_type_e transport)
{
   if (strcasecmp(ast_dns_naptr_get_service(record), service)) {
      return -1;
   }

   /* It is possible for us to receive an explicit transport that is already IPv6, in that case
    * we can't turn it into an IPv6 transport and check. If it's not IPv6 though we need to check
    * for both IPv4 and IPv6 as PJSIP does not provide enough differentiation to know that we
    * want only IPv4.
    */
   if (!sip_transport_is_available(transport) &&
      (!(transport & PJSIP_TRANSPORT_IPV6) && !sip_transport_is_available(transport | PJSIP_TRANSPORT_IPV6))) {
      ast_debug(2, "[%p] NAPTR service %s skipped as transport is unavailable\n",
         resolve, service);
      return -1;
   }

   if (strcasecmp(ast_dns_naptr_get_flags(record), "s")) {
      ast_debug(2, "[%p] NAPTR service %s received with unsupported flags '%s'\n",
         resolve, service, ast_dns_naptr_get_flags(record));
      return -1;
   }

   if (ast_strlen_zero(ast_dns_naptr_get_replacement(record))) {
      return -1;
   }

   return sip_resolve_add(resolve, ast_dns_naptr_get_replacement(record), T_SRV, C_IN,
      transport, 0);
}

/*!
 * \internal
 * \brief Query set callback function, invoked when all queries have completed
 *
 * \param query_set The completed query set
 *
 * \return Nothing
 */
static void sip_resolve_callback(const struct ast_dns_query_set *query_set)
{
   struct sip_resolve *resolve = ast_dns_query_set_get_data(query_set);
   struct ast_dns_query_set *queries = resolve->queries;
   struct targets resolving;
   int idx, address_count = 0, have_naptr = 0, have_srv = 0;
   unsigned short order = 0;
   int strict_order = 0;

   ast_debug(2, "[%p] All parallel queries completed\n", resolve);

   resolve->queries = NULL;

   /* This purposely steals the resolving list so we can add entries to the new one in
    * the same loop and also have access to the old.
    */
   resolving = resolve->resolving;
   AST_VECTOR_INIT(&resolve->resolving, 0);

   /* The order of queries is what defines the preference order for the records within
    * this specific query set. The preference order overall is defined as a result of
    * drilling down from other records. Each completed query set replaces the results
    * of the last.
    */
   for (idx = 0; idx < ast_dns_query_set_num_queries(queries); ++idx) {
      struct ast_dns_query *query = ast_dns_query_set_get(queries, idx);
      struct ast_dns_result *result = ast_dns_query_get_result(query);
      struct sip_target *target;
      const struct ast_dns_record *record;

      if (!result) {
         ast_debug(2, "[%p] No result information for target '%s' of type '%d'\n", resolve,
            ast_dns_query_get_name(query), ast_dns_query_get_rr_type(query));
         continue;
      }

      target = AST_VECTOR_GET_ADDR(&resolving, idx);
      for (record = ast_dns_result_get_records(result); record; record = ast_dns_record_get_next(record)) {

         if (ast_dns_record_get_rr_type(record) == T_A ||
            ast_dns_record_get_rr_type(record) == T_AAAA) {
            /* If NAPTR or SRV records exist the subsequent results from them take preference */
            if (have_naptr || have_srv) {
               ast_debug(2, "[%p] %s record being skipped on target '%s' because NAPTR or SRV record exists\n",
                  resolve, ast_dns_record_get_rr_type(record) == T_A ? "A" : "AAAA",
                  ast_dns_query_get_name(query));
               continue;
            }

            /* PJSIP has a fixed maximum number of addresses that can exist, so limit ourselves to that */
            if (address_count == PJSIP_MAX_RESOLVED_ADDRESSES) {
               break;
            }

            resolve->addresses.entry[address_count].type = target->transport;

            /* Populate address information for the new address entry */
            if (ast_dns_record_get_rr_type(record) == T_A) {
               ast_debug(2, "[%p] A record received on target '%s'\n", resolve, ast_dns_query_get_name(query));
               resolve->addresses.entry[address_count].addr_len = sizeof(pj_sockaddr_in);
               pj_sockaddr_init(pj_AF_INET(), &resolve->addresses.entry[address_count].addr, NULL,
                  target->port);
               resolve->addresses.entry[address_count].addr.ipv4.sin_addr = *(pj_in_addr *) ast_dns_record_get_data(record);
            } else {
               ast_debug(2, "[%p] AAAA record received on target '%s'\n", resolve, ast_dns_query_get_name(query));
               resolve->addresses.entry[address_count].addr_len = sizeof(pj_sockaddr_in6);
               pj_sockaddr_init(pj_AF_INET6(), &resolve->addresses.entry[address_count].addr, NULL,
                  target->port);
               pj_memcpy(&resolve->addresses.entry[address_count].addr.ipv6.sin6_addr, ast_dns_record_get_data(record),
                  ast_dns_record_get_data_size(record));
            }

            address_count++;
         } else if (ast_dns_record_get_rr_type(record) == T_SRV) {
            if (have_naptr) {
               ast_debug(2, "[%p] SRV record being skipped on target '%s' because NAPTR record exists\n",
                  resolve, ast_dns_query_get_name(query));
               continue;
            }

            /* SRV records just create new queries for AAAA+A, nothing fancy */
            ast_debug(2, "[%p] SRV record received on target '%s'\n", resolve, ast_dns_query_get_name(query));

            /* If an explicit IPv6 target transport has been requested look for only AAAA records */
            if ((target->transport & PJSIP_TRANSPORT_IPV6) &&
               sip_transport_is_available(target->transport)) {
               sip_resolve_add(resolve, ast_dns_srv_get_host(record), T_AAAA, C_IN, target->transport,
                  ast_dns_srv_get_port(record));
               have_srv = 1;
            } else if (!(target->transport & PJSIP_TRANSPORT_IPV6) &&
               sip_transport_is_available(target->transport | PJSIP_TRANSPORT_IPV6)) {
               sip_resolve_add(resolve, ast_dns_srv_get_host(record), T_AAAA, C_IN, target->transport | PJSIP_TRANSPORT_IPV6,
                  ast_dns_srv_get_port(record));
               have_srv = 1;
            }

            if (!(target->transport & PJSIP_TRANSPORT_IPV6) &&
               sip_transport_is_available(target->transport)) {
               sip_resolve_add(resolve, ast_dns_srv_get_host(record), T_A, C_IN, target->transport,
                  ast_dns_srv_get_port(record));
               have_srv = 1;
            }
         } else if (ast_dns_record_get_rr_type(record) == T_NAPTR) {
            int added = -1;

            ast_debug(2, "[%p] NAPTR record received on target '%s'\n", resolve, ast_dns_query_get_name(query));

            if (strict_order && (ast_dns_naptr_get_order(record) != order)) {
               ast_debug(2, "[%p] NAPTR record skipped because order '%hu' does not match strict order '%hu'\n",
                  resolve, ast_dns_naptr_get_order(record), order);
               continue;
            }

            if (target->transport == PJSIP_TRANSPORT_UNSPECIFIED || target->transport == PJSIP_TRANSPORT_UDP ||
               target->transport == PJSIP_TRANSPORT_UDP6) {
               added = sip_resolve_handle_naptr(resolve, record, "sip+d2u",
                  target->transport == PJSIP_TRANSPORT_UNSPECIFIED ? PJSIP_TRANSPORT_UDP : target->transport);
            }
            if (target->transport == PJSIP_TRANSPORT_UNSPECIFIED || target->transport == PJSIP_TRANSPORT_TCP ||
               target->transport == PJSIP_TRANSPORT_TCP6) {
               added = sip_resolve_handle_naptr(resolve, record, "sip+d2t",
                  target->transport == PJSIP_TRANSPORT_UNSPECIFIED ? PJSIP_TRANSPORT_TCP : target->transport);
            }
            if (target->transport == PJSIP_TRANSPORT_UNSPECIFIED || target->transport == PJSIP_TRANSPORT_TLS ||
               target->transport == PJSIP_TRANSPORT_TLS6) {
               added = sip_resolve_handle_naptr(resolve, record, "sips+d2t",
                  target->transport == PJSIP_TRANSPORT_UNSPECIFIED ? PJSIP_TRANSPORT_TLS : target->transport);
            }

            /* If this record was successfully handled then we need to limit ourselves to this order */
            if (!added) {
               have_naptr = 1;
               strict_order = 1;
               order = ast_dns_naptr_get_order(record);
            }
         }
      }
   }

   /* Update the server addresses count, this is not limited as it can never exceed the max allowed */
   resolve->addresses.count = address_count;

   /* Free the vector we stole as we are responsible for it */
   AST_VECTOR_FREE(&resolving);

   /* If additional queries were added start the resolution process again */
   if (resolve->queries) {
      ast_debug(2, "[%p] New queries added, performing parallel resolution again\n", resolve);
      ast_dns_query_set_resolve_async(resolve->queries, sip_resolve_callback, resolve);
      ao2_ref(queries, -1);
      return;
   }

   ast_debug(2, "[%p] Resolution completed - %d viable targets\n", resolve, resolve->addresses.count);

   /* Push a task to invoke the callback, we do this so it is guaranteed to run in a PJSIP thread */
   ao2_ref(resolve, +1);
   if (ast_sip_push_task(resolve->serializer, sip_resolve_invoke_user_callback, resolve)) {
      ao2_ref(resolve, -1);
   }

   ao2_ref(queries, -1);
}

/*!
 * \internal
 * \brief Determine what address family a host may be if it is already an IP address
 *
 * \param host The host (which may be an IP address)
 *
 * \retval 6 The host is an IPv6 address
 * \retval 4 The host is an IPv4 address
 * \retval 0 The host is not an IP address
 */
static int sip_resolve_get_ip_addr_ver(const pj_str_t *host)
{
   pj_in_addr dummy;
   pj_in6_addr dummy6;

   if (pj_inet_aton(host, &dummy) > 0) {
      return 4;
   }

   if (pj_inet_pton(pj_AF_INET6(), host, &dummy6) == PJ_SUCCESS) {
      return 6;
   }

   return 0;
}

/*!
 * \internal
 * \brief Perform SIP resolution of a host
 *
 * \param resolver Configured resolver instance
 * \param pool Memory pool to allocate things from
 * \param target The target we are resolving
 * \param token User data to pass to the resolver callback
 * \param cb User resolver callback to invoke upon resolution completion
 */
static void sip_resolve(pjsip_resolver_t *resolver, pj_pool_t *pool, const pjsip_host_info *target,
   void *token, pjsip_resolver_callback *cb)
{
   int ip_addr_ver;
   pjsip_transport_type_e type = target->type;
   struct sip_resolve *resolve;
   char host[NI_MAXHOST];
   int res = 0;

   ast_copy_pj_str(host, &target->addr.host, sizeof(host));

   ast_debug(2, "Performing SIP DNS resolution of target '%s'\n", host);

   /* If the provided target is already an address don't bother resolving */
   ip_addr_ver = sip_resolve_get_ip_addr_ver(&target->addr.host);

   /* Determine the transport to use if none has been explicitly specified */
   if (type == PJSIP_TRANSPORT_UNSPECIFIED) {
      /* If we've been told to use a secure or reliable transport restrict ourselves to that */
#if PJ_HAS_TCP
      if (target->flag & PJSIP_TRANSPORT_SECURE) {
         type = PJSIP_TRANSPORT_TLS;
      } else if (target->flag & PJSIP_TRANSPORT_RELIABLE) {
         type = PJSIP_TRANSPORT_TCP;
      } else
#endif
      /* According to the RFC otherwise if an explicit IP address OR an explicit port is specified
       * we use UDP
       */
      if (ip_addr_ver || target->addr.port) {
         type = PJSIP_TRANSPORT_UDP;
      }

      if (ip_addr_ver == 6) {
         type = (pjsip_transport_type_e)((int) type | PJSIP_TRANSPORT_IPV6);
      }
   }

   ast_debug(2, "Transport type for target '%s' is '%s'\n", host, pjsip_transport_get_type_desc(type));

   /* If it's already an address call the callback immediately */
   if (ip_addr_ver) {
      pjsip_server_addresses addresses = {
         .entry[0].type = type,
         .count = 1,
      };

      if (ip_addr_ver == 4) {
         addresses.entry[0].addr_len = sizeof(pj_sockaddr_in);
         pj_sockaddr_init(pj_AF_INET(), &addresses.entry[0].addr, NULL, 0);
         pj_inet_aton(&target->addr.host, &addresses.entry[0].addr.ipv4.sin_addr);
      } else {
         addresses.entry[0].addr_len = sizeof(pj_sockaddr_in6);
         pj_sockaddr_init(pj_AF_INET6(), &addresses.entry[0].addr, NULL, 0);
         pj_inet_pton(pj_AF_INET6(), &target->addr.host, &addresses.entry[0].addr.ipv6.sin6_addr);
      }

      pj_sockaddr_set_port(&addresses.entry[0].addr, !target->addr.port ? pjsip_transport_get_default_port_for_type(type) : target->addr.port);

      ast_debug(2, "Target '%s' is an IP address, skipping resolution\n", host);

      cb(PJ_SUCCESS, token, &addresses);

      return;
   }

   resolve = ao2_alloc_options(sizeof(*resolve), sip_resolve_destroy, AO2_ALLOC_OPT_LOCK_NOLOCK);
   if (!resolve) {
      cb(PJ_ENOMEM, token, NULL);
      return;
   }

   resolve->callback = cb;
   resolve->token = token;

   if (AST_VECTOR_INIT(&resolve->resolving, 4)) {
      ao2_ref(resolve, -1);
      cb(PJ_ENOMEM, token, NULL);
      return;
   }

   ast_debug(2, "[%p] Created resolution tracking for target '%s'\n", resolve, host);

   /* If no port has been specified we can do NAPTR + SRV */
   if (!target->addr.port) {
      char srv[NI_MAXHOST];

      /* When resolving addresses PJSIP can request an explicit transport type. It will explicitly
       * request an IPv6 transport if a message has been tagged to use an explicitly IPv6 transport.
       * For other cases it can be left unspecified OR an explicit non-IPv6 transport can be requested.
       * In the case where a non-IPv6 transport is requested there is no way to differentiate between
       * a transport being requested as part of a SIP URI (sip:test.com;transport=tcp) and a message
       * being tagged with a specific IPv4 transport. In this case we look for both IPv4 and IPv6 addresses.
       * If a message has been tagged with a specific IPv4 transport the IPv6 addresses will simply
       * be discarded. The code below and elsewhere handles the case where we know they requested IPv6
       * explicitly and only looks for IPv6 records.
       */

      res |= sip_resolve_add(resolve, host, T_NAPTR, C_IN, type, 0);

      if (type == PJSIP_TRANSPORT_UNSPECIFIED ||
         (type == PJSIP_TRANSPORT_TLS && sip_transport_is_available(PJSIP_TRANSPORT_TLS)) ||
         (type == PJSIP_TRANSPORT_TLS6 && sip_transport_is_available(PJSIP_TRANSPORT_TLS6))) {
         if (snprintf(srv, sizeof(srv), "_sips._tcp.%s", host) < NI_MAXHOST) {
            res |= sip_resolve_add(resolve, srv, T_SRV, C_IN,
               type == PJSIP_TRANSPORT_UNSPECIFIED ? PJSIP_TRANSPORT_TLS : type, 0);
         }
      }
      if (type == PJSIP_TRANSPORT_UNSPECIFIED ||
         (type == PJSIP_TRANSPORT_TCP && sip_transport_is_available(PJSIP_TRANSPORT_TCP)) ||
         (type == PJSIP_TRANSPORT_TCP6 && sip_transport_is_available(PJSIP_TRANSPORT_TCP6))) {
         if (snprintf(srv, sizeof(srv), "_sip._tcp.%s", host) < NI_MAXHOST) {
            res |= sip_resolve_add(resolve, srv, T_SRV, C_IN,
               type == PJSIP_TRANSPORT_UNSPECIFIED ? PJSIP_TRANSPORT_TCP : type, 0);
         }
      }
      if (type == PJSIP_TRANSPORT_UNSPECIFIED ||
         (type == PJSIP_TRANSPORT_UDP && sip_transport_is_available(PJSIP_TRANSPORT_UDP)) ||
         (type == PJSIP_TRANSPORT_UDP6 && sip_transport_is_available(PJSIP_TRANSPORT_UDP6))) {
         if (snprintf(srv, sizeof(srv), "_sip._udp.%s", host) < NI_MAXHOST) {
            res |= sip_resolve_add(resolve, srv, T_SRV, C_IN,
               type == PJSIP_TRANSPORT_UNSPECIFIED ? PJSIP_TRANSPORT_UDP : type, 0);
         }
      }
   }

   if ((type == PJSIP_TRANSPORT_UNSPECIFIED && sip_transport_is_available(PJSIP_TRANSPORT_UDP6)) ||
      ((type & PJSIP_TRANSPORT_IPV6) && sip_transport_is_available(type))) {
      res |= sip_resolve_add(resolve, host, T_AAAA, C_IN, (type == PJSIP_TRANSPORT_UNSPECIFIED ? PJSIP_TRANSPORT_UDP6 : type), target->addr.port);
   } else if (!(type & PJSIP_TRANSPORT_IPV6) && sip_transport_is_available(type | PJSIP_TRANSPORT_IPV6)) {
      res |= sip_resolve_add(resolve, host, T_AAAA, C_IN, type | PJSIP_TRANSPORT_IPV6, target->addr.port);
   }

   if ((type == PJSIP_TRANSPORT_UNSPECIFIED && sip_transport_is_available(PJSIP_TRANSPORT_UDP)) ||
      (!(type & PJSIP_TRANSPORT_IPV6) && sip_transport_is_available(type))) {
      res |= sip_resolve_add(resolve, host, T_A, C_IN, (type == PJSIP_TRANSPORT_UNSPECIFIED ? PJSIP_TRANSPORT_UDP : type), target->addr.port);
   }

   if (res) {
      ao2_ref(resolve, -1);
      cb(PJ_ENOMEM, token, NULL);
      return;
   }
   if (!resolve->queries) {
      ast_debug(2, "[%p] No resolution queries for target '%s'\n", resolve, host);
      ao2_ref(resolve, -1);
      cb(PJLIB_UTIL_EDNSNOANSWERREC, token, NULL);
      return;
   }

   resolve->serializer = ao2_bump(ast_threadpool_serializer_get_current());

   ast_debug(2, "[%p] Starting initial resolution using parallel queries for target '%s'\n", resolve, host);
   ast_dns_query_set_resolve_async(resolve->queries, sip_resolve_callback, resolve);

   ao2_ref(resolve, -1);
}

/*!
 * \internal
 * \brief Determine if a specific transport is configured on the system
 *
 * \param pool A memory pool to allocate things from
 * \param transport The type of transport to check
 * \param name A friendly name to print in the verbose message
 *
 * \return Nothing
 */
static void sip_check_transport(pj_pool_t *pool, pjsip_transport_type_e transport, const char *name)
{
   pjsip_tpmgr_fla2_param prm;
   enum sip_resolver_transport resolver_transport;

   pjsip_tpmgr_fla2_param_default(&prm);
   prm.tp_type = transport;

   if (transport == PJSIP_TRANSPORT_UDP) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_UDP;
   } else if (transport == PJSIP_TRANSPORT_TCP) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_TCP;
   } else if (transport == PJSIP_TRANSPORT_TLS) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_TLS;
   } else if (transport == PJSIP_TRANSPORT_UDP6) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_UDP6;
   } else if (transport == PJSIP_TRANSPORT_TCP6) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_TCP6;
   } else if (transport == PJSIP_TRANSPORT_TLS6) {
      resolver_transport = SIP_RESOLVER_TRANSPORT_TLS6;
   } else {
      ast_verb(2, "'%s' is an unsupported SIP transport\n", name);
      return;
   }

   if (pjsip_tpmgr_find_local_addr2(pjsip_endpt_get_tpmgr(ast_sip_get_pjsip_endpoint()),
      pool, &prm) == PJ_SUCCESS) {
      ast_verb(2, "'%s' is an available SIP transport\n", name);
      sip_available_transports[resolver_transport] = 1;
   } else {
      ast_verb(2, "'%s' is not an available SIP transport, disabling resolver support for it\n",
         name);
   }
}

/*! \brief External resolver implementation for PJSIP */
static pjsip_ext_resolver ext_resolver = {
   .resolve = sip_resolve,
};

/*!
 * \internal
 * \brief Task to determine available transports and set ourselves an external resolver
 *
 * \retval 0 success
 * \retval -1 failure
 */
static int sip_replace_resolver(void *data)
{
   pj_pool_t *pool;


   pool = pjsip_endpt_create_pool(ast_sip_get_pjsip_endpoint(), "Transport Availability", 256, 256);
   if (!pool) {
      return -1;
   }

   /* Determine what transports are available on the system */
   sip_check_transport(pool, PJSIP_TRANSPORT_UDP, "UDP+IPv4");
   sip_check_transport(pool, PJSIP_TRANSPORT_TCP, "TCP+IPv4");
   sip_check_transport(pool, PJSIP_TRANSPORT_TLS, "TLS+IPv4");
   sip_check_transport(pool, PJSIP_TRANSPORT_UDP6, "UDP+IPv6");
   sip_check_transport(pool, PJSIP_TRANSPORT_TCP6, "TCP+IPv6");
   sip_check_transport(pool, PJSIP_TRANSPORT_TLS6, "TLS+IPv6");

   pjsip_endpt_release_pool(ast_sip_get_pjsip_endpoint(), pool);

   /* Replace the PJSIP resolver with our own implementation */
   pjsip_endpt_set_ext_resolver(ast_sip_get_pjsip_endpoint(), &ext_resolver);
   return 0;
}

void ast_sip_initialize_resolver(void)
{
   /* Replace the existing PJSIP resolver with our own implementation */
   ast_sip_push_task_wait_servant(NULL, sip_replace_resolver, NULL);
}

#else

void ast_sip_initialize_resolver(void)
{
   /* External resolver support does not exist in the version of PJSIP in use */
   ast_log(LOG_NOTICE, "The version of PJSIP in use does not support external resolvers, using PJSIP provided resolver\n");
}

#endif