htb.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553
  1. /*
  2. * lib/route/sch/htb.c HTB Qdisc
  3. *
  4. * This library is free software; you can redistribute it and/or
  5. * modify it under the terms of the GNU Lesser General Public
  6. * License as published by the Free Software Foundation version 2.1
  7. * of the License.
  8. *
  9. * Copyright (c) 2003-2006 Thomas Graf <tgraf@suug.ch>
  10. * Copyright (c) 2005-2006 Petr Gotthard <petr.gotthard@siemens.com>
  11. * Copyright (c) 2005-2006 Siemens AG Oesterreich
  12. */
  13. /**
  14. * @ingroup qdisc_api
  15. * @ingroup class_api
  16. * @defgroup htb Hierachical Token Bucket (HTB)
  17. * @{
  18. */
  19. #include <netlink-local.h>
  20. #include <netlink-tc.h>
  21. #include <netlink/netlink.h>
  22. #include <netlink/cache.h>
  23. #include <netlink/utils.h>
  24. #include <netlink/route/tc.h>
  25. #include <netlink/route/qdisc.h>
  26. #include <netlink/route/qdisc-modules.h>
  27. #include <netlink/route/class.h>
  28. #include <netlink/route/class-modules.h>
  29. #include <netlink/route/link.h>
  30. #include <netlink/route/sch/htb.h>
  31. /** @cond SKIP */
  32. #define SCH_HTB_HAS_RATE2QUANTUM 0x01
  33. #define SCH_HTB_HAS_DEFCLS 0x02
  34. #define SCH_HTB_HAS_PRIO 0x001
  35. #define SCH_HTB_HAS_MTU 0x002
  36. #define SCH_HTB_HAS_RATE 0x004
  37. #define SCH_HTB_HAS_CEIL 0x008
  38. #define SCH_HTB_HAS_RBUFFER 0x010
  39. #define SCH_HTB_HAS_CBUFFER 0x020
  40. #define SCH_HTB_HAS_QUANTUM 0x040
  41. #define SCH_HTB_HAS_OVERHEAD 0x080
  42. #define SCH_HTB_HAS_MPU 0x100
  43. /** @endcond */
  44. static inline struct rtnl_htb_qdisc *htb_qdisc(struct rtnl_qdisc *qdisc)
  45. {
  46. if (qdisc->q_subdata == NULL)
  47. qdisc->q_subdata = calloc(1, sizeof(struct rtnl_htb_qdisc));
  48. return (struct rtnl_htb_qdisc *) qdisc->q_subdata;
  49. }
  50. static struct nla_policy htb_policy[TCA_HTB_MAX+1] = {
  51. [TCA_HTB_INIT] = { .minlen = sizeof(struct tc_htb_glob) },
  52. [TCA_HTB_PARMS] = { .minlen = sizeof(struct tc_htb_opt) },
  53. };
  54. static int htb_qdisc_msg_parser(struct rtnl_qdisc *qdisc)
  55. {
  56. int err;
  57. struct nlattr *tb[TCA_HTB_MAX + 1];
  58. struct rtnl_htb_qdisc *d;
  59. err = tca_parse(tb, TCA_HTB_MAX, (struct rtnl_tca *) qdisc, htb_policy);
  60. if (err < 0)
  61. return err;
  62. d = htb_qdisc(qdisc);
  63. if (tb[TCA_HTB_INIT]) {
  64. struct tc_htb_glob opts;
  65. nla_memcpy(&opts, tb[TCA_HTB_INIT], sizeof(opts));
  66. d->qh_rate2quantum = opts.rate2quantum;
  67. d->qh_defcls = opts.defcls;
  68. d->qh_mask = (SCH_HTB_HAS_RATE2QUANTUM | SCH_HTB_HAS_DEFCLS);
  69. }
  70. return 0;
  71. }
  72. static void htb_qdisc_free_data(struct rtnl_qdisc *qdisc)
  73. {
  74. free(qdisc->q_subdata);
  75. }
  76. static inline struct rtnl_htb_class *htb_class(struct rtnl_class *class)
  77. {
  78. if (class->c_subdata == NULL)
  79. class->c_subdata = calloc(1, sizeof(struct rtnl_htb_class));
  80. return (struct rtnl_htb_class *) class->c_subdata;
  81. }
  82. static int htb_class_msg_parser(struct rtnl_class *class)
  83. {
  84. int err;
  85. struct nlattr *tb[TCA_HTB_MAX + 1];
  86. struct rtnl_htb_class *d;
  87. err = tca_parse(tb, TCA_HTB_MAX, (struct rtnl_tca *) class, htb_policy);
  88. if (err < 0)
  89. return err;
  90. d = htb_class(class);
  91. if (tb[TCA_HTB_PARMS]) {
  92. struct tc_htb_opt opts;
  93. nla_memcpy(&opts, tb[TCA_HTB_PARMS], sizeof(opts));
  94. d->ch_prio = opts.prio;
  95. rtnl_copy_ratespec(&d->ch_rate, &opts.rate);
  96. rtnl_copy_ratespec(&d->ch_ceil, &opts.ceil);
  97. d->ch_rbuffer = rtnl_tc_calc_bufsize(opts.buffer, opts.rate.rate);
  98. d->ch_cbuffer = rtnl_tc_calc_bufsize(opts.cbuffer, opts.ceil.rate);
  99. d->ch_quantum = opts.quantum;
  100. d->ch_overhead = (opts.rate.mpu >> 8) & 0xff;
  101. d->ch_mpu = opts.rate.mpu & 0xff;
  102. d->ch_mask = (SCH_HTB_HAS_PRIO | SCH_HTB_HAS_RATE |
  103. SCH_HTB_HAS_CEIL | SCH_HTB_HAS_RBUFFER |
  104. SCH_HTB_HAS_CBUFFER | SCH_HTB_HAS_QUANTUM |
  105. SCH_HTB_HAS_OVERHEAD | SCH_HTB_HAS_MPU);
  106. }
  107. return 0;
  108. }
  109. static void htb_class_free_data(struct rtnl_class *class)
  110. {
  111. free(class->c_subdata);
  112. }
  113. static int htb_qdisc_dump_brief(struct rtnl_qdisc *qdisc,
  114. struct nl_dump_params *p, int line)
  115. {
  116. struct rtnl_htb_qdisc *d = (struct rtnl_htb_qdisc *) qdisc->q_subdata;
  117. if (d == NULL)
  118. goto ignore;
  119. if (d->qh_mask & SCH_HTB_HAS_RATE2QUANTUM)
  120. dp_dump(p, " r2q %u", d->qh_rate2quantum);
  121. if (d->qh_mask & SCH_HTB_HAS_DEFCLS) {
  122. char buf[32];
  123. dp_dump(p, " default %s",
  124. rtnl_tc_handle2str(d->qh_defcls, buf, sizeof(buf)));
  125. }
  126. ignore:
  127. return line;
  128. }
  129. static int htb_class_dump_brief(struct rtnl_class *class,
  130. struct nl_dump_params *p, int line)
  131. {
  132. struct rtnl_htb_class *d = (struct rtnl_htb_class *) class->c_subdata;
  133. if (d == NULL)
  134. goto ignore;
  135. if (d->ch_mask & SCH_HTB_HAS_RATE) {
  136. double r, rbit;
  137. char *ru, *rubit;
  138. r = nl_cancel_down_bytes(d->ch_rate.rs_rate, &ru);
  139. rbit = nl_cancel_down_bits(d->ch_rate.rs_rate*8, &rubit);
  140. dp_dump(p, " rate %.2f%s/s (%.0f%s) log %u",
  141. r, ru, rbit, rubit, 1<<d->ch_rate.rs_cell_log);
  142. }
  143. ignore:
  144. return line;
  145. }
  146. static int htb_class_dump_full(struct rtnl_class *class,
  147. struct nl_dump_params *p, int line)
  148. {
  149. struct rtnl_htb_class *d = (struct rtnl_htb_class *) class->c_subdata;
  150. if (d == NULL)
  151. goto ignore;
  152. /* line 1 */
  153. if (d->ch_mask & SCH_HTB_HAS_CEIL) {
  154. double r, rbit;
  155. char *ru, *rubit;
  156. r = nl_cancel_down_bytes(d->ch_ceil.rs_rate, &ru);
  157. rbit = nl_cancel_down_bits(d->ch_ceil.rs_rate*8, &rubit);
  158. dp_dump(p, " ceil %.2f%s/s (%.0f%s) log %u",
  159. r, ru, rbit, rubit, 1<<d->ch_ceil.rs_cell_log);
  160. }
  161. if (d->ch_mask & SCH_HTB_HAS_PRIO)
  162. dp_dump(p, " prio %u", d->ch_prio);
  163. if (d->ch_mask & SCH_HTB_HAS_MTU)
  164. dp_dump(p, " mtu %u", d->ch_mtu);
  165. if (d->ch_mask & SCH_HTB_HAS_RBUFFER) {
  166. double b;
  167. char *bu;
  168. b = nl_cancel_down_bytes(d->ch_rbuffer, &bu);
  169. dp_dump(p, " rbuffer %.2f%s", b, bu);
  170. }
  171. if (d->ch_mask & SCH_HTB_HAS_CBUFFER) {
  172. double b;
  173. char *bu;
  174. b = nl_cancel_down_bytes(d->ch_cbuffer, &bu);
  175. dp_dump(p, " cbuffer %.2f%s", b, bu);
  176. }
  177. if (d->ch_mask & SCH_HTB_HAS_QUANTUM)
  178. dp_dump(p, " quantum %u", d->ch_quantum);
  179. if (d->ch_mask & SCH_HTB_HAS_OVERHEAD)
  180. dp_dump(p, " overhead %u", d->ch_overhead);
  181. if (d->ch_mask & SCH_HTB_HAS_MPU)
  182. dp_dump(p, " mpu %u", d->ch_mpu);
  183. ignore:
  184. return line;
  185. }
  186. static struct nl_msg *htb_qdisc_get_opts(struct rtnl_qdisc *qdisc)
  187. {
  188. struct rtnl_htb_qdisc *d = (struct rtnl_htb_qdisc *) qdisc->q_subdata;
  189. struct tc_htb_glob opts;
  190. struct nl_msg *msg;
  191. if (d == NULL)
  192. return NULL;
  193. msg = nlmsg_alloc();
  194. if (msg == NULL)
  195. return NULL;
  196. memset(&opts, 0, sizeof(opts));
  197. opts.version = TC_HTB_PROTOVER;
  198. if (d->qh_mask & SCH_HTB_HAS_RATE2QUANTUM)
  199. opts.rate2quantum = d->qh_rate2quantum;
  200. if (d->qh_mask & SCH_HTB_HAS_DEFCLS)
  201. opts.defcls = d->qh_defcls;
  202. nla_put(msg, TCA_HTB_INIT, sizeof(opts), &opts);
  203. return msg;
  204. }
  205. static uint8_t compute_cell(uint32_t rate, uint32_t mtu)
  206. {
  207. uint8_t cell_log = 0;
  208. while (mtu > 255) {
  209. mtu >>= 1;
  210. cell_log++;
  211. }
  212. return cell_log;
  213. }
  214. static struct nl_msg *htb_class_get_opts(struct rtnl_class *class)
  215. {
  216. struct rtnl_htb_class *d = (struct rtnl_htb_class *) class->c_subdata;
  217. uint32_t mtu, rtable[RTNL_TC_RTABLE_SIZE], ctable[RTNL_TC_RTABLE_SIZE];
  218. struct tc_htb_opt opts;
  219. struct nl_msg *msg;
  220. int buffer, cbuffer;
  221. uint8_t overhead = 0, mpu = 0;
  222. if (d == NULL)
  223. return NULL;
  224. msg = nlmsg_alloc();
  225. memset(&opts, 0, sizeof(opts));
  226. /* if not set, zero (0) is used as priority */
  227. if (d->ch_mask & SCH_HTB_HAS_PRIO)
  228. opts.prio = d->ch_prio;
  229. if (d->ch_mask & SCH_HTB_HAS_MTU)
  230. mtu = d->ch_mtu;
  231. else
  232. mtu = 1600; /* eth packet len */
  233. if (!(d->ch_mask & SCH_HTB_HAS_RATE))
  234. BUG();
  235. rtnl_rcopy_ratespec(&opts.rate, &d->ch_rate);
  236. /* if cell_log not set, compute default value */
  237. if (opts.rate.cell_log == UINT8_MAX)
  238. opts.rate.cell_log = compute_cell(opts.rate.rate, mtu);
  239. /* if not set, configured rate is used as ceil, which implies no borrowing */
  240. if (d->ch_mask & SCH_HTB_HAS_CEIL)
  241. rtnl_rcopy_ratespec(&opts.ceil, &d->ch_ceil);
  242. else
  243. memcpy(&opts.ceil, &opts.rate, sizeof(struct tc_ratespec));
  244. /* if cell_log not set, compute default value */
  245. if (opts.ceil.cell_log == UINT8_MAX)
  246. opts.ceil.cell_log = compute_cell(opts.ceil.rate, mtu);
  247. if (d->ch_mask & SCH_HTB_HAS_RBUFFER)
  248. buffer = d->ch_rbuffer;
  249. else
  250. buffer = opts.rate.rate / nl_get_hz() + mtu;
  251. opts.buffer = rtnl_tc_calc_txtime(buffer, opts.rate.rate);
  252. if (d->ch_mask & SCH_HTB_HAS_CBUFFER)
  253. cbuffer = d->ch_cbuffer;
  254. else
  255. cbuffer = opts.ceil.rate / nl_get_hz() + mtu;
  256. opts.cbuffer = rtnl_tc_calc_txtime(cbuffer, opts.ceil.rate);
  257. if (d->ch_mask & SCH_HTB_HAS_QUANTUM)
  258. opts.quantum = d->ch_quantum;
  259. if (d->ch_mask & SCH_HTB_HAS_OVERHEAD)
  260. overhead = d->ch_overhead;
  261. if (d->ch_mask & SCH_HTB_HAS_MPU)
  262. mpu = d->ch_mpu;
  263. opts.rate.mpu = mpu | (overhead << 8);
  264. opts.ceil.mpu = mpu | (overhead << 8);
  265. nla_put(msg, TCA_HTB_PARMS, sizeof(opts), &opts);
  266. rtnl_tc_build_rate_table(rtable, mpu, overhead,
  267. 1 << opts.rate.cell_log,
  268. opts.rate.rate);
  269. nla_put(msg, TCA_HTB_RTAB, sizeof(rtable), &rtable);
  270. rtnl_tc_build_rate_table(ctable, mpu, overhead,
  271. 1 << opts.ceil.cell_log,
  272. opts.ceil.rate);
  273. nla_put(msg, TCA_HTB_CTAB, sizeof(ctable), &ctable);
  274. return msg;
  275. }
  276. /**
  277. * @name Attribute Modifications
  278. * @{
  279. */
  280. void rtnl_htb_set_rate2quantum(struct rtnl_qdisc *qdisc, uint32_t rate2quantum)
  281. {
  282. struct rtnl_htb_qdisc *d = htb_qdisc(qdisc);
  283. if (d == NULL)
  284. return;
  285. d->qh_rate2quantum = rate2quantum;
  286. d->qh_mask |= SCH_HTB_HAS_RATE2QUANTUM;
  287. }
  288. /**
  289. * Set default class of the htb qdisc to the specified value
  290. * @arg qdisc qdisc to change
  291. * @arg defcls new default class
  292. */
  293. void rtnl_htb_set_defcls(struct rtnl_qdisc *qdisc, uint32_t defcls)
  294. {
  295. struct rtnl_htb_qdisc *d = htb_qdisc(qdisc);
  296. if (d == NULL)
  297. return;
  298. d->qh_defcls = defcls;
  299. d->qh_mask |= SCH_HTB_HAS_DEFCLS;
  300. }
  301. void rtnl_htb_set_prio(struct rtnl_class *class, uint32_t prio)
  302. {
  303. struct rtnl_htb_class *d = htb_class(class);
  304. if (d == NULL)
  305. return;
  306. d->ch_prio = prio;
  307. d->ch_mask |= SCH_HTB_HAS_PRIO;
  308. }
  309. /**
  310. * Set MTU of the data link.
  311. * @arg class HTB class to be modified.
  312. * @arg mtu New MTU in bytes.
  313. *
  314. * Sets MTU of the data link controlled by the HTB class.
  315. * If not set, the Ethernet MTU (1600) is used.
  316. */
  317. void rtnl_htb_set_mtu(struct rtnl_class *class, uint32_t mtu)
  318. {
  319. struct rtnl_htb_class *d = htb_class(class);
  320. if (d == NULL)
  321. return;
  322. d->ch_mtu = mtu;
  323. d->ch_mask |= SCH_HTB_HAS_MTU;
  324. }
  325. /**
  326. * Set rate of HTB class.
  327. * @arg class HTB class to be modified.
  328. * @arg rate New rate in bytes per second.
  329. */
  330. void rtnl_htb_set_rate(struct rtnl_class *class, uint32_t rate)
  331. {
  332. struct rtnl_htb_class *d = htb_class(class);
  333. if (d == NULL)
  334. return;
  335. d->ch_rate.rs_cell_log = UINT8_MAX; /* use default value */
  336. d->ch_rate.rs_rate = rate;
  337. d->ch_mask |= SCH_HTB_HAS_RATE;
  338. }
  339. /**
  340. * Set ceil of HTB class.
  341. * @arg class HTB class to be modified.
  342. * @arg ceil New ceil in bytes per second.
  343. */
  344. void rtnl_htb_set_ceil(struct rtnl_class *class, uint32_t ceil)
  345. {
  346. struct rtnl_htb_class *d = htb_class(class);
  347. if (d == NULL)
  348. return;
  349. d->ch_ceil.rs_cell_log = UINT8_MAX; /* use default value */
  350. d->ch_ceil.rs_rate = ceil;
  351. d->ch_mask |= SCH_HTB_HAS_CEIL;
  352. }
  353. /**
  354. * Set size of the rate bucket of HTB class.
  355. * @arg class HTB class to be modified.
  356. * @arg rbuffer New size in bytes.
  357. */
  358. void rtnl_htb_set_rbuffer(struct rtnl_class *class, uint32_t rbuffer)
  359. {
  360. struct rtnl_htb_class *d = htb_class(class);
  361. if (d == NULL)
  362. return;
  363. d->ch_rbuffer = rbuffer;
  364. d->ch_mask |= SCH_HTB_HAS_RBUFFER;
  365. }
  366. /**
  367. * Set size of the ceil bucket of HTB class.
  368. * @arg class HTB class to be modified.
  369. * @arg cbuffer New size in bytes.
  370. */
  371. void rtnl_htb_set_cbuffer(struct rtnl_class *class, uint32_t cbuffer)
  372. {
  373. struct rtnl_htb_class *d = htb_class(class);
  374. if (d == NULL)
  375. return;
  376. d->ch_cbuffer = cbuffer;
  377. d->ch_mask |= SCH_HTB_HAS_CBUFFER;
  378. }
  379. /**
  380. * Set how much bytes to serve from leaf at once of HTB class {use r2q}.
  381. * @arg class HTB class to be modified.
  382. * @arg quantum New size in bytes.
  383. */
  384. void rtnl_htb_set_quantum(struct rtnl_class *class, uint32_t quantum)
  385. {
  386. struct rtnl_htb_class *d = htb_class(class);
  387. if (d == NULL)
  388. return;
  389. d->ch_quantum = quantum;
  390. d->ch_mask |= SCH_HTB_HAS_QUANTUM;
  391. }
  392. /**
  393. * Set per-packet size overhead used in rate computations of HTB class.
  394. * @arg class HTB class to be modified.
  395. * @arg overhead Size in bytes.
  396. */
  397. void rtnl_htb_set_overhead(struct rtnl_class *class, uint8_t overhead)
  398. {
  399. struct rtnl_htb_class *d = htb_class(class);
  400. if (d == NULL)
  401. return;
  402. d->ch_overhead = overhead;
  403. d->ch_mask |= SCH_HTB_HAS_OVERHEAD;
  404. }
  405. /**
  406. * Set the minimum packet size used in rate computations of HTB class.
  407. * @arg class HTB class to be modified.
  408. * @arg mpu Size in bytes.
  409. */
  410. void rtnl_htb_set_mpu(struct rtnl_class *class, uint8_t mpu)
  411. {
  412. struct rtnl_htb_class *d = htb_class(class);
  413. if (d == NULL)
  414. return;
  415. d->ch_mpu = mpu;
  416. d->ch_mask |= SCH_HTB_HAS_MPU;
  417. }
  418. /** @} */
  419. static struct rtnl_qdisc_ops htb_qdisc_ops = {
  420. .qo_kind = "htb",
  421. .qo_msg_parser = htb_qdisc_msg_parser,
  422. .qo_free_data = htb_qdisc_free_data,
  423. .qo_dump[NL_DUMP_BRIEF] = htb_qdisc_dump_brief,
  424. .qo_get_opts = htb_qdisc_get_opts,
  425. };
  426. static struct rtnl_class_ops htb_class_ops = {
  427. .co_kind = "htb",
  428. .co_msg_parser = htb_class_msg_parser,
  429. .co_free_data = htb_class_free_data,
  430. .co_dump[NL_DUMP_BRIEF] = htb_class_dump_brief,
  431. .co_dump[NL_DUMP_FULL] = htb_class_dump_full,
  432. .co_get_opts = htb_class_get_opts,
  433. };
  434. static void __init htb_init(void)
  435. {
  436. rtnl_qdisc_register(&htb_qdisc_ops);
  437. rtnl_class_register(&htb_class_ops);
  438. }
  439. static void __exit htb_exit(void)
  440. {
  441. rtnl_qdisc_unregister(&htb_qdisc_ops);
  442. rtnl_class_unregister(&htb_class_ops);
  443. }
  444. /** @} */