# man > devlink-trap(8)

[_DEVLINK-TRAP_(8)](https://www.chedong.com/phpMan.php/man/DEVLINK-TRAP/8/markdown)                                 Linux                                [_DEVLINK-TRAP_(8)](https://www.chedong.com/phpMan.php/man/DEVLINK-TRAP/8/markdown)

## 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 _**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 speci‐
       fied.


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


## SEE ALSO
       [**devlink**(8)](https://www.chedong.com/phpMan.php/man/devlink/8/markdown), [**devlink-dev**(8)](https://www.chedong.com/phpMan.php/man/devlink-dev/8/markdown), [**devlink-monitor**(8)](https://www.chedong.com/phpMan.php/man/devlink-monitor/8/markdown),


## AUTHOR
       Ido Schimmel <<idosch@mellanox.com>>

iproute2                                    2 August 2019                            [_DEVLINK-TRAP_(8)](https://www.chedong.com/phpMan.php/man/DEVLINK-TRAP/8/markdown)