1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * net/sched/sch_drr.c Deficit Round Robin scheduler 4 * 5 * Copyright (c) 2008 Patrick McHardy <kaber@trash.net> 6 */ 7 8 #include <linux/module.h> 9 #include <linux/slab.h> 10 #include <linux/init.h> 11 #include <linux/errno.h> 12 #include <linux/netdevice.h> 13 #include <linux/pkt_sched.h> 14 #include <net/sch_generic.h> 15 #include <net/pkt_sched.h> 16 #include <net/pkt_cls.h> 17 18 struct drr_class { 19 struct Qdisc_class_common common; 20 unsigned int filter_cnt; 21 22 struct gnet_stats_basic_sync bstats; 23 struct gnet_stats_queue qstats; 24 struct net_rate_estimator __rcu *rate_est; 25 struct list_head alist; 26 struct Qdisc *qdisc; 27 28 u32 quantum; 29 u32 deficit; 30 }; 31 32 struct drr_sched { 33 struct list_head active; 34 struct tcf_proto __rcu *filter_list; 35 struct tcf_block *block; 36 struct Qdisc_class_hash clhash; 37 }; 38 39 static struct drr_class *drr_find_class(struct Qdisc *sch, u32 classid) 40 { 41 struct drr_sched *q = qdisc_priv(sch); 42 struct Qdisc_class_common *clc; 43 44 clc = qdisc_class_find(&q->clhash, classid); 45 if (clc == NULL) 46 return NULL; 47 return container_of(clc, struct drr_class, common); 48 } 49 50 static const struct nla_policy drr_policy[TCA_DRR_MAX + 1] = { 51 [TCA_DRR_QUANTUM] = { .type = NLA_U32 }, 52 }; 53 54 static int drr_change_class(struct Qdisc *sch, u32 classid, u32 parentid, 55 struct nlattr **tca, unsigned long *arg, 56 struct netlink_ext_ack *extack) 57 { 58 struct drr_sched *q = qdisc_priv(sch); 59 struct drr_class *cl = (struct drr_class *)*arg; 60 struct nlattr *opt = tca[TCA_OPTIONS]; 61 struct nlattr *tb[TCA_DRR_MAX + 1]; 62 u32 quantum; 63 int err; 64 65 if (!opt) { 66 NL_SET_ERR_MSG(extack, "DRR options are required for this operation"); 67 return -EINVAL; 68 } 69 70 err = nla_parse_nested_deprecated(tb, TCA_DRR_MAX, opt, drr_policy, 71 extack); 72 if (err < 0) 73 return err; 74 75 if (tb[TCA_DRR_QUANTUM]) { 76 quantum = nla_get_u32(tb[TCA_DRR_QUANTUM]); 77 if (quantum == 0) { 78 NL_SET_ERR_MSG(extack, "Specified DRR quantum cannot be zero"); 79 return -EINVAL; 80 } 81 } else 82 quantum = psched_mtu(qdisc_dev(sch)); 83 84 if (cl != NULL) { 85 if (tca[TCA_RATE]) { 86 err = gen_replace_estimator(&cl->bstats, NULL, 87 &cl->rate_est, 88 NULL, true, 89 tca[TCA_RATE]); 90 if (err) { 91 NL_SET_ERR_MSG(extack, "Failed to replace estimator"); 92 return err; 93 } 94 } 95 96 sch_tree_lock(sch); 97 if (tb[TCA_DRR_QUANTUM]) 98 cl->quantum = quantum; 99 sch_tree_unlock(sch); 100 101 return 0; 102 } 103 104 cl = kzalloc(sizeof(struct drr_class), GFP_KERNEL); 105 if (cl == NULL) 106 return -ENOBUFS; 107 108 gnet_stats_basic_sync_init(&cl->bstats); 109 cl->common.classid = classid; 110 cl->quantum = quantum; 111 cl->qdisc = qdisc_create_dflt(sch->dev_queue, 112 &pfifo_qdisc_ops, classid, 113 NULL); 114 if (cl->qdisc == NULL) 115 cl->qdisc = &noop_qdisc; 116 else 117 qdisc_hash_add(cl->qdisc, true); 118 119 if (tca[TCA_RATE]) { 120 err = gen_replace_estimator(&cl->bstats, NULL, &cl->rate_est, 121 NULL, true, tca[TCA_RATE]); 122 if (err) { 123 NL_SET_ERR_MSG(extack, "Failed to replace estimator"); 124 qdisc_put(cl->qdisc); 125 kfree(cl); 126 return err; 127 } 128 } 129 130 sch_tree_lock(sch); 131 qdisc_class_hash_insert(&q->clhash, &cl->common); 132 sch_tree_unlock(sch); 133 134 qdisc_class_hash_grow(sch, &q->clhash); 135 136 *arg = (unsigned long)cl; 137 return 0; 138 } 139 140 static void drr_destroy_class(struct Qdisc *sch, struct drr_class *cl) 141 { 142 gen_kill_estimator(&cl->rate_est); 143 qdisc_put(cl->qdisc); 144 kfree(cl); 145 } 146 147 static int drr_delete_class(struct Qdisc *sch, unsigned long arg, 148 struct netlink_ext_ack *extack) 149 { 150 struct drr_sched *q = qdisc_priv(sch); 151 struct drr_class *cl = (struct drr_class *)arg; 152 153 if (cl->filter_cnt > 0) 154 return -EBUSY; 155 156 sch_tree_lock(sch); 157 158 qdisc_purge_queue(cl->qdisc); 159 qdisc_class_hash_remove(&q->clhash, &cl->common); 160 161 sch_tree_unlock(sch); 162 163 drr_destroy_class(sch, cl); 164 return 0; 165 } 166 167 static unsigned long drr_search_class(struct Qdisc *sch, u32 classid) 168 { 169 return (unsigned long)drr_find_class(sch, classid); 170 } 171 172 static struct tcf_block *drr_tcf_block(struct Qdisc *sch, unsigned long cl, 173 struct netlink_ext_ack *extack) 174 { 175 struct drr_sched *q = qdisc_priv(sch); 176 177 if (cl) { 178 NL_SET_ERR_MSG(extack, "DRR classid must be zero"); 179 return NULL; 180 } 181 182 return q->block; 183 } 184 185 static unsigned long drr_bind_tcf(struct Qdisc *sch, unsigned long parent, 186 u32 classid) 187 { 188 struct drr_class *cl = drr_find_class(sch, classid); 189 190 if (cl != NULL) 191 cl->filter_cnt++; 192 193 return (unsigned long)cl; 194 } 195 196 static void drr_unbind_tcf(struct Qdisc *sch, unsigned long arg) 197 { 198 struct drr_class *cl = (struct drr_class *)arg; 199 200 cl->filter_cnt--; 201 } 202 203 static int drr_graft_class(struct Qdisc *sch, unsigned long arg, 204 struct Qdisc *new, struct Qdisc **old, 205 struct netlink_ext_ack *extack) 206 { 207 struct drr_class *cl = (struct drr_class *)arg; 208 209 if (new == NULL) { 210 new = qdisc_create_dflt(sch->dev_queue, &pfifo_qdisc_ops, 211 cl->common.classid, NULL); 212 if (new == NULL) 213 new = &noop_qdisc; 214 } 215 216 *old = qdisc_replace(sch, new, &cl->qdisc); 217 return 0; 218 } 219 220 static struct Qdisc *drr_class_leaf(struct Qdisc *sch, unsigned long arg) 221 { 222 struct drr_class *cl = (struct drr_class *)arg; 223 224 return cl->qdisc; 225 } 226 227 static void drr_qlen_notify(struct Qdisc *csh, unsigned long arg) 228 { 229 struct drr_class *cl = (struct drr_class *)arg; 230 231 list_del(&cl->alist); 232 } 233 234 static int drr_dump_class(struct Qdisc *sch, unsigned long arg, 235 struct sk_buff *skb, struct tcmsg *tcm) 236 { 237 struct drr_class *cl = (struct drr_class *)arg; 238 struct nlattr *nest; 239 240 tcm->tcm_parent = TC_H_ROOT; 241 tcm->tcm_handle = cl->common.classid; 242 tcm->tcm_info = cl->qdisc->handle; 243 244 nest = nla_nest_start_noflag(skb, TCA_OPTIONS); 245 if (nest == NULL) 246 goto nla_put_failure; 247 if (nla_put_u32(skb, TCA_DRR_QUANTUM, cl->quantum)) 248 goto nla_put_failure; 249 return nla_nest_end(skb, nest); 250 251 nla_put_failure: 252 nla_nest_cancel(skb, nest); 253 return -EMSGSIZE; 254 } 255 256 static int drr_dump_class_stats(struct Qdisc *sch, unsigned long arg, 257 struct gnet_dump *d) 258 { 259 struct drr_class *cl = (struct drr_class *)arg; 260 __u32 qlen = qdisc_qlen_sum(cl->qdisc); 261 struct Qdisc *cl_q = cl->qdisc; 262 struct tc_drr_stats xstats; 263 264 memset(&xstats, 0, sizeof(xstats)); 265 if (qlen) 266 xstats.deficit = cl->deficit; 267 268 if (gnet_stats_copy_basic(d, NULL, &cl->bstats, true) < 0 || 269 gnet_stats_copy_rate_est(d, &cl->rate_est) < 0 || 270 gnet_stats_copy_queue(d, cl_q->cpu_qstats, &cl_q->qstats, qlen) < 0) 271 return -1; 272 273 return gnet_stats_copy_app(d, &xstats, sizeof(xstats)); 274 } 275 276 static void drr_walk(struct Qdisc *sch, struct qdisc_walker *arg) 277 { 278 struct drr_sched *q = qdisc_priv(sch); 279 struct drr_class *cl; 280 unsigned int i; 281 282 if (arg->stop) 283 return; 284 285 for (i = 0; i < q->clhash.hashsize; i++) { 286 hlist_for_each_entry(cl, &q->clhash.hash[i], common.hnode) { 287 if (!tc_qdisc_stats_dump(sch, (unsigned long)cl, arg)) 288 return; 289 } 290 } 291 } 292 293 static struct drr_class *drr_classify(struct sk_buff *skb, struct Qdisc *sch, 294 int *qerr) 295 { 296 struct drr_sched *q = qdisc_priv(sch); 297 struct drr_class *cl; 298 struct tcf_result res; 299 struct tcf_proto *fl; 300 int result; 301 302 if (TC_H_MAJ(skb->priority ^ sch->handle) == 0) { 303 cl = drr_find_class(sch, skb->priority); 304 if (cl != NULL) 305 return cl; 306 } 307 308 *qerr = NET_XMIT_SUCCESS | __NET_XMIT_BYPASS; 309 fl = rcu_dereference_bh(q->filter_list); 310 result = tcf_classify(skb, NULL, fl, &res, false); 311 if (result >= 0) { 312 #ifdef CONFIG_NET_CLS_ACT 313 switch (result) { 314 case TC_ACT_QUEUED: 315 case TC_ACT_STOLEN: 316 case TC_ACT_TRAP: 317 *qerr = NET_XMIT_SUCCESS | __NET_XMIT_STOLEN; 318 fallthrough; 319 case TC_ACT_SHOT: 320 return NULL; 321 } 322 #endif 323 cl = (struct drr_class *)res.class; 324 if (cl == NULL) 325 cl = drr_find_class(sch, res.classid); 326 return cl; 327 } 328 return NULL; 329 } 330 331 static int drr_enqueue(struct sk_buff *skb, struct Qdisc *sch, 332 struct sk_buff **to_free) 333 { 334 unsigned int len = qdisc_pkt_len(skb); 335 struct drr_sched *q = qdisc_priv(sch); 336 struct drr_class *cl; 337 int err = 0; 338 bool first; 339 340 cl = drr_classify(skb, sch, &err); 341 if (cl == NULL) { 342 if (err & __NET_XMIT_BYPASS) 343 qdisc_qstats_drop(sch); 344 __qdisc_drop(skb, to_free); 345 return err; 346 } 347 348 first = !cl->qdisc->q.qlen; 349 err = qdisc_enqueue(skb, cl->qdisc, to_free); 350 if (unlikely(err != NET_XMIT_SUCCESS)) { 351 if (net_xmit_drop_count(err)) { 352 cl->qstats.drops++; 353 qdisc_qstats_drop(sch); 354 } 355 return err; 356 } 357 358 if (first) { 359 list_add_tail(&cl->alist, &q->active); 360 cl->deficit = cl->quantum; 361 } 362 363 sch->qstats.backlog += len; 364 sch->q.qlen++; 365 return err; 366 } 367 368 static struct sk_buff *drr_dequeue(struct Qdisc *sch) 369 { 370 struct drr_sched *q = qdisc_priv(sch); 371 struct drr_class *cl; 372 struct sk_buff *skb; 373 unsigned int len; 374 375 if (list_empty(&q->active)) 376 goto out; 377 while (1) { 378 cl = list_first_entry(&q->active, struct drr_class, alist); 379 skb = cl->qdisc->ops->peek(cl->qdisc); 380 if (skb == NULL) { 381 qdisc_warn_nonwc(__func__, cl->qdisc); 382 goto out; 383 } 384 385 len = qdisc_pkt_len(skb); 386 if (len <= cl->deficit) { 387 cl->deficit -= len; 388 skb = qdisc_dequeue_peeked(cl->qdisc); 389 if (unlikely(skb == NULL)) 390 goto out; 391 if (cl->qdisc->q.qlen == 0) 392 list_del(&cl->alist); 393 394 bstats_update(&cl->bstats, skb); 395 qdisc_bstats_update(sch, skb); 396 qdisc_qstats_backlog_dec(sch, skb); 397 sch->q.qlen--; 398 return skb; 399 } 400 401 cl->deficit += cl->quantum; 402 list_move_tail(&cl->alist, &q->active); 403 } 404 out: 405 return NULL; 406 } 407 408 static int drr_init_qdisc(struct Qdisc *sch, struct nlattr *opt, 409 struct netlink_ext_ack *extack) 410 { 411 struct drr_sched *q = qdisc_priv(sch); 412 int err; 413 414 err = tcf_block_get(&q->block, &q->filter_list, sch, extack); 415 if (err) 416 return err; 417 err = qdisc_class_hash_init(&q->clhash); 418 if (err < 0) 419 return err; 420 INIT_LIST_HEAD(&q->active); 421 return 0; 422 } 423 424 static void drr_reset_qdisc(struct Qdisc *sch) 425 { 426 struct drr_sched *q = qdisc_priv(sch); 427 struct drr_class *cl; 428 unsigned int i; 429 430 for (i = 0; i < q->clhash.hashsize; i++) { 431 hlist_for_each_entry(cl, &q->clhash.hash[i], common.hnode) { 432 if (cl->qdisc->q.qlen) 433 list_del(&cl->alist); 434 qdisc_reset(cl->qdisc); 435 } 436 } 437 } 438 439 static void drr_destroy_qdisc(struct Qdisc *sch) 440 { 441 struct drr_sched *q = qdisc_priv(sch); 442 struct drr_class *cl; 443 struct hlist_node *next; 444 unsigned int i; 445 446 tcf_block_put(q->block); 447 448 for (i = 0; i < q->clhash.hashsize; i++) { 449 hlist_for_each_entry_safe(cl, next, &q->clhash.hash[i], 450 common.hnode) 451 drr_destroy_class(sch, cl); 452 } 453 qdisc_class_hash_destroy(&q->clhash); 454 } 455 456 static const struct Qdisc_class_ops drr_class_ops = { 457 .change = drr_change_class, 458 .delete = drr_delete_class, 459 .find = drr_search_class, 460 .tcf_block = drr_tcf_block, 461 .bind_tcf = drr_bind_tcf, 462 .unbind_tcf = drr_unbind_tcf, 463 .graft = drr_graft_class, 464 .leaf = drr_class_leaf, 465 .qlen_notify = drr_qlen_notify, 466 .dump = drr_dump_class, 467 .dump_stats = drr_dump_class_stats, 468 .walk = drr_walk, 469 }; 470 471 static struct Qdisc_ops drr_qdisc_ops __read_mostly = { 472 .cl_ops = &drr_class_ops, 473 .id = "drr", 474 .priv_size = sizeof(struct drr_sched), 475 .enqueue = drr_enqueue, 476 .dequeue = drr_dequeue, 477 .peek = qdisc_peek_dequeued, 478 .init = drr_init_qdisc, 479 .reset = drr_reset_qdisc, 480 .destroy = drr_destroy_qdisc, 481 .owner = THIS_MODULE, 482 }; 483 484 static int __init drr_init(void) 485 { 486 return register_qdisc(&drr_qdisc_ops); 487 } 488 489 static void __exit drr_exit(void) 490 { 491 unregister_qdisc(&drr_qdisc_ops); 492 } 493 494 module_init(drr_init); 495 module_exit(drr_exit); 496 MODULE_LICENSE("GPL"); 497