From 8447bb44ef7c452cbc94c04fc38d4946a3ef9165 Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Tue, 28 Apr 2020 00:01:29 +0200 Subject: docs: networking: convert dctcp.txt to ReST - add SPDX header; - adjust title markup; - mark code blocks and literals as such; - adjust identation, whitespaces and blank lines; - add to networking/index.rst. Signed-off-by: Mauro Carvalho Chehab Signed-off-by: David S. Miller --- Documentation/networking/dctcp.rst | 52 ++++++++++++++++++++++++++++++++++++++ Documentation/networking/dctcp.txt | 44 -------------------------------- Documentation/networking/index.rst | 1 + 3 files changed, 53 insertions(+), 44 deletions(-) create mode 100644 Documentation/networking/dctcp.rst delete mode 100644 Documentation/networking/dctcp.txt diff --git a/Documentation/networking/dctcp.rst b/Documentation/networking/dctcp.rst new file mode 100644 index 000000000000..4cc8bb2dad50 --- /dev/null +++ b/Documentation/networking/dctcp.rst @@ -0,0 +1,52 @@ +.. SPDX-License-Identifier: GPL-2.0 + +====================== +DCTCP (DataCenter TCP) +====================== + +DCTCP is an enhancement to the TCP congestion control algorithm for data +center networks and leverages Explicit Congestion Notification (ECN) in +the data center network to provide multi-bit feedback to the end hosts. + +To enable it on end hosts:: + + sysctl -w net.ipv4.tcp_congestion_control=dctcp + sysctl -w net.ipv4.tcp_ecn_fallback=0 (optional) + +All switches in the data center network running DCTCP must support ECN +marking and be configured for marking when reaching defined switch buffer +thresholds. The default ECN marking threshold heuristic for DCTCP on +switches is 20 packets (30KB) at 1Gbps, and 65 packets (~100KB) at 10Gbps, +but might need further careful tweaking. + +For more details, see below documents: + +Paper: + +The algorithm is further described in detail in the following two +SIGCOMM/SIGMETRICS papers: + + i) Mohammad Alizadeh, Albert Greenberg, David A. Maltz, Jitendra Padhye, + Parveen Patel, Balaji Prabhakar, Sudipta Sengupta, and Murari Sridharan: + + "Data Center TCP (DCTCP)", Data Center Networks session" + + Proc. ACM SIGCOMM, New Delhi, 2010. + + http://simula.stanford.edu/~alizade/Site/DCTCP_files/dctcp-final.pdf + http://www.sigcomm.org/ccr/papers/2010/October/1851275.1851192 + +ii) Mohammad Alizadeh, Adel Javanmard, and Balaji Prabhakar: + + "Analysis of DCTCP: Stability, Convergence, and Fairness" + Proc. ACM SIGMETRICS, San Jose, 2011. + + http://simula.stanford.edu/~alizade/Site/DCTCP_files/dctcp_analysis-full.pdf + +IETF informational draft: + + http://tools.ietf.org/html/draft-bensley-tcpm-dctcp-00 + +DCTCP site: + + http://simula.stanford.edu/~alizade/Site/DCTCP.html diff --git a/Documentation/networking/dctcp.txt b/Documentation/networking/dctcp.txt deleted file mode 100644 index 13a857753208..000000000000 --- a/Documentation/networking/dctcp.txt +++ /dev/null @@ -1,44 +0,0 @@ -DCTCP (DataCenter TCP) ----------------------- - -DCTCP is an enhancement to the TCP congestion control algorithm for data -center networks and leverages Explicit Congestion Notification (ECN) in -the data center network to provide multi-bit feedback to the end hosts. - -To enable it on end hosts: - - sysctl -w net.ipv4.tcp_congestion_control=dctcp - sysctl -w net.ipv4.tcp_ecn_fallback=0 (optional) - -All switches in the data center network running DCTCP must support ECN -marking and be configured for marking when reaching defined switch buffer -thresholds. The default ECN marking threshold heuristic for DCTCP on -switches is 20 packets (30KB) at 1Gbps, and 65 packets (~100KB) at 10Gbps, -but might need further careful tweaking. - -For more details, see below documents: - -Paper: - -The algorithm is further described in detail in the following two -SIGCOMM/SIGMETRICS papers: - - i) Mohammad Alizadeh, Albert Greenberg, David A. Maltz, Jitendra Padhye, - Parveen Patel, Balaji Prabhakar, Sudipta Sengupta, and Murari Sridharan: - "Data Center TCP (DCTCP)", Data Center Networks session - Proc. ACM SIGCOMM, New Delhi, 2010. - http://simula.stanford.edu/~alizade/Site/DCTCP_files/dctcp-final.pdf - http://www.sigcomm.org/ccr/papers/2010/October/1851275.1851192 - -ii) Mohammad Alizadeh, Adel Javanmard, and Balaji Prabhakar: - "Analysis of DCTCP: Stability, Convergence, and Fairness" - Proc. ACM SIGMETRICS, San Jose, 2011. - http://simula.stanford.edu/~alizade/Site/DCTCP_files/dctcp_analysis-full.pdf - -IETF informational draft: - - http://tools.ietf.org/html/draft-bensley-tcpm-dctcp-00 - -DCTCP site: - - http://simula.stanford.edu/~alizade/Site/DCTCP.html diff --git a/Documentation/networking/index.rst b/Documentation/networking/index.rst index 3894043332de..9e83d3bda4e0 100644 --- a/Documentation/networking/index.rst +++ b/Documentation/networking/index.rst @@ -49,6 +49,7 @@ Contents: cops cxacru dccp + dctcp .. only:: subproject and html -- cgit v1.2.3