show bridge

show bridge

Syntax Description

Usage Guidelines

show bridge cache Display

show bridge statistics Display

show bridge spigots Display

show bridge config Display

show bridge spanning Display

Examples

show bridge cache Example

show bridge statistics Example

show bridge spigots Example

show bridge config Example

show bridge spanning Example

Related Commands

show bridge

Displays bridging information within the router.

show bridge {cache | statistics | spigots | config [Status] | spanning}

cache

This command will display the bridge's Ethernet address cache. The cache table contains hashed Ethernet addresses that are looked up to determine where to forward a particular packet.

The first line of the display contains statistics about the hashing performance of the bridge. The rest of the display is the contents of the cache.

statistics

This command displays bridge statistics on a per spigot basis.

spigots

This command displays the status of the bridge spigots, including current filtering masks. A bridge spigot is a physical or a virtual interface on the bridge. This command is mostly used to debug bridging problems and displays raw information of several important internal bridging parameters.

config [Status]

This command displays the current bridge configuration as stored in Flash ROM, or if a modified configuration exists in the command loop edit buffer, its information is displayed. The show bridge config command with the optional Status parameter displays the runtime parameters used by the system at the time the command is issued. The same parameters (with potentially different values) are displayed by all variations of these show bridge commands.

spannning

This command displays the IEEE Spanning Tree configuration of the bridge. If Spanning Tree is disabled, no information will be displayed by this command.

cache	This command will display the bridge's Ethernet address cache. The cache table contains hashed Ethernet addresses that are looked up to determine where to forward a particular packet. The first line of the display contains statistics about the hashing performance of the bridge. The rest of the display is the contents of the cache.
statistics	This command displays bridge statistics on a per spigot basis.
spigots	This command displays the status of the bridge spigots, including current filtering masks. A bridge spigot is a physical or a virtual interface on the bridge. This command is mostly used to debug bridging problems and displays raw information of several important internal bridging parameters.
config [Status]	This command displays the current bridge configuration as stored in Flash ROM, or if a modified configuration exists in the command loop edit buffer, its information is displayed. The show bridge config command with the optional Status parameter displays the runtime parameters used by the system at the time the command is issued. The same parameters (with potentially different values) are displayed by all variations of these show bridge commands.
spannning	This command displays the IEEE Spanning Tree configuration of the bridge. If Spanning Tree is disabled, no information will be displayed by this command.

Usage Guidelines

The following sections describe the display contents for each command.

show bridge cache Display

The information shown for show bridge cache includes:

Station Addr

The Ethernet address that has been detected on the network.

Spigot

The bridge spigot that was most recently associated with the Ethernet address. The router's addresses are listed as Router or Rtr Mcast.

Pkt Cnt

The number of packets received from the station while the entry has been in the cache. If a station has timed out, the packet count from that station is cleared.

Bucket

The hash bucket in which the Ethernet address has been placed. Hash buckets range from 0 to 255.

Flags

Currently there are two caching flags displayed: Current and Perm. Current indicates that the most recent packet has been received from the station in less than half of the aging interval. Perm indicates that the entry is considered permanent and will never be timed out.

Station Addr	The Ethernet address that has been detected on the network.
Spigot	The bridge spigot that was most recently associated with the Ethernet address. The router's addresses are listed as Router or Rtr Mcast.
Pkt Cnt	The number of packets received from the station while the entry has been in the cache. If a station has timed out, the packet count from that station is cleared.
Bucket	The hash bucket in which the Ethernet address has been placed. Hash buckets range from 0 to 255.
Flags	Currently there are two caching flags displayed: Current and Perm. Current indicates that the most recent packet has been received from the station in less than half of the aging interval. Perm indicates that the entry is considered permanent and will never be timed out.

show bridge statistics Display

The information shown for show bridge statistics includes:

Statistic Type

There are two main statistic types for the show bridge statistics command, Packets In and Packets Out. These two types tally the number of packets received and transmitted per bridge spigot. The statistic types are described below:

Packets In

The total number of packets received by the bridge spigot. Received packets are broken down into the Filtered, Routed, and Forwarded subtypes.

Filtered

The total number of packets which the bridge received and discarded. The subtypes of this type are Bridge, Blocked, Protocol, Routed Protocol and No Hash Entry.

Bridge. The number of packets discarded because the transmitting and receiving stations are on the same bridge spigot.

