|
 |
5ebd6f |
From 54e9c3a34d4ba8a0890f3bf21d708342329461b5 Mon Sep 17 00:00:00 2001
|
|
|
5ebd6f |
From: =?UTF-8?q?Petr=20P=C3=ADsa=C5=99?= <ppisar@redhat.com>
|
|
|
5ebd6f |
Date: Thu, 19 Sep 2013 10:41:26 +0200
|
|
|
5ebd6f |
Subject: [PATCH] iproute2: bridge: document mdb
|
|
|
5ebd6f |
MIME-Version: 1.0
|
|
|
5ebd6f |
Content-Type: text/plain; charset=UTF-8
|
|
|
5ebd6f |
Content-Transfer-Encoding: 8bit
|
|
|
5ebd6f |
|
|
|
5ebd6f |
This augments bridge(8) manual page with `bridge mdb' and `bridge
|
|
|
5ebd6f |
monitor mdb' commands which have been added recently.
|
|
|
5ebd6f |
|
|
|
5ebd6f |
Signed-off-by: Petr Písař <ppisar@redhat.com>
|
|
|
5ebd6f |
---
|
|
|
5ebd6f |
man/man8/bridge.8 | 88 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
|
|
|
5ebd6f |
1 file changed, 85 insertions(+), 3 deletions(-)
|
|
|
5ebd6f |
|
|
|
5ebd6f |
diff --git a/man/man8/bridge.8 b/man/man8/bridge.8
|
|
|
5ebd6f |
index 66678b5..9a34804 100644
|
|
|
5ebd6f |
--- a/man/man8/bridge.8
|
|
|
5ebd6f |
+++ b/man/man8/bridge.8
|
|
|
5ebd6f |
@@ -13,7 +13,7 @@ bridge \- show / manipulate bridge addresses and devices
|
|
|
5ebd6f |
|
|
|
5ebd6f |
.ti -8
|
|
|
5ebd6f |
.IR OBJECT " := { "
|
|
|
5ebd6f |
-.BR link " | " fdb " | " vlan " | " monitor " }"
|
|
|
5ebd6f |
+.BR link " | " fdb " | " mdb " | " vlan " | " monitor " }"
|
|
|
5ebd6f |
.sp
|
|
|
5ebd6f |
|
|
|
5ebd6f |
.ti -8
|
|
|
5ebd6f |
@@ -65,6 +65,21 @@ bridge \- show / manipulate bridge addresses and devices
|
|
|
5ebd6f |
.IR DEV " ]"
|
|
|
5ebd6f |
|
|
|
5ebd6f |
.ti -8
|
|
|
5ebd6f |
+.BR "bridge mdb" " { " add " | " del " } "
|
|
|
5ebd6f |
+.B dev
|
|
|
5ebd6f |
+.IR DEV
|
|
|
5ebd6f |
+.B port
|
|
|
5ebd6f |
+.IR PORT
|
|
|
5ebd6f |
+.B grp
|
|
|
5ebd6f |
+.IR GROUP " [ "
|
|
|
5ebd6f |
+.BR permanent " | " temp " ]"
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.ti -8
|
|
|
5ebd6f |
+.BR "bridge mdb show " [ "
|
|
|
5ebd6f |
+.B dev
|
|
|
5ebd6f |
+.IR DEV " ]"
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.ti -8
|
|
|
5ebd6f |
.BR "bridge vlan" " { " add " | " del " } "
|
|
|
5ebd6f |
.B dev
|
|
|
5ebd6f |
.IR DEV
|
|
|
5ebd6f |
@@ -79,7 +94,7 @@ bridge \- show / manipulate bridge addresses and devices
|
|
|
5ebd6f |
.IR DEV " ]"
|
|
|
5ebd6f |
|
|
|
5ebd6f |
.ti -8
|
|
|
5ebd6f |
-.BR "bridge monitor" " [ " all " | " neigh " | " link " ]"
|
|
|
5ebd6f |
+.BR "bridge monitor" " [ " all " | " neigh " | " link " | " mdb " ]"
|
|
|
5ebd6f |
|
|
|
5ebd6f |
.SH OPTIONS
|
|
|
5ebd6f |
|
|
|
5ebd6f |
@@ -110,6 +125,10 @@ As a rule, the information is statistics or some time values.
|
|
|
5ebd6f |
- Forwarding Database entry.
|
|
|
5ebd6f |
|
|
|
5ebd6f |
.TP
|
|
|
5ebd6f |
+.B mdb
|
|
|
5ebd6f |
+- Multicast group database entry.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.TP
|
|
|
5ebd6f |
.B vlan
|
|
|
5ebd6f |
- VLAN filter list.
|
|
|
5ebd6f |
|
|
|
5ebd6f |
@@ -326,6 +345,69 @@ With the
|
|
|
5ebd6f |
option, the command becomes verbose. It prints out the last updated
|
|
|
5ebd6f |
and last used time for each entry.
|
|
|
5ebd6f |
|
|
|
5ebd6f |
+.SH bridge mdb - multicast group database management
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.B mdb
|
|
|
5ebd6f |
+objects contain known IP multicast group addresses on a link.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.P
|
|
|
5ebd6f |
+The corresponding commands display mdb entries, add new entries,
|
|
|
5ebd6f |
+and delete old ones.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.SS bridge mdb add - add a new multicast group database entry
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+This command creates a new mdb entry.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.TP
|
|
|
5ebd6f |
+.BI dev " DEV"
|
|
|
5ebd6f |
+the interface where this group address is associated.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.TP
|
|
|
5ebd6f |
+.BI port " PORT"
|
|
|
5ebd6f |
+the port whose link is known to have members of this multicast group.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.TP
|
|
|
5ebd6f |
+.BI grp " GROUP"
|
|
|
5ebd6f |
+the IP multicast group address whose members reside on the link connected to
|
|
|
5ebd6f |
+the port.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.B permanent
|
|
|
5ebd6f |
+- the mdb entry is permanent
|
|
|
5ebd6f |
+.sp
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.B temp
|
|
|
5ebd6f |
+- the mdb entry is temporary (default)
|
|
|
5ebd6f |
+.sp
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.in -8
|
|
|
5ebd6f |
+.SS bridge mdb delete - delete a multicast group database entry
|
|
|
5ebd6f |
+This command removes an existing mdb entry.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.PP
|
|
|
5ebd6f |
+The arguments are the same as with
|
|
|
5ebd6f |
+.BR "bridge mdb add" .
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.SS bridge mdb show - list multicast group database entries
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+This command displays the current multicast group membership table. The table
|
|
|
5ebd6f |
+is populated by IGMP and MLD snooping in the bridge driver automatically. It
|
|
|
5ebd6f |
+can be altered by
|
|
|
5ebd6f |
+.B bridge mdb add
|
|
|
5ebd6f |
+and
|
|
|
5ebd6f |
+.B bridge mdb del
|
|
|
5ebd6f |
+commands manually too.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.TP
|
|
|
5ebd6f |
+.BI dev " DEV"
|
|
|
5ebd6f |
+the interface only whose entries should be listed. Default is to list all
|
|
|
5ebd6f |
+bridge interfaces.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
+.PP
|
|
|
5ebd6f |
+With the
|
|
|
5ebd6f |
+.B -details
|
|
|
5ebd6f |
+option, the command becomes verbose. It prints out the ports known to have
|
|
|
5ebd6f |
+a connected router.
|
|
|
5ebd6f |
+
|
|
|
5ebd6f |
.SH bridge vlan - VLAN filter list
|
|
|
5ebd6f |
|
|
|
5ebd6f |
.B vlan
|
|
|
5ebd6f |
@@ -395,7 +477,7 @@ command is the first in the command line and then the object list follows:
|
|
|
5ebd6f |
.I OBJECT-LIST
|
|
|
5ebd6f |
is the list of object types that we want to monitor.
|
|
|
5ebd6f |
It may contain
|
|
|
5ebd6f |
-.BR link ", and " fdb "."
|
|
|
5ebd6f |
+.BR link ", " fdb ", and " mdb "."
|
|
|
5ebd6f |
If no
|
|
|
5ebd6f |
.B file
|
|
|
5ebd6f |
argument is given,
|
|
|
5ebd6f |
--
|
|
|
5ebd6f |
1.8.3.1
|
|
|
5ebd6f |
|