From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pg1-f171.google.com (mail-pg1-f171.google.com [209.85.215.171]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7D04E19DF5F for ; Sat, 21 Jun 2025 09:20:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.171 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750497602; cv=none; b=rSJ9nBfCdlNxeGmKd6sETPGpDS9VOys/xZ2ruFQi1e3GNNKy0bfSyckpeRObujdo8k/UKsEEcwdQQnsmHeKp3IM4DyJvCGLiaAayhboWys1vcN65fw71iZphdmt5oOWpMU3GxnA3ypTHdYZkhOY7POa2HAdXfPBBvk2d9rev24E= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750497602; c=relaxed/simple; bh=TlJLR5bE/LSEyfqFwlPxAqc2pFp3L5chhoIGe0UhgNU=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=u8NtcNK0+KOFg83pHM/xiANgqyNNmRmue9C6CgxScoazHJPSAAm6T3qC7XkyXNyRjWLUK0AOd4B92UusPEQN481tJrpT3cPX+BlQ7DWPOVzQsSMPYyrZYjQrUUCBb4o0OWSoPdos1AamLfBcYQEziUPMUekLPibvZ66Ru4Liud4= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=RBvAbJ4R; arc=none smtp.client-ip=209.85.215.171 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="RBvAbJ4R" Received: by mail-pg1-f171.google.com with SMTP id 41be03b00d2f7-af51596da56so2165574a12.0 for ; Sat, 21 Jun 2025 02:20:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750497600; x=1751102400; darn=lists.linux.dev; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=Gb2OFSDE2Drj8JB0tU6F+SK9aQFEFXhP1Y8iZqptNjk=; b=RBvAbJ4RFkMIiOW722ixokX3CenpuieQG/+X+dD5WwEJiiqRPrnCIXDn/xbFeEkMnq YpwNydHDlMYZ0M0ek+MSPXWlJo2qhuuQu666EPigkTVQoUrJJSO/GXd0qI0/GPzfeKja vD1LwWvyryuwEdAN/r7malmxuVgfV8T/uizq0mIMla5VwoJR3K85Kct0tGGqfxDpkePI i0y4MTsOiJoXJlp9j9QeHofRU5PMY9HE/w+NOef8jTOkRCyKcLEPuL755SvBr4yjPcMu dVRXsPAjGfzdWNo42MgHEtnvM8AJmORHnDMXDa7ezN6FGy+UrAgcNZwZ3Kro0W4wyHDN 1Oew== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750497600; x=1751102400; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=Gb2OFSDE2Drj8JB0tU6F+SK9aQFEFXhP1Y8iZqptNjk=; b=B+NxReDatRxR+AgCy0XfQODDAtG98E77CtiSNcjg719yaYHMSoll8/Wj8iG0hIgi05 Sx86MVnUkDKLKgu26pPev+b5jcairbPdM+YiE1o+1OQp4/B3Slk2HqlzS0Hao7nul4Za 4cINvWLTxZy4/Ak5z7os8aD1cKQ9Oada9rYRrAWUv11Lw+f1cVxa5X/fcPNb5jKTYEXn V7uAOUsZtORMKcb3trWJiAwj6awaxt+ylH9aR8HAtkKkuLeQjs7eIMtnU/vswq/8MQvb Zu/7HdAIVquKgseI6iwtpw404p76hGCf5P3xRa53AoE5LdWY3CwCA712VnL1nfYV80Cf PnzQ== X-Forwarded-Encrypted: i=1; AJvYcCXO660v2tzOhAnIcUv6IkWh7vSFxPUoPeiCAFV2gAbPePCeee9xK5cfvektra1SWnkqX0zt5Pm2JUuwGgHFKkSb2YKvhg==@lists.linux.dev X-Gm-Message-State: AOJu0YxUREXsuic3N3WpEAsqbIJJvZ0oazUs/TvvRN3rlLHxVTx5Po5Q w5JlRr2o0D0wVBD0kDse6piLYVhG7oSXGxe+rMoF54c78k1htkXxYEjc X-Gm-Gg: ASbGnctlDK/Q1yWNVhtjRaP7Fs/rOC3+SnmPEQC691TDGsewQOyythvOP5SLx3AGg1t iudUZndUk9d//QtEs4x8FSwhOtSDMr95sTu82yh0aX4EU95amBZQ69rLOpYDwnvDUXWePkcCbdi g/yAWzto7jGwNK2iaZzlfV6UYUkFKe8UwEZnvctevnKId3PRcxUbFQG4eut0KE8575YpfRVeCI3 YBm4cjBgDPJYnnjs4hcbUKDsbyVtOijpvvWK5vmHah03Z4va3EZMb5e13JhgclhryirCGZ29TlN dUwOWNphmeeBi3ay+NIslRDZJIhG6Gyqe+LAT/raLt1sCEWM8UTlBFRASVOEYA== X-Google-Smtp-Source: AGHT+IG7BlAgeNt15LoNBTGF+uLERbEgVKWD0uxp4y5YChdeGXj1JFCxW0uLE3Hzps/4ZmMXA/qHFQ== X-Received: by 2002:a17:90b:1dc7:b0:312:e731:5a6b with SMTP id 98e67ed59e1d1-3159d8fe239mr7708289a91.32.1750497599534; Sat, 21 Jun 2025 02:19:59 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-3158a23e190sm6059930a91.13.2025.06.21.02.19.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 21 Jun 2025 02:19:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id EAA784207D0B; Sat, 21 Jun 2025 16:19:54 +0700 (WIB) Date: Sat, 21 Jun 2025 16:19:54 +0700 From: Bagas Sanjaya To: Abdelrahman Fekry , corbet@lwn.net, davem@davemloft.net, edumazet@google.com, horms@kernel.org, kuba@kernel.org, pabeni@redhat.com Cc: linux-doc@vger.kernel.org, linux-kernel-mentees@lists.linux.dev, linux-kernel@vger.kernel.org, netdev@vger.kernel.org, skhan@linuxfoundation.com, jacob.e.keller@intel.com, alok.a.tiwari@oracle.com Subject: Re: [PATCH net-next v3] docs: net: sysctl documentation cleanup Message-ID: References: <20250620215542.153440-1-abdelrahmanfekry375@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel-mentees@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <20250620215542.153440-1-abdelrahmanfekry375@gmail.com> 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