This patch set is a follow up to the "How to share IPv4 addresses by
partitioning the port space" talk given at LPC 2022 [1].
Please see patch #1 for the motivation & the use case description.
Patch #2 adds tests exercising the new option in various scenarios.
Documentation
-------------
Proposed update to the ip(7) man-page:
IP_LOCAL_PORT_RANGE (since Linux X.Y)
Set or get the per-socket default local port range. This
option can be used to clamp down the global local port
range, defined by the ip_local_port_range /proc interface
described below, for a given socket.
The option takes an uint32_t value with the high 16 bits
set to the upper range bound, and the low 16 bits set to
the lower range bound. Range bounds are inclusive. The
16-bit values should be in host byte order.
The lower bound has to be less than the upper bound when
both bounds are not zero. Otherwise, setting the option
fails with EINVAL.
If either bound is outside of the global local port range,
or is zero, then that bound has no effect.
To reset the setting, pass zero as both the upper and the
lower bound.
Interaction with SELinux bind() hook
------------------------------------
SELinux bind() hook - selinux_socket_bind() - performs a permission check
if the requested local port number lies outside of the netns ephemeral port
range.
The proposed socket option cannot be used change the ephemeral port range
to extend beyond the per-netns port range, as set by
net.ipv4.ip_local_port_range.
Hence, there is no interaction with SELinux, AFAICT.
Changelog:
---------
v3 -> v4:
v3: https://lore.kernel.org/r/20221221-sockopt-port-range-v3-0-36fa5f5996f4@xxxxxxxxxxxxxx
* Highlight that port bounds should be in host byte order. (Neal)
v2 -> v3:
v2: https://lore.kernel.org/r/20221221-sockopt-port-range-v2-0-1d5f114bf627@xxxxxxxxxxxxxx
* Describe interaction considerations with SELinux.
* Code changes called out in individual patches.
v1 -> v2:
v1: https://lore.kernel.org/netdev/20221221-sockopt-port-range-v1-0-e2b094b60ffd@xxxxxxxxxxxxxx/
* Fix the corner case when the per-socket range doesn't overlap with the
per-netns range. Fallback correctly to the per-netns range. (Kuniyuki)
* selftests: Instead of iterating over socket families (ip4, ip6) and types
(tcp, udp), generate tests for each combo from a template. This keeps the
code indentation level down and makes tests more granular.
* Rewrite man-page prose:
- explain how to unset the option,
- document when EINVAL is returned.
RFC -> v1
RFC: https://lore.kernel.org/netdev/20220912225308.93659-1-jakub@xxxxxxxxxxxxxx/
* Allow either the high bound or the low bound, or both, to be zero
* Add getsockopt support
* Add selftests
Links:
------
[1]: https://lpc.events/event/16/contributions/1349/
To: netdev@xxxxxxxxxxxxxxx
Cc: "David S. Miller" <davem@xxxxxxxxxxxxx>
Cc: Eric Dumazet <edumazet@xxxxxxxxxx>
Cc: Jakub Kicinski <kuba@xxxxxxxxxx>
Cc: Paolo Abeni <pabeni@xxxxxxxxxx>
Cc: Kuniyuki Iwashima <kuniyu@xxxxxxxxxx>
Cc: Neal Cardwell <ncardwell@xxxxxxxxxx>
Cc: selinux@xxxxxxxxxxxxxxx
Cc: Paul Moore <paul@xxxxxxxxxxxxxx>
Cc: Stephen Smalley <stephen.smalley.work@xxxxxxxxx>
Cc: Eric Paris <eparis@xxxxxxxxxxxxxx>
Cc: kernel-team@xxxxxxxxxxxxxx
Signed-off-by: Jakub Sitnicki <jakub@xxxxxxxxxxxxxx>
---
Jakub Sitnicki (2):
inet: Add IP_LOCAL_PORT_RANGE socket option
selftests/net: Cover the IP_LOCAL_PORT_RANGE socket option
include/net/inet_sock.h | 4 +
include/net/ip.h | 3 +-
include/uapi/linux/in.h | 1 +
net/ipv4/inet_connection_sock.c | 25 +-
net/ipv4/inet_hashtables.c | 2 +-
net/ipv4/ip_sockglue.c | 18 +
net/ipv4/udp.c | 2 +-
net/sctp/socket.c | 2 +-
tools/testing/selftests/net/Makefile | 2 +
tools/testing/selftests/net/ip_local_port_range.c | 447 +++++++++++++++++++++
tools/testing/selftests/net/ip_local_port_range.sh | 5 +
11 files changed, 505 insertions(+), 6 deletions(-)
