DEVLINK-TRAP(8)

🎀 DEVLINK-TRAP(8) 🎀

✨ NAME ✨

okay so devlink-trap is the manual page for devlink trap configuration 💅 it's how you poke at packet traps on your devices, bestie 🧚

💖 SYNOPSIS 💖

devlink [ OPTIONS ] trap { COMMAND | help }

OPTIONS := { -v[erbose] | -s[tatistics] }

devlink trap show [ DEV trap TRAP ]

devlink trap set DEV trap TRAP [ action { trap | drop | mirror } ]

devlink trap group show [ DEV group GROUP ]

devlink trap group set DEV group GROUP [ action { trap | drop | mirror } ] [ policer POLICER ] [ nopolicer ]

devlink trap policer set DEV policer POLICER [ rate RATE ] [ burst BURST ]

devlink trap help

🦋 DESCRIPTION 🦋

🌸 devlink trap show - display available packet traps and their attributes

DEV - tells it which devlink device to show packet traps from. Leave this out and you get every packet trap on every device, periodt 💅

trap TRAP - picks out one specific packet trap. This only works if you also name a devlink device 🫶

🔥 devlink trap set - set attributes of a packet trap

DEV - the devlink device that owns the packet trap 👑

trap TRAP - the packet trap you want to change ✨

action { trap | drop | mirror } - the packet trap action 💀

• trap - the one and only copy of the packet goes up to the CPU 🫶
• drop - the underlying device drops the packet and nothing gets sent to the CPU 😭
• mirror - the underlying device forwards the packet and a copy also gets sent to the CPU 🦋

🌈 devlink trap group show - display available packet trap groups and their attributes

DEV - the devlink device to show packet trap groups from. Skip it and you get all packet trap groups from all devices 🧚

group GROUP - picks out one specific packet trap group. Only works if you also name a devlink device 💖

🍓 devlink trap group set - set attributes of a packet trap group

DEV - the devlink device that owns the packet trap group 👑

group GROUP - the packet trap group you want to change 🎀

action { trap | drop | mirror } - the packet trap action. It gets applied to every packet trap in the group, but the actions of non-drop traps can't be changed, so those get skipped 🙈

policer POLICER - the packet trap policer you want to attach to this group. Set it to "0" and whatever policer is currently attached gets unbound 🌸

nopolicer - unbinds the packet trap policer from the packet trap group 💅

⭐ devlink trap policer set - set attributes of packet trap policer

DEV - the devlink device that owns the packet trap policer 👑

policer POLICER - the packet trap policer you want to change ✨

rate RATE - the packet trap policer rate, in packets per second 🫧

burst BURST - the packet trap policer burst size, in packets 💜

🎀 EXAMPLES 🎀

Here's how it looks in action, bestie 🧚

devlink trap show

List available packet traps. 💖

devlink trap group show

List available packet trap groups. 🌈

devlink -vs trap show pci/0000:01:00.0 trap source_mac_is_multicast

Show attributes and statistics of a specific packet trap. ✨

devlink -s trap group show pci/0000:01:00.0 group l2_drops

Show attributes and statistics of a specific packet trap group. 🦋

devlink trap set pci/0000:01:00.0 trap source_mac_is_multicast action trap

Set the action of a specific packet trap to 'trap'. 🔥

devlink trap policer show

List available packet trap policers. 🍓

devlink -s trap policer show pci/0000:01:00.0 policer 1

Show attributes and statistics of a specific packet trap policer. 💜

devlink trap policer set pci/0000:01:00.0 policer 1 rate 1000 burst 128

Set the rate and burst size of a specific packet trap policer. 👑

🌸 SEE ALSO 🌸

devlink(8), devlink-dev(8), devlink-monitor(8),

🫶 AUTHOR 🫶

Ido Schimmel <idosch@mellanox.com>

bestie, you're literally a devlink-trap pro now 🌈💖✨ this page came from iproute2, last updated 2 August 2019, so it's a little vintage but still iconic 🎀💅