Blocked. The number of packets discarded as a result of the Spanning Tree algorithm. Packets will be blocked if the spigot state is blocked, listening, or learning.

Protocol. The number of packets discarded because of protocol filtering.

Routed Protocol. The number of packets discarded because the protocol is currently being routed on this port, and the packet was not addressed to the station address of the router.

No Hash Entry. The number of packets discarded because the bridge was out of hash table entries. This tally should be 0; if it isn't, increase the allocation of hash table entries using the Bridging Global section.

Routed

Packets listed as routed were handed to the router input routines and were dispatched by the router switching routines.

Forwarded

The number of packets that have been forwarded by the bridge.

Packets Out

The total number of packets transmitted by the bridge spigot. Transmitted packets are broken down into the Broadcast and Flooded subtypes. These two subtypes will not add up to the total number of transmitted packets on this spigot.

Broadcast

This tally is the number of broadcast packets that were transmitted by this bridge spigot.

Flooded

This tally is the number of flooded packets that were transmitted by this bridge spigot. Flooded packets are transmitted out all spigots by the bridge, like broadcast packets. They include multicast packets, and those packets with unknown or new destination Ethernet addresses.

Statistic Type	There are two main statistic types for the show bridge statistics command, Packets In and Packets Out. These two types tally the number of packets received and transmitted per bridge spigot. The statistic types are described below:
Packets In	The total number of packets received by the bridge spigot. Received packets are broken down into the Filtered, Routed, and Forwarded subtypes. Filtered The total number of packets which the bridge received and discarded. The subtypes of this type are Bridge, Blocked, Protocol, Routed Protocol and No Hash Entry. Bridge. The number of packets discarded because the transmitting and receiving stations are on the same bridge spigot. Blocked. The number of packets discarded as a result of the Spanning Tree algorithm. Packets will be blocked if the spigot state is blocked, listening, or learning. Protocol. The number of packets discarded because of protocol filtering. Routed Protocol. The number of packets discarded because the protocol is currently being routed on this port, and the packet was not addressed to the station address of the router. No Hash Entry. The number of packets discarded because the bridge was out of hash table entries. This tally should be 0; if it isn't, increase the allocation of hash table entries using the Bridging Global section. Routed Packets listed as routed were handed to the router input routines and were dispatched by the router switching routines. Forwarded The number of packets that have been forwarded by the bridge.
Packets Out	The total number of packets transmitted by the bridge spigot. Transmitted packets are broken down into the Broadcast and Flooded subtypes. These two subtypes will not add up to the total number of transmitted packets on this spigot. Broadcast This tally is the number of broadcast packets that were transmitted by this bridge spigot. Flooded This tally is the number of flooded packets that were transmitted by this bridge spigot. Flooded packets are transmitted out all spigots by the bridge, like broadcast packets. They include multicast packets, and those packets with unknown or new destination Ethernet addresses.

show bridge spigots Display

The information shown for show bridge spigots includes:

Spigot

This is the bridge spigot name; all spigots configured will be listed by this display.

Port ID

The Port ID is a Spanning Tree parameter. The Port ID is the spigot number combined with its priority.

Pmask

The hexadecimal value of the protocol mask in effect for the spigot.

Rpmask

The hexadecimal value of the router protocol mask which indicates the protocols that are being routed for a spigot.

State

The Spanning Tree state for the spigot.

Flags

The hexadecimal value of the spigot flags.

Spigot	This is the bridge spigot name; all spigots configured will be listed by this display.
Port ID	The Port ID is a Spanning Tree parameter. The Port ID is the spigot number combined with its priority.
Pmask	The hexadecimal value of the protocol mask in effect for the spigot.
Rpmask	The hexadecimal value of the router protocol mask which indicates the protocols that are being routed for a spigot.
State	The Spanning Tree state for the spigot.
Flags	The hexadecimal value of the spigot flags.

show bridge config Display

The information shown for show bridge config includes:

Global Bridge Parameters

The Hash Table Size and Table Aging Time values are displayed. If no bridging is enabled, this is all that will be displayed.

Spanning Tree Parameters

Many of these values are only valid if the bridge is the root bridge. All bridges on a Spanning Tree bridged network use the values set by the root bridge. If Spanning Tree is not enabled, no parameters will be displayed.

Port parameters

