DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

ares_set_local_dev(3)




ARES_SET_LOCAL_DEV(3)  C LIBRARY FUNCTIONS  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 sup-
     ported 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.


SEE ALSO

     ares_set_local_ip4(3) ares_set_local_ip6(3)


NOTES

     This function was added in c-ares 1.7.4


AUTHOR

     Ben Greear

                    Last change: 30 June 2010                   1


Man(1) output converted with man2html