| 1 |
.TH DCB-APPTRUST 8 "22 November 2022" "iproute2" "Linux" |
| 2 |
.SH NAME |
| 3 |
dcb-apptrust \- show / configure per-selector trust and trust order of the |
| 4 |
application priority table of the DCB (Data Center Bridging) subsystem |
| 5 |
.SH SYNOPSIS |
| 6 |
.sp |
| 7 |
.ad l |
| 8 |
.in +8 |
| 9 |
|
| 10 |
.ti -8 |
| 11 |
.B dcb |
| 12 |
.RI "[ " OPTIONS " ] " |
| 13 |
.B apptrust |
| 14 |
.RI "{ " COMMAND " | " help " }" |
| 15 |
.sp |
| 16 |
|
| 17 |
.ti -8 |
| 18 |
.B dcb apptrust show dev |
| 19 |
.RI DEV |
| 20 |
.RB "[ " order " ]" |
| 21 |
|
| 22 |
.ti -8 |
| 23 |
.B dcb apptrust set dev |
| 24 |
.RI DEV |
| 25 |
.RB "[ " order " |
| 26 |
.IR "SEL-LIST" " ]" |
| 27 |
|
| 28 |
.ti -8 |
| 29 |
.IR SEL-LIST " := [ " SEL-LIST " ] " SEL |
| 30 |
|
| 31 |
.ti -8 |
| 32 |
.IR SEL " := { " ethtype " | " stream-port " | " dgram-port " | " port " | " dscp " | " pcp " } " |
| 33 |
|
| 34 |
.SH DESCRIPTION |
| 35 |
|
| 36 |
.B dcb apptrust |
| 37 |
is used to configure per-selector trust and trust order of the |
| 38 |
Application Priority Table, see |
| 39 |
.BR dcb-app (8) |
| 40 |
for details on how to configure app table entries. |
| 41 |
|
| 42 |
Selector trust can be used by the software stack or drivers (most likely the |
| 43 |
latter) when querying the APP table, to determine whether an APP entry should |
| 44 |
take effect. Additionally, the order of the trusted selectors dictates which |
| 45 |
selector should take precedence, in the case of multiple different APP table |
| 46 |
selectors being present. |
| 47 |
|
| 48 |
.SH COMMANDS |
| 49 |
|
| 50 |
.TP |
| 51 |
.B show |
| 52 |
Displays all trusted selectors. |
| 53 |
|
| 54 |
.TP |
| 55 |
.B set |
| 56 |
Sets a new list of trusted selectors. An empty list is effectively the same as |
| 57 |
removing trust entirely. |
| 58 |
|
| 59 |
.SH PARAMETERS |
| 60 |
|
| 61 |
The following describes only the write direction, i.e. as used with the |
| 62 |
\fBset\fR command. For the \fBshow\fR command, the parameter name is to be used |
| 63 |
as a simple keyword without further arguments. This instructs the tool to show |
| 64 |
the values of a given parameter. |
| 65 |
|
| 66 |
.TP |
| 67 |
.B order \fISEL-LIST |
| 68 |
\fISEL-LIST\fR is a space-separated list of selector names. Possible selector |
| 69 |
values are: |
| 70 |
.B ethtype, |
| 71 |
.B stream-port, |
| 72 |
.B dgram-port, |
| 73 |
.B port, |
| 74 |
.B dscp, |
| 75 |
and |
| 76 |
.B pcp |
| 77 |
|
| 78 |
|
| 79 |
.SH EXAMPLE & USAGE |
| 80 |
|
| 81 |
Set trust order to: dscp, pcp for eth0: |
| 82 |
.P |
| 83 |
# dcb apptrust set dev eth0 order dscp pcp |
| 84 |
|
| 85 |
Set trust order to: port (stream or dgram), pcp, ethtype for eth1: |
| 86 |
.P |
| 87 |
# dcb apptrust set dev eth1 order port pcp ethtype |
| 88 |
|
| 89 |
Show what was set: |
| 90 |
|
| 91 |
.P |
| 92 |
# dcb apptrust show dev eth0 |
| 93 |
.br |
| 94 |
order: port pcp ethtype |
| 95 |
|
| 96 |
.SH EXIT STATUS |
| 97 |
Exit status is 0 if command was successful or a positive integer upon failure. |
| 98 |
|
| 99 |
.SH SEE ALSO |
| 100 |
.BR dcb (8), |
| 101 |
.BR dcb-app (8) |
| 102 |
|
| 103 |
.SH REPORTING BUGS |
| 104 |
Report any bugs to the Network Developers mailing list |
| 105 |
.B <[email protected]> |
| 106 |
where the development and maintenance is primarily done. |
| 107 |
You do not have to be subscribed to the list to send a message there. |
| 108 |
|
| 109 |
.SH AUTHOR |
| 110 |
Daniel Machon <[email protected]> |