nl-qdisc-add.8 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118
  1. .TH nl\-qdisc 8 "21 October 2010" "libnl"
  2. .SH NAME
  3. nl\-qdisc\-{add|list|delete} - Manage queueing disciplines
  4. .SH SYNOPSIS
  5. .B nl\-qdisc\-add \-\-dev
  6. .I dev
  7. .B \-\-parent
  8. .I id
  9. .B [OPTIONS]
  10. .I qdisc-type
  11. .B [QDISC]
  12. .sp
  13. .B nl\-qdisc\-delete [ \-\-interactive ] [OPTIONS]
  14. .sp
  15. .B nl\-qdisc\-list [OPTIONS]
  16. .SH DESCRIPTION
  17. .PP
  18. The nl\-qdisc tools allow to manage and configure queueing disciplines
  19. (qdiscs) in the kernel.
  20. .SH OPTIONS
  21. .TP
  22. .BR \-\^h " or " \-\-help
  23. Print help text to console and exit.
  24. .TP
  25. .BR \-\^v " or " \-\-version
  26. Print versioning information to console and exit.
  27. .TP
  28. .BR \-\^q " or " \-\-quiet
  29. Do not print informal notifications about actions taken to the console.
  30. By default a short description of each qdisc added/update/deleted will
  31. be printed to the console. This option disables this behaviour.
  32. .TP
  33. .BR \-\^d " or " \-\-dev "=DEV"
  34. Network device the qdisc is attached to.
  35. .TP
  36. .BR \-\^p " or " \-\-parent "=ID"
  37. Identifier of the parent qdisc/class this qdisc is attached to. The
  38. identifier can be specified as classid, name or one of the special
  39. values "root" or "ingress".
  40. .TP
  41. .BR \-\^i " or " \-\-id "=ID"
  42. Identifier of qdisc. It can be specified as classid or name.
  43. .SS nl\-qdisc\-add Options
  44. .TP
  45. .B \-\-update
  46. Update qdisc if it already exists, otherwise attempting to add a qdisc which already
  47. exists will result in an error. This does not include changing the type of the qdisc,
  48. use \-\-replace if you wish to do so.
  49. .TP
  50. .B \-\-replace
  51. Replace or update qdisc if it already exists. Same behaviour as \-\-update but will
  52. completely replace the qdisc if it exists already.
  53. .TP
  54. .B \-\-update\-only
  55. Update an existing qdisc but do not create it if it does not exist.
  56. .TP
  57. .B \-\-replace\-only
  58. Update or replace an existing qdisc but do not create it if it does exist.
  59. .SS nl\-qdisc\-delete Options
  60. .TP
  61. .B \-\-interactive
  62. The interactive mode requires confirmation by the user for each qdisc deleted. It
  63. will print a prompt for each qdisc matching the provided filter and requires the
  64. user to answer 'y'es or 'n'o.
  65. .TP
  66. .B \-\-yes
  67. Make the default answer for interactive prompts be 'y'es. This option is also
  68. required to delete all qdiscs on all network devices.
  69. .TP
  70. .BR \-\^k " or " \-\-kind "=TYPE"
  71. Only delete qdiscs of this type.
  72. .SS nl\-qdisc\-list Options
  73. .TP
  74. .B \-\-details
  75. Show detailed information for each qdisc listed.
  76. .TP
  77. .B \-\-stats
  78. Show statistics information for each qdisc listed. This option will also turn
  79. on detailed information automatically.
  80. .TP
  81. .BR \-\^r " or " \-\-recursive
  82. List all TC objects recurisvely attached to all qdiscs matching the filter.
  83. .TP
  84. .BR \-\^k " or " \-\-kind "=TYPE"
  85. Only list qdiscs of this type.
  86. .SH USAGE
  87. .PP
  88. Add a HTB root qdisc with id "5:":
  89. .PP
  90. .RS
  91. nl\-qdisc\-add \-\-dev eth0 \-\-parent root \-\-id 5: htb
  92. .RE
  93. .PP
  94. List all qdiscs on eth0 and print statistical data:
  95. .PP
  96. .RS
  97. nl\-qdisc\-list \-\-stats \-\-dev eth0
  98. .RE
  99. .PP
  100. Delete the qdisc "5:":
  101. .RS
  102. nl\-qdisc\-delete \-\-id 5:
  103. .RE
  104. .SH "SEE ALSO"
  105. .PP
  106. .B nl\-classid\-lookup(8)
  107. .SH AUTHOR
  108. .PP
  109. Thomas Graf is the original author and current maintainer of libnl and
  110. libnl tools. Many people have contributed to it since.