|
Packit Service |
3880ab |
.TH BRIDGE 8 "1 August 2012" "iproute2" "Linux"
|
|
Packit Service |
3880ab |
.SH NAME
|
|
Packit Service |
3880ab |
bridge \- show / manipulate bridge addresses and devices
|
|
Packit Service |
3880ab |
.SH SYNOPSIS
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ad l
|
|
Packit Service |
3880ab |
.in +8
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B bridge
|
|
Packit Service |
3880ab |
.RI "[ " OPTIONS " ] " OBJECT " { " COMMAND " | "
|
|
Packit Service |
3880ab |
.BR help " }"
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.IR OBJECT " := { "
|
|
Packit Service |
3880ab |
.BR link " | " fdb " | " mdb " | " vlan " | " monitor " }"
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.IR OPTIONS " := { "
|
|
Packit Service |
3880ab |
\fB\-V\fR[\fIersion\fR] |
|
|
Packit Service |
3880ab |
\fB\-s\fR[\fItatistics\fR] |
|
|
Packit Service |
3880ab |
\fB\-n\fR[\fIetns\fR] name |
|
|
Packit Service |
3880ab |
\fB\-b\fR[\fIatch\fR] filename |
|
|
Packit Service |
3880ab |
\fB\-c\fR[\folor\fR] |
|
|
Packit Service |
3880ab |
\fB\-p\fR[\fIretty\fR] |
|
|
Packit Service |
3880ab |
\fB\-j\fR[\fIson\fR] |
|
|
Packit Service |
3880ab |
\fB\-o\fR[\fIneline\fr] }
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B "bridge link set"
|
|
Packit Service |
3880ab |
.B dev
|
|
Packit Service |
3880ab |
.IR DEV " [ "
|
|
Packit Service |
3880ab |
.B cost
|
|
Packit Service |
3880ab |
.IR COST " ] [ "
|
|
Packit Service |
3880ab |
.B priority
|
|
Packit Service |
3880ab |
.IR PRIO " ] [ "
|
|
Packit Service |
3880ab |
.B state
|
|
Packit Service |
3880ab |
.IR STATE " ] [ "
|
|
Packit Service |
3880ab |
.BR guard " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR hairpin " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR fastleave " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR root_block " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR learning " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR learning_sync " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR flood " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR hwmode " { " vepa " | " veb " } ] [ "
|
|
Packit Service |
3880ab |
.BR mcast_flood " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR mcast_to_unicast " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR neigh_suppress " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR vlan_tunnel " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.BR isolated " { " on " | " off " } ] [ "
|
|
Packit Service |
3880ab |
.B backup_port
|
|
Packit Service |
3880ab |
.IR DEVICE " ] ["
|
|
Packit Service |
3880ab |
.BR nobackup_port " ] [ "
|
|
Packit Service |
3880ab |
.BR self " ] [ " master " ]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "bridge link" " [ " show " ] [ "
|
|
Packit Service |
3880ab |
.B dev
|
|
Packit Service |
3880ab |
.IR DEV " ]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "bridge fdb" " { " add " | " append " | " del " | " replace " } "
|
|
Packit Service |
3880ab |
.I LLADDR
|
|
Packit Service |
3880ab |
.B dev
|
|
Packit Service |
3880ab |
.IR DEV " { "
|
|
Packit Service |
3880ab |
.BR local " | " static " | " dynamic " } [ "
|
|
Packit Service |
3880ab |
.BR self " ] [ " master " ] [ " router " ] [ " use " ] [ " extern_learn " ] [ " sticky " ] [ "
|
|
Packit Service |
3880ab |
.B src_vni
|
|
Packit Service |
3880ab |
.IR VNI " ] { ["
|
|
Packit Service |
3880ab |
.B dst
|
|
Packit Service |
3880ab |
.IR IPADDR " ] [ "
|
|
Packit Service |
3880ab |
.B vni
|
|
Packit Service |
3880ab |
.IR VNI " ] ["
|
|
Packit Service |
3880ab |
.B port
|
|
Packit Service |
3880ab |
.IR PORT " ] ["
|
|
Packit Service |
3880ab |
.B via
|
|
Packit Service |
3880ab |
.IR DEVICE " ] | "
|
|
Packit Service |
3880ab |
.B nhid
|
|
Packit Service |
3880ab |
.IR NHID " } "
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "bridge fdb" " [ [ " show " ] [ "
|
|
Packit Service |
3880ab |
.B br
|
|
Packit Service |
3880ab |
.IR BRDEV " ] [ "
|
|
Packit Service |
3880ab |
.B brport
|
|
Packit Service |
3880ab |
.IR DEV " ] [ "
|
|
Packit Service |
3880ab |
.B vlan
|
|
Packit Service |
3880ab |
.IR VID " ] [ "
|
|
Packit Service |
3880ab |
.B state
|
|
Packit Service |
3880ab |
.IR STATE " ] ["
|
|
Packit Service |
3880ab |
.B dynamic
|
|
Packit Service |
3880ab |
.IR "] ]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "bridge fdb get" " ["
|
|
Packit Service |
3880ab |
.B to
|
|
Packit Service |
3880ab |
.IR "]"
|
|
Packit Service |
3880ab |
.I LLADDR "[ "
|
|
Packit Service |
3880ab |
.B br
|
|
Packit Service |
3880ab |
.IR BRDEV " ]"
|
|
Packit Service |
3880ab |
.B { brport | dev }
|
|
Packit Service |
3880ab |
.IR DEV " [ "
|
|
Packit Service |
3880ab |
.B vlan
|
|
Packit Service |
3880ab |
.IR VID " ] [ "
|
|
Packit Service |
3880ab |
.B vni
|
|
Packit Service |
3880ab |
.IR VNI " ] ["
|
|
Packit Service |
3880ab |
.BR self " ] [ " master " ] [ " dynamic " ]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "bridge mdb" " { " add " | " del " } "
|
|
Packit Service |
3880ab |
.B dev
|
|
Packit Service |
3880ab |
.I DEV
|
|
Packit Service |
3880ab |
.B port
|
|
Packit Service |
3880ab |
.I PORT
|
|
Packit Service |
3880ab |
.B grp
|
|
Packit Service |
3880ab |
.IR GROUP " [ "
|
|
Packit Service |
3880ab |
.BR permanent " | " temp " ] [ "
|
|
Packit Service |
3880ab |
.B vid
|
|
Packit Service |
3880ab |
.IR VID " ] "
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "bridge mdb show " [ "
|
|
Packit Service |
3880ab |
.B dev
|
|
Packit Service |
3880ab |
.IR DEV " ]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "bridge vlan" " { " add " | " del " } "
|
|
Packit Service |
3880ab |
.B dev
|
|
Packit Service |
3880ab |
.I DEV
|
|
Packit Service |
3880ab |
.B vid
|
|
Packit Service |
3880ab |
.IR VID " [ "
|
|
Packit Service |
3880ab |
.B tunnel_info
|
|
Packit Service |
3880ab |
.IR TUNNEL_ID " ] [ "
|
|
Packit Service |
3880ab |
.BR pvid " ] [ " untagged " ] [ "
|
|
Packit Service |
3880ab |
.BR self " ] [ " master " ] "
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "bridge vlan" " [ " show " | " tunnelshow " ] [ "
|
|
Packit Service |
3880ab |
.B dev
|
|
Packit Service |
3880ab |
.IR DEV " ]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "bridge monitor" " [ " all " | " neigh " | " link " | " mdb " ]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH OPTIONS
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-V" , " -Version"
|
|
Packit Service |
3880ab |
print the version of the
|
|
Packit Service |
3880ab |
.B bridge
|
|
Packit Service |
3880ab |
utility and exit.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-s" , " \-stats", " \-statistics"
|
|
Packit Service |
3880ab |
output more information. If this option
|
|
Packit Service |
3880ab |
is given multiple times, the amount of information increases.
|
|
Packit Service |
3880ab |
As a rule, the information is statistics or some time values.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-d" , " \-details"
|
|
Packit Service |
3880ab |
print detailed information about MDB router ports.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-n" , " \-net" , " \-netns " <NETNS>
|
|
Packit Service |
3880ab |
switches
|
|
Packit Service |
3880ab |
.B bridge
|
|
Packit Service |
3880ab |
to the specified network namespace
|
|
Packit Service |
3880ab |
.IR NETNS .
|
|
Packit Service |
3880ab |
Actually it just simplifies executing of:
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B ip netns exec
|
|
Packit Service |
3880ab |
.I NETNS
|
|
Packit Service |
3880ab |
.B bridge
|
|
Packit Service |
3880ab |
.RI "[ " OPTIONS " ] " OBJECT " { " COMMAND " | "
|
|
Packit Service |
3880ab |
.BR help " }"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
to
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B bridge
|
|
Packit Service |
3880ab |
.RI "-n[etns] " NETNS " [ " OPTIONS " ] " OBJECT " { " COMMAND " | "
|
|
Packit Service |
3880ab |
.BR help " }"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-b", " \-batch " <FILENAME>
|
|
Packit Service |
3880ab |
Read commands from provided file or standard input and invoke them.
|
|
Packit Service |
3880ab |
First failure will cause termination of bridge command.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B "\-force"
|
|
Packit Service |
3880ab |
Don't terminate bridge command on errors in batch mode.
|
|
Packit Service |
3880ab |
If there were any errors during execution of the commands, the application
|
|
Packit Service |
3880ab |
return code will be non zero.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR \-c [ color ][ = { always | auto | never }
|
|
Packit Service |
3880ab |
Configure color output. If parameter is omitted or
|
|
Packit Service |
3880ab |
.BR always ,
|
|
Packit Service |
3880ab |
color output is enabled regardless of stdout state. If parameter is
|
|
Packit Service |
3880ab |
.BR auto ,
|
|
Packit Service |
3880ab |
stdout is checked to be a terminal before enabling color output. If parameter is
|
|
Packit Service |
3880ab |
.BR never ,
|
|
Packit Service |
3880ab |
color output is disabled. If specified multiple times, the last one takes
|
|
Packit Service |
3880ab |
precedence. This flag is ignored if
|
|
Packit Service |
3880ab |
.B \-json
|
|
Packit Service |
3880ab |
is also given.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-j", " \-json"
|
|
Packit Service |
3880ab |
Output results in JavaScript Object Notation (JSON).
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-p", " \-pretty"
|
|
Packit Service |
3880ab |
When combined with -j generate a pretty JSON output.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-o", " \-oneline"
|
|
Packit Service |
3880ab |
output each record on a single line, replacing line feeds
|
|
Packit Service |
3880ab |
with the
|
|
Packit Service |
3880ab |
.B '\e'
|
|
Packit Service |
3880ab |
character. This is convenient when you want to count records
|
|
Packit Service |
3880ab |
with
|
|
Packit Service |
3880ab |
.BR wc (1)
|
|
Packit Service |
3880ab |
or to
|
|
Packit Service |
3880ab |
.BR grep (1)
|
|
Packit Service |
3880ab |
the output.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH BRIDGE - COMMAND SYNTAX
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS
|
|
Packit Service |
3880ab |
.I OBJECT
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B link
|
|
Packit Service |
3880ab |
- Bridge port.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B fdb
|
|
Packit Service |
3880ab |
- Forwarding Database entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B mdb
|
|
Packit Service |
3880ab |
- Multicast group database entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B vlan
|
|
Packit Service |
3880ab |
- VLAN filter list.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS
|
|
Packit Service |
3880ab |
.I COMMAND
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
Specifies the action to perform on the object.
|
|
Packit Service |
3880ab |
The set of possible actions depends on the object type.
|
|
Packit Service |
3880ab |
As a rule, it is possible to
|
|
Packit Service |
3880ab |
.BR "add" , " delete"
|
|
Packit Service |
3880ab |
and
|
|
Packit Service |
3880ab |
.B show
|
|
Packit Service |
3880ab |
(or
|
|
Packit Service |
3880ab |
.B list
|
|
Packit Service |
3880ab |
) objects, but some objects do not allow all of these operations
|
|
Packit Service |
3880ab |
or have some additional commands. The
|
|
Packit Service |
3880ab |
.B help
|
|
Packit Service |
3880ab |
command is available for all objects. It prints
|
|
Packit Service |
3880ab |
out a list of available commands and argument syntax conventions.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
If no command is given, some default command is assumed.
|
|
Packit Service |
3880ab |
Usually it is
|
|
Packit Service |
3880ab |
.B list
|
|
Packit Service |
3880ab |
or, if the objects of this class cannot be listed,
|
|
Packit Service |
3880ab |
.BR "help" .
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH bridge link - bridge port
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B link
|
|
Packit Service |
3880ab |
objects correspond to the port devices of the bridge.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.P
|
|
Packit Service |
3880ab |
The corresponding commands set and display port status and bridge specific
|
|
Packit Service |
3880ab |
attributes.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge link set - set bridge specific attributes on a port
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI dev " NAME "
|
|
Packit Service |
3880ab |
interface name of the bridge port
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI cost " COST "
|
|
Packit Service |
3880ab |
the STP path cost of the specified port.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI priority " PRIO "
|
|
Packit Service |
3880ab |
the STP port priority. The priority value is an unsigned 8-bit quantity
|
|
Packit Service |
3880ab |
(number between 0 and 255). This metric is used in the designated port an
|
|
Packit Service |
3880ab |
droot port selection algorithms.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI state " STATE "
|
|
Packit Service |
3880ab |
the operation state of the port. Except state 0 (disable STP or BPDU filter feature),
|
|
Packit Service |
3880ab |
this is primarily used by user space STP/RSTP
|
|
Packit Service |
3880ab |
implementation. One may enter port state name (case insensitive), or one of the
|
|
Packit Service |
3880ab |
numbers below. Negative inputs are ignored, and unrecognized names return an
|
|
Packit Service |
3880ab |
error.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B 0
|
|
Packit Service |
3880ab |
- port is in STP
|
|
Packit Service |
3880ab |
.B DISABLED
|
|
Packit Service |
3880ab |
state. Make this port completely inactive for STP. This is also called
|
|
Packit Service |
3880ab |
BPDU filter and could be used to disable STP on an untrusted port, like
|
|
Packit Service |
3880ab |
a leaf virtual devices.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B 1
|
|
Packit Service |
3880ab |
- port is in STP
|
|
Packit Service |
3880ab |
.B LISTENING
|
|
Packit Service |
3880ab |
state. Only valid if STP is enabled on the bridge. In this
|
|
Packit Service |
3880ab |
state the port listens for STP BPDUs and drops all other traffic frames.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B 2
|
|
Packit Service |
3880ab |
- port is in STP
|
|
Packit Service |
3880ab |
.B LEARNING
|
|
Packit Service |
3880ab |
state. Only valid if STP is enabled on the bridge. In this
|
|
Packit Service |
3880ab |
state the port will accept traffic only for the purpose of updating MAC
|
|
Packit Service |
3880ab |
address tables.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B 3
|
|
Packit Service |
3880ab |
- port is in STP
|
|
Packit Service |
3880ab |
.B FORWARDING
|
|
Packit Service |
3880ab |
state. Port is fully active.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B 4
|
|
Packit Service |
3880ab |
- port is in STP
|
|
Packit Service |
3880ab |
.B BLOCKING
|
|
Packit Service |
3880ab |
state. Only valid if STP is enabled on the bridge. This state
|
|
Packit Service |
3880ab |
is used during the STP election process. In this state, port will only process
|
|
Packit Service |
3880ab |
STP BPDUs.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "guard on " or " guard off "
|
|
Packit Service |
3880ab |
Controls whether STP BPDUs will be processed by the bridge port. By default,
|
|
Packit Service |
3880ab |
the flag is turned off allowed BPDU processing. Turning this flag on will
|
|
Packit Service |
3880ab |
disables
|
|
Packit Service |
3880ab |
the bridge port if a STP BPDU packet is received.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
If running Spanning Tree on bridge, hostile devices on the network
|
|
Packit Service |
3880ab |
may send BPDU on a port and cause network failure. Setting
|
|
Packit Service |
3880ab |
.B guard on
|
|
Packit Service |
3880ab |
will detect and stop this by disabling the port.
|
|
Packit Service |
3880ab |
The port will be restarted if link is brought down, or
|
|
Packit Service |
3880ab |
removed and reattached. For example if guard is enable on
|
|
Packit Service |
3880ab |
eth0:
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B ip link set dev eth0 down; ip link set dev eth0 up
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "hairpin on " or " hairpin off "
|
|
Packit Service |
3880ab |
Controls whether traffic may be send back out of the port on which it was
|
|
Packit Service |
3880ab |
received. This option is also called reflective relay mode, and is used to support
|
|
Packit Service |
3880ab |
basic VEPA (Virtual Ethernet Port Aggregator) capabilities.
|
|
Packit Service |
3880ab |
By default, this flag is turned off and the bridge will not forward
|
|
Packit Service |
3880ab |
traffic back out of the receiving port.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "fastleave on " or " fastleave off "
|
|
Packit Service |
3880ab |
This flag allows the bridge to immediately stop multicast traffic on a port
|
|
Packit Service |
3880ab |
that receives IGMP Leave message. It is only used with IGMP snooping is
|
|
Packit Service |
3880ab |
enabled on the bridge. By default the flag is off.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "root_block on " or " root_block off "
|
|
Packit Service |
3880ab |
Controls whether a given port is allowed to become root port or not. Only used
|
|
Packit Service |
3880ab |
when STP is enabled on the bridge. By default the flag is off.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This feature is also called root port guard.
|
|
Packit Service |
3880ab |
If BPDU is received from a leaf (edge) port, it should not
|
|
Packit Service |
3880ab |
be elected as root port. This could be used if using STP on a bridge and the downstream bridges are not fully
|
|
Packit Service |
3880ab |
trusted; this prevents a hostile guest from rerouting traffic.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "learning on " or " learning off "
|
|
Packit Service |
3880ab |
Controls whether a given port will learn MAC addresses from received traffic or
|
|
Packit Service |
3880ab |
not. If learning if off, the bridge will end up flooding any traffic for which
|
|
Packit Service |
3880ab |
it has no FDB entry. By default this flag is on.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "learning_sync on " or " learning_sync off "
|
|
Packit Service |
3880ab |
Controls whether a given port will sync MAC addresses learned on device port to
|
|
Packit Service |
3880ab |
bridge FDB.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "flood on " or " flood off "
|
|
Packit Service |
3880ab |
Controls whether a given port will flood unicast traffic for which there is no FDB entry. By default this flag is on.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B hwmode
|
|
Packit Service |
3880ab |
Some network interface cards support HW bridge functionality and they may be
|
|
Packit Service |
3880ab |
configured in different modes. Currently support modes are:
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B vepa
|
|
Packit Service |
3880ab |
- Data sent between HW ports is sent on the wire to the external
|
|
Packit Service |
3880ab |
switch.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B veb
|
|
Packit Service |
3880ab |
- bridging happens in hardware.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "mcast_flood on " or " mcast_flood off "
|
|
Packit Service |
3880ab |
Controls whether a given port will flood multicast traffic for which
|
|
Packit Service |
3880ab |
there is no MDB entry. By default this flag is on.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "mcast_to_unicast on " or " mcast_to_unicast off "
|
|
Packit Service |
3880ab |
Controls whether a given port will replicate packets using unicast
|
|
Packit Service |
3880ab |
instead of multicast. By default this flag is off.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This is done by copying the packet per host and
|
|
Packit Service |
3880ab |
changing the multicast destination MAC to a unicast one accordingly.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B mcast_to_unicast
|
|
Packit Service |
3880ab |
works on top of the multicast snooping feature of
|
|
Packit Service |
3880ab |
the bridge. Which means unicast copies are only delivered to hosts which
|
|
Packit Service |
3880ab |
are interested in it and signalized this via IGMP/MLD reports
|
|
Packit Service |
3880ab |
previously.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This feature is intended for interface types which have a more reliable
|
|
Packit Service |
3880ab |
and/or efficient way to deliver unicast packets than broadcast ones
|
|
Packit Service |
3880ab |
(e.g. WiFi).
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
However, it should only be enabled on interfaces where no IGMPv2/MLDv1
|
|
Packit Service |
3880ab |
report suppression takes place. IGMP/MLD report suppression issue is usually
|
|
Packit Service |
3880ab |
overcome by the network daemon (supplicant) enabling AP isolation and
|
|
Packit Service |
3880ab |
by that separating all STAs.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
Delivery of STA-to-STA IP multicast is made possible again by
|
|
Packit Service |
3880ab |
enabling and utilizing the bridge hairpin mode, which considers the
|
|
Packit Service |
3880ab |
incoming port as a potential outgoing port, too (see
|
|
Packit Service |
3880ab |
.B hairpin
|
|
Packit Service |
3880ab |
option).
|
|
Packit Service |
3880ab |
Hairpin mode is performed after multicast snooping, therefore leading to
|
|
Packit Service |
3880ab |
only deliver reports to STAs running a multicast router.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "neigh_suppress on " or " neigh_suppress off "
|
|
Packit Service |
3880ab |
Controls whether neigh discovery (arp and nd) proxy and suppression is
|
|
Packit Service |
3880ab |
enabled on the port. By default this flag is off.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "vlan_tunnel on " or " vlan_tunnel off "
|
|
Packit Service |
3880ab |
Controls whether vlan to tunnel mapping is enabled on the port. By
|
|
Packit Service |
3880ab |
default this flag is off.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "isolated on " or " isolated off "
|
|
Packit Service |
3880ab |
Controls whether a given port will be isolated, which means it will be
|
|
Packit Service |
3880ab |
able to communicate with non-isolated ports only. By default this
|
|
Packit Service |
3880ab |
flag is off.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI backup_port " DEVICE"
|
|
Packit Service |
3880ab |
If the port loses carrier all traffic will be redirected to the
|
|
Packit Service |
3880ab |
configured backup port
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B nobackup_port
|
|
Packit Service |
3880ab |
Removes the currently configured backup port
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B self
|
|
Packit Service |
3880ab |
link setting is configured on specified physical device
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B master
|
|
Packit Service |
3880ab |
link setting is configured on the software bridge (default)
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-t" , " \-timestamp"
|
|
Packit Service |
3880ab |
display current time when using monitor option.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge link show - list ports configuration for all bridges.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This command displays port configuration and flags for all bridges.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
To display port configuration and flags for a specific bridge, use the
|
|
Packit Service |
3880ab |
"ip link show master <bridge_device>" command.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH bridge fdb - forwarding database management
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B fdb
|
|
Packit Service |
3880ab |
objects contain known Ethernet addresses on a link.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.P
|
|
Packit Service |
3880ab |
The corresponding commands display fdb entries, add new entries,
|
|
Packit Service |
3880ab |
append entries,
|
|
Packit Service |
3880ab |
and delete old ones.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge fdb add - add a new fdb entry
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This command creates a new fdb entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B LLADDR
|
|
Packit Service |
3880ab |
the Ethernet MAC address.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI dev " DEV"
|
|
Packit Service |
3880ab |
the interface to which this address is associated.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B local
|
|
Packit Service |
3880ab |
- is a local permanent fdb entry
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B static
|
|
Packit Service |
3880ab |
- is a static (no arp) fdb entry
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B dynamic
|
|
Packit Service |
3880ab |
- is a dynamic reachable age-able fdb entry
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B self
|
|
Packit Service |
3880ab |
- the address is associated with the port drivers fdb. Usually hardware.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B master
|
|
Packit Service |
3880ab |
- the address is associated with master devices fdb. Usually software (default).
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B router
|
|
Packit Service |
3880ab |
- the destination address is associated with a router.
|
|
Packit Service |
3880ab |
Valid if the referenced device is a VXLAN type device and has
|
|
Packit Service |
3880ab |
route short circuit enabled.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B use
|
|
Packit Service |
3880ab |
- the address is in use. User space can use this option to
|
|
Packit Service |
3880ab |
indicate to the kernel that the fdb entry is in use.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B extern_learn
|
|
Packit Service |
3880ab |
- this entry was learned externally. This option can be used to
|
|
Packit Service |
3880ab |
indicate to the kernel that an entry was hardware or user-space
|
|
Packit Service |
3880ab |
controller learnt dynamic entry. Kernel will not age such an entry.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B sticky
|
|
Packit Service |
3880ab |
- this entry will not change its port due to learning.
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.in -8
|
|
Packit Service |
3880ab |
The next command line parameters apply only
|
|
Packit Service |
3880ab |
when the specified device
|
|
Packit Service |
3880ab |
.I DEV
|
|
Packit Service |
3880ab |
is of type VXLAN.
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI dst " IPADDR"
|
|
Packit Service |
3880ab |
the IP address of the destination
|
|
Packit Service |
3880ab |
VXLAN tunnel endpoint where the Ethernet MAC ADDRESS resides.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI src_vni " VNI"
|
|
Packit Service |
3880ab |
the src VNI Network Identifier (or VXLAN Segment ID)
|
|
Packit Service |
3880ab |
this entry belongs to. Used only when the vxlan device is in
|
|
Packit Service |
3880ab |
external or collect metadata mode. If omitted the value specified at
|
|
Packit Service |
3880ab |
vxlan device creation will be used.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI vni " VNI"
|
|
Packit Service |
3880ab |
the VXLAN VNI Network Identifier (or VXLAN Segment ID)
|
|
Packit Service |
3880ab |
to use to connect to the remote VXLAN tunnel endpoint.
|
|
Packit Service |
3880ab |
If omitted the value specified at vxlan device creation
|
|
Packit Service |
3880ab |
will be used.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI port " PORT"
|
|
Packit Service |
3880ab |
the UDP destination PORT number to use to connect to the
|
|
Packit Service |
3880ab |
remote VXLAN tunnel endpoint.
|
|
Packit Service |
3880ab |
If omitted the default value is used.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI via " DEVICE"
|
|
Packit Service |
3880ab |
device name of the outgoing interface for the
|
|
Packit Service |
3880ab |
VXLAN device driver to reach the
|
|
Packit Service |
3880ab |
remote VXLAN tunnel endpoint.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI nhid " NHID "
|
|
Packit Service |
3880ab |
ecmp nexthop group for the VXLAN device driver
|
|
Packit Service |
3880ab |
to reach remote VXLAN tunnel endpoints.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge fdb append - append a forwarding database entry
|
|
Packit Service |
3880ab |
This command adds a new fdb entry with an already known
|
|
Packit Service |
3880ab |
.IR LLADDR .
|
|
Packit Service |
3880ab |
Valid only for multicast link layer addresses.
|
|
Packit Service |
3880ab |
The command adds support for broadcast and multicast
|
|
Packit Service |
3880ab |
Ethernet MAC addresses.
|
|
Packit Service |
3880ab |
The Ethernet MAC address is added multiple times into
|
|
Packit Service |
3880ab |
the forwarding database and the vxlan device driver
|
|
Packit Service |
3880ab |
sends a copy of the data packet to each entry found.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
The arguments are the same as with
|
|
Packit Service |
3880ab |
.BR "bridge fdb add" .
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge fdb delete - delete a forwarding database entry
|
|
Packit Service |
3880ab |
This command removes an existing fdb entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
The arguments are the same as with
|
|
Packit Service |
3880ab |
.BR "bridge fdb add" .
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge fdb replace - replace a forwarding database entry
|
|
Packit Service |
3880ab |
If no matching entry is found, a new one will be created instead.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
The arguments are the same as with
|
|
Packit Service |
3880ab |
.BR "bridge fdb add" .
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge fdb show - list forwarding entries.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This command displays the current forwarding table.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
With the
|
|
Packit Service |
3880ab |
.B -statistics
|
|
Packit Service |
3880ab |
option, the command becomes verbose. It prints out the last updated
|
|
Packit Service |
3880ab |
and last used time for each entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge fdb get - get bridge forwarding entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
lookup a bridge forwarding table entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B LLADDR
|
|
Packit Service |
3880ab |
the Ethernet MAC address.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI dev " DEV"
|
|
Packit Service |
3880ab |
the interface to which this address is associated.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI brport " DEV"
|
|
Packit Service |
3880ab |
the bridge port to which this address is associated. same as dev above.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI br " DEV"
|
|
Packit Service |
3880ab |
the bridge to which this address is associated.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B self
|
|
Packit Service |
3880ab |
- the address is associated with the port drivers fdb. Usually hardware.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B master
|
|
Packit Service |
3880ab |
- the address is associated with master devices fdb. Usually software (default).
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH bridge mdb - multicast group database management
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B mdb
|
|
Packit Service |
3880ab |
objects contain known IP multicast group addresses on a link.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.P
|
|
Packit Service |
3880ab |
The corresponding commands display mdb entries, add new entries,
|
|
Packit Service |
3880ab |
and delete old ones.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge mdb add - add a new multicast group database entry
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This command creates a new mdb entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI dev " DEV"
|
|
Packit Service |
3880ab |
the interface where this group address is associated.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI port " PORT"
|
|
Packit Service |
3880ab |
the port whose link is known to have members of this multicast group.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI grp " GROUP"
|
|
Packit Service |
3880ab |
the IP multicast group address whose members reside on the link connected to
|
|
Packit Service |
3880ab |
the port.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B permanent
|
|
Packit Service |
3880ab |
- the mdb entry is permanent
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B temp
|
|
Packit Service |
3880ab |
- the mdb entry is temporary (default)
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI vid " VID"
|
|
Packit Service |
3880ab |
the VLAN ID which is known to have members of this multicast group.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.in -8
|
|
Packit Service |
3880ab |
.SS bridge mdb delete - delete a multicast group database entry
|
|
Packit Service |
3880ab |
This command removes an existing mdb entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
The arguments are the same as with
|
|
Packit Service |
3880ab |
.BR "bridge mdb add" .
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge mdb show - list multicast group database entries
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This command displays the current multicast group membership table. The table
|
|
Packit Service |
3880ab |
is populated by IGMP and MLD snooping in the bridge driver automatically. It
|
|
Packit Service |
3880ab |
can be altered by
|
|
Packit Service |
3880ab |
.B bridge mdb add
|
|
Packit Service |
3880ab |
and
|
|
Packit Service |
3880ab |
.B bridge mdb del
|
|
Packit Service |
3880ab |
commands manually too.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI dev " DEV"
|
|
Packit Service |
3880ab |
the interface only whose entries should be listed. Default is to list all
|
|
Packit Service |
3880ab |
bridge interfaces.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
With the
|
|
Packit Service |
3880ab |
.B -details
|
|
Packit Service |
3880ab |
option, the command becomes verbose. It prints out the ports known to have
|
|
Packit Service |
3880ab |
a connected router.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
With the
|
|
Packit Service |
3880ab |
.B -statistics
|
|
Packit Service |
3880ab |
option, the command displays timer values for mdb and router port entries.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH bridge vlan - VLAN filter list
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B vlan
|
|
Packit Service |
3880ab |
objects contain known VLAN IDs for a link.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.P
|
|
Packit Service |
3880ab |
The corresponding commands display vlan filter entries, add new entries,
|
|
Packit Service |
3880ab |
and delete old ones.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge vlan add - add a new vlan filter entry
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This command creates a new vlan filter entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI dev " NAME"
|
|
Packit Service |
3880ab |
the interface with which this vlan is associated.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI vid " VID"
|
|
Packit Service |
3880ab |
the VLAN ID that identifies the vlan.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BI tunnel_info " TUNNEL_ID"
|
|
Packit Service |
3880ab |
the TUNNEL ID that maps to this vlan. The tunnel id is set in
|
|
Packit Service |
3880ab |
dst_metadata for every packet that belongs to this vlan (applicable to
|
|
Packit Service |
3880ab |
bridge ports with vlan_tunnel flag set).
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B pvid
|
|
Packit Service |
3880ab |
the vlan specified is to be considered a PVID at ingress.
|
|
Packit Service |
3880ab |
Any untagged frames will be assigned to this VLAN.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B untagged
|
|
Packit Service |
3880ab |
the vlan specified is to be treated as untagged on egress.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B self
|
|
Packit Service |
3880ab |
the vlan is configured on the specified physical device. Required if the
|
|
Packit Service |
3880ab |
device is the bridge device.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B master
|
|
Packit Service |
3880ab |
the vlan is configured on the software bridge (default).
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge vlan delete - delete a vlan filter entry
|
|
Packit Service |
3880ab |
This command removes an existing vlan filter entry.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
The arguments are the same as with
|
|
Packit Service |
3880ab |
.BR "bridge vlan add".
|
|
Packit Service |
3880ab |
The
|
|
Packit Service |
3880ab |
.BR "pvid " and " untagged"
|
|
Packit Service |
3880ab |
flags are ignored.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge vlan show - list vlan configuration.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This command displays the current VLAN filter table.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
With the
|
|
Packit Service |
3880ab |
.B -statistics
|
|
Packit Service |
3880ab |
option, the command displays per-vlan traffic statistics.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS bridge vlan tunnelshow - list vlan tunnel mapping.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
This command displays the current vlan tunnel info mapping.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH bridge monitor - state monitoring
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
The
|
|
Packit Service |
3880ab |
.B bridge
|
|
Packit Service |
3880ab |
utility can monitor the state of devices and addresses
|
|
Packit Service |
3880ab |
continuously. This option has a slightly different format.
|
|
Packit Service |
3880ab |
Namely, the
|
|
Packit Service |
3880ab |
.B monitor
|
|
Packit Service |
3880ab |
command is the first in the command line and then the object list follows:
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.BR "bridge monitor" " [ " all " |"
|
|
Packit Service |
3880ab |
.IR OBJECT-LIST " ]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.I OBJECT-LIST
|
|
Packit Service |
3880ab |
is the list of object types that we want to monitor.
|
|
Packit Service |
3880ab |
It may contain
|
|
Packit Service |
3880ab |
.BR link ", " fdb ", and " mdb "."
|
|
Packit Service |
3880ab |
If no
|
|
Packit Service |
3880ab |
.B file
|
|
Packit Service |
3880ab |
argument is given,
|
|
Packit Service |
3880ab |
.B bridge
|
|
Packit Service |
3880ab |
opens RTNETLINK, listens on it and dumps state changes in the format
|
|
Packit Service |
3880ab |
described in previous sections.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.P
|
|
Packit Service |
3880ab |
If a file name is given, it does not listen on RTNETLINK,
|
|
Packit Service |
3880ab |
but opens the file containing RTNETLINK messages saved in binary format
|
|
Packit Service |
3880ab |
and dumps them.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH NOTES
|
|
Packit Service |
3880ab |
This command uses facilities added in Linux 3.0.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
Although the forwarding table is maintained on a per-bridge device basis
|
|
Packit Service |
3880ab |
the bridge device is not part of the syntax. This is a limitation of the
|
|
Packit Service |
3880ab |
underlying netlink neighbour message protocol. When displaying the
|
|
Packit Service |
3880ab |
forwarding table, entries for all bridges are displayed.
|
|
Packit Service |
3880ab |
Add/delete/modify commands determine the underlying bridge device
|
|
Packit Service |
3880ab |
based on the bridge to which the corresponding ethernet device is attached.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH SEE ALSO
|
|
Packit Service |
3880ab |
.BR ip (8)
|
|
Packit Service |
3880ab |
.SH BUGS
|
|
Packit Service |
3880ab |
.RB "Please direct bugreports and patches to: " <netdev@vger.kernel.org>
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH AUTHOR
|
|
Packit Service |
3880ab |
Original Manpage by Stephen Hemminger
|