Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 15 Feb 2021 21:56:56 GMT
From:      Richard Scheffenegger <rscheff@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org
Subject:   git: 1e76911d62ed - releng/13.0 - Adding PRR sysctls to tcp(4) man page
Message-ID:  <202102152156.11FLuulB083273@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch releng/13.0 has been updated by rscheff:

URL: https://cgit.FreeBSD.org/src/commit/?id=1e76911d62ed4b66bc21cfc22101ef6b20cd6630

commit 1e76911d62ed4b66bc21cfc22101ef6b20cd6630
Author:     Richard Scheffenegger <rscheff@FreeBSD.org>
AuthorDate: 2021-02-12 11:32:48 +0000
Commit:     Richard Scheffenegger <rscheff@FreeBSD.org>
CommitDate: 2021-02-15 21:56:39 +0000

    Adding PRR sysctls to tcp(4) man page
    
    Documenting the newly added, and enabled by default,
    Proportional Rate Reduction algorithm's governing sysctls.
    
    Reviewed by:    kbowling, rgrimes
    Approved by:    re(gjb)
    MFC after:      3 days
    Sponsored by:   NetApp, Inc.
    Differential Revision:  https://reviews.freebsd.org/D28568
    
    (cherry picked from commit a78fee8182614593992e841fbb0d4a958f70da0f)
---
 share/man/man4/tcp.4 | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/share/man/man4/tcp.4 b/share/man/man4/tcp.4
index dee4040c0a98..431bcd95513b 100644
--- a/share/man/man4/tcp.4
+++ b/share/man/man4/tcp.4
@@ -34,7 +34,7 @@
 .\"     From: @(#)tcp.4	8.1 (Berkeley) 6/5/93
 .\" $FreeBSD$
 .\"
-.Dd January 14, 2021
+.Dd February 11, 2021
 .Dt TCP 4
 .Os
 .Sh NAME
@@ -544,9 +544,22 @@ This gently reduces the congestion window during periods, where TCP is
 application limited and the network bandwidth is not utilized completely.
 That prevents self-inflicted packet losses once the application starts to
 transmit data at a higher speed.
+.It Va do_prr
+Perform SACK loss recovery using the Proportional Rate Reduction (PRR) algorithm
+described in RFC6937.
+This improves the effectiveness of retransmissions particular in environments
+with ACK thinning or burst loss events, as chances to run out of the ACK clock
+are reduced, preventing lengthy and performance reducing RTO based loss recovery
+(default is true).
+.It Va do_prr_conservative
+While doing Proportional Rate Reduction, remain strictly in a packet conserving
+mode, sending only one new packet for each ACK received.
+Helpful when a misconfigured token bucket traffic policer causes persistent
+high losses leading to RTO, but reduces PRR effectiveness in more common settings
+(default is false).
 .It Va rfc6675_pipe
 Calculate the bytes in flight using the algorithm described in RFC 6675, and
-is also a prerequisite to enable Proportional Rate Reduction.
+is also an improvement when Proportional Rate Reduction is enabled.
 .It Va rfc3042
 Enable the Limited Transmit algorithm as described in RFC 3042.
 It helps avoid timeouts on lossy links and also when the congestion window



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202102152156.11FLuulB083273>