ares_set_local_dev - Bind to a specific network device when creating sockets.
#include <ares.h> void ares_set_local_dev(ares_channel channel, const char* local_dev_name)
ARES_SET_LOCAL_DEV(3) Library Functions Manual ARES_SET_LOCAL_DEV(3)
NAME
ares_set_local_dev - Bind to a specific network device when creating
sockets.
SYNOPSIS
#include <ares.h>
void ares_set_local_dev(ares_channel channel, const char* local_dev_name)
DESCRIPTION
The ares_set_local_dev function causes all future sockets to be bound
to this device with SO_BINDTODEVICE. This forces communications to go
over a certain interface, which can be useful on multi-homed machines.
This option is only supported on Linux, and root privileges are
required for the option to work. If SO_BINDTODEVICE is not supported
or the setsocktop call fails (probably because of permissions), the
error is silently ignored.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/libcares |
+---------------+------------------+
|Stability | Volatile |
+---------------+------------------+
SEE ALSO
ares_set_local_ip4(3) ares_set_local_ip6(3)
NOTES
This function was added in c-ares 1.7.4
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://c-ares.haxx.se/download/c-
ares-1.17.2.tar.gz.
Further information about this software can be found on the open source
community website at https://c-ares.haxx.se/.
AUTHOR
Ben Greear
30 June 2010 ARES_SET_LOCAL_DEV(3)