Date: Tue, 15 Aug 2023 15:18:43 -0700
From: Stephen Hemminger <stephen@...workplumber.org>
To: netdev@...r.kernel.org
Cc: Stephen Hemminger <stephen@...workplumber.org>
Subject: [RFC iproute2] man: remove old kernel references from ip route man page

It is less confusing if the ip route man page does not
include references to no longer supported kernels.
Kernels before 4.4 are end of life and we don't need
to keep caveats in documentation for them.

Signed-off-by: Stephen Hemminger <stephen@...workplumber.org>
---
 man/man8/ip-route.8.in | 38 +++++++++++++++++++-------------------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/man/man8/ip-route.8.in b/man/man8/ip-route.8.in
index 7a97d7447c6d..ce448efb0a12 100644
--- a/man/man8/ip-route.8.in
+++ b/man/man8/ip-route.8.in
@@ -334,7 +334,7 @@ to real (or internal) ones before forwarding. The addresses to translate to
 are selected with the attribute
 .BR "via" .
 .B Warning:
-Route NAT is no longer supported in Linux 2.6.
+Route NAT is no longer supported.
 
 .sp
 .B anycast
@@ -511,43 +511,43 @@ seconds and ms, msec or msecs to specify milliseconds.
 
 
 .TP
-.BI rttvar " TIME " "(Linux 2.3.15+ only)"
+.BI rttvar " TIME "
 the initial RTT variance estimate. Values are specified as with
 .BI rtt
 above.
 
 .TP
-.BI rto_min " TIME " "(Linux 2.6.23+ only)"
+.BI rto_min " TIME "
 the minimum TCP Retransmission TimeOut to use when communicating with this
 destination. Values are specified as with
 .BI rtt
 above.
 
 .TP
-.BI ssthresh " NUMBER " "(Linux 2.3.15+ only)"
+.BI ssthresh " NUMBER "
 an estimate for the initial slow start threshold.
 
 .TP
-.BI cwnd " NUMBER " "(Linux 2.3.15+ only)"
+.BI cwnd " NUMBER "
 the clamp for congestion window. It is ignored if the
 .B lock
 flag is not used.
 
 .TP
-.BI initcwnd " NUMBER " "(Linux 2.5.70+ only)"
+.BI initcwnd " NUMBER "
 the initial congestion window size for connections to this destination.
 Actual window size is this value multiplied by the MSS
 (``Maximal Segment Size'') for same connection. The default is
 zero, meaning to use the values specified in RFC2414.
 
 .TP
-.BI initrwnd " NUMBER " "(Linux 2.6.33+ only)"
+.BI initrwnd " NUMBER "
 the initial receive window size for connections to this destination.
 Actual window size is this value multiplied by the MSS of the connection.
 The default value is zero, meaning to use Slow Start value.
 
 .TP
-.BI features " FEATURES " (Linux 3.18+ only)
+.BI features " FEATURES "
 Enable or disable per-route features. Only available feature at this
 time is
 .B ecn
@@ -559,17 +559,17 @@ also be used even if the
 sysctl is set to 0.
 
 .TP
-.BI quickack " BOOL " "(Linux 3.11+ only)"
+.BI quickack " BOOL "
 Enable or disable quick ack for connections to this destination.
 
 .TP
-.BI fastopen_no_cookie " BOOL " "(Linux 4.15+ only)"
+.BI fastopen_no_cookie " BOOL "
 Enable TCP Fastopen without a cookie for connections to this destination.
 
 .TP
-.BI congctl " NAME " "(Linux 3.20+ only)"
+.BI congctl " NAME "
 .TP
-.BI "congctl lock" " NAME " "(Linux 3.20+ only)"
+.BI "congctl lock" " NAME "
 Sets a specific TCP congestion control algorithm only for a given destination.
 If not specified, Linux keeps the current global default TCP congestion control
 algorithm, or the one set from the application. If the modifier
@@ -582,14 +582,14 @@ control algorithm for that destination, thus it will be enforced/guaranteed to
 use the proposed algorithm.
 
 .TP
-.BI advmss " NUMBER " "(Linux 2.3.15+ only)"
+.BI advmss " NUMBER "
 the MSS ('Maximal Segment Size') to advertise to these
 destinations when establishing TCP connections. If it is not given,
 Linux uses a default value calculated from the first hop device MTU.
 (If the path to these destination is asymmetric, this guess may be wrong.)
 
 .TP
-.BI reordering " NUMBER " "(Linux 2.3.15+ only)"
+.BI reordering " NUMBER "
 Maximal reordering on the path to this destination.
 If it is not given, Linux uses the value selected with
 .B sysctl
@@ -852,7 +852,7 @@ Three counters are implemented: 1) packets correctly processed;
 2) bytes correctly processed; 3) packets that cause a processing error
 (i.e., missing SID List, wrong SID List, etc). To retrieve the counters
 related to an action use the \fB-s\fR flag in the \fBshow\fR command.
-The following actions are currently supported (\fBLinux 4.14+ only\fR).
+The following actions are currently supported:
 .in +2
 
 .BR End " [ " flavors
@@ -1060,7 +1060,7 @@ mode.
 .in -8
 
 .TP
-.BI expires " TIME " "(Linux 4.4+ only)"
+.BI expires " TIME "
 the route will be deleted after the expires time.
 .B Only
 support IPv6 at present.
@@ -1346,10 +1346,10 @@ already exist in the table will be ignored.
 .RE
 
 .SH NOTES
-Starting with Linux kernel version 3.6, there is no routing cache for IPv4
-anymore. Hence
+There is no routing cache for IPv4 in current Linux kernels.
+Hence
 .B "ip route show cached"
-will never print any entries on systems with this or newer kernel versions.
+will never print any IPv4 entries.
 
 .SH EXAMPLES
 .PP
-- 
2.39.2

Powered by blists - more mailing lists