mirror of
https://git.proxmox.com/git/mirror_iproute2
synced 2025-10-10 14:56:56 +00:00
d611682a8c
This patch finishes removing the replace option from the bridge
man page which I missed in this commit
commit 57b9785de3
Author: John Fastabend <john.r.fastabend@intel.com>
Date: Mon Aug 27 10:52:31 2012 -0700
iproute2: bridge: remove replace and change options
Also add documentation for "{ self | embedded }" already shown on
the cmd line help msg.
Signed-off-by: John Fastabend <john.r.fastabend@intel.com>
194 lines
4.0 KiB
Groff
194 lines
4.0 KiB
Groff
.TH BRIDGE 8 "1 August 2012" "iproute2" "Linux"
|
|
.SH NAME
|
|
bridge \- show / manipulate bridge addresses and devices
|
|
.SH SYNOPSIS
|
|
|
|
.ad l
|
|
.in +8
|
|
.ti -8
|
|
.B bridge
|
|
.RI "[ " OPTIONS " ] " OBJECT " { " COMMAND " | "
|
|
.BR help " }"
|
|
.sp
|
|
|
|
.ti -8
|
|
.IR OBJECT " := { "
|
|
.BR fdb " | " monitor " }"
|
|
.sp
|
|
|
|
.ti -8
|
|
.IR OPTIONS " := { "
|
|
\fB\-V\fR[\fIersion\fR] |
|
|
\fB\-s\fR[\fItatistics\fR]
|
|
|
|
.ti -8
|
|
.BR "bridge fdb" " { " add " | " del " } "
|
|
.I LLADDR
|
|
.B dev
|
|
.IR DEV " { "
|
|
.BR local " | " temp " } { "
|
|
.BR self " } { " embedded " } "
|
|
|
|
.ti -8
|
|
.BR "bridge fdb" " [ " show " ] [ "
|
|
.B dev
|
|
.IR DEV " ]"
|
|
|
|
.ti -8
|
|
.BR "bridge monitor" " [ " all " | " neigh " | " link " ]"
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
.BR "\-V" , " -Version"
|
|
print the version of the
|
|
.B bridge
|
|
utility and exit.
|
|
|
|
.TP
|
|
.BR "\-s" , " \-stats", " \-statistics"
|
|
output more information. If the option
|
|
appears twice or more, the amount of information increases.
|
|
As a rule, the information is statistics or some time values.
|
|
|
|
|
|
.SH BRIDGE - COMMAND SYNTAX
|
|
|
|
.SS
|
|
.I OBJECT
|
|
|
|
.TP
|
|
.B fdb
|
|
- Forwarding Database entry.
|
|
|
|
.SS
|
|
.I COMMAND
|
|
|
|
Specifies the action to perform on the object.
|
|
The set of possible actions depends on the object type.
|
|
As a rule, it is possible to
|
|
.BR "add" , " delete"
|
|
and
|
|
.B show
|
|
(or
|
|
.B list
|
|
) objects, but some objects do not allow all of these operations
|
|
or have some additional commands. The
|
|
.B help
|
|
command is available for all objects. It prints
|
|
out a list of available commands and argument syntax conventions.
|
|
.sp
|
|
If no command is given, some default command is assumed.
|
|
Usually it is
|
|
.B list
|
|
or, if the objects of this class cannot be listed,
|
|
.BR "help" .
|
|
|
|
.SH bridge fdb - forwarding database management
|
|
|
|
.B fdb
|
|
objects contain known Ethernet addresses on a link.
|
|
|
|
.P
|
|
The corresponding commands display fdb entries, add new entries,
|
|
and delete old ones.
|
|
|
|
.SS bridge fdb add - add a new fdb entry
|
|
|
|
This command creates a new fdb entry.
|
|
|
|
.TP
|
|
.BI "ADDRESS"
|
|
the Ethernet MAC address.
|
|
|
|
.TP
|
|
.BI dev " NAME"
|
|
the interface to which this address is associated.
|
|
|
|
.TP
|
|
.in +8
|
|
.B local
|
|
- the address is associated with a local interface on the system
|
|
and is never forwarded.
|
|
.sp
|
|
|
|
.B temp
|
|
- the address is a dynamic entry, and will be removed if not used.
|
|
.sp
|
|
|
|
.B self
|
|
- the address is associated with a software fdb (default)
|
|
.sp
|
|
|
|
.B embedded
|
|
- the address is associated with an offloaded fdb
|
|
.sp
|
|
|
|
.in -8
|
|
|
|
.SS bridge fdb delete - delete a forwarding database entry
|
|
This command removes an existing fdb entry.
|
|
|
|
.PP
|
|
The arguments are the same as with
|
|
.BR "bridge fdb add" ,
|
|
|
|
.SS bridge fdb show - list forwarding entries.
|
|
|
|
This commands displays current forwarding table.
|
|
|
|
.PP
|
|
With the
|
|
.B -statistics
|
|
option, the command becomes verbose. It prints out the last updated
|
|
and last used time for each entry.
|
|
|
|
.SH bridge monitor - state monitoring
|
|
|
|
The
|
|
.B bridge
|
|
utility can monitor the state of devices and addresses
|
|
continuously. This option has a slightly different format.
|
|
Namely, the
|
|
.B monitor
|
|
command is the first in the command line and then the object list follows:
|
|
|
|
.BR "bridge monitor" " [ " all " |"
|
|
.IR LISTofOBJECTS " ]"
|
|
|
|
.I OBJECT-LIST
|
|
is the list of object types that we want to monitor.
|
|
It may contain
|
|
.BR link ", and " fdb "."
|
|
If no
|
|
.B file
|
|
argument is given,
|
|
.B bridge
|
|
opens RTNETLINK, listens on it and dumps state changes in the format
|
|
described in previous sections.
|
|
|
|
.P
|
|
If a file name is given, it does not listen on RTNETLINK,
|
|
but opens the file containing RTNETLINK messages saved in binary format
|
|
and dumps them. Such a history file can be generated with the
|
|
|
|
|
|
.SH NOTES
|
|
This command uses facilities added in Linux 3.0.
|
|
|
|
Although the forwarding table is maintained on a per-bridge device basis
|
|
the bridge device is not part of the syntax. This is a limitation of the
|
|
underlying netlink neighbour message protocol. When displaying the
|
|
forwarding table, entries for all bridges are displayed.
|
|
Add/delete/modify commands determine the underlying bridge device
|
|
based on the bridge to which the coresponding ethernet device is attached.
|
|
|
|
|
|
.SH SEE ALSO
|
|
.BR ip (8)
|
|
.br
|
|
.RB "Please direct bugreports and patches to: " <netdev@vger.kernel.org>
|
|
|
|
.SH AUTHOR
|
|
Original Manpage by Stephen Hemminger
|