Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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_t *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, the interface must not	be al-
       ready bound to the socket or  the  current  effective  user  must  have
       CAP_NET_RAW  capability in the current network namespace	for the	option
       to work.	 If SO_BINDTODEVICE is not supported or	 the  setsockopt  call
       fails (probably because of permissions),	the error is silently ignored.

SEE ALSO
       ares_set_local_ip4(3) ares_set_local_ip6(3) network_namespaces(7)

NOTES
       This function was added in c-ares 1.7.4

			       23 September 2024	 ARES_SET_LOCAL_DEV(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ares_set_local_dev&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help