.TH DEVLINK\-TRAP 8 "2 August 2019" "iproute2" "Linux"
.SH NAME
devlink-trap \- devlink trap configuration
.SH SYNOPSIS
.sp
.ad l
.in +8
.ti -8
.B devlink
.RI "[ " OPTIONS " ]"
.B trap
.RI "{ " COMMAND " |"
.BR help " }"
.sp

.ti -8
.IR OPTIONS " := { "
\fB\-v\fR[\fIerbose\fR] |
\fB\-s\fR[\fItatistics\fR] }

.ti -8
.B "devlink trap show"
.RI "[ " DEV
.B trap
.IR TRAP " ]"

.ti -8
.BI "devlink trap set " DEV " trap " TRAP
.RB "[ " action " { " trap " | " drop " } ]"

.ti -8
.B "devlink trap group show"
.RI "[ " DEV
.B group
.IR GROUP " ]"

.ti -8
.BI "devlink trap group set " DEV " group " GROUP
.RB "[ " action " { " trap " | " drop " } ]"

.ti -8
.B devlink trap help

.SH "DESCRIPTION"
.SS devlink trap show - display available packet traps and their attributes

.PP
.I "DEV"
- specifies the devlink device from which to show packet traps.
If this argument is omitted all packet traps of all devices are listed.

.PP
.BI "trap " TRAP
- specifies the packet trap.
Only applicable if a devlink device is also specified.

.SS devlink trap set - set attributes of a packet trap

.PP
.I "DEV"
- specifies the devlink device the packet trap belongs to.

.PP
.BI "trap " TRAP
- specifies the packet trap.

.TP
.BR action " { " trap " | " drop " } "
packet trap action.

.I trap
- the sole copy of the packet is sent to the CPU.

.I drop
- the packet is dropped by the underlying device and a copy is not sent to the CPU.

.SS devlink trap group show - display available packet trap groups and their attributes

.PP
.I "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.

.PP
.BI "group " GROUP
- specifies the packet trap group.
Only applicable if a devlink device is also specified.

.SS devlink trap group set - set attributes of a packet trap group

.PP
.I "DEV"
- specifies the devlink device the packet trap group belongs to.

.PP
.BI "group " GROUP
- specifies the packet trap group.

.TP
.BR 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.

.SH "EXAMPLES"
.PP
devlink trap show
.RS 4
List available packet traps.
.RE
.PP
devlink trap group show
.RS 4
List available packet trap groups.
.RE
.PP
devlink -vs trap show pci/0000:01:00.0 trap source_mac_is_multicast
.RS 4
Show attributes and statistics of a specific packet trap.
.RE
.PP
devlink -s trap group show pci/0000:01:00.0 group l2_drops
.RS 4
Show attributes and statistics of a specific packet trap group.
.RE
.PP
devlink trap set pci/0000:01:00.0 trap source_mac_is_multicast action trap
.RS 4
Set the action of a specific packet trap to 'trap'.

.SH SEE ALSO
.BR devlink (8),
.BR devlink-dev (8),
.BR devlink-monitor (8),
.br

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