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.

       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 <idosch@mellanox.com>

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
       netdev@vger.kernel.org, shemminger@osdl.org.  This page was obtained
       from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/network/iproute2/iproute2.git⟩ on
       2020-08-13.  (At that time, the date of the most recent commit that
       was found in the repository was 2020-06-24.)  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
       man-pages@man7.org

iproute2                        2 August 2019                DEVLINK-TRAP(8)

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