2008/055 Solaris Bridging

[James Carlson]

James Carlson writes:
> Sowmini.Varadhan at Sun.COM writes:
> > a nit:
> > 
> > > dladm show-bridge [-p] [-s [-i <interval>]] [<bridge-name>]
> > 
> > should support the -o option, like the other show commands, i.e.,
> > 
> >   dladm show-bridge [-p] [-o field,..] [-s [-i <interval>]] [<bridge-name>]
> 
> Good point.  I'd modeled that one after the existing show-aggr, but I
> should have picked up the clearview/brussels change.  Consider the
> proposal updated.  ;-}

Your comment made me go back and update the spec in detail to show the
parameters that can be shown, and to add support for showing the
running bridging-related port status described in 802.1D, as well as
private interfaces used.  The diffs against the original spec are
below, and the new spec is in the case directory as "spec.txt".

diff -r 5243e2e65184 bridging-spec.txt
--- a/bridging-spec.txt	Mon Jan 28 16:55:42 2008 -0500
+++ b/bridging-spec.txt	Tue Jan 29 11:04:44 2008 -0500
@@ -235,12 +235,36 @@ 1.1 New dladm subcommands
 
       The options are the same as for the "create-bridge" subcommand.
 
-    dladm show-bridge [-p] [-s [-i <interval>]] [<bridge-name>]
+    dladm show-bridge [-p] [-o field,...] [-s [-i <interval>]]
+      [<bridge-name>]
 
       This subcommand shows the running status of bridges.  When given
       a bridge name, it shows the status of that one bridge.  If no
       bridge name is given, then it shows summary status of all
       bridges on the system.
+
+      The '-o' option allows the user to specify a comma-separated
+      case-insensitive list of fields to display.  The field name may
+      "all" to display all fields, or any combination of:
+
+	BRIDGE		Assigned name of the bridge (same as
+			<bridge-name>, if provided)
+	BRIDGEID	Bridge Identifier value (MAC + priority)
+	PRIORITY	Configured priority value (-p)
+	BMAXAGE		Configured bridge maximum age (-m)
+	BHELLOTIME	Configured bridge hello time (-h)
+	BFWDDELAY	Configured forwarding delay (-d)
+	FORCEPROTO	Configured forced maximum protocol (-f)
+	TCTIME		Time since last topology change in seconds
+	TCCOUNT		Count of the number of topology changes
+	TCHANGE		Topology change detected ("yes" or "no")
+	DESROOT		Bridge Identifier of the root node (MAC + priority)
+	ROOTCOST	Cost of the path to the root node
+	ROOTPORT	Port used to reach root node
+	MAXAGE		Maximum age value from root node
+	HELLOTIME	Hello time value from root node
+	FWDDELAY	Forward delay value from root node
+	HOLDTIME	Minimum BPDU interval
 
       Note the lack of a "-R" option here.  It is not possible to list
       bridge configuration information in an alternate root, in
@@ -251,7 +275,30 @@ 1.1 New dladm subcommands
       but "reading" is not feasible because the repository on the
       alternate root may be incompatible with the running system.
 
+    dladm show-bridge -P [-p] [-o field,...] [-s [-i <interval>]]
+      <bridge-name>
+
+      This variant of the show-bridge subcommand displays port-related
+      information for a single bridge instance.  Note that configured
+      parameters are shown through show-linkprop.  The relevant field
+      names for the "show-bridge -P" subcommand are:
+
+	PORT		Link name
+	STATE		"disabled", "listening", "learning",
+			"forwarding", or "blocking"
+	UPTIME		Number of seconds since last reset or initialize
+	DESROOT		Root Bridge Identifier (MAC + priority) seen
+			on this port
+	DESCOST		Path cost to root node through designated port
+	DESBRIDGE	Bridge Identifier (MAC + priority)
+	DESPORT		Port ID and priority of port used to transmit
+			configuration messages for this port
+	TCACK		Topology Change Acknowledge flag ("yes" or "no")
+
 1.2 New dladm Link Properties
+
+    These may be used with the existing dladm set-linkprop,
+    reset-linkprop, and show-linkprop subcommands.
 
     "stp"
 
@@ -590,6 +637,7 @@ 6.  Interface Summary
     Interface		Stability		Comments
     ---------		---------		--------
     dladm *-bridge	Committed
+    field names		Committed		dladm show-bridge -o
     link properties	Committed
     kstats		Volatile		Should be raised later
     /dev/bridge/	Committed		Observability node
@@ -599,3 +647,6 @@ 6.  Interface Summary
     config/*		Project Private		SMF properties
     bridge module	Project Private		Kernel bridging module
     DLPI_BRIDGE		Committed		dlpi_open(3DLPI)
+    /var/run/bridge_door/
+			Project Private		Doors interface to daemons
+    librstp.so.1	Project Private		RSTP implementation

-- 
James Carlson, Solaris Networking              <james.d.carlson at sun.com>
Sun Microsystems / 35 Network Drive        71.232W   Vox +1 781 442 2084
MS UBUR02-212 / Burlington MA 01803-2757   42.496N   Fax +1 781 442 1677