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