tc: man: Add man entry for the matchall classifier.
In addition to providing information about the mathcall filter and its configurations, the man entry contains examples for creating port mirorring entries. Signed-off-by: Yotam Gigi <yotamg@mellanox.com> Signed-off-by: Jiri Pirko <jiri@mellanox.com>
This commit is contained in:
parent
d5cbf3ff05
commit
0501294bca
|
|
@ -14,7 +14,7 @@ MAN8PAGES = $(TARGETS) ip.8 arpd.8 lnstat.8 routel.8 rtacct.8 rtmon.8 rtpr.8 ss.
|
||||||
tipc.8 tipc-bearer.8 tipc-link.8 tipc-media.8 tipc-nametable.8 \
|
tipc.8 tipc-bearer.8 tipc-link.8 tipc-media.8 tipc-nametable.8 \
|
||||||
tipc-node.8 tipc-socket.8 \
|
tipc-node.8 tipc-socket.8 \
|
||||||
tc-basic.8 tc-cgroup.8 tc-flow.8 tc-flower.8 tc-fw.8 tc-route.8 \
|
tc-basic.8 tc-cgroup.8 tc-flow.8 tc-flower.8 tc-fw.8 tc-route.8 \
|
||||||
tc-tcindex.8 tc-u32.8 \
|
tc-tcindex.8 tc-u32.8 tc-matchall.8 \
|
||||||
tc-connmark.8 tc-csum.8 tc-mirred.8 tc-nat.8 tc-pedit.8 tc-police.8 \
|
tc-connmark.8 tc-csum.8 tc-mirred.8 tc-nat.8 tc-pedit.8 tc-police.8 \
|
||||||
tc-simple.8 tc-skbedit.8 tc-vlan.8 tc-xt.8 \
|
tc-simple.8 tc-skbedit.8 tc-vlan.8 tc-xt.8 \
|
||||||
devlink.8 devlink-dev.8 devlink-monitor.8 devlink-port.8 devlink-sb.8
|
devlink.8 devlink-dev.8 devlink-monitor.8 devlink-port.8 devlink-sb.8
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,76 @@
|
||||||
|
.TH "Match-all classifier in tc" 8 "21 Oct 2015" "iproute2" "Linux"
|
||||||
|
|
||||||
|
.SH NAME
|
||||||
|
matchall \- traffic control filter that matches every packet
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.in +8
|
||||||
|
.ti -8
|
||||||
|
.BR tc " " filter " ... " matchall " [ "
|
||||||
|
.BR skip_sw " | " skip_hw
|
||||||
|
.R " ] [ "
|
||||||
|
.B action
|
||||||
|
.IR ACTION_SPEC " ] [ "
|
||||||
|
.B classid
|
||||||
|
.IR CLASSID " ]"
|
||||||
|
.SH DESCRIPTION
|
||||||
|
The
|
||||||
|
.B matchall
|
||||||
|
filter allows to classify every packet that flows on the port and run a
|
||||||
|
action on it.
|
||||||
|
.SH OPTIONS
|
||||||
|
.TP
|
||||||
|
.BI action " ACTION_SPEC"
|
||||||
|
Apply an action from the generic actions framework on matching packets.
|
||||||
|
.TP
|
||||||
|
.BI classid " CLASSID"
|
||||||
|
Push matching packets into the class identified by
|
||||||
|
.IR CLASSID .
|
||||||
|
.TP
|
||||||
|
.BI skip_sw
|
||||||
|
Do not process filter by software. If hardware has no offload support for this
|
||||||
|
filter, or TC offload is not enabled for the interface, operation will fail.
|
||||||
|
.TP
|
||||||
|
.BI skip_hw
|
||||||
|
Do not process filter by hardware.
|
||||||
|
.SH EXAMPLES
|
||||||
|
To create ingress mirroring from port eth1 to port eth2:
|
||||||
|
.RS
|
||||||
|
.EX
|
||||||
|
|
||||||
|
tc qdisc add dev eth1 handle ffff: ingress
|
||||||
|
tc filter add dev eth1 parent ffff: \\
|
||||||
|
matchall skip_sw \\
|
||||||
|
action mirred egress mirror \\
|
||||||
|
dev eth2
|
||||||
|
.EE
|
||||||
|
.RE
|
||||||
|
|
||||||
|
The first command creats an ingress qdisc with handle
|
||||||
|
.BR ffff:
|
||||||
|
on device
|
||||||
|
.BR eth1
|
||||||
|
where the second command attaches a matchall filters on it that mirrors the
|
||||||
|
packets to device eth2.
|
||||||
|
|
||||||
|
To create egress mirroring from port eth1 to port eth2:
|
||||||
|
.EX
|
||||||
|
|
||||||
|
tc qdisc add dev eth1 handle 1: root prio
|
||||||
|
tc filter add dev eth1 parent 1: \\
|
||||||
|
matchall skip_sw \\
|
||||||
|
action mirred egress mirror \\
|
||||||
|
dev eth2
|
||||||
|
.EE
|
||||||
|
.RE
|
||||||
|
|
||||||
|
The first command creats an egress qdisc with handle
|
||||||
|
.BR 1:
|
||||||
|
that replaces the root qdisc on device
|
||||||
|
.BR eth1
|
||||||
|
where the second command attaches a matchall filters on it that mirrors the
|
||||||
|
packets to device eth2.
|
||||||
|
|
||||||
|
|
||||||
|
.EE
|
||||||
|
.SH SEE ALSO
|
||||||
|
.BR tc (8),
|
||||||
|
|
@ -187,6 +187,11 @@ u32
|
||||||
Generic filtering on arbitrary packet data, assisted by syntax to abstract common operations. See
|
Generic filtering on arbitrary packet data, assisted by syntax to abstract common operations. See
|
||||||
.BR tc-u32 (8)
|
.BR tc-u32 (8)
|
||||||
for details.
|
for details.
|
||||||
|
.TP
|
||||||
|
matchall
|
||||||
|
Traffic control filter that matches every packet. See
|
||||||
|
.BR tc-matchall (8)
|
||||||
|
for details.
|
||||||
|
|
||||||
.SH CLASSLESS QDISCS
|
.SH CLASSLESS QDISCS
|
||||||
The classless qdiscs are:
|
The classless qdiscs are:
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue