2 .\" Copyright (c) 2014 Midori Kato <katoon@sfc.wide.ad.jp>
3 .\" Copyright (c) 2014 The FreeBSD Foundation
4 .\" All rights reserved.
6 .\" Portions of this documentation were written at Keio University, Japan.
8 .\" Redistribution and use in source and binary forms, with or without
9 .\" modification, are permitted provided that the following conditions
11 .\" 1. Redistributions of source code must retain the above copyright
12 .\" notice, this list of conditions and the following disclaimer.
13 .\" 2. Redistributions in binary form must reproduce the above copyright
14 .\" notice, this list of conditions and the following disclaimer in the
15 .\" documentation and/or other materials provided with the distribution.
17 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
21 .\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36 .Nd DCTCP Congestion Control Algorithm
38 The DCTCP (data center TCP) congestion control algorithm aims to maximise
39 throughput and minimise latency in data center networks by utilising the
40 proportion of Explicit Congestion Notification (ECN) marks received from capable
41 hardware as a congestion signal.
43 DCTCP uses fraction of ECN marked packets to update congestion window.
44 The window reduction ratio is always <= 1/2.
45 Only when all of the packets are
46 marked, congestion window is halved.
48 In order to keep the accuracy of the ECN marked fraction, a DCTCP receiver
49 mirrors back incoming (or missing) CE marks by setting (or clearing) ECE marks.
50 This feedback methodology is also adopted when the receiver uses delayed ACK.
54 DCTCP implementation includes two minor modifications for the one-sided
56 Considering the situation that DCTCP is used as sender and classic
57 ECN is used as receiver, DCTCP sets the CWR flag as the reaction to the ECE
59 In addition, when classic ECN is used as sender and DCTCP is used as
60 receiver, DCTCP avoids to mirror back ACKs only when the CWR flag is
61 set in the incoming packet.
63 The other specifications are based on the paper and Internet Draft referenced
68 The algorithm exposes the following tunable variables in the
69 .Va net.inet.tcp.cc.dctcp
73 .Bl -tag -width ".Va alpha"
75 An initial estimator of the congestion on the link.
78 An estimation gain in the alpha calculation.
81 A trigger to halve congestion window after slow start.
82 Default does nothing to halve window.
95 .%A "Mohammad Alizadeh"
96 .%A "Albert Greenberg"
100 .%A "Balaji Prabhakar"
101 .%A "Sudipta Sengupta"
102 .%A "Murari Sridharan"
103 .%T "Data Center TCP (DCTCP)"
104 .%U "http://research.microsoft.com/pubs/121386/dctcp-public.pdf"
105 .%J "ACM SIGCOMM 2010"
110 .%A "Stephen Bensley"
113 .%T "Microsoft's Datacenter TCP (DCTCP): TCP Congestion Control for Datacenters"
114 .%U "http://tools.ietf.org/html/draft-bensley-tcpm-dctcp-01"
119 congestion control module first appeared in
122 The module was first released in 2014 by Midori Kato studying at Keio
128 congestion control module and this manual page were written by
129 .An Midori Kato Mt katoon@sfc.wide.ad.jp
131 .An Lars Eggert Mt lars@netapp.com
132 with help and modifications from
133 .An Hiren Panchasara Mt hiren@FreeBSD.org