ARES_SET_SORTLIST(3)       Library Functions Manual       ARES_SET_SORTLIST(3)

NAME
       ares_set_sortlist - Initialize an ares_channel_t *sortlist
       configuration

SYNOPSIS
       #include <ares.h>

       int ares_set_sortlist(ares_channel_t *channel, const char *sortstr)

DESCRIPTION
       The ares_set_sortlist(3) function initializes an address sortlist
       configuration for the channel data identified by channel, so that
       addresses returned by ares_gethostbyname(3) are sorted according to the
       sortlist.  The provided sortstr string that holds a space separated
       list of IP-address-netmask pairs.  The netmask is optional but follows
       the address after a slash if present.  For example,
       "130.155.160.0/255.255.240.0 130.155.0.0".

       This function replaces any potentially previously configured address
       sortlist with the ones given in the configuration string.


RETURN VALUES
       ares_set_sortlist(3) may return any of the following values:

       ARES_SUCCESS   The sortlist configuration was successfully initialized.

       ARES_ENOMEM    The process's available memory was exhausted.

       ARES_ENODATA   The channel data identified by channel was invalid.

       ARES_ENOTINITIALIZED
                      c-ares library initialization not yet performed.

SEE ALSO
       ares_init_options(3), ares_dup(3)

AVAILABILITY
       ares_set_sortlist(3) was added in c-ares 1.11.0

                               23 November 2015           ARES_SET_SORTLIST(3)