DEVLINK-TRAP(8)



DEVLINK-TRAP(8)                      Linux                     DEVLINK-TRAP(8)

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 } ]

       devlink trap group show [ DEV group GROUP ]

       devlink trap group set DEV group GROUP [ action { trap | drop } ]
               [ 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 }
              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.

   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 de-
       vices 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 }
              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.

       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.

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

AUTHOR
       Ido Schimmel <idosch@mellanox.com>

iproute2                         2 August 2019                 DEVLINK-TRAP(8)

Man(1) output converted with man2html
list of all man pages