1ARES_SET_SERVERS_CSV(3)    Library Functions Manual    ARES_SET_SERVERS_CSV(3)
2
3
4

NAME

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

SYNOPSIS

10       #include <ares.h>
11
12       int ares_set_servers_csv(ares_channel channel, const char* servers)
13       int ares_set_servers_ports_csv(ares_channel channel, const char* servers)
14

DESCRIPTION

16       The ares_set_servers_csv  and  ares_set_servers_ports_csvfunctions  set
17       the  list  of  DNS  servers  that  ARES  will query.  The format of the
18       servers option is:
19
20       host[:port][,host[:port]]...
21
22       For example:
23
24       192.168.1.100,192.168.1.101,3.4.5.6
25
26       The ares_set_servers_csv function will ignore any port values specified
27       in  the  input string, whereare the ares_set_servers_ports_csv function
28       will apply any specified port values as the UDP and TCP port to be used
29       for that particular nameserver.
30
31

RETURN VALUES

33       ares_set_servers_csv(3)  This  function may return any of the following
34       values:
35
36       ARES_SUCCESS   The name servers configuration was successfully initial‐
37                      ized.
38
39       ARES_ENOMEM    The process's available memory was exhausted.
40
41       ARES_ENODATA   The channel data identified by channel was invalid.
42
43       ARES_ENOTINITIALIZED
44                      c-ares library initialization not yet performed.
45

SEE ALSO

47       ares_set_servers(3)
48

AVAILABILITY

50       ares_set_servers_csv      was      added      in      c-ares     1.7.2;
51       ares_set_servers_ports_csv was added in c-ares 1.11.0.
52

AUTHOR

54       Ben Greear
55
56
57
58                                 30 June 2010          ARES_SET_SERVERS_CSV(3)