devlink-trap(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | AUTHOR | COLOPHON

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

NAME         top

       devlink-trap - devlink trap configuration

SYNOPSIS         top

       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         top

   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         top

       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         top

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

AUTHOR         top

       Ido Schimmel <[email protected]>

COLOPHON         top

       This page is part of the iproute2 (utilities for controlling
       TCP/IP networking and traffic) project.  Information about the
       project can be found at 
       ⟨http://www.linuxfoundation.org/collaborate/workgroups/networking/iproute2⟩.
       If you have a bug report for this manual page, send it to
       [email protected], [email protected].  This page was
       obtained from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/network/iproute2/iproute2.git⟩ on
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-11.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to [email protected]

iproute2                      2 August 2019              DEVLINK-TRAP(8)

Pages that refer to this page: devlink(8)devlink-monitor(8)