CC_CHD(4)

πŸ“¦ version 15.1, in freebsd 14.5, freebsd 15.1, nixpkgs unstable

πŸ¦‹ cc_chd(4) β€” CHD Congestion Control Algorithm πŸ¦‹

okay so bestie, welcome to the cc_chd(4) page from the Kernel Interfaces Manual. This is the CHD congestion control algorithm, and yes it's iconic. πŸ’…

🌸 NAME 🌸

cc_chd β€” CHD Congestion Control Algorithm

✨ DESCRIPTION ✨

CHD is the glow-up of the HD algorithm implemented in cc_hd(4). It gives you tolerance to non-congestion related packet loss and improvements to coexistence with traditional loss-based TCP flows, especially when the bottleneck link is lightly multiplexed. no cap, that's the whole vibe check πŸ¦‹

Like HD, the algorithm aims to keep network queuing delays below a particular threshold (queue_threshold) and decides to reduce the congestion window (cwnd) probabilistically based on its estimate of the network queuing delay.

The way that it differs from HD is three key aspects, periodt πŸ’…

  • The probability of cwnd reduction due to congestion is calculated once per round trip time instead of each time an acknowledgement is received as done by cc_hd(4).
  • Packet losses that occur while the queuing delay is less than queue_threshold do not cause cwnd to be reduced.
  • CHD uses a shadow window to help regain lost transmission opportunities when competing with loss-based TCP flows.

πŸŽ€ MIB Variables πŸŽ€

The algorithm exposes the following tunable variables in the net.inet.tcp.cc.chd branch of the sysctl(3) MIB:

  • queue_threshold β€” queueing congestion threshold (qth) in ticks. Default is 20.
  • pmax β€” per RTT maximum backoff probability as a percentage. Default is 50.
  • qmin β€” minimum queuing delay threshold (qmin) in ticks. Default is 5.
  • loss_fair β€” if 1, cwnd is adjusted using the shadow window when a congestion related loss is detected. Default is 1.
  • use_max β€” if 1, the maximum RTT seen within the measurement period is used as the basic delay measurement for the algorithm, otherwise a sampled RTT measurement is used. Default is 1.

πŸ’« SEE ALSO πŸ’«

cc_cdg(4), cc_cubic(4), cc_dctcp(4), cc_hd(4), cc_htcp(4), cc_newreno(4), cc_vegas(4), h_ertt(4), mod_cc(4), tcp(4), khelp(9), mod_cc(9)

D. A. Hayes and G. Armitage, β€œImproved coexistence and loss tolerance for delay based TCP congestion control”, in 35th Annual IEEE Conference on Local Computer Networks, 24-31, October 2010.

🫢 ACKNOWLEDGEMENTS 🫢

Development and testing of this software were made possible in part by grants from the FreeBSD Foundation and Cisco University Research Program Fund at Community Foundation Silicon Valley.

πŸ“œ HISTORY πŸ“œ

The cc_chd congestion control module first appeared in FreeBSD 9.0.

The module was first released in 2010 by David Hayes whilst working on the NewTCP research project at Swinburne University of Technology's Centre for Advanced Internet Architectures, Melbourne, Australia. More details are available at:

http://caia.swin.edu.au/urp/newtcp/

πŸ‘‘ AUTHORS πŸ‘‘

The cc_chd congestion control module and this manual page were written by David Hayes <david.hayes@ieee.org>.

mwah πŸ’‹ this page is from Debian, dated May 13, 2021, and it's the CC_CHD(4) manual page. byeee 🫢✨

πŸ“¦ where this page comes from