System Grab Bag

View all man pages from Ubuntu (or from all projects)

Name

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 "[ " 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.

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.

- packet trap policer rate in packets per second.

- 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.

See Also

  1. devlink(8),
  2. devlink-dev(8),
  3. devlink-monitor(8),

Author

Ido Schimmel <[email protected]>