DCB-APPTRUST(8)

๐Ÿ“ฆ
version 7.3.0 ยท 2 versions
, in alpine 3.24, arch rolling, centos-stream 10, nixos 26.05, nixpkgs unstable, ubuntu stonking

๐Ÿ’… dcb-apptrust โ€” the DCB (Data Center Bridging) manual page, section 8, Linux edition โœจ

okay bestie, so this is dcb-apptrust from section 8 of the Linux manual, and it's literally the tool that shows + configures the per-selector trust and the trust order of the Application Priority Table of the DCB (Data Center Bridging) subsystem. iykyk. ๐Ÿฆ‹


โœจ NAME โœจ

dcb-apptrust โ€” show / configure per-selector trust and trust order of the application priority table of the DCB (Data Center Bridging) subsystem. periodt. ๐Ÿ’…


๐ŸŒธ SYNOPSIS ๐ŸŒธ

dcb [ OPTIONS ] apptrust { COMMAND | help }

dcb apptrust show dev DEV [ order ]

dcb apptrust set dev DEV [ order SEL-LIST ]

SEL-LIST := [ SEL-LIST ] SEL

SEL := { ethtype | stream-port | dgram-port | port | dscp | pcp }

๐ŸŽ€ DESCRIPTION ๐ŸŽ€

so dcb apptrust is the one you call when you wanna configure per-selector trust and the trust order of the Application Priority Table. and if you're like "wait, what even is the app table" โ€” bestie, go read dcb-app(8), it explains how to configure app table entries. no cap. ๐Ÿ“–

now, why do you care about selector trust? the software stack or the drivers (ngl, most likely the drivers) use it when they're querying the APP table, to figure out whether an APP entry should actually take effect or not. vibe check on your entries, essentially.

and there's more: the order of the trusted selectors is what decides which selector takes precedence when you've got multiple different APP table selectors hanging out at the same time. so it's giving "who's the main character here" energy, and the order is the answer. ๐Ÿ‘‘


๐Ÿ’– COMMANDS ๐Ÿ’–

  • show โ€” displays all trusted selectors. the receipts, basically. ๐Ÿงพ
  • set โ€” sets a new list of trusted selectors. heads up: an empty list is effectively the same as removing trust entirely. so like, giving someone the silent treatment but for selectors. ๐Ÿ’€

๐ŸŒˆ PARAMETERS ๐ŸŒˆ

okay so this part only describes the write direction, i.e. how you use it with the set command. for the show command, you just use the parameter name as a simple keyword with no extra arguments โ€” that's you telling the tool "show me the values of this parameter, pls". ๐Ÿซถ

  • order SEL-LIST โ€” SEL-LIST is a space-separated list of selector names. the possible selector values are: ethtype, stream-port, dgram-port, port, dscp, and pcp.

โญ EXAMPLE & USAGE โญ

set trust order to: dscp, pcp for eth0:

# dcb apptrust set dev eth0 order dscp pcp

set trust order to: port (stream or dgram), pcp, ethtype for eth1:

# dcb apptrust set dev eth1 order port pcp ethtype

show what was set:

# dcb apptrust show dev eth0
order: port pcp ethtype

slay. that's it, that's the whole workflow. โœจ


๐Ÿฆ‹ EXIT STATUS ๐Ÿฆ‹

exit status is 0 if the command was successful, or a positive integer upon failure. so 0 = we ate, anything else = we did not eat. ๐Ÿ˜ญ


๐Ÿ‘‘ SEE ALSO ๐Ÿ‘‘

go read those, bestie, they're the lore. ๐Ÿ“š


๐Ÿ™ˆ REPORTING BUGS ๐Ÿ™ˆ

found a bug? report it to the Network Developers mailing list <netdev@vger.kernel.org> โ€” that's where the development and maintenance is primarily done. and the best part: you do not have to be subscribed to the list to send a message there. so no gatekeeping, just send it. ๐Ÿซถ


๐Ÿ’œ AUTHOR ๐Ÿ’œ

Daniel Machon <daniel.machon@microchip.com>


ok that's the whole page, you're officially a DCB apptrust girlie now ๐Ÿ’…

this was iproute2, dated 22 November 2022 โ€” bye bestie, go configure some trust orders ๐ŸŽ€โœจ

๐Ÿ“ฆ where this page comes from