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
14       int ares_set_servers_ports_csv(ares_channel channel, const char* servers)
15

DESCRIPTION

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

RETURN VALUES

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

SEE ALSO

51       ares_set_servers(3)
52

AVAILABILITY

54       ares_set_servers_csv     was      added      in      c-ares      1.7.2;
55       ares_set_servers_ports_csv was added in c-ares 1.11.0.
56

AUTHOR

58       Ben Greear
59
60
61
62                                 30 June 2010          ARES_SET_SERVERS_CSV(3)
Impressum