summaryrefslogtreecommitdiff
path: root/ares_set_local_ip4.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_local_ip4.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_local_ip4.3')
-rw-r--r--ares_set_local_ip4.334
1 files changed, 34 insertions, 0 deletions
diff --git a/ares_set_local_ip4.3 b/ares_set_local_ip4.3
new file mode 100644
index 0000000..b7955b7
--- /dev/null
+++ b/ares_set_local_ip4.3
@@ -0,0 +1,34 @@
+.\"
+.\" 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_LOCAL_IP4 3 "30 June 2010"
+.SH NAME
+ares_set_local_ip4 \- Set local IPv4 address outgoing requests.
+.SH SYNOPSIS
+.nf
+.B #include <ares.h>
+.PP
+.B void ares_set_local_ip4(ares_channel \fIchannel\fP, uint32_t \fIlocal_ip\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_set_local_ip4\fP function sets the IP address for outbound
+requests. This allows users to specify outbound interfaces when used
+on multi-homed systems.
+.SH SEE ALSO
+.BR ares_set_local_ip6 (3)
+.SH NOTES
+This function was added in c-ares 1.7.2
+.SH AUTHOR
+Ben Greear