linux/net/sched/sch_codel.c
<<
>>
Prefs
   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");
 311