2 * Pluggable TCP congestion control support and newReno
4 * Based on ideas from I/O scheduler support and Web100.
6 * Copyright (C) 2005 Stephen Hemminger <shemminger@osdl.org>
9 #define pr_fmt(fmt) "TCP: " fmt
11 #include <linux/module.h>
13 #include <linux/types.h>
14 #include <linux/list.h>
15 #include <linux/gfp.h>
16 #include <linux/jhash.h>
19 static DEFINE_SPINLOCK(tcp_cong_list_lock
);
20 static LIST_HEAD(tcp_cong_list
);
22 /* Simple linear search, don't expect many entries! */
23 static struct tcp_congestion_ops
*tcp_ca_find(const char *name
)
25 struct tcp_congestion_ops
*e
;
27 list_for_each_entry_rcu(e
, &tcp_cong_list
, list
) {
28 if (strcmp(e
->name
, name
) == 0)
35 /* Must be called with rcu lock held */
36 static const struct tcp_congestion_ops
*__tcp_ca_find_autoload(const char *name
)
38 const struct tcp_congestion_ops
*ca
= tcp_ca_find(name
);
40 if (!ca
&& capable(CAP_NET_ADMIN
)) {
42 request_module("tcp_%s", name
);
44 ca
= tcp_ca_find(name
);
50 /* Simple linear search, not much in here. */
51 struct tcp_congestion_ops
*tcp_ca_find_key(u32 key
)
53 struct tcp_congestion_ops
*e
;
55 list_for_each_entry_rcu(e
, &tcp_cong_list
, list
) {
64 * Attach new congestion control algorithm to the list
65 * of available options.
67 int tcp_register_congestion_control(struct tcp_congestion_ops
*ca
)
71 /* all algorithms must implement ssthresh and cong_avoid ops */
72 if (!ca
->ssthresh
|| !ca
->cong_avoid
) {
73 pr_err("%s does not implement required ops\n", ca
->name
);
77 ca
->key
= jhash(ca
->name
, sizeof(ca
->name
), strlen(ca
->name
));
79 spin_lock(&tcp_cong_list_lock
);
80 if (ca
->key
== TCP_CA_UNSPEC
|| tcp_ca_find_key(ca
->key
)) {
81 pr_notice("%s already registered or non-unique key\n",
85 list_add_tail_rcu(&ca
->list
, &tcp_cong_list
);
86 pr_debug("%s registered\n", ca
->name
);
88 spin_unlock(&tcp_cong_list_lock
);
92 EXPORT_SYMBOL_GPL(tcp_register_congestion_control
);
95 * Remove congestion control algorithm, called from
96 * the module's remove function. Module ref counts are used
97 * to ensure that this can't be done till all sockets using
98 * that method are closed.
100 void tcp_unregister_congestion_control(struct tcp_congestion_ops
*ca
)
102 spin_lock(&tcp_cong_list_lock
);
103 list_del_rcu(&ca
->list
);
104 spin_unlock(&tcp_cong_list_lock
);
106 /* Wait for outstanding readers to complete before the
107 * module gets removed entirely.
109 * A try_module_get() should fail by now as our module is
110 * in "going" state since no refs are held anymore and
111 * module_exit() handler being called.
115 EXPORT_SYMBOL_GPL(tcp_unregister_congestion_control
);
117 u32
tcp_ca_get_key_by_name(const char *name
, bool *ecn_ca
)
119 const struct tcp_congestion_ops
*ca
;
120 u32 key
= TCP_CA_UNSPEC
;
125 ca
= __tcp_ca_find_autoload(name
);
128 *ecn_ca
= ca
->flags
& TCP_CONG_NEEDS_ECN
;
134 EXPORT_SYMBOL_GPL(tcp_ca_get_key_by_name
);
136 char *tcp_ca_get_name_by_key(u32 key
, char *buffer
)
138 const struct tcp_congestion_ops
*ca
;
142 ca
= tcp_ca_find_key(key
);
144 ret
= strncpy(buffer
, ca
->name
,
150 EXPORT_SYMBOL_GPL(tcp_ca_get_name_by_key
);
152 /* Assign choice of congestion control. */
153 void tcp_assign_congestion_control(struct sock
*sk
)
155 struct inet_connection_sock
*icsk
= inet_csk(sk
);
156 struct tcp_congestion_ops
*ca
;
159 list_for_each_entry_rcu(ca
, &tcp_cong_list
, list
) {
160 if (likely(try_module_get(ca
->owner
))) {
161 icsk
->icsk_ca_ops
= ca
;
164 /* Fallback to next available. The last really
165 * guaranteed fallback is Reno from this list.
171 /* Clear out private data before diag gets it and
172 * the ca has not been initialized.
175 memset(icsk
->icsk_ca_priv
, 0, sizeof(icsk
->icsk_ca_priv
));
176 if (ca
->flags
& TCP_CONG_NEEDS_ECN
)
179 INET_ECN_dontxmit(sk
);
182 void tcp_init_congestion_control(struct sock
*sk
)
184 const struct inet_connection_sock
*icsk
= inet_csk(sk
);
186 if (icsk
->icsk_ca_ops
->init
)
187 icsk
->icsk_ca_ops
->init(sk
);
188 if (tcp_ca_needs_ecn(sk
))
191 INET_ECN_dontxmit(sk
);
194 static void tcp_reinit_congestion_control(struct sock
*sk
,
195 const struct tcp_congestion_ops
*ca
)
197 struct inet_connection_sock
*icsk
= inet_csk(sk
);
199 tcp_cleanup_congestion_control(sk
);
200 icsk
->icsk_ca_ops
= ca
;
201 icsk
->icsk_ca_setsockopt
= 1;
203 if (sk
->sk_state
!= TCP_CLOSE
)
204 tcp_init_congestion_control(sk
);
207 /* Manage refcounts on socket close. */
208 void tcp_cleanup_congestion_control(struct sock
*sk
)
210 struct inet_connection_sock
*icsk
= inet_csk(sk
);
212 if (icsk
->icsk_ca_ops
->release
)
213 icsk
->icsk_ca_ops
->release(sk
);
214 module_put(icsk
->icsk_ca_ops
->owner
);
217 /* Used by sysctl to change default congestion control */
218 int tcp_set_default_congestion_control(const char *name
)
220 struct tcp_congestion_ops
*ca
;
223 spin_lock(&tcp_cong_list_lock
);
224 ca
= tcp_ca_find(name
);
225 #ifdef CONFIG_MODULES
226 if (!ca
&& capable(CAP_NET_ADMIN
)) {
227 spin_unlock(&tcp_cong_list_lock
);
229 request_module("tcp_%s", name
);
230 spin_lock(&tcp_cong_list_lock
);
231 ca
= tcp_ca_find(name
);
236 ca
->flags
|= TCP_CONG_NON_RESTRICTED
; /* default is always allowed */
237 list_move(&ca
->list
, &tcp_cong_list
);
240 spin_unlock(&tcp_cong_list_lock
);
245 /* Set default value from kernel configuration at bootup */
246 static int __init
tcp_congestion_default(void)
248 return tcp_set_default_congestion_control(CONFIG_DEFAULT_TCP_CONG
);
250 late_initcall(tcp_congestion_default
);
252 /* Build string with list of available congestion control values */
253 void tcp_get_available_congestion_control(char *buf
, size_t maxlen
)
255 struct tcp_congestion_ops
*ca
;
259 list_for_each_entry_rcu(ca
, &tcp_cong_list
, list
) {
260 offs
+= snprintf(buf
+ offs
, maxlen
- offs
,
262 offs
== 0 ? "" : " ", ca
->name
);
267 /* Get current default congestion control */
268 void tcp_get_default_congestion_control(char *name
)
270 struct tcp_congestion_ops
*ca
;
271 /* We will always have reno... */
272 BUG_ON(list_empty(&tcp_cong_list
));
275 ca
= list_entry(tcp_cong_list
.next
, struct tcp_congestion_ops
, list
);
276 strncpy(name
, ca
->name
, TCP_CA_NAME_MAX
);
280 /* Built list of non-restricted congestion control values */
281 void tcp_get_allowed_congestion_control(char *buf
, size_t maxlen
)
283 struct tcp_congestion_ops
*ca
;
288 list_for_each_entry_rcu(ca
, &tcp_cong_list
, list
) {
289 if (!(ca
->flags
& TCP_CONG_NON_RESTRICTED
))
291 offs
+= snprintf(buf
+ offs
, maxlen
- offs
,
293 offs
== 0 ? "" : " ", ca
->name
);
298 /* Change list of non-restricted congestion control */
299 int tcp_set_allowed_congestion_control(char *val
)
301 struct tcp_congestion_ops
*ca
;
302 char *saved_clone
, *clone
, *name
;
305 saved_clone
= clone
= kstrdup(val
, GFP_USER
);
309 spin_lock(&tcp_cong_list_lock
);
310 /* pass 1 check for bad entries */
311 while ((name
= strsep(&clone
, " ")) && *name
) {
312 ca
= tcp_ca_find(name
);
319 /* pass 2 clear old values */
320 list_for_each_entry_rcu(ca
, &tcp_cong_list
, list
)
321 ca
->flags
&= ~TCP_CONG_NON_RESTRICTED
;
323 /* pass 3 mark as allowed */
324 while ((name
= strsep(&val
, " ")) && *name
) {
325 ca
= tcp_ca_find(name
);
328 ca
->flags
|= TCP_CONG_NON_RESTRICTED
;
331 spin_unlock(&tcp_cong_list_lock
);
337 /* Change congestion control for socket */
338 int tcp_set_congestion_control(struct sock
*sk
, const char *name
)
340 struct inet_connection_sock
*icsk
= inet_csk(sk
);
341 const struct tcp_congestion_ops
*ca
;
344 if (icsk
->icsk_ca_dst_locked
)
348 ca
= __tcp_ca_find_autoload(name
);
349 /* No change asking for existing value */
350 if (ca
== icsk
->icsk_ca_ops
) {
351 icsk
->icsk_ca_setsockopt
= 1;
356 else if (!((ca
->flags
& TCP_CONG_NON_RESTRICTED
) ||
357 ns_capable(sock_net(sk
)->user_ns
, CAP_NET_ADMIN
)))
359 else if (!try_module_get(ca
->owner
))
362 tcp_reinit_congestion_control(sk
, ca
);
368 /* Slow start is used when congestion window is no greater than the slow start
369 * threshold. We base on RFC2581 and also handle stretch ACKs properly.
370 * We do not implement RFC3465 Appropriate Byte Counting (ABC) per se but
371 * something better;) a packet is only considered (s)acked in its entirety to
372 * defend the ACK attacks described in the RFC. Slow start processes a stretch
373 * ACK of degree N as if N acks of degree 1 are received back to back except
374 * ABC caps N to 2. Slow start exits when cwnd grows over ssthresh and
375 * returns the leftover acks to adjust cwnd in congestion avoidance mode.
377 u32
tcp_slow_start(struct tcp_sock
*tp
, u32 acked
)
379 u32 cwnd
= min(tp
->snd_cwnd
+ acked
, tp
->snd_ssthresh
);
381 acked
-= cwnd
- tp
->snd_cwnd
;
382 tp
->snd_cwnd
= min(cwnd
, tp
->snd_cwnd_clamp
);
386 EXPORT_SYMBOL_GPL(tcp_slow_start
);
388 /* In theory this is tp->snd_cwnd += 1 / tp->snd_cwnd (or alternative w),
389 * for every packet that was ACKed.
391 void tcp_cong_avoid_ai(struct tcp_sock
*tp
, u32 w
, u32 acked
)
393 /* If credits accumulated at a higher w, apply them gently now. */
394 if (tp
->snd_cwnd_cnt
>= w
) {
395 tp
->snd_cwnd_cnt
= 0;
399 tp
->snd_cwnd_cnt
+= acked
;
400 if (tp
->snd_cwnd_cnt
>= w
) {
401 u32 delta
= tp
->snd_cwnd_cnt
/ w
;
403 tp
->snd_cwnd_cnt
-= delta
* w
;
404 tp
->snd_cwnd
+= delta
;
406 tp
->snd_cwnd
= min(tp
->snd_cwnd
, tp
->snd_cwnd_clamp
);
408 EXPORT_SYMBOL_GPL(tcp_cong_avoid_ai
);
411 * TCP Reno congestion control
412 * This is special case used for fallback as well.
414 /* This is Jacobson's slow start and congestion avoidance.
415 * SIGCOMM '88, p. 328.
417 void tcp_reno_cong_avoid(struct sock
*sk
, u32 ack
, u32 acked
)
419 struct tcp_sock
*tp
= tcp_sk(sk
);
421 if (!tcp_is_cwnd_limited(sk
))
424 /* In "safe" area, increase. */
425 if (tcp_in_slow_start(tp
)) {
426 acked
= tcp_slow_start(tp
, acked
);
430 /* In dangerous area, increase slowly. */
431 tcp_cong_avoid_ai(tp
, tp
->snd_cwnd
, acked
);
433 EXPORT_SYMBOL_GPL(tcp_reno_cong_avoid
);
435 /* Slow start threshold is half the congestion window (min 2) */
436 u32
tcp_reno_ssthresh(struct sock
*sk
)
438 const struct tcp_sock
*tp
= tcp_sk(sk
);
440 return max(tp
->snd_cwnd
>> 1U, 2U);
442 EXPORT_SYMBOL_GPL(tcp_reno_ssthresh
);
444 struct tcp_congestion_ops tcp_reno
= {
445 .flags
= TCP_CONG_NON_RESTRICTED
,
447 .owner
= THIS_MODULE
,
448 .ssthresh
= tcp_reno_ssthresh
,
449 .cong_avoid
= tcp_reno_cong_avoid
,