1.\" 2.\" Copyright (c) 2009 Lawrence Stewart <lstewart@FreeBSD.org> 3.\" Copyright (c) 2011 The FreeBSD Foundation 4.\" All rights reserved. 5.\" 6.\" Portions of this documentation were written at the Centre for Advanced 7.\" Internet Architectures, Swinburne University of Technology, Melbourne, 8.\" Australia by Lawrence Stewart under sponsorship from the FreeBSD Foundation. 9.\" 10.\" Redistribution and use in source and binary forms, with or without 11.\" modification, are permitted provided that the following conditions 12.\" are met: 13.\" 1. Redistributions of source code must retain the above copyright 14.\" notice, this list of conditions and the following disclaimer. 15.\" 2. Redistributions in binary form must reproduce the above copyright 16.\" notice, this list of conditions and the following disclaimer in the 17.\" documentation and/or other materials provided with the distribution. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR 23.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" $FreeBSD$ 32.\" 33.Dd March 19, 2018 34.Dt CC_NEWRENO 4 35.Os 36.Sh NAME 37.Nm cc_newreno 38.Nd NewReno Congestion Control Algorithm 39.Sh SYNOPSIS 40.In netinet/cc/cc_newreno.h 41.Sh DESCRIPTION 42The NewReno congestion control algorithm is the default for TCP. 43Details about the algorithm can be found in RFC5681. 44.Sh Socket Options 45The 46.Nm 47module supports a number of socket options under TCP_CCALGOOPT (refer to 48.Xr tcp 4 49and 50.Xr moc_cc 9 for details) 51which can 52be set with 53.Xr setsockopt 2 54and tested with 55.Xr getsockopt 2 . 56The 57.Nm 58socket options use this structure defined in 59<sys/netinet/cc/cc_newreno.h>: 60.Bd -literal 61struct cc_newreno_opts { 62 int name; 63 uint32_t val; 64} 65.Ed 66.Bl -tag -width ".Va CC_NEWRENO_BETA_ECN" 67.It Va CC_NEWRENO_BETA 68Multiplicative window decrease factor, specified as a percentage, applied to 69the congestion window in response to a congestion signal per: cwnd = (cwnd * 70CC_NEWRENO_BETA) / 100. 71Default is 50. 72.It Va CC_NEWRENO_BETA_ECN 73Multiplicative window decrease factor, specified as a percentage, applied to 74the congestion window in response to an ECN congestion signal when 75.Va net.inet.tcp.cc.abe=1 76per: cwnd = (cwnd * CC_NEWRENO_BETA_ECN) / 100. 77Default is 80. 78.Sh MIB Variables 79The algorithm exposes these variables in the 80.Va net.inet.tcp.cc.newreno 81branch of the 82.Xr sysctl 3 83MIB: 84.Bl -tag -width ".Va beta_ecn" 85.It Va beta 86Multiplicative window decrease factor, specified as a percentage, applied to 87the congestion window in response to a congestion signal per: cwnd = (cwnd * 88beta) / 100. 89Default is 50. 90.It Va beta_ecn 91Multiplicative window decrease factor, specified as a percentage, applied to 92the congestion window in response to an ECN congestion signal when 93.Va net.inet.tcp.cc.abe=1 94per: cwnd = (cwnd * beta_ecn) / 100. 95Default is 80. 96.Sh SEE ALSO 97.Xr cc_chd 4 , 98.Xr cc_cubic 4 , 99.Xr cc_hd 4 , 100.Xr cc_htcp 4 , 101.Xr cc_vegas 4 , 102.Xr mod_cc 4 , 103.Xr tcp 4 , 104.Xr mod_cc 9 105.Rs 106.%A "Mark Allman" 107.%A "Vern Paxson" 108.%A "Ethan Blanton" 109.%T "TCP Congestion Control" 110.%O "RFC 5681" 111.Re 112.Rs 113.%A "Naeem Khademi" 114.%A "Michael Welzl" 115.%A "Grenville Armitage" 116.%A "Gorry Fairhurst" 117.%T "TCP Alternative Backoff with ECN (ABE)" 118.%R "internet draft" 119.%D "February 2018" 120.%N "draft-ietf-tcpm-alternativebackoff-ecn" 121.%O "work in progress" 122.Re 123.Sh ACKNOWLEDGEMENTS 124Development and testing of this software were made possible in part by grants 125from the FreeBSD Foundation and Cisco University Research Program Fund at 126Community Foundation Silicon Valley. 127.Sh HISTORY 128The 129.Nm 130congestion control algorithm first appeared in its modular form in 131.Fx 9.0 . 132.Pp 133The module was first released in 2007 by James Healy and Lawrence Stewart whilst 134working on the NewTCP research project at Swinburne University of Technology's 135Centre for Advanced Internet Architectures, Melbourne, Australia, which was made 136possible in part by a grant from the Cisco University Research Program Fund at 137Community Foundation Silicon Valley. 138More details are available at: 139.Pp 140http://caia.swin.edu.au/urp/newtcp/ 141.Sh AUTHORS 142.An -nosplit 143The 144.Nm 145congestion control module was written by 146.An James Healy Aq Mt jimmy@deefa.com , 147.An Lawrence Stewart Aq Mt lstewart@FreeBSD.org 148and 149.An David Hayes Aq Mt david.hayes@ieee.org . 150.Pp 151Support for TCP ABE was added by 152.An Tom Jones Aq Mt tj@enoti.me . 153.Pp 154This manual page was written by 155.An Lawrence Stewart Aq Mt lstewart@FreeBSD.org . 156