Skip to content

Commit

Permalink
docs: Update ares_set_local_dev man page
Browse files Browse the repository at this point in the history
Binding to an interface does not require root since
torvalds/linux@c427bfe
  • Loading branch information
crrodriguez committed Sep 24, 2024
1 parent 8b2f5e0 commit 007654b
Showing 1 changed file with 6 additions and 4 deletions.
10 changes: 6 additions & 4 deletions docs/ares_set_local_dev.3
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
.\" Copyright 2010 by Ben Greear <greearb@candelatech.com>
.\" SPDX-License-Identifier: MIT
.\"
.TH ARES_SET_LOCAL_DEV 3 "30 June 2010"
.TH ARES_SET_LOCAL_DEV 3 "23 September 2024"
.SH NAME
ares_set_local_dev \- Bind to a specific network device when creating sockets.
.SH SYNOPSIS
Expand All @@ -15,12 +15,14 @@ void ares_set_local_dev(ares_channel_t *\fIchannel\fP, const char* \fIlocal_dev_
The \fBares_set_local_dev\fP 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
This option is only supported on Linux, the interface must not be already 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.
.SH SEE ALSO
.BR ares_set_local_ip4 (3)
.BR ares_set_local_ip6 (3)
.BR network_namespaces (7)
.SH NOTES
This function was added in c-ares 1.7.4

0 comments on commit 007654b

Please sign in to comment.