These parameters include filter settings, priorities, and path costs.

Global Bridge Parameters	The Hash Table Size and Table Aging Time values are displayed. If no bridging is enabled, this is all that will be displayed.
Spanning Tree Parameters	Many of these values are only valid if the bridge is the root bridge. All bridges on a Spanning Tree bridged network use the values set by the root bridge. If Spanning Tree is not enabled, no parameters will be displayed.
Port parameters	These parameters include filter settings, priorities, and path costs.

show bridge spanning Display

The information shown for show bridge spanning includes:

Spanning Tree parameters

For the bridge and the root bridge on the network. The values used by the bridge are those of the root bridge. Also displayed are a flag indicating if the bridge is the root bridge; the root path cost; and the root port on the bridge. See the Bridging Global section for descriptions of what the parameter values are and how to become the root bridge on the network.

Spanning Tree Port parameter

For spigots that are part of the Spanning Tree algorithm. The values displayed are the runtime values. The fields are described below:

Spigot. The bridge spigot name.

Port ID. The hexadecimal value of the Spanning Tree port ID for a spigot. The port ID is a combination of the spigot number and its priority. Lower numbers have higher priority.

State. The Spanning Tree state for the port. Possible states include: Listening, Learning, Forwarding, Blocked, and Disabled. Other states are possible, but have the same meaning as Disabled. The states have the following definitions:

Listening. In this state, a bridge spigot has just been enabled, and is preparing to participate in the Spanning Tree network. The bridge only learns of neighboring bridges and will not forward any packets or learn any addresses.

Learning. In this state, the bridge spigot has just left the Listening state, but it still isn't forwarding packets. Station addresses are learned and added to the address cache.

Forwarding. This state is the normal operating mode. Station addresses are learned and packets are forwarded.

Blocked. In this state, the spigot doesn't participate in the bridged network except to listen to Spanning Tree packets. This state is entered anytime that a loop is detected by the Spanning Tree algorithm.

Disabled. In this state, the spigot has been disabled by the administrator, and it is not included in the Spanning Tree computation in any way.

Priority. The priority of the spigot.

Path Cost. The path cost of a spigot, used to compute the cost/distance from the root bridge.

Designated Root . The root bridge as reported by the configuration packets received by the spigot.

Cost. The cost reported is the distance to the root bridge on the network attached to the spigot.

Designated Bridge and Port ID. These two parameters indicate the bridge with the highest priority on a network segment and the ID of the port with which it is attached.

Spanning Tree parameters	For the bridge and the root bridge on the network. The values used by the bridge are those of the root bridge. Also displayed are a flag indicating if the bridge is the root bridge; the root path cost; and the root port on the bridge. See the Bridging Global section for descriptions of what the parameter values are and how to become the root bridge on the network.
Spanning Tree Port parameter	For spigots that are part of the Spanning Tree algorithm. The values displayed are the runtime values. The fields are described below: Spigot. The bridge spigot name. Port ID. The hexadecimal value of the Spanning Tree port ID for a spigot. The port ID is a combination of the spigot number and its priority. Lower numbers have higher priority. State. The Spanning Tree state for the port. Possible states include: Listening, Learning, Forwarding, Blocked, and Disabled. Other states are possible, but have the same meaning as Disabled. The states have the following definitions: Listening. In this state, a bridge spigot has just been enabled, and is preparing to participate in the Spanning Tree network. The bridge only learns of neighboring bridges and will not forward any packets or learn any addresses. Learning. In this state, the bridge spigot has just left the Listening state, but it still isn't forwarding packets. Station addresses are learned and added to the address cache. Forwarding. This state is the normal operating mode. Station addresses are learned and packets are forwarded. Blocked. In this state, the spigot doesn't participate in the bridged network except to listen to Spanning Tree packets. This state is entered anytime that a loop is detected by the Spanning Tree algorithm. Disabled. In this state, the spigot has been disabled by the administrator, and it is not included in the Spanning Tree computation in any way. Priority. The priority of the spigot. Path Cost. The path cost of a spigot, used to compute the cost/distance from the root bridge. Designated Root . The root bridge as reported by the configuration packets received by the spigot. Cost. The cost reported is the distance to the root bridge on the network attached to the spigot. Designated Bridge and Port ID. These two parameters indicate the bridge with the highest priority on a network segment and the ID of the port with which it is attached.