# devlink-trap

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



           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.
    


* * *