mirror of
https://git.proxmox.com/git/mirror_iproute2
synced 2025-10-31 15:31:19 +00:00
16418561b7
This should be made generic and part of a common tc-actions man page. Though leave it here for now to not confuse readers of the example which uses it. Signed-off-by: Phil Sutter <phil@nwl.cc> Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
109 lines
2.4 KiB
Groff
109 lines
2.4 KiB
Groff
.TH "VLAN manipulation action in tc" 8 "12 Jan 2015" "iproute2" "Linux"
|
|
|
|
.SH NAME
|
|
vlan - vlan manipulation module
|
|
.SH SYNOPSIS
|
|
.in +8
|
|
.ti -8
|
|
.BR tc " ... " "action vlan" " { " pop " |"
|
|
.IR PUSH " } [ " CONTROL " ]"
|
|
|
|
.ti -8
|
|
.IR PUSH " := "
|
|
.BR push " [ " protocol
|
|
.IR VLANPROTO " ]"
|
|
.BI id " VLANID"
|
|
|
|
.ti -8
|
|
.IR CONTROL " := { "
|
|
.BR reclassify " | " pipe " | " drop " | " continue " | " pass " }"
|
|
.SH DESCRIPTION
|
|
The
|
|
.B vlan
|
|
action allows to perform 802.1Q en- or decapsulation on a packet, reflected by
|
|
the two operation modes
|
|
.IR POP " and " PUSH .
|
|
The
|
|
.I POP
|
|
mode is simple, as no further information is required to just drop the
|
|
outer-most VLAN encapsulation. The
|
|
.I PUSH
|
|
mode on the other hand requires at least a
|
|
.I VLANID
|
|
and allows to optionally choose the
|
|
.I VLANPROTO
|
|
to use.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B pop
|
|
Decapsulation mode, no further arguments allowed.
|
|
.TP
|
|
.B push
|
|
Encapsulation mode. Requires at least
|
|
.B id
|
|
option.
|
|
.TP
|
|
.BI id " VLANID"
|
|
Specify the VLAN ID to encapsulate into.
|
|
.I VLANID
|
|
is an unsigned 16bit integer, the format is detected automatically (e.g. prefix
|
|
with
|
|
.RB ' 0x '
|
|
for hexadecimal interpretation, etc.).
|
|
.TP
|
|
.BI protocol " VLANPROTO"
|
|
Choose the VLAN protocol to use. At the time of writing, the kernel accepts only
|
|
.BR 802.1Q " or " 802.1ad .
|
|
.TP
|
|
.I CONTROL
|
|
How to continue after executing this action.
|
|
.RS
|
|
.TP
|
|
.B reclassify
|
|
Restarts classification by jumping back to the first filter attached to this
|
|
action's parent.
|
|
.TP
|
|
.B pipe
|
|
Continue with the next action, this is the default.
|
|
.TP
|
|
.B drop
|
|
Packet will be dropped without running further actions.
|
|
.TP
|
|
.B continue
|
|
Continue classification with next filter in line.
|
|
.TP
|
|
.B pass
|
|
Return to calling qdisc for packet processing. This ends the classification
|
|
process.
|
|
.RE
|
|
.SH EXAMPLES
|
|
The following example encapsulates incoming ICMP packets on eth0 from 10.0.0.2
|
|
into VLAN ID 123:
|
|
|
|
.RS
|
|
.EX
|
|
#tc qdisc add dev eth0 handle ffff: ingress
|
|
#tc filter add dev eth0 parent ffff: pref 11 protocol ip \\
|
|
u32 match ip protocol 1 0xff flowid 1:1 \\
|
|
u32 match ip src 10.0.0.2 flowid 1:1 \\
|
|
action vlan push id 123
|
|
.EE
|
|
.RE
|
|
|
|
Here is an example of the
|
|
.B pop
|
|
function: Incoming VLAN packets on eth0 are decapsulated and the classification
|
|
process then restarted for the plain packet:
|
|
|
|
.RS
|
|
.EX
|
|
#tc qdisc add dev eth0 handle ffff: ingress
|
|
#tc filter add dev $ETH parent ffff: pref 1 protocol 802.1Q \\
|
|
u32 match u32 0 0 flowid 1:1 \\
|
|
action vlan pop reclassify
|
|
.EE
|
|
.RE
|
|
|
|
.SH SEE ALSO
|
|
.BR tc (8)
|