ares_set_local_dev (3)

Leading comments

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 pe...

(The comments found at the beginning of the groff file "man3/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.

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