Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ARES_SET_SORTLIST(3)	   Library Functions Manual	  ARES_SET_SORTLIST(3)

NAME
       ares_set_sortlist - Initialize an ares_channel sortlist configuration

SYNOPSIS
       #include	<ares.h>

       int ares_set_sortlist(ares_channel channel, const char *sortstr)

DESCRIPTION
       The  ares_set_sortlist(3) function initializes an address sortlist con-
       figuration for the channel data identified  by  channel,	 so  that  ad-
       dresses	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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | AVAILABILITY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ares_set_sortlist&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help