devlink-trap8
Devlink trap configuration
Usage
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
Overview
devlink trap show - display available packet traps and their attributes
DEV - specifies the devlink device from which to show packet traps. If this argument is omitted all packet traps of all devices are listed.
trap TRAP - specifies the packet trap. Only applicable if a devlink device is also specified.
devlink trap set - set attributes of a packet trap
DEV - specifies the devlink device the packet trap belongs to.
trap TRAP - specifies the packet trap.
action{trap|drop|mirror}-
packet trap action.
trap - the sole copy of the packet is sent to the CPU.
drop - the packet is dropped by the underlying device and a copy is not sent to the CPU.
mirror - the packet is forwarded by the underlying device and a copy is sent to the CPU.
devlink trap group show - display available packet trap groups and their attributes
DEV - specifies the devlink device from which to show packet trap groups. If this argument is omitted all packet trap groups of all devices are listed.
group GROUP - specifies the packet trap group. Only applicable if a devlink device is also specified.
devlink trap group set - set attributes of a packet trap group
DEV - specifies the devlink device the packet trap group belongs to.
group GROUP - specifies the packet trap group.
action{trap|drop|mirror}-
packet trap action. The action is set for all the packet traps member in the trap group. The actions of non-drop traps cannot be changed and are thus skipped.
policerPOLICER-
packet trap policer. The policer to bind to the packet trap group. A value of "0" will unbind the currently bound policer.
nopolicer-
Unbind packet trap policer from the packet trap group.
devlink trap policer set - set attributes of packet trap policer
DEV - specifies the devlink device the packet trap policer belongs to.
policer POLICER - specifies the packet trap policer.
rate RATE - packet trap policer rate in packets per second.
burst BURST - packet trap policer burst size in packets.
Examples
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.
Releases
Unchanged in 4 releases since Debian 11 (Bullseye).