xref: /linux/net/sched/sch_hfsc.c (revision f2c53ea949c5048f96b3dbb5a5ee7131ce4ff2de)
1 /*
2  * Copyright (c) 2003 Patrick McHardy, <kaber@trash.net>
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * 2003-10-17 - Ported from altq
10  */
11 /*
12  * Copyright (c) 1997-1999 Carnegie Mellon University. All Rights Reserved.
13  *
14  * Permission to use, copy, modify, and distribute this software and
15  * its documentation is hereby granted (including for commercial or
16  * for-profit use), provided that both the copyright notice and this
17  * permission notice appear in all copies of the software, derivative
18  * works, or modified versions, and any portions thereof.
19  *
20  * THIS SOFTWARE IS EXPERIMENTAL AND IS KNOWN TO HAVE BUGS, SOME OF
21  * WHICH MAY HAVE SERIOUS CONSEQUENCES.  CARNEGIE MELLON PROVIDES THIS
22  * SOFTWARE IN ITS ``AS IS'' CONDITION, AND ANY EXPRESS OR IMPLIED
23  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
25  * DISCLAIMED.  IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
28  * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
29  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
30  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
32  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
33  * DAMAGE.
34  *
35  * Carnegie Mellon encourages (but does not require) users of this
36  * software to return any improvements or extensions that they make,
37  * and to grant Carnegie Mellon the rights to redistribute these
38  * changes without encumbrance.
39  */
40 /*
41  * H-FSC is described in Proceedings of SIGCOMM'97,
42  * "A Hierarchical Fair Service Curve Algorithm for Link-Sharing,
43  * Real-Time and Priority Service"
44  * by Ion Stoica, Hui Zhang, and T. S. Eugene Ng.
45  *
46  * Oleg Cherevko <olwi@aq.ml.com.ua> added the upperlimit for link-sharing.
47  * when a class has an upperlimit, the fit-time is computed from the
48  * upperlimit service curve.  the link-sharing scheduler does not schedule
49  * a class whose fit-time exceeds the current time.
50  */
51 
52 #include <linux/kernel.h>
53 #include <linux/module.h>
54 #include <linux/types.h>
55 #include <linux/errno.h>
56 #include <linux/compiler.h>
57 #include <linux/spinlock.h>
58 #include <linux/skbuff.h>
59 #include <linux/string.h>
60 #include <linux/slab.h>
61 #include <linux/list.h>
62 #include <linux/rbtree.h>
63 #include <linux/init.h>
64 #include <linux/rtnetlink.h>
65 #include <linux/pkt_sched.h>
66 #include <net/netlink.h>
67 #include <net/pkt_sched.h>
68 #include <net/pkt_cls.h>
69 #include <asm/div64.h>
70 
71 /*
72  * kernel internal service curve representation:
73  *   coordinates are given by 64 bit unsigned integers.
74  *   x-axis: unit is clock count.
75  *   y-axis: unit is byte.
76  *
77  *   The service curve parameters are converted to the internal
78  *   representation. The slope values are scaled to avoid overflow.
79  *   the inverse slope values as well as the y-projection of the 1st
80  *   segment are kept in order to avoid 64-bit divide operations
81  *   that are expensive on 32-bit architectures.
82  */
83 
84 struct internal_sc {
85 	u64	sm1;	/* scaled slope of the 1st segment */
86 	u64	ism1;	/* scaled inverse-slope of the 1st segment */
87 	u64	dx;	/* the x-projection of the 1st segment */
88 	u64	dy;	/* the y-projection of the 1st segment */
89 	u64	sm2;	/* scaled slope of the 2nd segment */
90 	u64	ism2;	/* scaled inverse-slope of the 2nd segment */
91 };
92 
93 /* runtime service curve */
94 struct runtime_sc {
95 	u64	x;	/* current starting position on x-axis */
96 	u64	y;	/* current starting position on y-axis */
97 	u64	sm1;	/* scaled slope of the 1st segment */
98 	u64	ism1;	/* scaled inverse-slope of the 1st segment */
99 	u64	dx;	/* the x-projection of the 1st segment */
100 	u64	dy;	/* the y-projection of the 1st segment */
101 	u64	sm2;	/* scaled slope of the 2nd segment */
102 	u64	ism2;	/* scaled inverse-slope of the 2nd segment */
103 };
104 
105 enum hfsc_class_flags {
106 	HFSC_RSC = 0x1,
107 	HFSC_FSC = 0x2,
108 	HFSC_USC = 0x4
109 };
110 
111 struct hfsc_class {
112 	struct Qdisc_class_common cl_common;
113 
114 	struct gnet_stats_basic_sync bstats;
115 	struct gnet_stats_queue qstats;
116 	struct net_rate_estimator __rcu *rate_est;
117 	struct tcf_proto __rcu *filter_list; /* filter list */
118 	struct tcf_block *block;
119 	unsigned int	level;		/* class level in hierarchy */
120 
121 	struct hfsc_sched *sched;	/* scheduler data */
122 	struct hfsc_class *cl_parent;	/* parent class */
123 	struct list_head siblings;	/* sibling classes */
124 	struct list_head children;	/* child classes */
125 	struct Qdisc	*qdisc;		/* leaf qdisc */
126 
127 	struct rb_node el_node;		/* qdisc's eligible tree member */
128 	struct rb_root vt_tree;		/* active children sorted by cl_vt */
129 	struct rb_node vt_node;		/* parent's vt_tree member */
130 	struct rb_root cf_tree;		/* active children sorted by cl_f */
131 	struct rb_node cf_node;		/* parent's cf_heap member */
132 
133 	u64	cl_total;		/* total work in bytes */
134 	u64	cl_cumul;		/* cumulative work in bytes done by
135 					   real-time criteria */
136 
137 	u64	cl_d;			/* deadline*/
138 	u64	cl_e;			/* eligible time */
139 	u64	cl_vt;			/* virtual time */
140 	u64	cl_f;			/* time when this class will fit for
141 					   link-sharing, max(myf, cfmin) */
142 	u64	cl_myf;			/* my fit-time (calculated from this
143 					   class's own upperlimit curve) */
144 	u64	cl_cfmin;		/* earliest children's fit-time (used
145 					   with cl_myf to obtain cl_f) */
146 	u64	cl_cvtmin;		/* minimal virtual time among the
147 					   children fit for link-sharing
148 					   (monotonic within a period) */
149 	u64	cl_vtadj;		/* intra-period cumulative vt
150 					   adjustment */
151 	u64	cl_cvtoff;		/* largest virtual time seen among
152 					   the children */
153 
154 	struct internal_sc cl_rsc;	/* internal real-time service curve */
155 	struct internal_sc cl_fsc;	/* internal fair service curve */
156 	struct internal_sc cl_usc;	/* internal upperlimit service curve */
157 	struct runtime_sc cl_deadline;	/* deadline curve */
158 	struct runtime_sc cl_eligible;	/* eligible curve */
159 	struct runtime_sc cl_virtual;	/* virtual curve */
160 	struct runtime_sc cl_ulimit;	/* upperlimit curve */
161 
162 	u8		cl_flags;	/* which curves are valid */
163 	u32		cl_vtperiod;	/* vt period sequence number */
164 	u32		cl_parentperiod;/* parent's vt period sequence number*/
165 	u32		cl_nactive;	/* number of active children */
166 };
167 
168 struct hfsc_sched {
169 	u16	defcls;				/* default class id */
170 	struct hfsc_class root;			/* root class */
171 	struct Qdisc_class_hash clhash;		/* class hash */
172 	struct rb_root eligible;		/* eligible tree */
173 	struct qdisc_watchdog watchdog;		/* watchdog timer */
174 };
175 
176 #define	HT_INFINITY	0xffffffffffffffffULL	/* infinite time value */
177 
cl_in_el_or_vttree(struct hfsc_class * cl)178 static bool cl_in_el_or_vttree(struct hfsc_class *cl)
179 {
180 	return ((cl->cl_flags & HFSC_FSC) && cl->cl_nactive) ||
181 		((cl->cl_flags & HFSC_RSC) && !RB_EMPTY_NODE(&cl->el_node));
182 }
183 
184 /*
185  * eligible tree holds backlogged classes being sorted by their eligible times.
186  * there is one eligible tree per hfsc instance.
187  */
188 
189 static void
eltree_insert(struct hfsc_class * cl)190 eltree_insert(struct hfsc_class *cl)
191 {
192 	struct rb_node **p = &cl->sched->eligible.rb_node;
193 	struct rb_node *parent = NULL;
194 	struct hfsc_class *cl1;
195 
196 	while (*p != NULL) {
197 		parent = *p;
198 		cl1 = rb_entry(parent, struct hfsc_class, el_node);
199 		if (cl->cl_e >= cl1->cl_e)
200 			p = &parent->rb_right;
201 		else
202 			p = &parent->rb_left;
203 	}
204 	rb_link_node(&cl->el_node, parent, p);
205 	rb_insert_color(&cl->el_node, &cl->sched->eligible);
206 }
207 
208 static inline void
eltree_remove(struct hfsc_class * cl)209 eltree_remove(struct hfsc_class *cl)
210 {
211 	if (!RB_EMPTY_NODE(&cl->el_node)) {
212 		rb_erase(&cl->el_node, &cl->sched->eligible);
213 		RB_CLEAR_NODE(&cl->el_node);
214 	}
215 }
216 
217 static inline void
eltree_update(struct hfsc_class * cl)218 eltree_update(struct hfsc_class *cl)
219 {
220 	eltree_remove(cl);
221 	eltree_insert(cl);
222 }
223 
224 /* find the class with the minimum deadline among the eligible classes */
225 static inline struct hfsc_class *
eltree_get_mindl(struct hfsc_sched * q,u64 cur_time)226 eltree_get_mindl(struct hfsc_sched *q, u64 cur_time)
227 {
228 	struct hfsc_class *p, *cl = NULL;
229 	struct rb_node *n;
230 
231 	for (n = rb_first(&q->eligible); n != NULL; n = rb_next(n)) {
232 		p = rb_entry(n, struct hfsc_class, el_node);
233 		if (p->cl_e > cur_time)
234 			break;
235 		if (cl == NULL || p->cl_d < cl->cl_d)
236 			cl = p;
237 	}
238 	return cl;
239 }
240 
241 /* find the class with minimum eligible time among the eligible classes */
242 static inline struct hfsc_class *
eltree_get_minel(struct hfsc_sched * q)243 eltree_get_minel(struct hfsc_sched *q)
244 {
245 	struct rb_node *n;
246 
247 	n = rb_first(&q->eligible);
248 	if (n == NULL)
249 		return NULL;
250 	return rb_entry(n, struct hfsc_class, el_node);
251 }
252 
253 /*
254  * vttree holds holds backlogged child classes being sorted by their virtual
255  * time. each intermediate class has one vttree.
256  */
257 static void
vttree_insert(struct hfsc_class * cl)258 vttree_insert(struct hfsc_class *cl)
259 {
260 	struct rb_node **p = &cl->cl_parent->vt_tree.rb_node;
261 	struct rb_node *parent = NULL;
262 	struct hfsc_class *cl1;
263 
264 	while (*p != NULL) {
265 		parent = *p;
266 		cl1 = rb_entry(parent, struct hfsc_class, vt_node);
267 		if (cl->cl_vt >= cl1->cl_vt)
268 			p = &parent->rb_right;
269 		else
270 			p = &parent->rb_left;
271 	}
272 	rb_link_node(&cl->vt_node, parent, p);
273 	rb_insert_color(&cl->vt_node, &cl->cl_parent->vt_tree);
274 }
275 
276 static inline void
vttree_remove(struct hfsc_class * cl)277 vttree_remove(struct hfsc_class *cl)
278 {
279 	rb_erase(&cl->vt_node, &cl->cl_parent->vt_tree);
280 }
281 
282 static inline void
vttree_update(struct hfsc_class * cl)283 vttree_update(struct hfsc_class *cl)
284 {
285 	vttree_remove(cl);
286 	vttree_insert(cl);
287 }
288 
289 static inline struct hfsc_class *
vttree_firstfit(struct hfsc_class * cl,u64 cur_time)290 vttree_firstfit(struct hfsc_class *cl, u64 cur_time)
291 {
292 	struct hfsc_class *p;
293 	struct rb_node *n;
294 
295 	for (n = rb_first(&cl->vt_tree); n != NULL; n = rb_next(n)) {
296 		p = rb_entry(n, struct hfsc_class, vt_node);
297 		if (p->cl_f <= cur_time)
298 			return p;
299 	}
300 	return NULL;
301 }
302 
303 /*
304  * get the leaf class with the minimum vt in the hierarchy
305  */
306 static struct hfsc_class *
vttree_get_minvt(struct hfsc_class * cl,u64 cur_time)307 vttree_get_minvt(struct hfsc_class *cl, u64 cur_time)
308 {
309 	/* if root-class's cfmin is bigger than cur_time nothing to do */
310 	if (cl->cl_cfmin > cur_time)
311 		return NULL;
312 
313 	while (cl->level > 0) {
314 		cl = vttree_firstfit(cl, cur_time);
315 		if (cl == NULL)
316 			return NULL;
317 		/*
318 		 * update parent's cl_cvtmin.
319 		 */
320 		if (cl->cl_parent->cl_cvtmin < cl->cl_vt)
321 			cl->cl_parent->cl_cvtmin = cl->cl_vt;
322 	}
323 	return cl;
324 }
325 
326 static void
cftree_insert(struct hfsc_class * cl)327 cftree_insert(struct hfsc_class *cl)
328 {
329 	struct rb_node **p = &cl->cl_parent->cf_tree.rb_node;
330 	struct rb_node *parent = NULL;
331 	struct hfsc_class *cl1;
332 
333 	while (*p != NULL) {
334 		parent = *p;
335 		cl1 = rb_entry(parent, struct hfsc_class, cf_node);
336 		if (cl->cl_f >= cl1->cl_f)
337 			p = &parent->rb_right;
338 		else
339 			p = &parent->rb_left;
340 	}
341 	rb_link_node(&cl->cf_node, parent, p);
342 	rb_insert_color(&cl->cf_node, &cl->cl_parent->cf_tree);
343 }
344 
345 static inline void
cftree_remove(struct hfsc_class * cl)346 cftree_remove(struct hfsc_class *cl)
347 {
348 	rb_erase(&cl->cf_node, &cl->cl_parent->cf_tree);
349 }
350 
351 static inline void
cftree_update(struct hfsc_class * cl)352 cftree_update(struct hfsc_class *cl)
353 {
354 	cftree_remove(cl);
355 	cftree_insert(cl);
356 }
357 
358 /*
359  * service curve support functions
360  *
361  *  external service curve parameters
362  *	m: bps
363  *	d: us
364  *  internal service curve parameters
365  *	sm: (bytes/psched_us) << SM_SHIFT
366  *	ism: (psched_us/byte) << ISM_SHIFT
367  *	dx: psched_us
368  *
369  * The clock source resolution with ktime and PSCHED_SHIFT 10 is 1.024us.
370  *
371  * sm and ism are scaled in order to keep effective digits.
372  * SM_SHIFT and ISM_SHIFT are selected to keep at least 4 effective
373  * digits in decimal using the following table.
374  *
375  *  bits/sec      100Kbps     1Mbps     10Mbps     100Mbps    1Gbps
376  *  ------------+-------------------------------------------------------
377  *  bytes/1.024us 12.8e-3    128e-3     1280e-3    12800e-3   128000e-3
378  *
379  *  1.024us/byte  78.125     7.8125     0.78125    0.078125   0.0078125
380  *
381  * So, for PSCHED_SHIFT 10 we need: SM_SHIFT 20, ISM_SHIFT 18.
382  */
383 #define	SM_SHIFT	(30 - PSCHED_SHIFT)
384 #define	ISM_SHIFT	(8 + PSCHED_SHIFT)
385 
386 #define	SM_MASK		((1ULL << SM_SHIFT) - 1)
387 #define	ISM_MASK	((1ULL << ISM_SHIFT) - 1)
388 
389 /*
390  * Cap on the non-descending hops a classify walk may take before its
391  * filter chain is treated as misconfigured. A flowid binding that was
392  * legal at bind time can become lateral once hfsc_adjust_levels()
393  * raises a class level; a few such hops are legitimate, an unbounded
394  * run means the chain cycles.
395  */
396 #define	HFSC_CLASSIFY_MAX_DRIFT	8
397 
398 static inline u64
seg_x2y(u64 x,u64 sm)399 seg_x2y(u64 x, u64 sm)
400 {
401 	u64 y;
402 
403 	/*
404 	 * compute
405 	 *	y = x * sm >> SM_SHIFT
406 	 * but divide it for the upper and lower bits to avoid overflow
407 	 */
408 	y = (x >> SM_SHIFT) * sm + (((x & SM_MASK) * sm) >> SM_SHIFT);
409 	return y;
410 }
411 
412 static inline u64
seg_y2x(u64 y,u64 ism)413 seg_y2x(u64 y, u64 ism)
414 {
415 	u64 x;
416 
417 	if (y == 0)
418 		x = 0;
419 	else if (ism == HT_INFINITY)
420 		x = HT_INFINITY;
421 	else {
422 		x = (y >> ISM_SHIFT) * ism
423 		    + (((y & ISM_MASK) * ism) >> ISM_SHIFT);
424 	}
425 	return x;
426 }
427 
428 /* Convert m (bps) into sm (bytes/psched us) */
429 static u64
m2sm(u32 m)430 m2sm(u32 m)
431 {
432 	u64 sm;
433 
434 	sm = ((u64)m << SM_SHIFT);
435 	sm += PSCHED_TICKS_PER_SEC - 1;
436 	do_div(sm, PSCHED_TICKS_PER_SEC);
437 	return sm;
438 }
439 
440 /* convert m (bps) into ism (psched us/byte) */
441 static u64
m2ism(u32 m)442 m2ism(u32 m)
443 {
444 	u64 ism;
445 
446 	if (m == 0)
447 		ism = HT_INFINITY;
448 	else {
449 		ism = ((u64)PSCHED_TICKS_PER_SEC << ISM_SHIFT);
450 		ism += m - 1;
451 		do_div(ism, m);
452 	}
453 	return ism;
454 }
455 
456 /* convert d (us) into dx (psched us) */
457 static u64
d2dx(u32 d)458 d2dx(u32 d)
459 {
460 	u64 dx;
461 
462 	dx = ((u64)d * PSCHED_TICKS_PER_SEC);
463 	dx += USEC_PER_SEC - 1;
464 	do_div(dx, USEC_PER_SEC);
465 	return dx;
466 }
467 
468 /* convert sm (bytes/psched us) into m (bps) */
469 static u32
sm2m(u64 sm)470 sm2m(u64 sm)
471 {
472 	u64 m;
473 
474 	m = (sm * PSCHED_TICKS_PER_SEC) >> SM_SHIFT;
475 	return (u32)m;
476 }
477 
478 /* convert dx (psched us) into d (us) */
479 static u32
dx2d(u64 dx)480 dx2d(u64 dx)
481 {
482 	u64 d;
483 
484 	d = dx * USEC_PER_SEC;
485 	do_div(d, PSCHED_TICKS_PER_SEC);
486 	return (u32)d;
487 }
488 
489 static void
sc2isc(struct tc_service_curve * sc,struct internal_sc * isc)490 sc2isc(struct tc_service_curve *sc, struct internal_sc *isc)
491 {
492 	isc->sm1  = m2sm(sc->m1);
493 	isc->ism1 = m2ism(sc->m1);
494 	isc->dx   = d2dx(sc->d);
495 	isc->dy   = seg_x2y(isc->dx, isc->sm1);
496 	isc->sm2  = m2sm(sc->m2);
497 	isc->ism2 = m2ism(sc->m2);
498 }
499 
500 /*
501  * initialize the runtime service curve with the given internal
502  * service curve starting at (x, y).
503  */
504 static void
rtsc_init(struct runtime_sc * rtsc,struct internal_sc * isc,u64 x,u64 y)505 rtsc_init(struct runtime_sc *rtsc, struct internal_sc *isc, u64 x, u64 y)
506 {
507 	rtsc->x	   = x;
508 	rtsc->y    = y;
509 	rtsc->sm1  = isc->sm1;
510 	rtsc->ism1 = isc->ism1;
511 	rtsc->dx   = isc->dx;
512 	rtsc->dy   = isc->dy;
513 	rtsc->sm2  = isc->sm2;
514 	rtsc->ism2 = isc->ism2;
515 }
516 
517 /*
518  * calculate the y-projection of the runtime service curve by the
519  * given x-projection value
520  */
521 static u64
rtsc_y2x(struct runtime_sc * rtsc,u64 y)522 rtsc_y2x(struct runtime_sc *rtsc, u64 y)
523 {
524 	u64 x;
525 
526 	if (y < rtsc->y)
527 		x = rtsc->x;
528 	else if (y <= rtsc->y + rtsc->dy) {
529 		/* x belongs to the 1st segment */
530 		if (rtsc->dy == 0)
531 			x = rtsc->x + rtsc->dx;
532 		else
533 			x = rtsc->x + seg_y2x(y - rtsc->y, rtsc->ism1);
534 	} else {
535 		/* x belongs to the 2nd segment */
536 		x = rtsc->x + rtsc->dx
537 		    + seg_y2x(y - rtsc->y - rtsc->dy, rtsc->ism2);
538 	}
539 	return x;
540 }
541 
542 static u64
rtsc_x2y(struct runtime_sc * rtsc,u64 x)543 rtsc_x2y(struct runtime_sc *rtsc, u64 x)
544 {
545 	u64 y;
546 
547 	if (x <= rtsc->x)
548 		y = rtsc->y;
549 	else if (x <= rtsc->x + rtsc->dx)
550 		/* y belongs to the 1st segment */
551 		y = rtsc->y + seg_x2y(x - rtsc->x, rtsc->sm1);
552 	else
553 		/* y belongs to the 2nd segment */
554 		y = rtsc->y + rtsc->dy
555 		    + seg_x2y(x - rtsc->x - rtsc->dx, rtsc->sm2);
556 	return y;
557 }
558 
559 /*
560  * update the runtime service curve by taking the minimum of the current
561  * runtime service curve and the service curve starting at (x, y).
562  */
563 static void
rtsc_min(struct runtime_sc * rtsc,struct internal_sc * isc,u64 x,u64 y)564 rtsc_min(struct runtime_sc *rtsc, struct internal_sc *isc, u64 x, u64 y)
565 {
566 	u64 y1, y2, dx, dy;
567 	u64 dsm;
568 
569 	if (isc->sm1 <= isc->sm2) {
570 		/* service curve is convex */
571 		y1 = rtsc_x2y(rtsc, x);
572 		if (y1 < y)
573 			/* the current rtsc is smaller */
574 			return;
575 		rtsc->x = x;
576 		rtsc->y = y;
577 		return;
578 	}
579 
580 	/*
581 	 * service curve is concave
582 	 * compute the two y values of the current rtsc
583 	 *	y1: at x
584 	 *	y2: at (x + dx)
585 	 */
586 	y1 = rtsc_x2y(rtsc, x);
587 	if (y1 <= y) {
588 		/* rtsc is below isc, no change to rtsc */
589 		return;
590 	}
591 
592 	y2 = rtsc_x2y(rtsc, x + isc->dx);
593 	if (y2 >= y + isc->dy) {
594 		/* rtsc is above isc, replace rtsc by isc */
595 		rtsc->x = x;
596 		rtsc->y = y;
597 		rtsc->dx = isc->dx;
598 		rtsc->dy = isc->dy;
599 		return;
600 	}
601 
602 	/*
603 	 * the two curves intersect
604 	 * compute the offsets (dx, dy) using the reverse
605 	 * function of seg_x2y()
606 	 *	seg_x2y(dx, sm1) == seg_x2y(dx, sm2) + (y1 - y)
607 	 */
608 	dx = (y1 - y) << SM_SHIFT;
609 	dsm = isc->sm1 - isc->sm2;
610 	dx = div64_u64(dx, dsm);
611 	/*
612 	 * check if (x, y1) belongs to the 1st segment of rtsc.
613 	 * if so, add the offset.
614 	 */
615 	if (rtsc->x + rtsc->dx > x)
616 		dx += rtsc->x + rtsc->dx - x;
617 	dy = seg_x2y(dx, isc->sm1);
618 
619 	rtsc->x = x;
620 	rtsc->y = y;
621 	rtsc->dx = dx;
622 	rtsc->dy = dy;
623 }
624 
625 static void
init_ed(struct hfsc_class * cl,unsigned int next_len)626 init_ed(struct hfsc_class *cl, unsigned int next_len)
627 {
628 	u64 cur_time = psched_get_time();
629 
630 	/* update the deadline curve */
631 	rtsc_min(&cl->cl_deadline, &cl->cl_rsc, cur_time, cl->cl_cumul);
632 
633 	/*
634 	 * update the eligible curve.
635 	 * for concave, it is equal to the deadline curve.
636 	 * for convex, it is a linear curve with slope m2.
637 	 */
638 	cl->cl_eligible = cl->cl_deadline;
639 	if (cl->cl_rsc.sm1 <= cl->cl_rsc.sm2) {
640 		cl->cl_eligible.dx = 0;
641 		cl->cl_eligible.dy = 0;
642 	}
643 
644 	/* compute e and d */
645 	cl->cl_e = rtsc_y2x(&cl->cl_eligible, cl->cl_cumul);
646 	cl->cl_d = rtsc_y2x(&cl->cl_deadline, cl->cl_cumul + next_len);
647 
648 	eltree_insert(cl);
649 }
650 
651 static void
update_ed(struct hfsc_class * cl,unsigned int next_len)652 update_ed(struct hfsc_class *cl, unsigned int next_len)
653 {
654 	cl->cl_e = rtsc_y2x(&cl->cl_eligible, cl->cl_cumul);
655 	cl->cl_d = rtsc_y2x(&cl->cl_deadline, cl->cl_cumul + next_len);
656 
657 	eltree_update(cl);
658 }
659 
660 static inline void
update_d(struct hfsc_class * cl,unsigned int next_len)661 update_d(struct hfsc_class *cl, unsigned int next_len)
662 {
663 	cl->cl_d = rtsc_y2x(&cl->cl_deadline, cl->cl_cumul + next_len);
664 }
665 
666 static inline void
update_cfmin(struct hfsc_class * cl)667 update_cfmin(struct hfsc_class *cl)
668 {
669 	struct rb_node *n = rb_first(&cl->cf_tree);
670 	struct hfsc_class *p;
671 
672 	if (n == NULL) {
673 		cl->cl_cfmin = 0;
674 		return;
675 	}
676 	p = rb_entry(n, struct hfsc_class, cf_node);
677 	cl->cl_cfmin = p->cl_f;
678 }
679 
680 static void
init_vf(struct hfsc_class * cl,unsigned int len)681 init_vf(struct hfsc_class *cl, unsigned int len)
682 {
683 	struct hfsc_class *max_cl;
684 	struct rb_node *n;
685 	u64 vt, f, cur_time;
686 	int go_active;
687 
688 	cur_time = 0;
689 	go_active = 1;
690 	for (; cl->cl_parent != NULL; cl = cl->cl_parent) {
691 		if (go_active && cl->cl_nactive++ == 0)
692 			go_active = 1;
693 		else
694 			go_active = 0;
695 
696 		if (go_active) {
697 			n = rb_last(&cl->cl_parent->vt_tree);
698 			if (n != NULL) {
699 				max_cl = rb_entry(n, struct hfsc_class, vt_node);
700 				/*
701 				 * set vt to the average of the min and max
702 				 * classes.  if the parent's period didn't
703 				 * change, don't decrease vt of the class.
704 				 */
705 				vt = max_cl->cl_vt;
706 				if (cl->cl_parent->cl_cvtmin != 0)
707 					vt = (cl->cl_parent->cl_cvtmin + vt)/2;
708 
709 				if (cl->cl_parent->cl_vtperiod !=
710 				    cl->cl_parentperiod || vt > cl->cl_vt)
711 					cl->cl_vt = vt;
712 			} else {
713 				/*
714 				 * first child for a new parent backlog period.
715 				 * initialize cl_vt to the highest value seen
716 				 * among the siblings. this is analogous to
717 				 * what cur_time would provide in realtime case.
718 				 */
719 				cl->cl_vt = cl->cl_parent->cl_cvtoff;
720 				cl->cl_parent->cl_cvtmin = 0;
721 			}
722 
723 			/* update the virtual curve */
724 			rtsc_min(&cl->cl_virtual, &cl->cl_fsc, cl->cl_vt, cl->cl_total);
725 			cl->cl_vtadj = 0;
726 
727 			WRITE_ONCE(cl->cl_vtperiod, cl->cl_vtperiod + 1);  /* increment vt period */
728 			cl->cl_parentperiod = cl->cl_parent->cl_vtperiod;
729 			if (cl->cl_parent->cl_nactive == 0)
730 				cl->cl_parentperiod++;
731 			cl->cl_f = 0;
732 
733 			vttree_insert(cl);
734 			cftree_insert(cl);
735 
736 			if (cl->cl_flags & HFSC_USC) {
737 				/* class has upper limit curve */
738 				if (cur_time == 0)
739 					cur_time = psched_get_time();
740 
741 				/* update the ulimit curve */
742 				rtsc_min(&cl->cl_ulimit, &cl->cl_usc, cur_time,
743 					 cl->cl_total);
744 				/* compute myf */
745 				cl->cl_myf = rtsc_y2x(&cl->cl_ulimit,
746 						      cl->cl_total);
747 			}
748 		}
749 
750 		f = max(cl->cl_myf, cl->cl_cfmin);
751 		if (f != cl->cl_f) {
752 			cl->cl_f = f;
753 			cftree_update(cl);
754 		}
755 		update_cfmin(cl->cl_parent);
756 	}
757 }
758 
759 static void
update_vf(struct hfsc_class * cl,unsigned int len,u64 cur_time)760 update_vf(struct hfsc_class *cl, unsigned int len, u64 cur_time)
761 {
762 	u64 f; /* , myf_bound, delta; */
763 	int go_passive = 0;
764 
765 	if (cl->qdisc->q.qlen == 0 && cl->cl_flags & HFSC_FSC && cl->cl_nactive)
766 		go_passive = 1;
767 
768 	for (; cl->cl_parent != NULL; cl = cl->cl_parent) {
769 		WRITE_ONCE(cl->cl_total, cl->cl_total + len);
770 
771 		if (!(cl->cl_flags & HFSC_FSC) || cl->cl_nactive == 0)
772 			continue;
773 
774 		if (go_passive && --cl->cl_nactive == 0)
775 			go_passive = 1;
776 		else
777 			go_passive = 0;
778 
779 		/* update vt */
780 		cl->cl_vt = rtsc_y2x(&cl->cl_virtual, cl->cl_total) + cl->cl_vtadj;
781 
782 		/*
783 		 * if vt of the class is smaller than cvtmin,
784 		 * the class was skipped in the past due to non-fit.
785 		 * if so, we need to adjust vtadj.
786 		 */
787 		if (cl->cl_vt < cl->cl_parent->cl_cvtmin) {
788 			cl->cl_vtadj += cl->cl_parent->cl_cvtmin - cl->cl_vt;
789 			cl->cl_vt = cl->cl_parent->cl_cvtmin;
790 		}
791 
792 		if (go_passive) {
793 			/* no more active child, going passive */
794 
795 			/* update cvtoff of the parent class */
796 			if (cl->cl_vt > cl->cl_parent->cl_cvtoff)
797 				cl->cl_parent->cl_cvtoff = cl->cl_vt;
798 
799 			/* remove this class from the vt tree */
800 			vttree_remove(cl);
801 
802 			cftree_remove(cl);
803 			update_cfmin(cl->cl_parent);
804 
805 			continue;
806 		}
807 
808 		/* update the vt tree */
809 		vttree_update(cl);
810 
811 		/* update f */
812 		if (cl->cl_flags & HFSC_USC) {
813 			cl->cl_myf = rtsc_y2x(&cl->cl_ulimit, cl->cl_total);
814 #if 0
815 			cl->cl_myf = cl->cl_myfadj + rtsc_y2x(&cl->cl_ulimit,
816 							      cl->cl_total);
817 			/*
818 			 * This code causes classes to stay way under their
819 			 * limit when multiple classes are used at gigabit
820 			 * speed. needs investigation. -kaber
821 			 */
822 			/*
823 			 * if myf lags behind by more than one clock tick
824 			 * from the current time, adjust myfadj to prevent
825 			 * a rate-limited class from going greedy.
826 			 * in a steady state under rate-limiting, myf
827 			 * fluctuates within one clock tick.
828 			 */
829 			myf_bound = cur_time - PSCHED_JIFFIE2US(1);
830 			if (cl->cl_myf < myf_bound) {
831 				delta = cur_time - cl->cl_myf;
832 				cl->cl_myfadj += delta;
833 				cl->cl_myf += delta;
834 			}
835 #endif
836 		}
837 
838 		f = max(cl->cl_myf, cl->cl_cfmin);
839 		if (f != cl->cl_f) {
840 			cl->cl_f = f;
841 			cftree_update(cl);
842 			update_cfmin(cl->cl_parent);
843 		}
844 	}
845 }
846 
847 static void
hfsc_adjust_levels(struct hfsc_class * cl)848 hfsc_adjust_levels(struct hfsc_class *cl)
849 {
850 	struct hfsc_class *p;
851 	unsigned int level;
852 
853 	do {
854 		level = 0;
855 		list_for_each_entry(p, &cl->children, siblings) {
856 			if (p->level >= level)
857 				level = p->level + 1;
858 		}
859 		WRITE_ONCE(cl->level, level);
860 	} while ((cl = cl->cl_parent) != NULL);
861 }
862 
863 static inline struct hfsc_class *
hfsc_find_class(u32 classid,struct Qdisc * sch)864 hfsc_find_class(u32 classid, struct Qdisc *sch)
865 {
866 	struct hfsc_sched *q = qdisc_priv(sch);
867 	struct Qdisc_class_common *clc;
868 
869 	clc = qdisc_class_find(&q->clhash, classid);
870 	if (clc == NULL)
871 		return NULL;
872 	return container_of(clc, struct hfsc_class, cl_common);
873 }
874 
875 static void
hfsc_change_rsc(struct hfsc_class * cl,struct tc_service_curve * rsc,u64 cur_time)876 hfsc_change_rsc(struct hfsc_class *cl, struct tc_service_curve *rsc,
877 		u64 cur_time)
878 {
879 	sc2isc(rsc, &cl->cl_rsc);
880 	rtsc_init(&cl->cl_deadline, &cl->cl_rsc, cur_time, cl->cl_cumul);
881 	cl->cl_eligible = cl->cl_deadline;
882 	if (cl->cl_rsc.sm1 <= cl->cl_rsc.sm2) {
883 		cl->cl_eligible.dx = 0;
884 		cl->cl_eligible.dy = 0;
885 	}
886 	cl->cl_flags |= HFSC_RSC;
887 }
888 
889 static void
hfsc_change_fsc(struct hfsc_class * cl,struct tc_service_curve * fsc)890 hfsc_change_fsc(struct hfsc_class *cl, struct tc_service_curve *fsc)
891 {
892 	sc2isc(fsc, &cl->cl_fsc);
893 	rtsc_init(&cl->cl_virtual, &cl->cl_fsc, cl->cl_vt, cl->cl_total);
894 	cl->cl_flags |= HFSC_FSC;
895 }
896 
897 static void
hfsc_change_usc(struct hfsc_class * cl,struct tc_service_curve * usc,u64 cur_time)898 hfsc_change_usc(struct hfsc_class *cl, struct tc_service_curve *usc,
899 		u64 cur_time)
900 {
901 	sc2isc(usc, &cl->cl_usc);
902 	rtsc_init(&cl->cl_ulimit, &cl->cl_usc, cur_time, cl->cl_total);
903 	cl->cl_flags |= HFSC_USC;
904 }
905 
906 static void
hfsc_upgrade_rt(struct hfsc_class * cl)907 hfsc_upgrade_rt(struct hfsc_class *cl)
908 {
909 	cl->cl_fsc = cl->cl_rsc;
910 	rtsc_init(&cl->cl_virtual, &cl->cl_fsc, cl->cl_vt, cl->cl_total);
911 	cl->cl_flags |= HFSC_FSC;
912 }
913 
914 static const struct nla_policy hfsc_policy[TCA_HFSC_MAX + 1] = {
915 	[TCA_HFSC_RSC]	= { .len = sizeof(struct tc_service_curve) },
916 	[TCA_HFSC_FSC]	= { .len = sizeof(struct tc_service_curve) },
917 	[TCA_HFSC_USC]	= { .len = sizeof(struct tc_service_curve) },
918 };
919 
920 static int
hfsc_change_class(struct Qdisc * sch,u32 classid,u32 parentid,struct nlattr ** tca,unsigned long * arg,struct netlink_ext_ack * extack)921 hfsc_change_class(struct Qdisc *sch, u32 classid, u32 parentid,
922 		  struct nlattr **tca, unsigned long *arg,
923 		  struct netlink_ext_ack *extack)
924 {
925 	struct hfsc_sched *q = qdisc_priv(sch);
926 	struct hfsc_class *cl = (struct hfsc_class *)*arg;
927 	struct hfsc_class *parent = NULL;
928 	struct nlattr *opt = tca[TCA_OPTIONS];
929 	struct nlattr *tb[TCA_HFSC_MAX + 1];
930 	struct tc_service_curve *rsc = NULL, *fsc = NULL, *usc = NULL;
931 	u64 cur_time;
932 	int err;
933 
934 	if (opt == NULL)
935 		return -EINVAL;
936 
937 	err = nla_parse_nested_deprecated(tb, TCA_HFSC_MAX, opt, hfsc_policy,
938 					  NULL);
939 	if (err < 0)
940 		return err;
941 
942 	if (tb[TCA_HFSC_RSC]) {
943 		rsc = nla_data(tb[TCA_HFSC_RSC]);
944 		if (rsc->m1 == 0 && rsc->m2 == 0)
945 			rsc = NULL;
946 	}
947 
948 	if (tb[TCA_HFSC_FSC]) {
949 		fsc = nla_data(tb[TCA_HFSC_FSC]);
950 		if (fsc->m1 == 0 && fsc->m2 == 0)
951 			fsc = NULL;
952 	}
953 
954 	if (tb[TCA_HFSC_USC]) {
955 		usc = nla_data(tb[TCA_HFSC_USC]);
956 		if (usc->m1 == 0 && usc->m2 == 0)
957 			usc = NULL;
958 	}
959 
960 	if (cl != NULL) {
961 		int old_flags;
962 		int len = 0;
963 
964 		if (parentid) {
965 			if (cl->cl_parent &&
966 			    cl->cl_parent->cl_common.classid != parentid)
967 				return -EINVAL;
968 			if (cl->cl_parent == NULL && parentid != TC_H_ROOT)
969 				return -EINVAL;
970 		}
971 		cur_time = psched_get_time();
972 
973 		if (tca[TCA_RATE]) {
974 			err = gen_replace_estimator(&cl->bstats, NULL,
975 						    &cl->rate_est,
976 						    NULL,
977 						    true,
978 						    tca[TCA_RATE]);
979 			if (err)
980 				return err;
981 		}
982 
983 		sch_tree_lock(sch);
984 		old_flags = cl->cl_flags;
985 
986 		if (rsc != NULL)
987 			hfsc_change_rsc(cl, rsc, cur_time);
988 		if (fsc != NULL)
989 			hfsc_change_fsc(cl, fsc);
990 		if (usc != NULL)
991 			hfsc_change_usc(cl, usc, cur_time);
992 
993 		if (cl->qdisc->q.qlen != 0)
994 			len = qdisc_peek_len(cl->qdisc);
995 		/* Check queue length again since some qdisc implementations
996 		 * (e.g., netem/codel) might empty the queue during the peek
997 		 * operation.
998 		 */
999 		if (cl->qdisc->q.qlen != 0) {
1000 			if (cl->cl_flags & HFSC_RSC) {
1001 				if (old_flags & HFSC_RSC)
1002 					update_ed(cl, len);
1003 				else
1004 					init_ed(cl, len);
1005 			}
1006 
1007 			if (cl->cl_flags & HFSC_FSC) {
1008 				if (old_flags & HFSC_FSC)
1009 					update_vf(cl, 0, cur_time);
1010 				else
1011 					init_vf(cl, len);
1012 			}
1013 		}
1014 		sch_tree_unlock(sch);
1015 
1016 		return 0;
1017 	}
1018 
1019 	if (parentid == TC_H_ROOT)
1020 		return -EEXIST;
1021 
1022 	parent = &q->root;
1023 	if (parentid) {
1024 		parent = hfsc_find_class(parentid, sch);
1025 		if (parent == NULL)
1026 			return -ENOENT;
1027 	}
1028 
1029 	if (classid == 0 || TC_H_MAJ(classid ^ sch->handle) != 0)
1030 		return -EINVAL;
1031 	if (hfsc_find_class(classid, sch))
1032 		return -EEXIST;
1033 
1034 	if (rsc == NULL && fsc == NULL)
1035 		return -EINVAL;
1036 
1037 	cl = kzalloc_obj(struct hfsc_class);
1038 	if (cl == NULL)
1039 		return -ENOBUFS;
1040 
1041 	RB_CLEAR_NODE(&cl->el_node);
1042 
1043 	err = tcf_block_get(&cl->block, &cl->filter_list, sch, extack);
1044 	if (err) {
1045 		kfree(cl);
1046 		return err;
1047 	}
1048 
1049 	if (tca[TCA_RATE]) {
1050 		err = gen_new_estimator(&cl->bstats, NULL, &cl->rate_est,
1051 					NULL, true, tca[TCA_RATE]);
1052 		if (err) {
1053 			tcf_block_put(cl->block);
1054 			kfree(cl);
1055 			return err;
1056 		}
1057 	}
1058 
1059 	if (rsc != NULL)
1060 		hfsc_change_rsc(cl, rsc, 0);
1061 	if (fsc != NULL)
1062 		hfsc_change_fsc(cl, fsc);
1063 	if (usc != NULL)
1064 		hfsc_change_usc(cl, usc, 0);
1065 
1066 	cl->cl_common.classid = classid;
1067 	cl->sched     = q;
1068 	cl->cl_parent = parent;
1069 	cl->qdisc = qdisc_create_dflt(sch->dev_queue, &pfifo_qdisc_ops,
1070 				      classid, NULL);
1071 	if (cl->qdisc == NULL)
1072 		cl->qdisc = &noop_qdisc;
1073 	else
1074 		qdisc_hash_add(cl->qdisc, true);
1075 	INIT_LIST_HEAD(&cl->children);
1076 	cl->vt_tree = RB_ROOT;
1077 	cl->cf_tree = RB_ROOT;
1078 
1079 	sch_tree_lock(sch);
1080 	/* Check if the inner class is a misconfigured 'rt' */
1081 	if (!(parent->cl_flags & HFSC_FSC) && parent != &q->root) {
1082 		NL_SET_ERR_MSG(extack,
1083 			       "Forced curve change on parent 'rt' to 'sc'");
1084 		hfsc_upgrade_rt(parent);
1085 	}
1086 	qdisc_class_hash_insert(&q->clhash, &cl->cl_common);
1087 	list_add_tail(&cl->siblings, &parent->children);
1088 	if (parent->level == 0)
1089 		qdisc_purge_queue(parent->qdisc);
1090 	hfsc_adjust_levels(parent);
1091 	sch_tree_unlock(sch);
1092 
1093 	qdisc_class_hash_grow(sch, &q->clhash);
1094 
1095 	*arg = (unsigned long)cl;
1096 	return 0;
1097 }
1098 
1099 static void
hfsc_destroy_class(struct Qdisc * sch,struct hfsc_class * cl)1100 hfsc_destroy_class(struct Qdisc *sch, struct hfsc_class *cl)
1101 {
1102 	struct hfsc_sched *q = qdisc_priv(sch);
1103 
1104 	tcf_block_put(cl->block);
1105 	qdisc_put(cl->qdisc);
1106 	gen_kill_estimator(&cl->rate_est);
1107 	if (cl != &q->root)
1108 		kfree(cl);
1109 }
1110 
1111 static int
hfsc_delete_class(struct Qdisc * sch,unsigned long arg,struct netlink_ext_ack * extack)1112 hfsc_delete_class(struct Qdisc *sch, unsigned long arg,
1113 		  struct netlink_ext_ack *extack)
1114 {
1115 	struct hfsc_sched *q = qdisc_priv(sch);
1116 	struct hfsc_class *cl = (struct hfsc_class *)arg;
1117 
1118 	if (cl->level > 0 || qdisc_class_in_use(&cl->cl_common) ||
1119 	    cl == &q->root) {
1120 		NL_SET_ERR_MSG(extack, "HFSC class in use");
1121 		return -EBUSY;
1122 	}
1123 
1124 	sch_tree_lock(sch);
1125 
1126 	list_del(&cl->siblings);
1127 	hfsc_adjust_levels(cl->cl_parent);
1128 
1129 	qdisc_purge_queue(cl->qdisc);
1130 	qdisc_class_hash_remove(&q->clhash, &cl->cl_common);
1131 
1132 	sch_tree_unlock(sch);
1133 
1134 	hfsc_destroy_class(sch, cl);
1135 	return 0;
1136 }
1137 
1138 static struct hfsc_class *
hfsc_classify(struct sk_buff * skb,struct Qdisc * sch,int * qerr)1139 hfsc_classify(struct sk_buff *skb, struct Qdisc *sch, int *qerr)
1140 {
1141 	struct hfsc_sched *q = qdisc_priv(sch);
1142 	struct hfsc_class *head, *cl;
1143 	struct tcf_result res;
1144 	struct tcf_proto *tcf;
1145 	unsigned int drift;
1146 	int result;
1147 
1148 	if (TC_H_MAJ(skb->priority ^ sch->handle) == 0 &&
1149 	    (cl = hfsc_find_class(skb->priority, sch)) != NULL)
1150 		if (cl->level == 0)
1151 			return cl;
1152 
1153 	*qerr = NET_XMIT_SUCCESS | __NET_XMIT_BYPASS;
1154 	head = &q->root;
1155 	drift = HFSC_CLASSIFY_MAX_DRIFT;
1156 	tcf = rcu_dereference_bh(q->root.filter_list);
1157 	while (tcf && (result = tcf_classify_qdisc(skb, tcf, &res, false)) >= 0) {
1158 #ifdef CONFIG_NET_CLS_ACT
1159 		switch (result) {
1160 		case TC_ACT_QUEUED:
1161 		case TC_ACT_STOLEN:
1162 		case TC_ACT_TRAP:
1163 			*qerr = NET_XMIT_SUCCESS | __NET_XMIT_STOLEN;
1164 			fallthrough;
1165 		case TC_ACT_SHOT:
1166 			return NULL;
1167 		}
1168 #endif
1169 		cl = (struct hfsc_class *)res.class;
1170 		if (!cl) {
1171 			cl = hfsc_find_class(res.classid, sch);
1172 			if (!cl)
1173 				break; /* filter selected invalid classid */
1174 			if (cl->level >= head->level)
1175 				break; /* filter may only point downwards */
1176 		}
1177 
1178 		if (cl->level == 0)
1179 			return cl; /* hit leaf class */
1180 
1181 		/*
1182 		 * flowid binds skip the level check above (res.class is set
1183 		 * at bind time and levels drift after), so a walk can follow
1184 		 * lateral hops without descending; a bounded number of them
1185 		 * is legal, more means the chain cycles.
1186 		 */
1187 		if (cl->level >= head->level && drift-- == 0) {
1188 			pr_warn_ratelimited("hfsc: classify hop budget exhausted, dropping packet\n");
1189 			return NULL;
1190 		}
1191 
1192 		/* apply inner filter chain */
1193 		tcf = rcu_dereference_bh(cl->filter_list);
1194 		head = cl;
1195 	}
1196 
1197 	/* classification failed, try default class */
1198 	cl = hfsc_find_class(TC_H_MAKE(TC_H_MAJ(sch->handle),
1199 				       READ_ONCE(q->defcls)), sch);
1200 	if (cl == NULL || cl->level > 0)
1201 		return NULL;
1202 
1203 	return cl;
1204 }
1205 
1206 static int
hfsc_graft_class(struct Qdisc * sch,unsigned long arg,struct Qdisc * new,struct Qdisc ** old,struct netlink_ext_ack * extack)1207 hfsc_graft_class(struct Qdisc *sch, unsigned long arg, struct Qdisc *new,
1208 		 struct Qdisc **old, struct netlink_ext_ack *extack)
1209 {
1210 	struct hfsc_class *cl = (struct hfsc_class *)arg;
1211 
1212 	if (cl->level > 0)
1213 		return -EINVAL;
1214 	if (new == NULL) {
1215 		new = qdisc_create_dflt(sch->dev_queue, &pfifo_qdisc_ops,
1216 					cl->cl_common.classid, NULL);
1217 		if (new == NULL)
1218 			new = &noop_qdisc;
1219 	}
1220 
1221 	*old = qdisc_replace(sch, new, &cl->qdisc);
1222 	return 0;
1223 }
1224 
1225 static struct Qdisc *
hfsc_class_leaf(struct Qdisc * sch,unsigned long arg)1226 hfsc_class_leaf(struct Qdisc *sch, unsigned long arg)
1227 {
1228 	struct hfsc_class *cl = (struct hfsc_class *)arg;
1229 
1230 	if (cl->level == 0)
1231 		return cl->qdisc;
1232 
1233 	return NULL;
1234 }
1235 
1236 static void
hfsc_qlen_notify(struct Qdisc * sch,unsigned long arg)1237 hfsc_qlen_notify(struct Qdisc *sch, unsigned long arg)
1238 {
1239 	struct hfsc_class *cl = (struct hfsc_class *)arg;
1240 
1241 	/* vttree is now handled in update_vf() so that update_vf(cl, 0, 0)
1242 	 * needs to be called explicitly to remove a class from vttree.
1243 	 */
1244 	if (cl->cl_nactive)
1245 		update_vf(cl, 0, 0);
1246 	if (cl->cl_flags & HFSC_RSC)
1247 		eltree_remove(cl);
1248 }
1249 
1250 static unsigned long
hfsc_search_class(struct Qdisc * sch,u32 classid)1251 hfsc_search_class(struct Qdisc *sch, u32 classid)
1252 {
1253 	return (unsigned long)hfsc_find_class(classid, sch);
1254 }
1255 
1256 static unsigned long
hfsc_bind_tcf(struct Qdisc * sch,unsigned long parent,u32 classid)1257 hfsc_bind_tcf(struct Qdisc *sch, unsigned long parent, u32 classid)
1258 {
1259 	struct hfsc_class *p = (struct hfsc_class *)parent;
1260 	struct hfsc_class *cl = hfsc_find_class(classid, sch);
1261 
1262 	if (cl != NULL) {
1263 		if (p != NULL && p->level <= cl->level)
1264 			return 0;
1265 		qdisc_class_get(&cl->cl_common);
1266 	}
1267 
1268 	return (unsigned long)cl;
1269 }
1270 
1271 static void
hfsc_unbind_tcf(struct Qdisc * sch,unsigned long arg)1272 hfsc_unbind_tcf(struct Qdisc *sch, unsigned long arg)
1273 {
1274 	struct hfsc_class *cl = (struct hfsc_class *)arg;
1275 
1276 	qdisc_class_put(&cl->cl_common);
1277 }
1278 
hfsc_tcf_block(struct Qdisc * sch,unsigned long arg,struct netlink_ext_ack * extack)1279 static struct tcf_block *hfsc_tcf_block(struct Qdisc *sch, unsigned long arg,
1280 					struct netlink_ext_ack *extack)
1281 {
1282 	struct hfsc_sched *q = qdisc_priv(sch);
1283 	struct hfsc_class *cl = (struct hfsc_class *)arg;
1284 
1285 	if (cl == NULL)
1286 		cl = &q->root;
1287 
1288 	return cl->block;
1289 }
1290 
1291 static int
hfsc_dump_sc(struct sk_buff * skb,int attr,struct internal_sc * sc)1292 hfsc_dump_sc(struct sk_buff *skb, int attr, struct internal_sc *sc)
1293 {
1294 	struct tc_service_curve tsc;
1295 
1296 	tsc.m1 = sm2m(sc->sm1);
1297 	tsc.d  = dx2d(sc->dx);
1298 	tsc.m2 = sm2m(sc->sm2);
1299 	if (nla_put(skb, attr, sizeof(tsc), &tsc))
1300 		goto nla_put_failure;
1301 
1302 	return skb->len;
1303 
1304  nla_put_failure:
1305 	return -1;
1306 }
1307 
1308 static int
hfsc_dump_curves(struct sk_buff * skb,struct hfsc_class * cl)1309 hfsc_dump_curves(struct sk_buff *skb, struct hfsc_class *cl)
1310 {
1311 	if ((cl->cl_flags & HFSC_RSC) &&
1312 	    (hfsc_dump_sc(skb, TCA_HFSC_RSC, &cl->cl_rsc) < 0))
1313 		goto nla_put_failure;
1314 
1315 	if ((cl->cl_flags & HFSC_FSC) &&
1316 	    (hfsc_dump_sc(skb, TCA_HFSC_FSC, &cl->cl_fsc) < 0))
1317 		goto nla_put_failure;
1318 
1319 	if ((cl->cl_flags & HFSC_USC) &&
1320 	    (hfsc_dump_sc(skb, TCA_HFSC_USC, &cl->cl_usc) < 0))
1321 		goto nla_put_failure;
1322 
1323 	return skb->len;
1324 
1325  nla_put_failure:
1326 	return -1;
1327 }
1328 
1329 static int
hfsc_dump_class(struct Qdisc * sch,unsigned long arg,struct sk_buff * skb,struct tcmsg * tcm)1330 hfsc_dump_class(struct Qdisc *sch, unsigned long arg, struct sk_buff *skb,
1331 		struct tcmsg *tcm)
1332 {
1333 	struct hfsc_class *cl = (struct hfsc_class *)arg;
1334 	struct nlattr *nest;
1335 
1336 	tcm->tcm_parent = cl->cl_parent ? cl->cl_parent->cl_common.classid :
1337 					  TC_H_ROOT;
1338 	tcm->tcm_handle = cl->cl_common.classid;
1339 	if (cl->level == 0)
1340 		tcm->tcm_info = cl->qdisc->handle;
1341 
1342 	nest = nla_nest_start_noflag(skb, TCA_OPTIONS);
1343 	if (nest == NULL)
1344 		goto nla_put_failure;
1345 	if (hfsc_dump_curves(skb, cl) < 0)
1346 		goto nla_put_failure;
1347 	return nla_nest_end(skb, nest);
1348 
1349  nla_put_failure:
1350 	nla_nest_cancel(skb, nest);
1351 	return -EMSGSIZE;
1352 }
1353 
1354 static int
hfsc_dump_class_stats(struct Qdisc * sch,unsigned long arg,struct gnet_dump * d)1355 hfsc_dump_class_stats(struct Qdisc *sch, unsigned long arg,
1356 	struct gnet_dump *d)
1357 {
1358 	struct hfsc_class *cl = (struct hfsc_class *)arg;
1359 	struct tc_hfsc_stats xstats;
1360 	__u32 qlen;
1361 
1362 	qdisc_qstats_qlen_backlog(cl->qdisc, &qlen, &cl->qstats.backlog);
1363 	xstats.level   = READ_ONCE(cl->level);
1364 	xstats.period  = READ_ONCE(cl->cl_vtperiod);
1365 	xstats.work    = READ_ONCE(cl->cl_total);
1366 	xstats.rtwork  = READ_ONCE(cl->cl_cumul);
1367 
1368 	if (gnet_stats_copy_basic(d, NULL, &cl->bstats, true) < 0 ||
1369 	    gnet_stats_copy_rate_est(d, &cl->rate_est) < 0 ||
1370 	    gnet_stats_copy_queue(d, NULL, &cl->qstats, qlen) < 0)
1371 		return -1;
1372 
1373 	return gnet_stats_copy_app(d, &xstats, sizeof(xstats));
1374 }
1375 
1376 
1377 
1378 static void
hfsc_walk(struct Qdisc * sch,struct qdisc_walker * arg)1379 hfsc_walk(struct Qdisc *sch, struct qdisc_walker *arg)
1380 {
1381 	struct hfsc_sched *q = qdisc_priv(sch);
1382 	struct hfsc_class *cl;
1383 	unsigned int i;
1384 
1385 	if (arg->stop)
1386 		return;
1387 
1388 	for (i = 0; i < q->clhash.hashsize; i++) {
1389 		hlist_for_each_entry(cl, &q->clhash.hash[i],
1390 				     cl_common.hnode) {
1391 			if (!tc_qdisc_stats_dump(sch, (unsigned long)cl, arg))
1392 				return;
1393 		}
1394 	}
1395 }
1396 
1397 static void
hfsc_schedule_watchdog(struct Qdisc * sch)1398 hfsc_schedule_watchdog(struct Qdisc *sch)
1399 {
1400 	struct hfsc_sched *q = qdisc_priv(sch);
1401 	struct hfsc_class *cl;
1402 	u64 next_time = 0;
1403 
1404 	cl = eltree_get_minel(q);
1405 	if (cl)
1406 		next_time = cl->cl_e;
1407 	if (q->root.cl_cfmin != 0) {
1408 		if (next_time == 0 || next_time > q->root.cl_cfmin)
1409 			next_time = q->root.cl_cfmin;
1410 	}
1411 	if (next_time)
1412 		qdisc_watchdog_schedule(&q->watchdog, next_time);
1413 }
1414 
1415 static int
hfsc_init_qdisc(struct Qdisc * sch,struct nlattr * opt,struct netlink_ext_ack * extack)1416 hfsc_init_qdisc(struct Qdisc *sch, struct nlattr *opt,
1417 		struct netlink_ext_ack *extack)
1418 {
1419 	struct hfsc_sched *q = qdisc_priv(sch);
1420 	struct tc_hfsc_qopt *qopt;
1421 	int err;
1422 
1423 	qdisc_watchdog_init(&q->watchdog, sch);
1424 
1425 	if (!opt || nla_len(opt) < sizeof(*qopt))
1426 		return -EINVAL;
1427 	qopt = nla_data(opt);
1428 
1429 	q->defcls = qopt->defcls;
1430 	err = qdisc_class_hash_init(&q->clhash);
1431 	if (err < 0)
1432 		return err;
1433 	q->eligible = RB_ROOT;
1434 
1435 	err = tcf_block_get(&q->root.block, &q->root.filter_list, sch, extack);
1436 	if (err)
1437 		return err;
1438 
1439 	gnet_stats_basic_sync_init(&q->root.bstats);
1440 	q->root.cl_common.classid = sch->handle;
1441 	q->root.sched   = q;
1442 	q->root.qdisc = qdisc_create_dflt(sch->dev_queue, &pfifo_qdisc_ops,
1443 					  sch->handle, NULL);
1444 	if (q->root.qdisc == NULL)
1445 		q->root.qdisc = &noop_qdisc;
1446 	else
1447 		qdisc_hash_add(q->root.qdisc, true);
1448 	INIT_LIST_HEAD(&q->root.children);
1449 	q->root.vt_tree = RB_ROOT;
1450 	q->root.cf_tree = RB_ROOT;
1451 
1452 	qdisc_class_hash_insert(&q->clhash, &q->root.cl_common);
1453 	qdisc_class_hash_grow(sch, &q->clhash);
1454 
1455 	return 0;
1456 }
1457 
1458 static int
hfsc_change_qdisc(struct Qdisc * sch,struct nlattr * opt,struct netlink_ext_ack * extack)1459 hfsc_change_qdisc(struct Qdisc *sch, struct nlattr *opt,
1460 		  struct netlink_ext_ack *extack)
1461 {
1462 	struct hfsc_sched *q = qdisc_priv(sch);
1463 	struct tc_hfsc_qopt *qopt;
1464 
1465 	if (nla_len(opt) < sizeof(*qopt))
1466 		return -EINVAL;
1467 	qopt = nla_data(opt);
1468 
1469 	WRITE_ONCE(q->defcls, qopt->defcls);
1470 
1471 	return 0;
1472 }
1473 
1474 static void
hfsc_reset_class(struct hfsc_class * cl)1475 hfsc_reset_class(struct hfsc_class *cl)
1476 {
1477 	WRITE_ONCE(cl->cl_total, 0);
1478 	WRITE_ONCE(cl->cl_cumul, 0);
1479 	cl->cl_d            = 0;
1480 	cl->cl_e            = 0;
1481 	cl->cl_vt           = 0;
1482 	cl->cl_vtadj        = 0;
1483 	cl->cl_cvtmin       = 0;
1484 	cl->cl_cvtoff       = 0;
1485 	WRITE_ONCE(cl->cl_vtperiod, 0);
1486 	cl->cl_parentperiod = 0;
1487 	cl->cl_f            = 0;
1488 	cl->cl_myf          = 0;
1489 	cl->cl_cfmin        = 0;
1490 	cl->cl_nactive      = 0;
1491 
1492 	cl->vt_tree = RB_ROOT;
1493 	cl->cf_tree = RB_ROOT;
1494 	qdisc_reset(cl->qdisc);
1495 
1496 	if (cl->cl_flags & HFSC_RSC)
1497 		rtsc_init(&cl->cl_deadline, &cl->cl_rsc, 0, 0);
1498 	if (cl->cl_flags & HFSC_FSC)
1499 		rtsc_init(&cl->cl_virtual, &cl->cl_fsc, 0, 0);
1500 	if (cl->cl_flags & HFSC_USC)
1501 		rtsc_init(&cl->cl_ulimit, &cl->cl_usc, 0, 0);
1502 }
1503 
1504 static void
hfsc_reset_qdisc(struct Qdisc * sch)1505 hfsc_reset_qdisc(struct Qdisc *sch)
1506 {
1507 	struct hfsc_sched *q = qdisc_priv(sch);
1508 	struct hfsc_class *cl;
1509 	unsigned int i;
1510 
1511 	for (i = 0; i < q->clhash.hashsize; i++) {
1512 		hlist_for_each_entry(cl, &q->clhash.hash[i], cl_common.hnode)
1513 			hfsc_reset_class(cl);
1514 	}
1515 	q->eligible = RB_ROOT;
1516 	qdisc_watchdog_cancel(&q->watchdog);
1517 }
1518 
1519 static void
hfsc_destroy_qdisc(struct Qdisc * sch)1520 hfsc_destroy_qdisc(struct Qdisc *sch)
1521 {
1522 	struct hfsc_sched *q = qdisc_priv(sch);
1523 	struct hlist_node *next;
1524 	struct hfsc_class *cl;
1525 	unsigned int i;
1526 
1527 	for (i = 0; i < q->clhash.hashsize; i++) {
1528 		hlist_for_each_entry(cl, &q->clhash.hash[i], cl_common.hnode) {
1529 			tcf_block_put(cl->block);
1530 			cl->block = NULL;
1531 		}
1532 	}
1533 	for (i = 0; i < q->clhash.hashsize; i++) {
1534 		hlist_for_each_entry_safe(cl, next, &q->clhash.hash[i],
1535 					  cl_common.hnode)
1536 			hfsc_destroy_class(sch, cl);
1537 	}
1538 	qdisc_class_hash_destroy(&q->clhash);
1539 	qdisc_watchdog_cancel(&q->watchdog);
1540 }
1541 
1542 static int
hfsc_dump_qdisc(struct Qdisc * sch,struct sk_buff * skb)1543 hfsc_dump_qdisc(struct Qdisc *sch, struct sk_buff *skb)
1544 {
1545 	struct hfsc_sched *q = qdisc_priv(sch);
1546 	unsigned char *b = skb_tail_pointer(skb);
1547 	struct tc_hfsc_qopt qopt;
1548 
1549 	qopt.defcls = READ_ONCE(q->defcls);
1550 	if (nla_put(skb, TCA_OPTIONS, sizeof(qopt), &qopt))
1551 		goto nla_put_failure;
1552 	return skb->len;
1553 
1554  nla_put_failure:
1555 	nlmsg_trim(skb, b);
1556 	return -1;
1557 }
1558 
1559 static int
hfsc_enqueue(struct sk_buff * skb,struct Qdisc * sch,struct sk_buff ** to_free)1560 hfsc_enqueue(struct sk_buff *skb, struct Qdisc *sch, struct sk_buff **to_free)
1561 {
1562 	unsigned int len = qdisc_pkt_len(skb);
1563 	struct hfsc_class *cl;
1564 	int err;
1565 	bool first;
1566 
1567 	cl = hfsc_classify(skb, sch, &err);
1568 	if (cl == NULL) {
1569 		if (err & __NET_XMIT_BYPASS)
1570 			qdisc_qstats_drop(sch);
1571 		__qdisc_drop(skb, to_free);
1572 		return err;
1573 	}
1574 
1575 	first = !cl->qdisc->q.qlen;
1576 	err = qdisc_enqueue(skb, cl->qdisc, to_free);
1577 	if (unlikely(err != NET_XMIT_SUCCESS)) {
1578 		if (net_xmit_drop_count(err)) {
1579 			cl->qstats.drops++;
1580 			qdisc_qstats_drop(sch);
1581 		}
1582 		return err;
1583 	}
1584 
1585 	qstats_backlog_add(sch, len);
1586 	qdisc_qlen_inc(sch);
1587 
1588 	if (first && !cl_in_el_or_vttree(cl)) {
1589 		if (cl->cl_flags & HFSC_RSC)
1590 			init_ed(cl, len);
1591 		if (cl->cl_flags & HFSC_FSC)
1592 			init_vf(cl, len);
1593 		/*
1594 		 * If this is the first packet, isolate the head so an eventual
1595 		 * head drop before the first dequeue operation has no chance
1596 		 * to invalidate the deadline.
1597 		 */
1598 		if (cl->cl_flags & HFSC_RSC)
1599 			cl->qdisc->ops->peek(cl->qdisc);
1600 
1601 	}
1602 
1603 	return NET_XMIT_SUCCESS;
1604 }
1605 
1606 static struct sk_buff *
hfsc_dequeue(struct Qdisc * sch)1607 hfsc_dequeue(struct Qdisc *sch)
1608 {
1609 	struct hfsc_sched *q = qdisc_priv(sch);
1610 	struct hfsc_class *cl;
1611 	struct sk_buff *skb;
1612 	u64 cur_time;
1613 	unsigned int next_len;
1614 	int realtime = 0;
1615 
1616 	if (sch->q.qlen == 0)
1617 		return NULL;
1618 
1619 	cur_time = psched_get_time();
1620 
1621 	/*
1622 	 * if there are eligible classes, use real-time criteria.
1623 	 * find the class with the minimum deadline among
1624 	 * the eligible classes.
1625 	 */
1626 	cl = eltree_get_mindl(q, cur_time);
1627 	if (cl) {
1628 		realtime = 1;
1629 	} else {
1630 		/*
1631 		 * use link-sharing criteria
1632 		 * get the class with the minimum vt in the hierarchy
1633 		 */
1634 		cl = vttree_get_minvt(&q->root, cur_time);
1635 		if (cl == NULL) {
1636 			qdisc_qstats_overlimit(sch);
1637 			hfsc_schedule_watchdog(sch);
1638 			return NULL;
1639 		}
1640 	}
1641 
1642 	skb = qdisc_dequeue_peeked(cl->qdisc);
1643 	if (skb == NULL) {
1644 		qdisc_warn_nonwc("HFSC", cl->qdisc);
1645 		return NULL;
1646 	}
1647 
1648 	bstats_update(&cl->bstats, skb);
1649 	update_vf(cl, qdisc_pkt_len(skb), cur_time);
1650 	if (realtime)
1651 		WRITE_ONCE(cl->cl_cumul, cl->cl_cumul + qdisc_pkt_len(skb));
1652 
1653 	if (cl->cl_flags & HFSC_RSC) {
1654 		if (cl->qdisc->q.qlen != 0) {
1655 			/* update ed */
1656 			next_len = qdisc_peek_len(cl->qdisc);
1657 			/* Check queue length again since some qdisc implementations
1658 			 * (e.g., netem/codel) might empty the queue during the peek
1659 			 * operation.
1660 			 */
1661 			if (cl->qdisc->q.qlen != 0) {
1662 				if (realtime)
1663 					update_ed(cl, next_len);
1664 				else
1665 					update_d(cl, next_len);
1666 			}
1667 		} else {
1668 			/* the class becomes passive */
1669 			eltree_remove(cl);
1670 		}
1671 	}
1672 
1673 	qdisc_bstats_update(sch, skb);
1674 	qdisc_qstats_backlog_dec(sch, skb);
1675 	qdisc_qlen_dec(sch);
1676 
1677 	return skb;
1678 }
1679 
1680 static const struct Qdisc_class_ops hfsc_class_ops = {
1681 	.change		= hfsc_change_class,
1682 	.delete		= hfsc_delete_class,
1683 	.graft		= hfsc_graft_class,
1684 	.leaf		= hfsc_class_leaf,
1685 	.qlen_notify	= hfsc_qlen_notify,
1686 	.find		= hfsc_search_class,
1687 	.bind_tcf	= hfsc_bind_tcf,
1688 	.unbind_tcf	= hfsc_unbind_tcf,
1689 	.tcf_block	= hfsc_tcf_block,
1690 	.dump		= hfsc_dump_class,
1691 	.dump_stats	= hfsc_dump_class_stats,
1692 	.walk		= hfsc_walk
1693 };
1694 
1695 static struct Qdisc_ops hfsc_qdisc_ops __read_mostly = {
1696 	.id		= "hfsc",
1697 	.init		= hfsc_init_qdisc,
1698 	.change		= hfsc_change_qdisc,
1699 	.reset		= hfsc_reset_qdisc,
1700 	.destroy	= hfsc_destroy_qdisc,
1701 	.dump		= hfsc_dump_qdisc,
1702 	.enqueue	= hfsc_enqueue,
1703 	.dequeue	= hfsc_dequeue,
1704 	.peek		= qdisc_peek_dequeued,
1705 	.cl_ops		= &hfsc_class_ops,
1706 	.priv_size	= sizeof(struct hfsc_sched),
1707 	.owner		= THIS_MODULE
1708 };
1709 MODULE_ALIAS_NET_SCH("hfsc");
1710 
1711 static int __init
hfsc_init(void)1712 hfsc_init(void)
1713 {
1714 	return register_qdisc(&hfsc_qdisc_ops);
1715 }
1716 
1717 static void __exit
hfsc_cleanup(void)1718 hfsc_cleanup(void)
1719 {
1720 	unregister_qdisc(&hfsc_qdisc_ops);
1721 }
1722 
1723 MODULE_LICENSE("GPL");
1724 MODULE_DESCRIPTION("Hierarchical Fair Service Curve scheduler");
1725 module_init(hfsc_init);
1726 module_exit(hfsc_cleanup);
1727