-
Cisco Nexus 5000 Series Command Reference
-
Index
-
Preface
-
Cisco Nexus 5000 Series Basic System Commands
-
Cisco Nexus 5000 Series Ethernet Commands
-
Cisco Nexus 5000 Series Ethernet Show Commands
-
Cisco Nexus 5000 Series Quality of Service Commands
-
Cisco Nexus 5000 Series Security Commands
-
Cisco Nexus 5000 Series System Management Commands
-
Cisco Nexus 5000 Series Fibre Channel Commands
-
Cisco Nexus 5000 Series Fibre Channel Show Commands
-
Feedback
Table Of Contents
Cisco Nexus 5000 Series Ethernet Show Commands
show interface private-vlan mapping
show mac-address-table aging-time
show mac-address-table notification
show port-channel compatibility-parameters
show port-channel load-balance
show running-config spanning-tree
Cisco Nexus 5000 Series Ethernet Show Commands
This chapter describes the Cisco NX-OS Ethernet show commands available on Cisco Nexus 5000 Series switches.
show interface mac-address
To display the information about the MAC address, use the show interface mac-address command.
show interface [type slot/port] mac-address
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
If you do not specify an interface, the system displays all the MAC addresses.
Examples
This example shows how to display the information on MAC addresses for the entire switch:
switch# show interface mac-addressRelated Commands
show interface port-channel
To display the information about an EtherChannel interface configuration, use the show interface port-channel command.
show interface port-channel number[.subinterface-number] [brief | counters | description | status]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the configuration information of a specified EtherChannel interface:
switch# show interface port-channel 21Related Commands
show interface private-vlan mapping
To display information about private VLAN mapping for primary VLAN interfaces, use the show interface private-vlan mapping command.
show interface private-vlan mapping
Syntax Description
This command has no arguments or keywords.
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
Before you can configure private VLANs, you must enable them by using the feature private-vlan command. The commands for configuring private VLANs are not visible until you enable private VLANs.
This command displays the mapping information between the primary and secondary VLANs that allows both VLANs to share the VLAN interface of the primary VLAN.
Examples
This example shows how to display information about primary and secondary private VLAN mapping:
switch# show interface private-vlan mappingRelated Commands
show interface switchport
To display information about all the switch port interfaces, use the show interface switchport command.
show interface switchport
Syntax Description
This command has no arguments or keywords.
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display information for all Ethernet and virtual Ethernet interfaces:
switch# show interface switchportRelated Commands
switchport access vlan
Sets the access VLAN when the interface is in access mode.
show interface vlan
To display brief descriptive information about specified VLANs, use the show interface vlan command.
show interface vlan vlan_id [brief | description | private-vlan mapping]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
You must enable interface VLANs by using the feature interface-vlan or the svi enable command. The commands for configuring interface VLANs are not visible until you enable this feature.
This command displays descriptive information for the specified VLAN, including private VLANs.
The switch displays output for the show interface vlan vlan_id private-vlan mapping command only when you specify a primary private VLAN. If you specify a secondary private VLAN, the output is blank.
Examples
This example shows how to display information about the specified VLAN:
switch# show interface vlan 5This example shows how to display a brief description for the specified VLAN:
switch# show interface vlan 5 briefThis example shows how to display the description for a specified VLAN:
switch# show interface vlan 5 descriptionThis example shows how to display the private VLAN mapping information, if any, for the VLAN:
switch# show interface vlan 5 private-vlan mappingWhen you specify a primary VLAN, the switch displays all secondary VLANs mapped to that primary VLAN.
This example shows how to display the status of the VLAN:
switch# show interface vlan 5 statusRelated Commands
show ip igmp snooping
To display the Internet Group Management Protocol (IGMP) snooping configuration of the switch, use the show ip igmp snooping command.
show ip igmp snooping [explicit-tracking vlan vlan_id | groups [detail | vlan vlan_id] | mrouter [vlan vlan_id] | querier [vlan vlan_id] | vlan vlan_id]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display the IGMP snooping configuration of the switch:
switch# show ip igmp snoopingRelated Commands
Globally enables IGMP snooping. IGMP snooping must be globally enabled in order to be enabled on a VLAN.
Enables IGMP snooping on the VLAN interface.
show lacp
To display Link Aggregation Control Protocol (LACP) information, use the show lacp command.
show lacp {counters | interface ethernet slot/port | neighbor [interface port-channel number] | port-channel [interface port-channel number] | system-identifier}
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
Use the show lacp command to troubleshoot problems related to LACP in a network.
Examples
This example shows how to display the LACP system identification:
switch# show lacp system-identifiershow mac-address-table aging-time
To display information about the time-out values for the MAC address table, use the show mac-address-table aging-time command.
show mac-address-table aging-time [vlan vlan_id]
Syntax Description
vlan vlan_id
(Optional) Displays information for a specific VLAN; the range of valid values is from 1 to 4094.
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display MAC address aging times:
switch# show mac-address-table aging-timeRelated Commands
mac-address-table aging-time
Configures the aging time for entries in the MAC address table.
show mac-address-table
Displays information about the MAC address table.
show mac-address-table count
To display the number of entries currently in the MAC address table, use the show mac-address-table count command.
show mac-address-table count [address EEEE.EEEE.EEEE] [dynamic | static] [interface {type slot/port | port-channel number}] [vlan vlan_id]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display the number of dynamic entries currently in the MAC address table:
switch# show mac-address-table count dynamicRelated Commands
show mac-address-table notification
To display notifications about the MAC address table, use the show mac-address-table notification command.
show mac-address-table notification {mac-move | threshold}
Syntax Description
mac-move
Shows notification messages about MAC addresses that were moved.
threshold
Shows notification messages sent when the MAC address table threshold was exceeded.
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display MAC address move notifications:
switch# show mac-address-table notification mac-moveRelated Commands
show mac-address-table
To display the information about the MAC address table, use the show mac-address-table command.
show mac-address-table [address mac_address] [dynamic | multicast | static] [interface {type slot/port | port-channel number}] [vlan vlan_id]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
The switch maintains static MAC address entries that are saved in its startup configuration across reboots and flushes the dynamic entries.
Examples
This example shows how to display the information about the entries for the MAC address table:
switch# show mac address-tableThis example shows how to display the information about the entries for the MAC address table for a specific MAC address:
switch# show mac address-table address 0018.bad8.3fbdThis example shows how to display the information about the dynamic entries for the MAC address table:
switch# show mac address-table dynamicThis example shows how to display the information about the MAC address table for a specific interface:
switch# show mac address-table interface ethernet 1/3This example shows how to display the static entries in the MAC address table:
switch# show mac address-table staticThis example shows how to display the entries in the MAC address table for a specific VLAN:
switch# show mac address-table vlan 5Related Commands
show monitor session
To display information about the SPAN sessions, use the show monitor session command.
show monitor session [session | all [brief] | range range [brief] | status]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display information about SPAN session 1:
switch# show monitor session 1This example shows how to display a range of SPAN sessions:
switch# show monitor session range 1-4Related Commands
show port-channel capacity
To display the total number of EtherChannel interfaces and the number of free or used EtherChannel interfaces, use the show port-channel capacity command.
show port-channel capacity
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the EtherChannel capacity:
switch# show port-channel capacityRelated Commands
port-channel load-balance ethernet
Configures the load-balancing algorithm for EtherChannels.
show port-channel compatibility-parameters
To display the parameters that must be the same among the member ports in order to join an EtherChannel interface, use the show port-channel compatibility-parameters command.
show port-channel compatibility-parameters
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the EtherChannel interface parameters:
switch# show port-channel compatibility-parametersRelated Commands
port-channel load-balance ethernet
Configures the load-balancing algorithm for EtherChannels.
show port-channel database
To display the aggregation state for one or more EtherChannel interfaces, use the show port-channel database command.
show port-channel database [interface port-channel number[.subinterface-number]]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the aggregation state of all EtherChannel interfaces:
switch# show port-channel databaseRelated Commands
port-channel load-balance ethernet
Configures the load-balancing algorithm for EtherChannels.
show port-channel load-balance
To display information about EtherChannel load balancing, use the show port-channel load-balance command.
show port-channel load-balance [forwarding-path interface port-channel number [dst-ip ipv4-addr] [dst-ipv6 ipv6-addr] [dst-mac dst-mac-addr] [l4-dst-port dst-port] [l4-src-port src-port] [src-ip ipv4-addr] [src-ipv6 ipv6-addr] [src-mac src-mac-addr]]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the port channel load balance information:
switch# show port-channel load-balancePort Channel Load-Balancing Configuration:System: source-dest-ipPort Channel Load-Balancing Addresses Used Per-Protocol:Non-IP: source-dest-macIP: source-dest-ip source-dest-macswitch#Table 3-1 describes the fields shown in the display:
Related Commands
port-channel load-balance ethernet
Configures the load-balancing algorithm for EtherChannels.
show port-channel summary
To display summary information about EtherChannels, use the show port-channel summary command.
show port-channel summary
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Global configuration mode
EXEC mode
Command History
Usage Guidelines
Before you use this command, you must configure an EtherChannel group using the interface port-channel command.
Examples
This example shows how to display summary information about EtherChannels:
switch# show port-channel summaryRelated Commands
show port-channel traffic
To display the traffic statistics for EtherChannels, use the show port-channel traffic command.
show port-channel traffic [interface port-channel number[.subinterface-number]]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the traffic statistics for all EtherChannels:
switch# show port-channel trafficRelated Commands
port-channel load-balance ethernet
Configures the load-balancing algorithm for EtherChannels.
show port-channel usage
To display the range of used and unused EtherChannel numbers, use the show port-channel usage command.
show port-channel usage
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the EtherChannel usage information:
switch# show port-channel usageRelated Commands
port-channel load-balance ethernet
Configures the load-balancing algorithm for EtherChannels.
show running-config
To display the contents of the currently running configuration file, use the show running-config command.
show running-config [all]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display information on the running configuration:
switch# show running-configThis example shows how to display detailed information on the running configuration:
switch# show running-config allRelated Commands
show running-config spanning-tree
To display the running configuration for the Spanning Tree Protocol (STP), use the show running-config spanning-tree command.
show running-config spanning-tree [all]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display information on the running STP configuration:
switch# show running-config spanning-treeThis example shows how to display detailed information on the running STP configuration:
switch# show running-config spanning-tree all
Note
Display output differs slightly depending on whether you are running Rapid PVST+ or MST.
Related Commands
show running-config vlan
To display the running configuration for a specified VLAN, use the show running-config vlan command.
show running-config vlan vlan_id
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
This command provides information on the specified VLAN, including private VLANs.
The display varies with your configuration. If you have configured the VLAN name, shutdown status, or suspended status, these are also displayed.
Examples
This example shows how to display the running configuration for VLAN 5:
switch# show running-config vlan 5Related Commands
show spanning-tree
To display information about the Spanning Tree Protocol (STP), use the show spanning-tree command.
show spanning-tree [blockedports | inconsistentports | pathcost method]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
The STP port type displays only when you have configured the port as either an STP edge port or an STP network port. If you have not configured the STP port type, no port type displays.
Examples
This example shows how to display spanning tree information:
switch# show spanning-treeThis example shows how to display the blocked ports in spanning tree:
switch(config)# show spanning-tree blockedportsThis example shows how to determine if any ports are in any STP--inconsistent state:
switch# show spanning-tree inconsistentportsThis example shows how to display the path cost method:
switch(config)# show spanning-tree pathcost methodTable 3-2 describes the fields that are displayed in the output of show spanning-tree commands.
Note
Related Commands
show spanning-tree active
To display STP information on STP-active interfaces only, use the show spanning-tree active command.
show spanning-tree active [brief | detail]
Syntax Description
brief
(Optional) Displays a brief summary of STP interface information.
detail
(Optional) Displays a detailed summary of STP interface information.
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display STP information on the STP-active interfaces:
switch# show spanning-tree activeRelated Commands
show spanning-tree bridge
To display status and configuration of the local bridge, use the show spanning-tree bridge command.
show spanning-tree bridge [address | brief | detail | forward-time | hello-time | id | max-age | priority [system-id] | protocol]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows display STP information for the bridge:
switch# show spanning-tree bridgeRelated Commands
show spanning-tree brief
To display a brief summary of the STP status and configuration on the switch, use the show spanning-tree brief command.
show spanning-tree brief [active]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display a brief summary of STP information:
switch(config)# show spanning-tree briefRelated Commands
show spanning-tree detail
To display detailed information on the STP status and configuration on the switch, use the show spanning-tree detail command.
show spanning-tree detail [active]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display detailed information on the STP configuration:
switch(config)# show spanning-tree detailRelated Commands
show spanning-tree interface
To display information on the STP interface status and configuration of specified interfaces, use the show spanning-tree interface command.
show spanning-tree interface {interface slot/port | port-channel number} [active [brief | detail] | brief [active] | cost | detail [active] | edge | inconsistency | priority | rootcost | state]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
The STP port type displays only when you have configured the port as either an STP edge port or an STP network port. If you have not configured the STP port type, no port type displays.
If you specify an interface that is not running STP, the switch returns an error message.
When you are running MST, this command displays the PVST simulation setting.
Note
Examples
This example shows how to display STP information on a specified interface:
switch(config)# show spanning-tree interface ethernet 1/3This example shows how to display detailed STP information on a specified interface:
switch(config)# show spanning-tree interface ethernet 1/3 detailRelated Commands
show spanning-tree mst
To display information on MST status and configuration, use the show spanning-tree mst command.
show spanning-tree mst [instance_id [detail | interface {interface slot/port | port-channel number} [detail]]
show spanning-tree mst [configuration [digest]]
show spanning-tree mst [detail | interface {interface slot/port | port-channel number}} [detail]]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
If the switch is not running in STP MST mode when you enter this command, it returns the following message:
ERROR: Switch is not in mst modeExamples
This example shows how to display STP information about MST instance information for the VLAN ports that are currently active:
switch# show spanning-tree mstThis example shows how to display STP information about a specific MST instance:
switch)# show spanning-tree mst 0This example shows how to display detailed STP information about the MST protocol:
switch)# show spanning-tree mst detailThis example shows how to display STP information about specified MST interfaces:
switch)# show spanning-tree mst interface ethernet 8/2This example shows how to display information about the MST configuration:
switch)# show spanning-tree mst configurationThis example shows how to display the MD5 digest included in the current MST configuration:
switch)# show spanning-tree mst configuration digestSee Table 3-2 for descriptions of the fields that are displayed in the output of show spanning-tree commands.
Related Commands
show spanning-tree root
To display the status and configuration of the root bridge, use the show spanning-tree root command.
show spanning-tree root [address | brief | cost | detail | forward-time | hello-time | id | max-age | port | priority [system-id]]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display information for the root bridge:
switch(config)# show spanning-tree rootRelated Commands
show spanning-tree summary
To display summary STP information on the switch, use the show spanning-tree summary command.
show spanning-tree summary [totals]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
The display output for this command differs when you are running Rapid PVST+ or MST.
Examples
This example shows how to display a summary of STP information on the switch:
switch(config)# show spanning-tree summaryRelated Commands
show spanning-tree vlan
To display STP information for specified VLANs, use the show spanning-tree vlan command.
show spanning-tree vlan {vlan_id} [active [brief | detail]]
show spanning-tree vlan {vlan_id} [blockedports]
show spanning-tree vlan {vlan_id} [bridge [address] | brief | detail | forward-time | hello-time | id | max-age | priority [system-id] | protocol]
show spanning-tree vlan {vlan_id} [brief [active]
show spanning-tree vlan {vlan_id} [detail [active]]
show spanning-tree vlan {vlan_id} [inconsistentports]
show spanning-tree vlan {vlan_id} [interface {interface slot/port | port-channel number} [active [brief | detail]] | brief [active] | cost | detail [active] | edge | inconsistency | priority | rootcost | state]]
show spanning-tree vlan {vlan_id} [root [address | brief | cost | detail | forward-time | hello-time | id | max-age | port | priority [system-id]]
show spanning-tree vlan {vlan_id} [summary]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display STP information on VLAN 1:
switch# show spanning-tree vlan 1Related Commands
show startup-config
To display the contents of the currently running configuration file, use the show startup-config command.
show startup-config
Syntax Description
This command has no other arguments or keywords.
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display information from the startup configuration file:
switch# show startup-configRelated Commands
show running-config
Displays the contents of the currently running configuration file.
show vlan
To display VLAN information, use the show vlan command.
show vlan [brief | name {name} | summary]
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
This command displays information for all VLANs, including private VLANs, on the switch.
Each access port can belong to only one VLAN. Trunk ports can be on multiple VLANs.
Note
If you shut down a VLAN using the state suspend or the state active command, these values appear in the Status field:
•
•
If you shut down a VLAN using the shutdown command, these values appear in the Status field:
•
•
If a VLAN is shut down internally, these values appear in the Status field:
•
•
If a VLAN is shut down locally and internally, the value that is displayed in the Status field is act/ishut or sus/ishut. If a VLAN is shut down locally only, the value that is displayed in the Status field is act/lshut or sus/lshut.
Examples
This example shows how to display information for all VLANs on the switch:
switch# show vlanThis example shows how to display the VLAN name, status, and associated ports only:
switch# show vlan briefThis example shows how to display the VLAN information for a specific VLAN by name:
switch# show vlan name testThis example shows how to display information about the number of VLANs configured on the switch:
switch# show vlan summaryRelated Commands
show interface switchport
Displays information about the ports, including those in private VLANs.
show vlan private-vlan
Displays private VLAN information.
show vlan id
To display information and statistics for an individual VLAN or a range of VLANs, use the show vlan id command.
show vlan id {vlan_id}
Syntax Description
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
Use this command to display information and statistics on an individual VLAN or a range of VLANs, including private VLANs.
Note
Examples
This example shows how to display information for the individual VLAN 5:
switch# show vlan id 5Related Commands
show vlan private-vlan
To display private VLAN information, use the show vlan private-vlan command.
show vlan [id {vlan_id}] private-vlan [type]
Syntax Description
id vlan_id
(Optional) Displays private VLAN information for the specified VLAN.
type
(Optional) Displays the private VLAN type (primary, isolated, or community).
Command Default
None.
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
This example shows how to display information on all private VLANs on the switch:
switch(config)# show vlan private-vlanThis example shows how to display information for a specific private VLAN:
switch(config)# show vlan id 42 private-vlanThis example shows how to display information on the types of all private VLANs on the switch:
switch(config)# show vlan private-vlan typeThis example shows how to display information on the type for the specified private VLAN:
switch(config)# show vlan id 42 private-vlan typeRelated Commands
