Devlink-trap (8) Linux Manual Page

devlink-trap – devlink trap configuration

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 – 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.
policer POLICER: 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.

Author

Ido Schimmel <idosch [at] mellanox.com>

devlink-trap (8) Linux Manual Page