summaryrefslogtreecommitdiff
path: root/ares_set_servers_csv.3
diff options
context:
space:
mode:
authorBen Greear <greearb@candelatech.com>2010-07-18 23:58:39 +0200
committerDaniel Stenberg <daniel@haxx.se>2010-07-18 23:58:39 +0200
commite3b04e5a4796215d2483aba3cb75c72ba337ac14 (patch)
tree3671ebcef566e0e32f00a50b0557b88bd8b67475 /ares_set_servers_csv.3
parent45a09b7efba9665bdc08e227f4baf51fab3862ae (diff)
downloadc-ares-e3b04e5a4796215d2483aba3cb75c72ba337ac14.tar.gz
c-ares-e3b04e5a4796215d2483aba3cb75c72ba337ac14.tar.bz2
c-ares-e3b04e5a4796215d2483aba3cb75c72ba337ac14.zip
local-bind: Support binding to local interface/IPs
Add 3 new functions to set the local binding for the out-going socket connection, and add ares_set_servers_csv() to set a list of servers at once as a comma-separated string. Signed-off-by: Ben Greear <greearb@candelatech.com>
Diffstat (limited to 'ares_set_servers_csv.3')
-rw-r--r--ares_set_servers_csv.343
1 files changed, 43 insertions, 0 deletions
diff --git a/ares_set_servers_csv.3 b/ares_set_servers_csv.3
new file mode 100644
index 0000000..a37c437
--- /dev/null
+++ b/ares_set_servers_csv.3
@@ -0,0 +1,43 @@
+.\"
+.\" Copyright 2010 by Ben Greear <greearb@candelatech.com>
+.\"
+.\" 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.
+.\"
+.TH ARES_SET_SERVERS_CSV 3 "30 June 2010"
+.SH NAME
+ares_set_servers_csv \- Set list of DNS servers to be used.
+.SH SYNOPSIS
+.nf
+.B #include <ares.h>
+.PP
+.B void ares_set_servers_csv(ares_channel \fIchannel\fP, const char* \fIservers\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_set_servers_csv\fP function sets 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
+
+.SH SEE ALSO
+.BR ares_set_servers (3)
+.SH NOTES
+The port option is currently ignored by c-ares internals
+and the standard port is always used.
+
+This function was added in c-ares 1.7.2
+.SH AUTHOR
+Ben Greear