You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
127 lines
2.8 KiB
127 lines
2.8 KiB
.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 " | " MODIFY " } [ " CONTROL " ]"
|
|
|
|
.ti -8
|
|
.IR PUSH " := "
|
|
.BR push " [ " protocol
|
|
.IR VLANPROTO " ]"
|
|
.BR " [ " priority
|
|
.IR VLANPRIO " ] "
|
|
.BI id " VLANID"
|
|
|
|
.ti -8
|
|
.IR MODIFY " := "
|
|
.BR modify " [ " protocol
|
|
.IR VLANPROTO " ]"
|
|
.BR " [ " priority
|
|
.IR VLANPRIO " ] "
|
|
.BI id " VLANID"
|
|
|
|
.ti -8
|
|
.IR CONTROL " := { "
|
|
.BR reclassify " | " pipe " | " drop " | " continue " | " pass " | " goto " " chain " " CHAIN_INDEX " }"
|
|
.SH DESCRIPTION
|
|
The
|
|
.B vlan
|
|
action allows to perform 802.1Q en- or decapsulation on a packet, reflected by
|
|
the operation modes
|
|
.IR POP ", " PUSH " and " MODIFY .
|
|
The
|
|
.I POP
|
|
mode is simple, as no further information is required to just drop the
|
|
outer-most VLAN encapsulation. The
|
|
.IR PUSH " and " MODIFY
|
|
modes require at least a
|
|
.I VLANID
|
|
and allow 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
|
|
.B modify
|
|
Replace mode. Existing 802.1Q tag is replaced. 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
|
|
.BI priority " VLANPRIO"
|
|
Choose the VLAN priority to use. Decimal number in range of 0-7.
|
|
.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)
|