Re: [PATCH net-next v3] docs: net: sysctl documentation cleanup
From: Bagas Sanjaya <hidden>
Date: 2025-06-21 09:20:00
Also in:
linux-doc, linux-kernel-mentees, lkml
Subsystem:
documentation, networking [general], the rest · Maintainers:
Jonathan Corbet, "David S. Miller", Eric Dumazet, Jakub Kicinski, Paolo Abeni, Linus Torvalds
On Sat, Jun 21, 2025 at 12:55:42AM +0300, Abdelrahman Fekry wrote:
+ Possible values: + - 0 (disabled) + - 1 (enabled) + + Default: 0 (disabled)
I see boolean lists as normal paragraph instead, so I have to separate them: ---- >8 ----
diff --git a/Documentation/networking/ip-sysctl.rst b/Documentation/networking/ip-sysctl.rst
index edf4b22535e40b..4cc9f0aacf6418 100644
--- a/Documentation/networking/ip-sysctl.rst
+++ b/Documentation/networking/ip-sysctl.rst@@ -15,6 +15,7 @@ ip_forward - BOOLEAN for routers) Possible values: + - 0 (disabled) - 1 (enabled)
@@ -66,6 +67,7 @@ ip_forward_use_pmtu - BOOLEAN case. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -78,6 +80,7 @@ fwmark_reflect - BOOLEAN fwmark of the packet they are replying to. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -90,6 +93,7 @@ fib_multipath_use_neigh - BOOLEAN built with CONFIG_IP_ROUTE_MULTIPATH enabled. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -374,6 +378,7 @@ tcp_autocorking - BOOLEAN when they know how/when to uncork their sockets. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -418,6 +423,7 @@ tcp_dsack - BOOLEAN Allows TCP to send "duplicate" SACKs. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -463,6 +469,7 @@ tcp_ecn_fallback - BOOLEAN control) ECN settings are disabled. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -502,6 +509,7 @@ tcp_fwmark_accept - BOOLEAN unaffected. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -552,6 +560,7 @@ tcp_l3mdev_accept - BOOLEAN compiled with CONFIG_NET_L3_MASTER_DEV. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -625,6 +634,7 @@ tcp_moderate_rcvbuf - BOOLEAN match the size required by the path for full throughput. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -657,6 +667,7 @@ tcp_no_metrics_save - BOOLEAN connections. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -667,6 +678,7 @@ tcp_no_ssthresh_metrics_save - BOOLEAN If enabled, ssthresh metrics are disabled. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -710,6 +722,7 @@ tcp_reflect_tos - BOOLEAN This options affects both IPv4 and IPv6. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -735,6 +748,7 @@ tcp_retrans_collapse - BOOLEAN certain TCP stacks. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -772,6 +786,7 @@ tcp_rfc1337 - BOOLEAN assassination. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -800,6 +815,7 @@ tcp_sack - BOOLEAN Enable select acknowledgments (SACKS). Possible values: + - 0 (disabled) - 1 (enabled)
@@ -832,6 +848,7 @@ tcp_backlog_ack_defer - BOOLEAN long latencies at end of a TCP socket syscall. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -844,6 +861,7 @@ tcp_slow_start_after_idle - BOOLEAN be timed out after an idle period. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -855,6 +873,7 @@ tcp_stdurg - BOOLEAN Linux might not communicate correctly with them. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -916,6 +935,7 @@ tcp_migrate_req - BOOLEAN disable this option. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1101,6 +1121,7 @@ tcp_window_scaling - BOOLEAN Enable window scaling as defined in RFC1323. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1113,12 +1134,13 @@ tcp_shrink_window - BOOLEAN window can be offered, and that TCP implementations MUST ensure that they handle a shrinking window, as specified in RFC 1122. - Possible values - - 0 (disabled) The window is never shrunk. - - 1 (enabled) The window is shrunk when necessary to remain within - the memory limit set by autotuning (sk_rcvbuf). - This only occurs if a non-zero receive window - scaling factor is also in effect. + Possible values: + + - 0 (disabled): The window is never shrunk. + - 1 (enabled): The window is shrunk when necessary to remain within + the memory limit set by autotuning (sk_rcvbuf). + This only occurs if a non-zero receive window + scaling factor is also in effect. Default: 0 (disabled)
@@ -1163,6 +1185,7 @@ tcp_workaround_signed_windows - BOOLEAN not receive a window scaling option from them. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1180,6 +1203,7 @@ tcp_thin_linear_timeouts - BOOLEAN Documentation/networking/tcp-thin.rst Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1257,6 +1281,7 @@ tcp_plb_enabled - BOOLEAN make repathing decisions. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1361,6 +1386,7 @@ udp_l3mdev_accept - BOOLEAN CONFIG_NET_L3_MASTER_DEV. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1425,6 +1451,7 @@ raw_l3mdev_accept - BOOLEAN CONFIG_NET_L3_MASTER_DEV. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1441,6 +1468,7 @@ cipso_cache_enable - BOOLEAN off and the cache will always be "safe". Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1463,6 +1491,7 @@ cipso_rbm_optfmt - BOOLEAN categories in order to make the packet data 32-bit aligned. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1477,6 +1506,7 @@ cipso_rbm_strictvalid - BOOLEAN with other implementations that require strict checking. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1541,6 +1571,7 @@ ip_nonlocal_bind - BOOLEAN which can be quite useful - but may break some applications. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1555,6 +1586,7 @@ ip_autobind_reuse - BOOLEAN option should only be set by experts. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1577,6 +1609,7 @@ ip_early_demux - BOOLEAN reduces overall throughput, in such case you should disable it. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1593,6 +1626,7 @@ tcp_early_demux - BOOLEAN Enable early demux for established TCP sockets. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1603,6 +1637,7 @@ udp_early_demux - BOOLEAN your system could experience more unconnected load. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1613,6 +1648,7 @@ icmp_echo_ignore_all - BOOLEAN requests sent to it. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1623,6 +1659,7 @@ icmp_echo_enable_probe - BOOLEAN requests sent to it. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1633,6 +1670,7 @@ icmp_echo_ignore_broadcasts - BOOLEAN TIMESTAMP requests sent to it via broadcast/multicast. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1697,6 +1735,7 @@ icmp_ignore_bogus_error_responses - BOOLEAN will avoid log file clutter. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -1718,6 +1757,7 @@ icmp_errors_use_inbound_ifaddr - BOOLEAN has one will be used regardless of this setting. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -2096,6 +2136,7 @@ disable_policy - BOOLEAN Disable IPSEC policy (SPD) for this interface Possible values: + - 0 (disabled) - 1 (enabled)
@@ -2105,6 +2146,7 @@ disable_xfrm - BOOLEAN Disable IPSEC encryption on this interface, whatever the policy Possible values: + - 0 (disabled) - 1 (enabled)
@@ -2126,6 +2168,7 @@ ignore_routes_with_linkdown - BOOLEAN Ignore routes whose link is down when performing a FIB lookup. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -2137,6 +2180,7 @@ promote_secondaries - BOOLEAN removing all the corresponding secondary IP addresses. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -2150,6 +2194,7 @@ drop_unicast_in_l2_multicast - BOOLEAN 1122, but is disabled by default for compatibility reasons. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -2161,6 +2206,7 @@ drop_gratuitous_arp - BOOLEAN (or in the case of 802.11, must not be used to prevent attacks.) Possible values: + - 0 (disabled) - 1 (enabled)
@@ -2209,6 +2255,7 @@ bindv6only - BOOLEAN only. Possible values: + - 0 (disabled) - enable IPv4-mapped address feature - 1 (enabled) - disable IPv4-mapped address feature
@@ -2220,6 +2267,7 @@ flowlabel_consistency - BOOLEAN flow label manager. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -2250,6 +2298,7 @@ flowlabel_state_ranges - BOOLEAN is reserved for stateless flow labels as described in RFC6437. Possible values: + - 0 (disabled) - 1 (enabled)
@@ -2323,6 +2372,7 @@ anycast_src_echo_reply - BOOLEAN echo reply Possible values: + - 0 (disabled) - 1 (enabled)
Thanks. -- An old man doll... just what I always wanted! - Clara