1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * net/sched/sch_htb.c Hierarchical token bucket, feed tree version
5 * Authors: Martin Devera, <devik@cdi.cz>
7 * Credits (in time order) for older HTB versions:
8 * Stef Coene <stef.coene@docum.org>
9 * HTB support at LARTC mailing list
10 * Ondrej Kraus, <krauso@barr.cz>
11 * found missing INIT_QDISC(htb)
12 * Vladimir Smelhaus, Aamer Akhter, Bert Hubert
13 * helped a lot to locate nasty class stall bug
14 * Andi Kleen, Jamal Hadi, Bert Hubert
15 * code review and helpful comments on shaping
16 * Tomasz Wrona, <tw@eter.tym.pl>
17 * created test case so that I was able to fix nasty bug
19 * spotted bug in dequeue code and helped with fix
21 * fixed requeue routine
22 * and many others. thanks.
24 #include <linux/module.h>
25 #include <linux/moduleparam.h>
26 #include <linux/types.h>
27 #include <linux/kernel.h>
28 #include <linux/string.h>
29 #include <linux/errno.h>
30 #include <linux/skbuff.h>
31 #include <linux/list.h>
32 #include <linux/compiler.h>
33 #include <linux/rbtree.h>
34 #include <linux/workqueue.h>
35 #include <linux/slab.h>
36 #include <net/netlink.h>
37 #include <net/sch_generic.h>
38 #include <net/pkt_sched.h>
39 #include <net/pkt_cls.h>
43 ========================================================================
44 HTB is like TBF with multiple classes. It is also similar to CBQ because
45 it allows to assign priority to each class in hierarchy.
46 In fact it is another implementation of Floyd's formal sharing.
49 Each class is assigned level. Leaf has ALWAYS level 0 and root
50 classes have level TC_HTB_MAXDEPTH-1. Interior nodes has level
51 one less than their parent.
54 static int htb_hysteresis __read_mostly = 0; /* whether to use mode hysteresis for speedup */
55 #define HTB_VER 0x30011 /* major must be matched with number supplied by TC as version */
57 #if HTB_VER >> 16 != TC_HTB_PROTOVER
58 #error "Mismatched sch_htb.c and pkt_sch.h"
61 /* Module parameter and sysfs export */
62 module_param (htb_hysteresis, int, 0640);
63 MODULE_PARM_DESC(htb_hysteresis, "Hysteresis mode, less CPU load, less accurate");
65 static int htb_rate_est = 0; /* htb classes have a default rate estimator */
66 module_param(htb_rate_est, int, 0640);
67 MODULE_PARM_DESC(htb_rate_est, "setup a default rate estimator (4sec 16sec) for htb classes");
69 /* used internaly to keep status of single class */
71 HTB_CANT_SEND, /* class can't send and can't borrow */
72 HTB_MAY_BORROW, /* class can't send but may borrow */
73 HTB_CAN_SEND /* class can send */
82 /* When class changes from state 1->2 and disconnects from
83 * parent's feed then we lost ptr value and start from the
84 * first child again. Here we store classid of the
85 * last valid ptr (used when ptr is NULL).
90 /* interior & leaf nodes; props specific to leaves are marked L:
91 * To reduce false sharing, place mostly read fields at beginning,
92 * and mostly written ones at the end.
95 struct Qdisc_class_common common;
96 struct psched_ratecfg rate;
97 struct psched_ratecfg ceil;
98 s64 buffer, cbuffer;/* token bucket depth/rate */
99 s64 mbuffer; /* max wait time */
100 u32 prio; /* these two are used only by leaves... */
101 int quantum; /* but stored for parent-to-leaf return */
103 struct tcf_proto __rcu *filter_list; /* class attached filters */
104 struct tcf_block *block;
107 int level; /* our level (see above) */
108 unsigned int children;
109 struct htb_class *parent; /* parent class */
111 struct net_rate_estimator __rcu *rate_est;
114 * Written often fields
116 struct gnet_stats_basic_sync bstats;
117 struct gnet_stats_basic_sync bstats_bias;
118 struct tc_htb_xstats xstats; /* our special stats */
120 /* token bucket parameters */
121 s64 tokens, ctokens;/* current number of tokens */
122 s64 t_c; /* checkpoint time */
125 struct htb_class_leaf {
126 int deficit[TC_HTB_MAXDEPTH];
128 struct netdev_queue *offload_queue;
130 struct htb_class_inner {
131 struct htb_prio clprio[TC_HTB_NUMPRIO];
136 int prio_activity; /* for which prios are we active */
137 enum htb_cmode cmode; /* current mode of the class */
138 struct rb_node pq_node; /* node for event queue */
139 struct rb_node node[TC_HTB_NUMPRIO]; /* node for self or feed tree */
141 unsigned int drops ____cacheline_aligned_in_smp;
142 unsigned int overlimits;
146 struct rb_root wait_pq;
147 struct htb_prio hprio[TC_HTB_NUMPRIO];
151 struct Qdisc_class_hash clhash;
152 int defcls; /* class where unclassified flows go to */
153 int rate2quantum; /* quant = rate / rate2quantum */
155 /* filters for qdisc itself */
156 struct tcf_proto __rcu *filter_list;
157 struct tcf_block *block;
159 #define HTB_WARN_TOOMANYEVENTS 0x1
160 unsigned int warned; /* only one warning */
162 struct work_struct work;
164 /* non shaped skbs; let them go directly thru */
165 struct qdisc_skb_head direct_queue;
169 struct qdisc_watchdog watchdog;
171 s64 now; /* cached dequeue time */
173 /* time of nearest event per level (row) */
174 s64 near_ev_cache[TC_HTB_MAXDEPTH];
176 int row_mask[TC_HTB_MAXDEPTH];
178 struct htb_level hlevel[TC_HTB_MAXDEPTH];
180 struct Qdisc **direct_qdiscs;
181 unsigned int num_direct_qdiscs;
186 /* find class in global hash table using given handle */
187 static inline struct htb_class *htb_find(u32 handle, struct Qdisc *sch)
189 struct htb_sched *q = qdisc_priv(sch);
190 struct Qdisc_class_common *clc;
192 clc = qdisc_class_find(&q->clhash, handle);
195 return container_of(clc, struct htb_class, common);
198 static unsigned long htb_search(struct Qdisc *sch, u32 handle)
200 return (unsigned long)htb_find(handle, sch);
203 * htb_classify - classify a packet into class
205 * It returns NULL if the packet should be dropped or -1 if the packet
206 * should be passed directly thru. In all other cases leaf class is returned.
207 * We allow direct class selection by classid in priority. The we examine
208 * filters in qdisc and in inner nodes (if higher filter points to the inner
209 * node). If we end up with classid MAJOR:0 we enqueue the skb into special
210 * internal fifo (direct). These packets then go directly thru. If we still
211 * have no valid leaf we try to use MAJOR:default leaf. It still unsuccessful
212 * then finish and return direct queue.
214 #define HTB_DIRECT ((struct htb_class *)-1L)
216 static struct htb_class *htb_classify(struct sk_buff *skb, struct Qdisc *sch,
219 struct htb_sched *q = qdisc_priv(sch);
220 struct htb_class *cl;
221 struct tcf_result res;
222 struct tcf_proto *tcf;
225 /* allow to select class by setting skb->priority to valid classid;
226 * note that nfmark can be used too by attaching filter fw with no
229 if (skb->priority == sch->handle)
230 return HTB_DIRECT; /* X:0 (direct flow) selected */
231 cl = htb_find(skb->priority, sch);
235 /* Start with inner filter chain if a non-leaf class is selected */
236 tcf = rcu_dereference_bh(cl->filter_list);
238 tcf = rcu_dereference_bh(q->filter_list);
241 *qerr = NET_XMIT_SUCCESS | __NET_XMIT_BYPASS;
242 while (tcf && (result = tcf_classify(skb, NULL, tcf, &res, false)) >= 0) {
243 #ifdef CONFIG_NET_CLS_ACT
248 *qerr = NET_XMIT_SUCCESS | __NET_XMIT_STOLEN;
254 cl = (void *)res.class;
256 if (res.classid == sch->handle)
257 return HTB_DIRECT; /* X:0 (direct flow) */
258 cl = htb_find(res.classid, sch);
260 break; /* filter selected invalid classid */
263 return cl; /* we hit leaf; return it */
265 /* we have got inner class; apply inner filter chain */
266 tcf = rcu_dereference_bh(cl->filter_list);
268 /* classification failed; try to use default class */
269 cl = htb_find(TC_H_MAKE(TC_H_MAJ(sch->handle), q->defcls), sch);
270 if (!cl || cl->level)
271 return HTB_DIRECT; /* bad default .. this is safe bet */
276 * htb_add_to_id_tree - adds class to the round robin list
277 * @root: the root of the tree
278 * @cl: the class to add
279 * @prio: the give prio in class
281 * Routine adds class to the list (actually tree) sorted by classid.
282 * Make sure that class is not already on such list for given prio.
284 static void htb_add_to_id_tree(struct rb_root *root,
285 struct htb_class *cl, int prio)
287 struct rb_node **p = &root->rb_node, *parent = NULL;
292 c = rb_entry(parent, struct htb_class, node[prio]);
294 if (cl->common.classid > c->common.classid)
295 p = &parent->rb_right;
297 p = &parent->rb_left;
299 rb_link_node(&cl->node[prio], parent, p);
300 rb_insert_color(&cl->node[prio], root);
304 * htb_add_to_wait_tree - adds class to the event queue with delay
305 * @q: the priority event queue
306 * @cl: the class to add
307 * @delay: delay in microseconds
309 * The class is added to priority event queue to indicate that class will
310 * change its mode in cl->pq_key microseconds. Make sure that class is not
311 * already in the queue.
313 static void htb_add_to_wait_tree(struct htb_sched *q,
314 struct htb_class *cl, s64 delay)
316 struct rb_node **p = &q->hlevel[cl->level].wait_pq.rb_node, *parent = NULL;
318 cl->pq_key = q->now + delay;
319 if (cl->pq_key == q->now)
322 /* update the nearest event cache */
323 if (q->near_ev_cache[cl->level] > cl->pq_key)
324 q->near_ev_cache[cl->level] = cl->pq_key;
329 c = rb_entry(parent, struct htb_class, pq_node);
330 if (cl->pq_key >= c->pq_key)
331 p = &parent->rb_right;
333 p = &parent->rb_left;
335 rb_link_node(&cl->pq_node, parent, p);
336 rb_insert_color(&cl->pq_node, &q->hlevel[cl->level].wait_pq);
340 * htb_next_rb_node - finds next node in binary tree
341 * @n: the current node in binary tree
343 * When we are past last key we return NULL.
344 * Average complexity is 2 steps per call.
346 static inline void htb_next_rb_node(struct rb_node **n)
352 * htb_add_class_to_row - add class to its row
353 * @q: the priority event queue
354 * @cl: the class to add
355 * @mask: the given priorities in class in bitmap
357 * The class is added to row at priorities marked in mask.
358 * It does nothing if mask == 0.
360 static inline void htb_add_class_to_row(struct htb_sched *q,
361 struct htb_class *cl, int mask)
363 q->row_mask[cl->level] |= mask;
365 int prio = ffz(~mask);
366 mask &= ~(1 << prio);
367 htb_add_to_id_tree(&q->hlevel[cl->level].hprio[prio].row, cl, prio);
371 /* If this triggers, it is a bug in this code, but it need not be fatal */
372 static void htb_safe_rb_erase(struct rb_node *rb, struct rb_root *root)
374 if (RB_EMPTY_NODE(rb)) {
384 * htb_remove_class_from_row - removes class from its row
385 * @q: the priority event queue
386 * @cl: the class to add
387 * @mask: the given priorities in class in bitmap
389 * The class is removed from row at priorities marked in mask.
390 * It does nothing if mask == 0.
392 static inline void htb_remove_class_from_row(struct htb_sched *q,
393 struct htb_class *cl, int mask)
396 struct htb_level *hlevel = &q->hlevel[cl->level];
399 int prio = ffz(~mask);
400 struct htb_prio *hprio = &hlevel->hprio[prio];
402 mask &= ~(1 << prio);
403 if (hprio->ptr == cl->node + prio)
404 htb_next_rb_node(&hprio->ptr);
406 htb_safe_rb_erase(cl->node + prio, &hprio->row);
407 if (!hprio->row.rb_node)
410 q->row_mask[cl->level] &= ~m;
414 * htb_activate_prios - creates active classe's feed chain
415 * @q: the priority event queue
416 * @cl: the class to activate
418 * The class is connected to ancestors and/or appropriate rows
419 * for priorities it is participating on. cl->cmode must be new
420 * (activated) mode. It does nothing if cl->prio_activity == 0.
422 static void htb_activate_prios(struct htb_sched *q, struct htb_class *cl)
424 struct htb_class *p = cl->parent;
425 long m, mask = cl->prio_activity;
427 while (cl->cmode == HTB_MAY_BORROW && p && mask) {
430 unsigned int prio = ffz(~m);
432 if (WARN_ON_ONCE(prio >= ARRAY_SIZE(p->inner.clprio)))
436 if (p->inner.clprio[prio].feed.rb_node)
437 /* parent already has its feed in use so that
438 * reset bit in mask as parent is already ok
440 mask &= ~(1 << prio);
442 htb_add_to_id_tree(&p->inner.clprio[prio].feed, cl, prio);
444 p->prio_activity |= mask;
449 if (cl->cmode == HTB_CAN_SEND && mask)
450 htb_add_class_to_row(q, cl, mask);
454 * htb_deactivate_prios - remove class from feed chain
455 * @q: the priority event queue
456 * @cl: the class to deactivate
458 * cl->cmode must represent old mode (before deactivation). It does
459 * nothing if cl->prio_activity == 0. Class is removed from all feed
462 static void htb_deactivate_prios(struct htb_sched *q, struct htb_class *cl)
464 struct htb_class *p = cl->parent;
465 long m, mask = cl->prio_activity;
467 while (cl->cmode == HTB_MAY_BORROW && p && mask) {
474 if (p->inner.clprio[prio].ptr == cl->node + prio) {
475 /* we are removing child which is pointed to from
476 * parent feed - forget the pointer but remember
479 p->inner.clprio[prio].last_ptr_id = cl->common.classid;
480 p->inner.clprio[prio].ptr = NULL;
483 htb_safe_rb_erase(cl->node + prio,
484 &p->inner.clprio[prio].feed);
486 if (!p->inner.clprio[prio].feed.rb_node)
490 p->prio_activity &= ~mask;
495 if (cl->cmode == HTB_CAN_SEND && mask)
496 htb_remove_class_from_row(q, cl, mask);
499 static inline s64 htb_lowater(const struct htb_class *cl)
502 return cl->cmode != HTB_CANT_SEND ? -cl->cbuffer : 0;
506 static inline s64 htb_hiwater(const struct htb_class *cl)
509 return cl->cmode == HTB_CAN_SEND ? -cl->buffer : 0;
516 * htb_class_mode - computes and returns current class mode
517 * @cl: the target class
518 * @diff: diff time in microseconds
520 * It computes cl's mode at time cl->t_c+diff and returns it. If mode
521 * is not HTB_CAN_SEND then cl->pq_key is updated to time difference
522 * from now to time when cl will change its state.
523 * Also it is worth to note that class mode doesn't change simply
524 * at cl->{c,}tokens == 0 but there can rather be hysteresis of
525 * 0 .. -cl->{c,}buffer range. It is meant to limit number of
526 * mode transitions per time unit. The speed gain is about 1/6.
528 static inline enum htb_cmode
529 htb_class_mode(struct htb_class *cl, s64 *diff)
533 if ((toks = (cl->ctokens + *diff)) < htb_lowater(cl)) {
535 return HTB_CANT_SEND;
538 if ((toks = (cl->tokens + *diff)) >= htb_hiwater(cl))
542 return HTB_MAY_BORROW;
546 * htb_change_class_mode - changes classe's mode
547 * @q: the priority event queue
548 * @cl: the target class
549 * @diff: diff time in microseconds
551 * This should be the only way how to change classe's mode under normal
552 * circumstances. Routine will update feed lists linkage, change mode
553 * and add class to the wait event queue if appropriate. New mode should
554 * be different from old one and cl->pq_key has to be valid if changing
555 * to mode other than HTB_CAN_SEND (see htb_add_to_wait_tree).
558 htb_change_class_mode(struct htb_sched *q, struct htb_class *cl, s64 *diff)
560 enum htb_cmode new_mode = htb_class_mode(cl, diff);
562 if (new_mode == cl->cmode)
565 if (new_mode == HTB_CANT_SEND) {
570 if (cl->prio_activity) { /* not necessary: speed optimization */
571 if (cl->cmode != HTB_CANT_SEND)
572 htb_deactivate_prios(q, cl);
573 cl->cmode = new_mode;
574 if (new_mode != HTB_CANT_SEND)
575 htb_activate_prios(q, cl);
577 cl->cmode = new_mode;
581 * htb_activate - inserts leaf cl into appropriate active feeds
582 * @q: the priority event queue
583 * @cl: the target class
585 * Routine learns (new) priority of leaf and activates feed chain
586 * for the prio. It can be called on already active leaf safely.
587 * It also adds leaf into droplist.
589 static inline void htb_activate(struct htb_sched *q, struct htb_class *cl)
591 WARN_ON(cl->level || !cl->leaf.q || !cl->leaf.q->q.qlen);
593 if (!cl->prio_activity) {
594 cl->prio_activity = 1 << cl->prio;
595 htb_activate_prios(q, cl);
600 * htb_deactivate - remove leaf cl from active feeds
601 * @q: the priority event queue
602 * @cl: the target class
604 * Make sure that leaf is active. In the other words it can't be called
605 * with non-active leaf. It also removes class from the drop list.
607 static inline void htb_deactivate(struct htb_sched *q, struct htb_class *cl)
609 WARN_ON(!cl->prio_activity);
611 htb_deactivate_prios(q, cl);
612 cl->prio_activity = 0;
615 static int htb_enqueue(struct sk_buff *skb, struct Qdisc *sch,
616 struct sk_buff **to_free)
619 unsigned int len = qdisc_pkt_len(skb);
620 struct htb_sched *q = qdisc_priv(sch);
621 struct htb_class *cl = htb_classify(skb, sch, &ret);
623 if (cl == HTB_DIRECT) {
624 /* enqueue to helper queue */
625 if (q->direct_queue.qlen < q->direct_qlen) {
626 __qdisc_enqueue_tail(skb, &q->direct_queue);
629 return qdisc_drop(skb, sch, to_free);
631 #ifdef CONFIG_NET_CLS_ACT
633 if (ret & __NET_XMIT_BYPASS)
634 qdisc_qstats_drop(sch);
635 __qdisc_drop(skb, to_free);
638 } else if ((ret = qdisc_enqueue(skb, cl->leaf.q,
639 to_free)) != NET_XMIT_SUCCESS) {
640 if (net_xmit_drop_count(ret)) {
641 qdisc_qstats_drop(sch);
649 sch->qstats.backlog += len;
651 return NET_XMIT_SUCCESS;
654 static inline void htb_accnt_tokens(struct htb_class *cl, int bytes, s64 diff)
656 s64 toks = diff + cl->tokens;
658 if (toks > cl->buffer)
660 toks -= (s64) psched_l2t_ns(&cl->rate, bytes);
661 if (toks <= -cl->mbuffer)
662 toks = 1 - cl->mbuffer;
667 static inline void htb_accnt_ctokens(struct htb_class *cl, int bytes, s64 diff)
669 s64 toks = diff + cl->ctokens;
671 if (toks > cl->cbuffer)
673 toks -= (s64) psched_l2t_ns(&cl->ceil, bytes);
674 if (toks <= -cl->mbuffer)
675 toks = 1 - cl->mbuffer;
681 * htb_charge_class - charges amount "bytes" to leaf and ancestors
682 * @q: the priority event queue
683 * @cl: the class to start iterate
684 * @level: the minimum level to account
685 * @skb: the socket buffer
687 * Routine assumes that packet "bytes" long was dequeued from leaf cl
688 * borrowing from "level". It accounts bytes to ceil leaky bucket for
689 * leaf and all ancestors and to rate bucket for ancestors at levels
690 * "level" and higher. It also handles possible change of mode resulting
691 * from the update. Note that mode can also increase here (MAY_BORROW to
692 * CAN_SEND) because we can use more precise clock that event queue here.
693 * In such case we remove class from event queue first.
695 static void htb_charge_class(struct htb_sched *q, struct htb_class *cl,
696 int level, struct sk_buff *skb)
698 int bytes = qdisc_pkt_len(skb);
699 enum htb_cmode old_mode;
703 diff = min_t(s64, q->now - cl->t_c, cl->mbuffer);
704 if (cl->level >= level) {
705 if (cl->level == level)
707 htb_accnt_tokens(cl, bytes, diff);
709 cl->xstats.borrows++;
710 cl->tokens += diff; /* we moved t_c; update tokens */
712 htb_accnt_ctokens(cl, bytes, diff);
715 old_mode = cl->cmode;
717 htb_change_class_mode(q, cl, &diff);
718 if (old_mode != cl->cmode) {
719 if (old_mode != HTB_CAN_SEND)
720 htb_safe_rb_erase(&cl->pq_node, &q->hlevel[cl->level].wait_pq);
721 if (cl->cmode != HTB_CAN_SEND)
722 htb_add_to_wait_tree(q, cl, diff);
725 /* update basic stats except for leaves which are already updated */
727 bstats_update(&cl->bstats, skb);
734 * htb_do_events - make mode changes to classes at the level
735 * @q: the priority event queue
736 * @level: which wait_pq in 'q->hlevel'
737 * @start: start jiffies
739 * Scans event queue for pending events and applies them. Returns time of
740 * next pending event (0 for no event in pq, q->now for too many events).
741 * Note: Applied are events whose have cl->pq_key <= q->now.
743 static s64 htb_do_events(struct htb_sched *q, const int level,
746 /* don't run for longer than 2 jiffies; 2 is used instead of
747 * 1 to simplify things when jiffy is going to be incremented
750 unsigned long stop_at = start + 2;
751 struct rb_root *wait_pq = &q->hlevel[level].wait_pq;
753 while (time_before(jiffies, stop_at)) {
754 struct htb_class *cl;
756 struct rb_node *p = rb_first(wait_pq);
761 cl = rb_entry(p, struct htb_class, pq_node);
762 if (cl->pq_key > q->now)
765 htb_safe_rb_erase(p, wait_pq);
766 diff = min_t(s64, q->now - cl->t_c, cl->mbuffer);
767 htb_change_class_mode(q, cl, &diff);
768 if (cl->cmode != HTB_CAN_SEND)
769 htb_add_to_wait_tree(q, cl, diff);
772 /* too much load - let's continue after a break for scheduling */
773 if (!(q->warned & HTB_WARN_TOOMANYEVENTS)) {
774 pr_warn("htb: too many events!\n");
775 q->warned |= HTB_WARN_TOOMANYEVENTS;
781 /* Returns class->node+prio from id-tree where classe's id is >= id. NULL
782 * is no such one exists.
784 static struct rb_node *htb_id_find_next_upper(int prio, struct rb_node *n,
787 struct rb_node *r = NULL;
789 struct htb_class *cl =
790 rb_entry(n, struct htb_class, node[prio]);
792 if (id > cl->common.classid) {
794 } else if (id < cl->common.classid) {
805 * htb_lookup_leaf - returns next leaf class in DRR order
806 * @hprio: the current one
807 * @prio: which prio in class
809 * Find leaf where current feed pointers points to.
811 static struct htb_class *htb_lookup_leaf(struct htb_prio *hprio, const int prio)
815 struct rb_node *root;
816 struct rb_node **pptr;
818 } stk[TC_HTB_MAXDEPTH], *sp = stk;
820 BUG_ON(!hprio->row.rb_node);
821 sp->root = hprio->row.rb_node;
822 sp->pptr = &hprio->ptr;
823 sp->pid = &hprio->last_ptr_id;
825 for (i = 0; i < 65535; i++) {
826 if (!*sp->pptr && *sp->pid) {
827 /* ptr was invalidated but id is valid - try to recover
828 * the original or next ptr
831 htb_id_find_next_upper(prio, sp->root, *sp->pid);
833 *sp->pid = 0; /* ptr is valid now so that remove this hint as it
834 * can become out of date quickly
836 if (!*sp->pptr) { /* we are at right end; rewind & go up */
837 *sp->pptr = sp->root;
838 while ((*sp->pptr)->rb_left)
839 *sp->pptr = (*sp->pptr)->rb_left;
846 htb_next_rb_node(sp->pptr);
849 struct htb_class *cl;
850 struct htb_prio *clp;
852 cl = rb_entry(*sp->pptr, struct htb_class, node[prio]);
855 clp = &cl->inner.clprio[prio];
856 (++sp)->root = clp->feed.rb_node;
857 sp->pptr = &clp->ptr;
858 sp->pid = &clp->last_ptr_id;
865 /* dequeues packet at given priority and level; call only if
866 * you are sure that there is active class at prio/level
868 static struct sk_buff *htb_dequeue_tree(struct htb_sched *q, const int prio,
871 struct sk_buff *skb = NULL;
872 struct htb_class *cl, *start;
873 struct htb_level *hlevel = &q->hlevel[level];
874 struct htb_prio *hprio = &hlevel->hprio[prio];
876 /* look initial class up in the row */
877 start = cl = htb_lookup_leaf(hprio, prio);
884 /* class can be empty - it is unlikely but can be true if leaf
885 * qdisc drops packets in enqueue routine or if someone used
886 * graft operation on the leaf since last dequeue;
887 * simply deactivate and skip such class
889 if (unlikely(cl->leaf.q->q.qlen == 0)) {
890 struct htb_class *next;
891 htb_deactivate(q, cl);
893 /* row/level might become empty */
894 if ((q->row_mask[level] & (1 << prio)) == 0)
897 next = htb_lookup_leaf(hprio, prio);
899 if (cl == start) /* fix start if we just deleted it */
905 skb = cl->leaf.q->dequeue(cl->leaf.q);
906 if (likely(skb != NULL))
909 qdisc_warn_nonwc("htb", cl->leaf.q);
910 htb_next_rb_node(level ? &cl->parent->inner.clprio[prio].ptr:
911 &q->hlevel[0].hprio[prio].ptr);
912 cl = htb_lookup_leaf(hprio, prio);
914 } while (cl != start);
916 if (likely(skb != NULL)) {
917 bstats_update(&cl->bstats, skb);
918 cl->leaf.deficit[level] -= qdisc_pkt_len(skb);
919 if (cl->leaf.deficit[level] < 0) {
920 cl->leaf.deficit[level] += cl->quantum;
921 htb_next_rb_node(level ? &cl->parent->inner.clprio[prio].ptr :
922 &q->hlevel[0].hprio[prio].ptr);
924 /* this used to be after charge_class but this constelation
925 * gives us slightly better performance
927 if (!cl->leaf.q->q.qlen)
928 htb_deactivate(q, cl);
929 htb_charge_class(q, cl, level, skb);
934 static struct sk_buff *htb_dequeue(struct Qdisc *sch)
937 struct htb_sched *q = qdisc_priv(sch);
940 unsigned long start_at;
942 /* try to dequeue direct packets as high prio (!) to minimize cpu work */
943 skb = __qdisc_dequeue_head(&q->direct_queue);
946 qdisc_bstats_update(sch, skb);
947 qdisc_qstats_backlog_dec(sch, skb);
954 q->now = ktime_get_ns();
957 next_event = q->now + 5LLU * NSEC_PER_SEC;
959 for (level = 0; level < TC_HTB_MAXDEPTH; level++) {
960 /* common case optimization - skip event handler quickly */
962 s64 event = q->near_ev_cache[level];
964 if (q->now >= event) {
965 event = htb_do_events(q, level, start_at);
967 event = q->now + NSEC_PER_SEC;
968 q->near_ev_cache[level] = event;
971 if (next_event > event)
974 m = ~q->row_mask[level];
975 while (m != (int)(-1)) {
979 skb = htb_dequeue_tree(q, prio, level);
980 if (likely(skb != NULL))
984 if (likely(next_event > q->now))
985 qdisc_watchdog_schedule_ns(&q->watchdog, next_event);
987 schedule_work(&q->work);
992 /* reset all classes */
993 /* always caled under BH & queue lock */
994 static void htb_reset(struct Qdisc *sch)
996 struct htb_sched *q = qdisc_priv(sch);
997 struct htb_class *cl;
1000 for (i = 0; i < q->clhash.hashsize; i++) {
1001 hlist_for_each_entry(cl, &q->clhash.hash[i], common.hnode) {
1003 memset(&cl->inner, 0, sizeof(cl->inner));
1005 if (cl->leaf.q && !q->offload)
1006 qdisc_reset(cl->leaf.q);
1008 cl->prio_activity = 0;
1009 cl->cmode = HTB_CAN_SEND;
1012 qdisc_watchdog_cancel(&q->watchdog);
1013 __qdisc_reset_queue(&q->direct_queue);
1014 memset(q->hlevel, 0, sizeof(q->hlevel));
1015 memset(q->row_mask, 0, sizeof(q->row_mask));
1018 static const struct nla_policy htb_policy[TCA_HTB_MAX + 1] = {
1019 [TCA_HTB_PARMS] = { .len = sizeof(struct tc_htb_opt) },
1020 [TCA_HTB_INIT] = { .len = sizeof(struct tc_htb_glob) },
1021 [TCA_HTB_CTAB] = { .type = NLA_BINARY, .len = TC_RTAB_SIZE },
1022 [TCA_HTB_RTAB] = { .type = NLA_BINARY, .len = TC_RTAB_SIZE },
1023 [TCA_HTB_DIRECT_QLEN] = { .type = NLA_U32 },
1024 [TCA_HTB_RATE64] = { .type = NLA_U64 },
1025 [TCA_HTB_CEIL64] = { .type = NLA_U64 },
1026 [TCA_HTB_OFFLOAD] = { .type = NLA_FLAG },
1029 static void htb_work_func(struct work_struct *work)
1031 struct htb_sched *q = container_of(work, struct htb_sched, work);
1032 struct Qdisc *sch = q->watchdog.qdisc;
1035 __netif_schedule(qdisc_root(sch));
1039 static void htb_set_lockdep_class_child(struct Qdisc *q)
1041 static struct lock_class_key child_key;
1043 lockdep_set_class(qdisc_lock(q), &child_key);
1046 static int htb_offload(struct net_device *dev, struct tc_htb_qopt_offload *opt)
1048 return dev->netdev_ops->ndo_setup_tc(dev, TC_SETUP_QDISC_HTB, opt);
1051 static int htb_init(struct Qdisc *sch, struct nlattr *opt,
1052 struct netlink_ext_ack *extack)
1054 struct net_device *dev = qdisc_dev(sch);
1055 struct tc_htb_qopt_offload offload_opt;
1056 struct htb_sched *q = qdisc_priv(sch);
1057 struct nlattr *tb[TCA_HTB_MAX + 1];
1058 struct tc_htb_glob *gopt;
1063 qdisc_watchdog_init(&q->watchdog, sch);
1064 INIT_WORK(&q->work, htb_work_func);
1069 err = tcf_block_get(&q->block, &q->filter_list, sch, extack);
1073 err = nla_parse_nested_deprecated(tb, TCA_HTB_MAX, opt, htb_policy,
1078 if (!tb[TCA_HTB_INIT])
1081 gopt = nla_data(tb[TCA_HTB_INIT]);
1082 if (gopt->version != HTB_VER >> 16)
1085 offload = nla_get_flag(tb[TCA_HTB_OFFLOAD]);
1088 if (sch->parent != TC_H_ROOT) {
1089 NL_SET_ERR_MSG(extack, "HTB must be the root qdisc to use offload");
1093 if (!tc_can_offload(dev) || !dev->netdev_ops->ndo_setup_tc) {
1094 NL_SET_ERR_MSG(extack, "hw-tc-offload ethtool feature flag must be on");
1098 q->num_direct_qdiscs = dev->real_num_tx_queues;
1099 q->direct_qdiscs = kcalloc(q->num_direct_qdiscs,
1100 sizeof(*q->direct_qdiscs),
1102 if (!q->direct_qdiscs)
1106 err = qdisc_class_hash_init(&q->clhash);
1110 if (tb[TCA_HTB_DIRECT_QLEN])
1111 q->direct_qlen = nla_get_u32(tb[TCA_HTB_DIRECT_QLEN]);
1113 q->direct_qlen = qdisc_dev(sch)->tx_queue_len;
1115 if ((q->rate2quantum = gopt->rate2quantum) < 1)
1116 q->rate2quantum = 1;
1117 q->defcls = gopt->defcls;
1122 for (ntx = 0; ntx < q->num_direct_qdiscs; ntx++) {
1123 struct netdev_queue *dev_queue = netdev_get_tx_queue(dev, ntx);
1124 struct Qdisc *qdisc;
1126 qdisc = qdisc_create_dflt(dev_queue, &pfifo_qdisc_ops,
1127 TC_H_MAKE(sch->handle, 0), extack);
1132 htb_set_lockdep_class_child(qdisc);
1133 q->direct_qdiscs[ntx] = qdisc;
1134 qdisc->flags |= TCQ_F_ONETXQUEUE | TCQ_F_NOPARENT;
1137 sch->flags |= TCQ_F_MQROOT;
1139 offload_opt = (struct tc_htb_qopt_offload) {
1140 .command = TC_HTB_CREATE,
1141 .parent_classid = TC_H_MAJ(sch->handle) >> 16,
1142 .classid = TC_H_MIN(q->defcls),
1145 err = htb_offload(dev, &offload_opt);
1149 /* Defer this assignment, so that htb_destroy skips offload-related
1150 * parts (especially calling ndo_setup_tc) on errors.
1157 static void htb_attach_offload(struct Qdisc *sch)
1159 struct net_device *dev = qdisc_dev(sch);
1160 struct htb_sched *q = qdisc_priv(sch);
1163 for (ntx = 0; ntx < q->num_direct_qdiscs; ntx++) {
1164 struct Qdisc *old, *qdisc = q->direct_qdiscs[ntx];
1166 old = dev_graft_qdisc(qdisc->dev_queue, qdisc);
1168 qdisc_hash_add(qdisc, false);
1170 for (ntx = q->num_direct_qdiscs; ntx < dev->num_tx_queues; ntx++) {
1171 struct netdev_queue *dev_queue = netdev_get_tx_queue(dev, ntx);
1172 struct Qdisc *old = dev_graft_qdisc(dev_queue, NULL);
1177 kfree(q->direct_qdiscs);
1178 q->direct_qdiscs = NULL;
1181 static void htb_attach_software(struct Qdisc *sch)
1183 struct net_device *dev = qdisc_dev(sch);
1186 /* Resemble qdisc_graft behavior. */
1187 for (ntx = 0; ntx < dev->num_tx_queues; ntx++) {
1188 struct netdev_queue *dev_queue = netdev_get_tx_queue(dev, ntx);
1189 struct Qdisc *old = dev_graft_qdisc(dev_queue, sch);
1191 qdisc_refcount_inc(sch);
1197 static void htb_attach(struct Qdisc *sch)
1199 struct htb_sched *q = qdisc_priv(sch);
1202 htb_attach_offload(sch);
1204 htb_attach_software(sch);
1207 static int htb_dump(struct Qdisc *sch, struct sk_buff *skb)
1209 struct htb_sched *q = qdisc_priv(sch);
1210 struct nlattr *nest;
1211 struct tc_htb_glob gopt;
1214 sch->flags |= TCQ_F_OFFLOADED;
1216 sch->flags &= ~TCQ_F_OFFLOADED;
1218 sch->qstats.overlimits = q->overlimits;
1219 /* Its safe to not acquire qdisc lock. As we hold RTNL,
1220 * no change can happen on the qdisc parameters.
1223 gopt.direct_pkts = q->direct_pkts;
1224 gopt.version = HTB_VER;
1225 gopt.rate2quantum = q->rate2quantum;
1226 gopt.defcls = q->defcls;
1229 nest = nla_nest_start_noflag(skb, TCA_OPTIONS);
1231 goto nla_put_failure;
1232 if (nla_put(skb, TCA_HTB_INIT, sizeof(gopt), &gopt) ||
1233 nla_put_u32(skb, TCA_HTB_DIRECT_QLEN, q->direct_qlen))
1234 goto nla_put_failure;
1235 if (q->offload && nla_put_flag(skb, TCA_HTB_OFFLOAD))
1236 goto nla_put_failure;
1238 return nla_nest_end(skb, nest);
1241 nla_nest_cancel(skb, nest);
1245 static int htb_dump_class(struct Qdisc *sch, unsigned long arg,
1246 struct sk_buff *skb, struct tcmsg *tcm)
1248 struct htb_class *cl = (struct htb_class *)arg;
1249 struct htb_sched *q = qdisc_priv(sch);
1250 struct nlattr *nest;
1251 struct tc_htb_opt opt;
1253 /* Its safe to not acquire qdisc lock. As we hold RTNL,
1254 * no change can happen on the class parameters.
1256 tcm->tcm_parent = cl->parent ? cl->parent->common.classid : TC_H_ROOT;
1257 tcm->tcm_handle = cl->common.classid;
1258 if (!cl->level && cl->leaf.q)
1259 tcm->tcm_info = cl->leaf.q->handle;
1261 nest = nla_nest_start_noflag(skb, TCA_OPTIONS);
1263 goto nla_put_failure;
1265 memset(&opt, 0, sizeof(opt));
1267 psched_ratecfg_getrate(&opt.rate, &cl->rate);
1268 opt.buffer = PSCHED_NS2TICKS(cl->buffer);
1269 psched_ratecfg_getrate(&opt.ceil, &cl->ceil);
1270 opt.cbuffer = PSCHED_NS2TICKS(cl->cbuffer);
1271 opt.quantum = cl->quantum;
1272 opt.prio = cl->prio;
1273 opt.level = cl->level;
1274 if (nla_put(skb, TCA_HTB_PARMS, sizeof(opt), &opt))
1275 goto nla_put_failure;
1276 if (q->offload && nla_put_flag(skb, TCA_HTB_OFFLOAD))
1277 goto nla_put_failure;
1278 if ((cl->rate.rate_bytes_ps >= (1ULL << 32)) &&
1279 nla_put_u64_64bit(skb, TCA_HTB_RATE64, cl->rate.rate_bytes_ps,
1281 goto nla_put_failure;
1282 if ((cl->ceil.rate_bytes_ps >= (1ULL << 32)) &&
1283 nla_put_u64_64bit(skb, TCA_HTB_CEIL64, cl->ceil.rate_bytes_ps,
1285 goto nla_put_failure;
1287 return nla_nest_end(skb, nest);
1290 nla_nest_cancel(skb, nest);
1294 static void htb_offload_aggregate_stats(struct htb_sched *q,
1295 struct htb_class *cl)
1297 u64 bytes = 0, packets = 0;
1298 struct htb_class *c;
1301 gnet_stats_basic_sync_init(&cl->bstats);
1303 for (i = 0; i < q->clhash.hashsize; i++) {
1304 hlist_for_each_entry(c, &q->clhash.hash[i], common.hnode) {
1305 struct htb_class *p = c;
1307 while (p && p->level < cl->level)
1313 bytes += u64_stats_read(&c->bstats_bias.bytes);
1314 packets += u64_stats_read(&c->bstats_bias.packets);
1315 if (c->level == 0) {
1316 bytes += u64_stats_read(&c->leaf.q->bstats.bytes);
1317 packets += u64_stats_read(&c->leaf.q->bstats.packets);
1321 _bstats_update(&cl->bstats, bytes, packets);
1325 htb_dump_class_stats(struct Qdisc *sch, unsigned long arg, struct gnet_dump *d)
1327 struct htb_class *cl = (struct htb_class *)arg;
1328 struct htb_sched *q = qdisc_priv(sch);
1329 struct gnet_stats_queue qs = {
1331 .overlimits = cl->overlimits,
1335 if (!cl->level && cl->leaf.q)
1336 qdisc_qstats_qlen_backlog(cl->leaf.q, &qlen, &qs.backlog);
1338 cl->xstats.tokens = clamp_t(s64, PSCHED_NS2TICKS(cl->tokens),
1340 cl->xstats.ctokens = clamp_t(s64, PSCHED_NS2TICKS(cl->ctokens),
1346 cl->bstats = cl->leaf.q->bstats;
1348 gnet_stats_basic_sync_init(&cl->bstats);
1349 _bstats_update(&cl->bstats,
1350 u64_stats_read(&cl->bstats_bias.bytes),
1351 u64_stats_read(&cl->bstats_bias.packets));
1353 htb_offload_aggregate_stats(q, cl);
1357 if (gnet_stats_copy_basic(d, NULL, &cl->bstats, true) < 0 ||
1358 gnet_stats_copy_rate_est(d, &cl->rate_est) < 0 ||
1359 gnet_stats_copy_queue(d, NULL, &qs, qlen) < 0)
1362 return gnet_stats_copy_app(d, &cl->xstats, sizeof(cl->xstats));
1365 static struct netdev_queue *
1366 htb_select_queue(struct Qdisc *sch, struct tcmsg *tcm)
1368 struct net_device *dev = qdisc_dev(sch);
1369 struct tc_htb_qopt_offload offload_opt;
1370 struct htb_sched *q = qdisc_priv(sch);
1374 return sch->dev_queue;
1376 offload_opt = (struct tc_htb_qopt_offload) {
1377 .command = TC_HTB_LEAF_QUERY_QUEUE,
1378 .classid = TC_H_MIN(tcm->tcm_parent),
1380 err = htb_offload(dev, &offload_opt);
1381 if (err || offload_opt.qid >= dev->num_tx_queues)
1383 return netdev_get_tx_queue(dev, offload_opt.qid);
1386 static struct Qdisc *
1387 htb_graft_helper(struct netdev_queue *dev_queue, struct Qdisc *new_q)
1389 struct net_device *dev = dev_queue->dev;
1390 struct Qdisc *old_q;
1392 if (dev->flags & IFF_UP)
1393 dev_deactivate(dev);
1394 old_q = dev_graft_qdisc(dev_queue, new_q);
1396 new_q->flags |= TCQ_F_ONETXQUEUE | TCQ_F_NOPARENT;
1397 if (dev->flags & IFF_UP)
1403 static struct netdev_queue *htb_offload_get_queue(struct htb_class *cl)
1405 struct netdev_queue *queue;
1407 queue = cl->leaf.offload_queue;
1408 if (!(cl->leaf.q->flags & TCQ_F_BUILTIN))
1409 WARN_ON(cl->leaf.q->dev_queue != queue);
1414 static void htb_offload_move_qdisc(struct Qdisc *sch, struct htb_class *cl_old,
1415 struct htb_class *cl_new, bool destroying)
1417 struct netdev_queue *queue_old, *queue_new;
1418 struct net_device *dev = qdisc_dev(sch);
1420 queue_old = htb_offload_get_queue(cl_old);
1421 queue_new = htb_offload_get_queue(cl_new);
1424 struct Qdisc *qdisc;
1426 if (dev->flags & IFF_UP)
1427 dev_deactivate(dev);
1428 qdisc = dev_graft_qdisc(queue_old, NULL);
1429 WARN_ON(qdisc != cl_old->leaf.q);
1432 if (!(cl_old->leaf.q->flags & TCQ_F_BUILTIN))
1433 cl_old->leaf.q->dev_queue = queue_new;
1434 cl_old->leaf.offload_queue = queue_new;
1437 struct Qdisc *qdisc;
1439 qdisc = dev_graft_qdisc(queue_new, cl_old->leaf.q);
1440 if (dev->flags & IFF_UP)
1442 WARN_ON(!(qdisc->flags & TCQ_F_BUILTIN));
1446 static int htb_graft(struct Qdisc *sch, unsigned long arg, struct Qdisc *new,
1447 struct Qdisc **old, struct netlink_ext_ack *extack)
1449 struct netdev_queue *dev_queue = sch->dev_queue;
1450 struct htb_class *cl = (struct htb_class *)arg;
1451 struct htb_sched *q = qdisc_priv(sch);
1452 struct Qdisc *old_q;
1458 dev_queue = htb_offload_get_queue(cl);
1461 new = qdisc_create_dflt(dev_queue, &pfifo_qdisc_ops,
1462 cl->common.classid, extack);
1468 htb_set_lockdep_class_child(new);
1469 /* One ref for cl->leaf.q, the other for dev_queue->qdisc. */
1470 qdisc_refcount_inc(new);
1471 old_q = htb_graft_helper(dev_queue, new);
1474 *old = qdisc_replace(sch, new, &cl->leaf.q);
1477 WARN_ON(old_q != *old);
1484 static struct Qdisc *htb_leaf(struct Qdisc *sch, unsigned long arg)
1486 struct htb_class *cl = (struct htb_class *)arg;
1487 return !cl->level ? cl->leaf.q : NULL;
1490 static void htb_qlen_notify(struct Qdisc *sch, unsigned long arg)
1492 struct htb_class *cl = (struct htb_class *)arg;
1494 htb_deactivate(qdisc_priv(sch), cl);
1497 static inline int htb_parent_last_child(struct htb_class *cl)
1500 /* the root class */
1502 if (cl->parent->children > 1)
1503 /* not the last child */
1508 static void htb_parent_to_leaf(struct Qdisc *sch, struct htb_class *cl,
1509 struct Qdisc *new_q)
1511 struct htb_sched *q = qdisc_priv(sch);
1512 struct htb_class *parent = cl->parent;
1514 WARN_ON(cl->level || !cl->leaf.q || cl->prio_activity);
1516 if (parent->cmode != HTB_CAN_SEND)
1517 htb_safe_rb_erase(&parent->pq_node,
1518 &q->hlevel[parent->level].wait_pq);
1521 memset(&parent->inner, 0, sizeof(parent->inner));
1522 parent->leaf.q = new_q ? new_q : &noop_qdisc;
1523 parent->tokens = parent->buffer;
1524 parent->ctokens = parent->cbuffer;
1525 parent->t_c = ktime_get_ns();
1526 parent->cmode = HTB_CAN_SEND;
1528 parent->leaf.offload_queue = cl->leaf.offload_queue;
1531 static void htb_parent_to_leaf_offload(struct Qdisc *sch,
1532 struct netdev_queue *dev_queue,
1533 struct Qdisc *new_q)
1535 struct Qdisc *old_q;
1537 /* One ref for cl->leaf.q, the other for dev_queue->qdisc. */
1539 qdisc_refcount_inc(new_q);
1540 old_q = htb_graft_helper(dev_queue, new_q);
1541 WARN_ON(!(old_q->flags & TCQ_F_BUILTIN));
1544 static int htb_destroy_class_offload(struct Qdisc *sch, struct htb_class *cl,
1545 bool last_child, bool destroying,
1546 struct netlink_ext_ack *extack)
1548 struct tc_htb_qopt_offload offload_opt;
1549 struct netdev_queue *dev_queue;
1550 struct Qdisc *q = cl->leaf.q;
1558 dev_queue = htb_offload_get_queue(cl);
1559 /* When destroying, caller qdisc_graft grafts the new qdisc and invokes
1560 * qdisc_put for the qdisc being destroyed. htb_destroy_class_offload
1561 * does not need to graft or qdisc_put the qdisc being destroyed.
1564 old = htb_graft_helper(dev_queue, NULL);
1565 /* Last qdisc grafted should be the same as cl->leaf.q when
1566 * calling htb_delete.
1572 _bstats_update(&cl->parent->bstats_bias,
1573 u64_stats_read(&q->bstats.bytes),
1574 u64_stats_read(&q->bstats.packets));
1577 offload_opt = (struct tc_htb_qopt_offload) {
1578 .command = !last_child ? TC_HTB_LEAF_DEL :
1579 destroying ? TC_HTB_LEAF_DEL_LAST_FORCE :
1580 TC_HTB_LEAF_DEL_LAST,
1581 .classid = cl->common.classid,
1584 err = htb_offload(qdisc_dev(sch), &offload_opt);
1590 htb_graft_helper(dev_queue, old);
1596 if (!err && offload_opt.classid != TC_H_MIN(cl->common.classid)) {
1597 u32 classid = TC_H_MAJ(sch->handle) |
1598 TC_H_MIN(offload_opt.classid);
1599 struct htb_class *moved_cl = htb_find(classid, sch);
1601 htb_offload_move_qdisc(sch, moved_cl, cl, destroying);
1607 static void htb_destroy_class(struct Qdisc *sch, struct htb_class *cl)
1610 WARN_ON(!cl->leaf.q);
1611 qdisc_put(cl->leaf.q);
1613 gen_kill_estimator(&cl->rate_est);
1614 tcf_block_put(cl->block);
1618 static void htb_destroy(struct Qdisc *sch)
1620 struct net_device *dev = qdisc_dev(sch);
1621 struct tc_htb_qopt_offload offload_opt;
1622 struct htb_sched *q = qdisc_priv(sch);
1623 struct hlist_node *next;
1624 bool nonempty, changed;
1625 struct htb_class *cl;
1628 cancel_work_sync(&q->work);
1629 qdisc_watchdog_cancel(&q->watchdog);
1630 /* This line used to be after htb_destroy_class call below
1631 * and surprisingly it worked in 2.4. But it must precede it
1632 * because filter need its target class alive to be able to call
1633 * unbind_filter on it (without Oops).
1635 tcf_block_put(q->block);
1637 for (i = 0; i < q->clhash.hashsize; i++) {
1638 hlist_for_each_entry(cl, &q->clhash.hash[i], common.hnode) {
1639 tcf_block_put(cl->block);
1647 for (i = 0; i < q->clhash.hashsize; i++) {
1648 hlist_for_each_entry_safe(cl, next, &q->clhash.hash[i],
1653 htb_destroy_class(sch, cl);
1664 last_child = htb_parent_last_child(cl);
1665 htb_destroy_class_offload(sch, cl, last_child,
1667 qdisc_class_hash_remove(&q->clhash,
1670 cl->parent->children--;
1672 htb_parent_to_leaf(sch, cl, NULL);
1673 htb_destroy_class(sch, cl);
1679 qdisc_class_hash_destroy(&q->clhash);
1680 __qdisc_reset_queue(&q->direct_queue);
1683 offload_opt = (struct tc_htb_qopt_offload) {
1684 .command = TC_HTB_DESTROY,
1686 htb_offload(dev, &offload_opt);
1689 if (!q->direct_qdiscs)
1691 for (i = 0; i < q->num_direct_qdiscs && q->direct_qdiscs[i]; i++)
1692 qdisc_put(q->direct_qdiscs[i]);
1693 kfree(q->direct_qdiscs);
1696 static int htb_delete(struct Qdisc *sch, unsigned long arg,
1697 struct netlink_ext_ack *extack)
1699 struct htb_sched *q = qdisc_priv(sch);
1700 struct htb_class *cl = (struct htb_class *)arg;
1701 struct Qdisc *new_q = NULL;
1705 /* TODO: why don't allow to delete subtree ? references ? does
1706 * tc subsys guarantee us that in htb_destroy it holds no class
1707 * refs so that we can remove children safely there ?
1709 if (cl->children || cl->filter_cnt)
1712 if (!cl->level && htb_parent_last_child(cl))
1716 err = htb_destroy_class_offload(sch, cl, last_child, false,
1723 struct netdev_queue *dev_queue = sch->dev_queue;
1726 dev_queue = htb_offload_get_queue(cl);
1728 new_q = qdisc_create_dflt(dev_queue, &pfifo_qdisc_ops,
1729 cl->parent->common.classid,
1733 htb_set_lockdep_class_child(new_q);
1734 htb_parent_to_leaf_offload(sch, dev_queue, new_q);
1741 qdisc_purge_queue(cl->leaf.q);
1743 /* delete from hash and active; remainder in destroy_class */
1744 qdisc_class_hash_remove(&q->clhash, &cl->common);
1746 cl->parent->children--;
1748 if (cl->prio_activity)
1749 htb_deactivate(q, cl);
1751 if (cl->cmode != HTB_CAN_SEND)
1752 htb_safe_rb_erase(&cl->pq_node,
1753 &q->hlevel[cl->level].wait_pq);
1756 htb_parent_to_leaf(sch, cl, new_q);
1758 sch_tree_unlock(sch);
1760 htb_destroy_class(sch, cl);
1764 static int htb_change_class(struct Qdisc *sch, u32 classid,
1765 u32 parentid, struct nlattr **tca,
1766 unsigned long *arg, struct netlink_ext_ack *extack)
1769 struct htb_sched *q = qdisc_priv(sch);
1770 struct htb_class *cl = (struct htb_class *)*arg, *parent;
1771 struct tc_htb_qopt_offload offload_opt;
1772 struct nlattr *opt = tca[TCA_OPTIONS];
1773 struct nlattr *tb[TCA_HTB_MAX + 1];
1774 struct Qdisc *parent_qdisc = NULL;
1775 struct netdev_queue *dev_queue;
1776 struct tc_htb_opt *hopt;
1780 /* extract all subattrs from opt attr */
1784 err = nla_parse_nested_deprecated(tb, TCA_HTB_MAX, opt, htb_policy,
1790 if (tb[TCA_HTB_PARMS] == NULL)
1793 parent = parentid == TC_H_ROOT ? NULL : htb_find(parentid, sch);
1795 hopt = nla_data(tb[TCA_HTB_PARMS]);
1796 if (!hopt->rate.rate || !hopt->ceil.rate)
1800 /* Options not supported by the offload. */
1801 if (hopt->rate.overhead || hopt->ceil.overhead) {
1802 NL_SET_ERR_MSG(extack, "HTB offload doesn't support the overhead parameter");
1805 if (hopt->rate.mpu || hopt->ceil.mpu) {
1806 NL_SET_ERR_MSG(extack, "HTB offload doesn't support the mpu parameter");
1809 if (hopt->quantum) {
1810 NL_SET_ERR_MSG(extack, "HTB offload doesn't support the quantum parameter");
1814 NL_SET_ERR_MSG(extack, "HTB offload doesn't support the prio parameter");
1819 /* Keeping backward compatible with rate_table based iproute2 tc */
1820 if (hopt->rate.linklayer == TC_LINKLAYER_UNAWARE)
1821 qdisc_put_rtab(qdisc_get_rtab(&hopt->rate, tb[TCA_HTB_RTAB],
1824 if (hopt->ceil.linklayer == TC_LINKLAYER_UNAWARE)
1825 qdisc_put_rtab(qdisc_get_rtab(&hopt->ceil, tb[TCA_HTB_CTAB],
1828 rate64 = tb[TCA_HTB_RATE64] ? nla_get_u64(tb[TCA_HTB_RATE64]) : 0;
1829 ceil64 = tb[TCA_HTB_CEIL64] ? nla_get_u64(tb[TCA_HTB_CEIL64]) : 0;
1831 if (!cl) { /* new class */
1832 struct net_device *dev = qdisc_dev(sch);
1833 struct Qdisc *new_q, *old_q;
1837 struct gnet_estimator opt;
1840 .nla_len = nla_attr_size(sizeof(est.opt)),
1841 .nla_type = TCA_RATE,
1844 /* 4s interval, 16s averaging constant */
1850 /* check for valid classid */
1851 if (!classid || TC_H_MAJ(classid ^ sch->handle) ||
1852 htb_find(classid, sch))
1855 /* check maximal depth */
1856 if (parent && parent->parent && parent->parent->level < 2) {
1857 pr_err("htb: tree is too deep\n");
1861 cl = kzalloc(sizeof(*cl), GFP_KERNEL);
1865 gnet_stats_basic_sync_init(&cl->bstats);
1866 gnet_stats_basic_sync_init(&cl->bstats_bias);
1868 err = tcf_block_get(&cl->block, &cl->filter_list, sch, extack);
1873 if (htb_rate_est || tca[TCA_RATE]) {
1874 err = gen_new_estimator(&cl->bstats, NULL,
1878 tca[TCA_RATE] ? : &est.nla);
1884 RB_CLEAR_NODE(&cl->pq_node);
1886 for (prio = 0; prio < TC_HTB_NUMPRIO; prio++)
1887 RB_CLEAR_NODE(&cl->node[prio]);
1889 cl->common.classid = classid;
1891 /* Make sure nothing interrupts us in between of two
1892 * ndo_setup_tc calls.
1896 /* create leaf qdisc early because it uses kmalloc(GFP_KERNEL)
1897 * so that can't be used inside of sch_tree_lock
1898 * -- thanks to Karlis Peisenieks
1901 dev_queue = sch->dev_queue;
1902 } else if (!(parent && !parent->level)) {
1903 /* Assign a dev_queue to this classid. */
1904 offload_opt = (struct tc_htb_qopt_offload) {
1905 .command = TC_HTB_LEAF_ALLOC_QUEUE,
1906 .classid = cl->common.classid,
1907 .parent_classid = parent ?
1908 TC_H_MIN(parent->common.classid) :
1909 TC_HTB_CLASSID_ROOT,
1910 .rate = max_t(u64, hopt->rate.rate, rate64),
1911 .ceil = max_t(u64, hopt->ceil.rate, ceil64),
1914 err = htb_offload(dev, &offload_opt);
1916 pr_err("htb: TC_HTB_LEAF_ALLOC_QUEUE failed with err = %d\n",
1918 goto err_kill_estimator;
1920 dev_queue = netdev_get_tx_queue(dev, offload_opt.qid);
1921 } else { /* First child. */
1922 dev_queue = htb_offload_get_queue(parent);
1923 old_q = htb_graft_helper(dev_queue, NULL);
1924 WARN_ON(old_q != parent->leaf.q);
1925 offload_opt = (struct tc_htb_qopt_offload) {
1926 .command = TC_HTB_LEAF_TO_INNER,
1927 .classid = cl->common.classid,
1929 TC_H_MIN(parent->common.classid),
1930 .rate = max_t(u64, hopt->rate.rate, rate64),
1931 .ceil = max_t(u64, hopt->ceil.rate, ceil64),
1934 err = htb_offload(dev, &offload_opt);
1936 pr_err("htb: TC_HTB_LEAF_TO_INNER failed with err = %d\n",
1938 htb_graft_helper(dev_queue, old_q);
1939 goto err_kill_estimator;
1941 _bstats_update(&parent->bstats_bias,
1942 u64_stats_read(&old_q->bstats.bytes),
1943 u64_stats_read(&old_q->bstats.packets));
1946 new_q = qdisc_create_dflt(dev_queue, &pfifo_qdisc_ops,
1950 htb_set_lockdep_class_child(new_q);
1951 /* One ref for cl->leaf.q, the other for
1954 qdisc_refcount_inc(new_q);
1956 old_q = htb_graft_helper(dev_queue, new_q);
1957 /* No qdisc_put needed. */
1958 WARN_ON(!(old_q->flags & TCQ_F_BUILTIN));
1961 if (parent && !parent->level) {
1962 /* turn parent into inner node */
1963 qdisc_purge_queue(parent->leaf.q);
1964 parent_qdisc = parent->leaf.q;
1965 if (parent->prio_activity)
1966 htb_deactivate(q, parent);
1968 /* remove from evt list because of level change */
1969 if (parent->cmode != HTB_CAN_SEND) {
1970 htb_safe_rb_erase(&parent->pq_node, &q->hlevel[0].wait_pq);
1971 parent->cmode = HTB_CAN_SEND;
1973 parent->level = (parent->parent ? parent->parent->level
1974 : TC_HTB_MAXDEPTH) - 1;
1975 memset(&parent->inner, 0, sizeof(parent->inner));
1978 /* leaf (we) needs elementary qdisc */
1979 cl->leaf.q = new_q ? new_q : &noop_qdisc;
1981 cl->leaf.offload_queue = dev_queue;
1983 cl->parent = parent;
1985 /* set class to be in HTB_CAN_SEND state */
1986 cl->tokens = PSCHED_TICKS2NS(hopt->buffer);
1987 cl->ctokens = PSCHED_TICKS2NS(hopt->cbuffer);
1988 cl->mbuffer = 60ULL * NSEC_PER_SEC; /* 1min */
1989 cl->t_c = ktime_get_ns();
1990 cl->cmode = HTB_CAN_SEND;
1992 /* attach to the hash list and parent's family */
1993 qdisc_class_hash_insert(&q->clhash, &cl->common);
1996 if (cl->leaf.q != &noop_qdisc)
1997 qdisc_hash_add(cl->leaf.q, true);
1999 if (tca[TCA_RATE]) {
2000 err = gen_replace_estimator(&cl->bstats, NULL,
2010 struct net_device *dev = qdisc_dev(sch);
2012 offload_opt = (struct tc_htb_qopt_offload) {
2013 .command = TC_HTB_NODE_MODIFY,
2014 .classid = cl->common.classid,
2015 .rate = max_t(u64, hopt->rate.rate, rate64),
2016 .ceil = max_t(u64, hopt->ceil.rate, ceil64),
2019 err = htb_offload(dev, &offload_opt);
2021 /* Estimator was replaced, and rollback may fail
2022 * as well, so we don't try to recover it, and
2023 * the estimator won't work property with the
2024 * offload anyway, because bstats are updated
2025 * only when the stats are queried.
2033 psched_ratecfg_precompute(&cl->rate, &hopt->rate, rate64);
2034 psched_ratecfg_precompute(&cl->ceil, &hopt->ceil, ceil64);
2036 /* it used to be a nasty bug here, we have to check that node
2037 * is really leaf before changing cl->leaf !
2040 u64 quantum = cl->rate.rate_bytes_ps;
2042 do_div(quantum, q->rate2quantum);
2043 cl->quantum = min_t(u64, quantum, INT_MAX);
2045 if (!hopt->quantum && cl->quantum < 1000) {
2049 if (!hopt->quantum && cl->quantum > 200000) {
2051 cl->quantum = 200000;
2054 cl->quantum = hopt->quantum;
2055 if ((cl->prio = hopt->prio) >= TC_HTB_NUMPRIO)
2056 cl->prio = TC_HTB_NUMPRIO - 1;
2059 cl->buffer = PSCHED_TICKS2NS(hopt->buffer);
2060 cl->cbuffer = PSCHED_TICKS2NS(hopt->cbuffer);
2062 sch_tree_unlock(sch);
2063 qdisc_put(parent_qdisc);
2066 pr_warn("HTB: quantum of class %X is %s. Consider r2q change.\n",
2067 cl->common.classid, (warn == -1 ? "small" : "big"));
2069 qdisc_class_hash_grow(sch, &q->clhash);
2071 *arg = (unsigned long)cl;
2075 gen_kill_estimator(&cl->rate_est);
2077 tcf_block_put(cl->block);
2083 static struct tcf_block *htb_tcf_block(struct Qdisc *sch, unsigned long arg,
2084 struct netlink_ext_ack *extack)
2086 struct htb_sched *q = qdisc_priv(sch);
2087 struct htb_class *cl = (struct htb_class *)arg;
2089 return cl ? cl->block : q->block;
2092 static unsigned long htb_bind_filter(struct Qdisc *sch, unsigned long parent,
2095 struct htb_class *cl = htb_find(classid, sch);
2097 /*if (cl && !cl->level) return 0;
2098 * The line above used to be there to prevent attaching filters to
2099 * leaves. But at least tc_index filter uses this just to get class
2100 * for other reasons so that we have to allow for it.
2102 * 19.6.2002 As Werner explained it is ok - bind filter is just
2103 * another way to "lock" the class - unlike "get" this lock can
2104 * be broken by class during destroy IIUC.
2108 return (unsigned long)cl;
2111 static void htb_unbind_filter(struct Qdisc *sch, unsigned long arg)
2113 struct htb_class *cl = (struct htb_class *)arg;
2119 static void htb_walk(struct Qdisc *sch, struct qdisc_walker *arg)
2121 struct htb_sched *q = qdisc_priv(sch);
2122 struct htb_class *cl;
2128 for (i = 0; i < q->clhash.hashsize; i++) {
2129 hlist_for_each_entry(cl, &q->clhash.hash[i], common.hnode) {
2130 if (!tc_qdisc_stats_dump(sch, (unsigned long)cl, arg))
2136 static const struct Qdisc_class_ops htb_class_ops = {
2137 .select_queue = htb_select_queue,
2140 .qlen_notify = htb_qlen_notify,
2142 .change = htb_change_class,
2143 .delete = htb_delete,
2145 .tcf_block = htb_tcf_block,
2146 .bind_tcf = htb_bind_filter,
2147 .unbind_tcf = htb_unbind_filter,
2148 .dump = htb_dump_class,
2149 .dump_stats = htb_dump_class_stats,
2152 static struct Qdisc_ops htb_qdisc_ops __read_mostly = {
2153 .cl_ops = &htb_class_ops,
2155 .priv_size = sizeof(struct htb_sched),
2156 .enqueue = htb_enqueue,
2157 .dequeue = htb_dequeue,
2158 .peek = qdisc_peek_dequeued,
2160 .attach = htb_attach,
2162 .destroy = htb_destroy,
2164 .owner = THIS_MODULE,
2167 static int __init htb_module_init(void)
2169 return register_qdisc(&htb_qdisc_ops);
2171 static void __exit htb_module_exit(void)
2173 unregister_qdisc(&htb_qdisc_ops);
2176 module_init(htb_module_init)
2177 module_exit(htb_module_exit)
2178 MODULE_LICENSE("GPL");