Copyright 2010 by Ben Greear <[email protected]>

Permission to use, copy, modify, and distribute this
software and its documentation for any purpose and without
fee is hereby granted, provided that the above copyright
notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting
documentation, and that the name of M.I.T. not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.
M.I.T. makes no representations about the suitability of
this software for any purpose. It is provided "as is"
without express or implied warranty.

ares_set_servers_csv, ares_set_servers_ports_csv - Set list of DNS servers to be used.

#include <ares.h>

int ares_set_servers_csv(ares_channel channel, const char* servers)

int ares_set_servers_ports_csv(ares_channel channel, const char* servers)

The ares_set_servers_csv and ares_set_servers_ports_csvfunctions set the list of DNS servers that ARES will query. The format of the servers option is: host[:port][,host[:port]]... For example: 192.168.1.100,192.168.1.101,3.4.5.6

The ares_set_servers_csv function will ignore any port values specified in the input string, whereare the ares_set_servers_ports_csv function will apply any specified port values as the UDP and TCP port to be used for that particular nameserver.

ares_set_servers_csv(3) This function may return any of the following values:

15 ARES_SUCCESS The name servers configuration was successfully initialized.

15 ARES_ENOMEM The process's available memory was exhausted.

15 ARES_ENODATA The channel data identified by channel was invalid.

15 ARES_ENOTINITIALIZED c-ares library initialization not yet performed.

15 ARES_ENOTIMP Changing name servers configuration while queries are outstanding is not implemented.

ares_set_servers (3) ares_set_servers_csv was added in c-ares 1.7.2; ares_set_servers_ports_csv was added in c-ares 1.11.0. Ben Greear