Linux Audio

Check our new training course

Loading...
Note: File does not exist in v3.1.
  1/*
  2 * Codel - The Controlled-Delay Active Queue Management algorithm
  3 *
  4 *  Copyright (C) 2011-2012 Kathleen Nichols <nichols@pollere.com>
  5 *  Copyright (C) 2011-2012 Van Jacobson <van@pollere.net>
  6 *
  7 *  Implemented on linux by :
  8 *  Copyright (C) 2012 Michael D. Taht <dave.taht@bufferbloat.net>
  9 *  Copyright (C) 2012,2015 Eric Dumazet <edumazet@google.com>
 10 *
 11 * Redistribution and use in source and binary forms, with or without
 12 * modification, are permitted provided that the following conditions
 13 * are met:
 14 * 1. Redistributions of source code must retain the above copyright
 15 *    notice, this list of conditions, and the following disclaimer,
 16 *    without modification.
 17 * 2. Redistributions in binary form must reproduce the above copyright
 18 *    notice, this list of conditions and the following disclaimer in the
 19 *    documentation and/or other materials provided with the distribution.
 20 * 3. The names of the authors may not be used to endorse or promote products
 21 *    derived from this software without specific prior written permission.
 22 *
 23 * Alternatively, provided that this notice is retained in full, this
 24 * software may be distributed under the terms of the GNU General
 25 * Public License ("GPL") version 2, in which case the provisions of the
 26 * GPL apply INSTEAD OF those given above.
 27 *
 28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 29 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 30 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 31 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 32 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 33 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 34 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 35 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 36 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 37 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
 39 * DAMAGE.
 40 *
 41 */
 42
 43#include <linux/module.h>
 44#include <linux/slab.h>
 45#include <linux/types.h>
 46#include <linux/kernel.h>
 47#include <linux/errno.h>
 48#include <linux/skbuff.h>
 49#include <linux/prefetch.h>
 50#include <net/pkt_sched.h>
 51#include <net/codel.h>
 52#include <net/codel_impl.h>
 53#include <net/codel_qdisc.h>
 54
 55
 56#define DEFAULT_CODEL_LIMIT 1000
 57
 58struct codel_sched_data {
 59	struct codel_params	params;
 60	struct codel_vars	vars;
 61	struct codel_stats	stats;
 62	u32			drop_overlimit;
 63};
 64
 65/* This is the specific function called from codel_dequeue()
 66 * to dequeue a packet from queue. Note: backlog is handled in
 67 * codel, we dont need to reduce it here.
 68 */
 69static struct sk_buff *dequeue_func(struct codel_vars *vars, void *ctx)
 70{
 71	struct Qdisc *sch = ctx;
 72	struct sk_buff *skb = __qdisc_dequeue_head(&sch->q);
 73
 74	if (skb) {
 75		sch->qstats.backlog -= qdisc_pkt_len(skb);
 76		prefetch(&skb->end); /* we'll need skb_shinfo() */
 77	}
 78	return skb;
 79}
 80
 81static void drop_func(struct sk_buff *skb, void *ctx)
 82{
 83	struct Qdisc *sch = ctx;
 84
 85	kfree_skb(skb);
 86	qdisc_qstats_drop(sch);
 87}
 88
 89static struct sk_buff *codel_qdisc_dequeue(struct Qdisc *sch)
 90{
 91	struct codel_sched_data *q = qdisc_priv(sch);
 92	struct sk_buff *skb;
 93
 94	skb = codel_dequeue(sch, &sch->qstats.backlog, &q->params, &q->vars,
 95			    &q->stats, qdisc_pkt_len, codel_get_enqueue_time,
 96			    drop_func, dequeue_func);
 97
 98	/* We cant call qdisc_tree_reduce_backlog() if our qlen is 0,
 99	 * or HTB crashes. Defer it for next round.
100	 */
101	if (q->stats.drop_count && sch->q.qlen) {
102		qdisc_tree_reduce_backlog(sch, q->stats.drop_count, q->stats.drop_len);
103		q->stats.drop_count = 0;
104		q->stats.drop_len = 0;
105	}
106	if (skb)
107		qdisc_bstats_update(sch, skb);
108	return skb;
109}
110
111static int codel_qdisc_enqueue(struct sk_buff *skb, struct Qdisc *sch,
112			       struct sk_buff **to_free)
113{
114	struct codel_sched_data *q;
115
116	if (likely(qdisc_qlen(sch) < sch->limit)) {
117		codel_set_enqueue_time(skb);
118		return qdisc_enqueue_tail(skb, sch);
119	}
120	q = qdisc_priv(sch);
121	q->drop_overlimit++;
122	return qdisc_drop(skb, sch, to_free);
123}
124
125static const struct nla_policy codel_policy[TCA_CODEL_MAX + 1] = {
126	[TCA_CODEL_TARGET]	= { .type = NLA_U32 },
127	[TCA_CODEL_LIMIT]	= { .type = NLA_U32 },
128	[TCA_CODEL_INTERVAL]	= { .type = NLA_U32 },
129	[TCA_CODEL_ECN]		= { .type = NLA_U32 },
130	[TCA_CODEL_CE_THRESHOLD]= { .type = NLA_U32 },
131};
132
133static int codel_change(struct Qdisc *sch, struct nlattr *opt,
134			struct netlink_ext_ack *extack)
135{
136	struct codel_sched_data *q = qdisc_priv(sch);
137	struct nlattr *tb[TCA_CODEL_MAX + 1];
138	unsigned int qlen, dropped = 0;
139	int err;
140
141	if (!opt)
142		return -EINVAL;
143
144	err = nla_parse_nested_deprecated(tb, TCA_CODEL_MAX, opt,
145					  codel_policy, NULL);
146	if (err < 0)
147		return err;
148
149	sch_tree_lock(sch);
150
151	if (tb[TCA_CODEL_TARGET]) {
152		u32 target = nla_get_u32(tb[TCA_CODEL_TARGET]);
153
154		q->params.target = ((u64)target * NSEC_PER_USEC) >> CODEL_SHIFT;
155	}
156
157	if (tb[TCA_CODEL_CE_THRESHOLD]) {
158		u64 val = nla_get_u32(tb[TCA_CODEL_CE_THRESHOLD]);
159
160		q->params.ce_threshold = (val * NSEC_PER_USEC) >> CODEL_SHIFT;
161	}
162
163	if (tb[TCA_CODEL_INTERVAL]) {
164		u32 interval = nla_get_u32(tb[TCA_CODEL_INTERVAL]);
165
166		q->params.interval = ((u64)interval * NSEC_PER_USEC) >> CODEL_SHIFT;
167	}
168
169	if (tb[TCA_CODEL_LIMIT])
170		sch->limit = nla_get_u32(tb[TCA_CODEL_LIMIT]);
171
172	if (tb[TCA_CODEL_ECN])
173		q->params.ecn = !!nla_get_u32(tb[TCA_CODEL_ECN]);
174
175	qlen = sch->q.qlen;
176	while (sch->q.qlen > sch->limit) {
177		struct sk_buff *skb = __qdisc_dequeue_head(&sch->q);
178
179		dropped += qdisc_pkt_len(skb);
180		qdisc_qstats_backlog_dec(sch, skb);
181		rtnl_qdisc_drop(skb, sch);
182	}
183	qdisc_tree_reduce_backlog(sch, qlen - sch->q.qlen, dropped);
184
185	sch_tree_unlock(sch);
186	return 0;
187}
188
189static int codel_init(struct Qdisc *sch, struct nlattr *opt,
190		      struct netlink_ext_ack *extack)
191{
192	struct codel_sched_data *q = qdisc_priv(sch);
193
194	sch->limit = DEFAULT_CODEL_LIMIT;
195
196	codel_params_init(&q->params);
197	codel_vars_init(&q->vars);
198	codel_stats_init(&q->stats);
199	q->params.mtu = psched_mtu(qdisc_dev(sch));
200
201	if (opt) {
202		int err = codel_change(sch, opt, extack);
203
204		if (err)
205			return err;
206	}
207
208	if (sch->limit >= 1)
209		sch->flags |= TCQ_F_CAN_BYPASS;
210	else
211		sch->flags &= ~TCQ_F_CAN_BYPASS;
212
213	return 0;
214}
215
216static int codel_dump(struct Qdisc *sch, struct sk_buff *skb)
217{
218	struct codel_sched_data *q = qdisc_priv(sch);
219	struct nlattr *opts;
220
221	opts = nla_nest_start_noflag(skb, TCA_OPTIONS);
222	if (opts == NULL)
223		goto nla_put_failure;
224
225	if (nla_put_u32(skb, TCA_CODEL_TARGET,
226			codel_time_to_us(q->params.target)) ||
227	    nla_put_u32(skb, TCA_CODEL_LIMIT,
228			sch->limit) ||
229	    nla_put_u32(skb, TCA_CODEL_INTERVAL,
230			codel_time_to_us(q->params.interval)) ||
231	    nla_put_u32(skb, TCA_CODEL_ECN,
232			q->params.ecn))
233		goto nla_put_failure;
234	if (q->params.ce_threshold != CODEL_DISABLED_THRESHOLD &&
235	    nla_put_u32(skb, TCA_CODEL_CE_THRESHOLD,
236			codel_time_to_us(q->params.ce_threshold)))
237		goto nla_put_failure;
238	return nla_nest_end(skb, opts);
239
240nla_put_failure:
241	nla_nest_cancel(skb, opts);
242	return -1;
243}
244
245static int codel_dump_stats(struct Qdisc *sch, struct gnet_dump *d)
246{
247	const struct codel_sched_data *q = qdisc_priv(sch);
248	struct tc_codel_xstats st = {
249		.maxpacket	= q->stats.maxpacket,
250		.count		= q->vars.count,
251		.lastcount	= q->vars.lastcount,
252		.drop_overlimit = q->drop_overlimit,
253		.ldelay		= codel_time_to_us(q->vars.ldelay),
254		.dropping	= q->vars.dropping,
255		.ecn_mark	= q->stats.ecn_mark,
256		.ce_mark	= q->stats.ce_mark,
257	};
258
259	if (q->vars.dropping) {
260		codel_tdiff_t delta = q->vars.drop_next - codel_get_time();
261
262		if (delta >= 0)
263			st.drop_next = codel_time_to_us(delta);
264		else
265			st.drop_next = -codel_time_to_us(-delta);
266	}
267
268	return gnet_stats_copy_app(d, &st, sizeof(st));
269}
270
271static void codel_reset(struct Qdisc *sch)
272{
273	struct codel_sched_data *q = qdisc_priv(sch);
274
275	qdisc_reset_queue(sch);
276	codel_vars_init(&q->vars);
277}
278
279static struct Qdisc_ops codel_qdisc_ops __read_mostly = {
280	.id		=	"codel",
281	.priv_size	=	sizeof(struct codel_sched_data),
282
283	.enqueue	=	codel_qdisc_enqueue,
284	.dequeue	=	codel_qdisc_dequeue,
285	.peek		=	qdisc_peek_dequeued,
286	.init		=	codel_init,
287	.reset		=	codel_reset,
288	.change 	=	codel_change,
289	.dump		=	codel_dump,
290	.dump_stats	=	codel_dump_stats,
291	.owner		=	THIS_MODULE,
292};
293
294static int __init codel_module_init(void)
295{
296	return register_qdisc(&codel_qdisc_ops);
297}
298
299static void __exit codel_module_exit(void)
300{
301	unregister_qdisc(&codel_qdisc_ops);
302}
303
304module_init(codel_module_init)
305module_exit(codel_module_exit)
306
307MODULE_DESCRIPTION("Controlled Delay queue discipline");
308MODULE_AUTHOR("Dave Taht");
309MODULE_AUTHOR("Eric Dumazet");
310MODULE_LICENSE("Dual BSD/GPL");