f5dd3d0c96
This introduces a new generic SOL_SOCKET-level socket option called SO_BINDTOIFINDEX. It behaves similar to SO_BINDTODEVICE, but takes a network interface index as argument, rather than the network interface name. User-space often refers to network-interfaces via their index, but has to temporarily resolve it to a name for a call into SO_BINDTODEVICE. This might pose problems when the network-device is renamed asynchronously by other parts of the system. When this happens, the SO_BINDTODEVICE might either fail, or worse, it might bind to the wrong device. In most cases user-space only ever operates on devices which they either manage themselves, or otherwise have a guarantee that the device name will not change (e.g., devices that are UP cannot be renamed). However, particularly in libraries this guarantee is non-obvious and it would be nice if that race-condition would simply not exist. It would make it easier for those libraries to operate even in situations where the device-name might change under the hood. A real use-case that we recently hit is trying to start the network stack early in the initrd but make it survive into the real system. Existing distributions rename network-interfaces during the transition from initrd into the real system. This, obviously, cannot affect devices that are up and running (unless you also consider moving them between network-namespaces). However, the network manager now has to make sure its management engine for dormant devices will not run in parallel to these renames. Particularly, when you offload operations like DHCP into separate processes, these might setup their sockets early, and thus have to resolve the device-name possibly running into this race-condition. By avoiding a call to resolve the device-name, we no longer depend on the name and can run network setup of dormant devices in parallel to the transition off the initrd. The SO_BINDTOIFINDEX ioctl plugs this race. Reviewed-by: Tom Gundersen <teg@jklm.no> Signed-off-by: David Herrmann <dh.herrmann@gmail.com> Acked-by: Willem de Bruijn <willemb@google.com> Signed-off-by: David S. Miller <davem@davemloft.net>
115 lines
2.5 KiB
C
115 lines
2.5 KiB
C
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
|
#ifndef _ASM_SOCKET_H
|
|
#define _ASM_SOCKET_H
|
|
|
|
#include <asm/sockios.h>
|
|
|
|
/* For setsockopt(2) */
|
|
#define SOL_SOCKET 0xffff
|
|
|
|
#define SO_DEBUG 0x0001
|
|
#define SO_PASSCRED 0x0002
|
|
#define SO_REUSEADDR 0x0004
|
|
#define SO_KEEPALIVE 0x0008
|
|
#define SO_DONTROUTE 0x0010
|
|
#define SO_BROADCAST 0x0020
|
|
#define SO_PEERCRED 0x0040
|
|
#define SO_LINGER 0x0080
|
|
#define SO_OOBINLINE 0x0100
|
|
#define SO_REUSEPORT 0x0200
|
|
#define SO_BSDCOMPAT 0x0400
|
|
#define SO_RCVLOWAT 0x0800
|
|
#define SO_SNDLOWAT 0x1000
|
|
#define SO_RCVTIMEO 0x2000
|
|
#define SO_SNDTIMEO 0x4000
|
|
#define SO_ACCEPTCONN 0x8000
|
|
|
|
#define SO_SNDBUF 0x1001
|
|
#define SO_RCVBUF 0x1002
|
|
#define SO_SNDBUFFORCE 0x100a
|
|
#define SO_RCVBUFFORCE 0x100b
|
|
#define SO_ERROR 0x1007
|
|
#define SO_TYPE 0x1008
|
|
#define SO_PROTOCOL 0x1028
|
|
#define SO_DOMAIN 0x1029
|
|
|
|
|
|
/* Linux specific, keep the same. */
|
|
#define SO_NO_CHECK 0x000b
|
|
#define SO_PRIORITY 0x000c
|
|
|
|
#define SO_BINDTODEVICE 0x000d
|
|
|
|
#define SO_ATTACH_FILTER 0x001a
|
|
#define SO_DETACH_FILTER 0x001b
|
|
#define SO_GET_FILTER SO_ATTACH_FILTER
|
|
|
|
#define SO_PEERNAME 0x001c
|
|
#define SO_TIMESTAMP 0x001d
|
|
#define SCM_TIMESTAMP SO_TIMESTAMP
|
|
|
|
#define SO_PEERSEC 0x001e
|
|
#define SO_PASSSEC 0x001f
|
|
#define SO_TIMESTAMPNS 0x0021
|
|
#define SCM_TIMESTAMPNS SO_TIMESTAMPNS
|
|
|
|
#define SO_MARK 0x0022
|
|
|
|
#define SO_TIMESTAMPING 0x0023
|
|
#define SCM_TIMESTAMPING SO_TIMESTAMPING
|
|
|
|
#define SO_RXQ_OVFL 0x0024
|
|
|
|
#define SO_WIFI_STATUS 0x0025
|
|
#define SCM_WIFI_STATUS SO_WIFI_STATUS
|
|
#define SO_PEEK_OFF 0x0026
|
|
|
|
/* Instruct lower device to use last 4-bytes of skb data as FCS */
|
|
#define SO_NOFCS 0x0027
|
|
|
|
#define SO_LOCK_FILTER 0x0028
|
|
|
|
#define SO_SELECT_ERR_QUEUE 0x0029
|
|
|
|
#define SO_BUSY_POLL 0x0030
|
|
|
|
#define SO_MAX_PACING_RATE 0x0031
|
|
|
|
#define SO_BPF_EXTENSIONS 0x0032
|
|
|
|
#define SO_INCOMING_CPU 0x0033
|
|
|
|
#define SO_ATTACH_BPF 0x0034
|
|
#define SO_DETACH_BPF SO_DETACH_FILTER
|
|
|
|
#define SO_ATTACH_REUSEPORT_CBPF 0x0035
|
|
#define SO_ATTACH_REUSEPORT_EBPF 0x0036
|
|
|
|
#define SO_CNX_ADVICE 0x0037
|
|
|
|
#define SCM_TIMESTAMPING_OPT_STATS 0x0038
|
|
|
|
#define SO_MEMINFO 0x0039
|
|
|
|
#define SO_INCOMING_NAPI_ID 0x003a
|
|
|
|
#define SO_COOKIE 0x003b
|
|
|
|
#define SCM_TIMESTAMPING_PKTINFO 0x003c
|
|
|
|
#define SO_PEERGROUPS 0x003d
|
|
|
|
#define SO_ZEROCOPY 0x003e
|
|
|
|
#define SO_TXTIME 0x003f
|
|
#define SCM_TXTIME SO_TXTIME
|
|
|
|
#define SO_BINDTOIFINDEX 0x0041
|
|
|
|
/* Security levels - as per NRL IPv6 - don't actually do anything */
|
|
#define SO_SECURITY_AUTHENTICATION 0x5001
|
|
#define SO_SECURITY_ENCRYPTION_TRANSPORT 0x5002
|
|
#define SO_SECURITY_ENCRYPTION_NETWORK 0x5004
|
|
|
|
#endif /* _ASM_SOCKET_H */
|