Cisco Nexus 5500 Series Operating manual

1
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Preface
This preface describes the audience, organization, and conventions of the Cisco Nexus 5500 Series
NX-OS Layer 2 Interfaces Command Reference. It also provides information on how to obtain related
documentation.
This preface includes the following sections:
•Audience, page 1
•Document Conventions, page 1
•Related Documentation, page 2
•Obtaining Documentation and Submitting a Service Request, page 3
Audience
This publication is for experienced users who configure and maintain Cisco NX-OS devices.
Document Conventions
Command descriptions use these conventions:
Convention Description
boldface font Commands and keywords are in boldface.
italic font Arguments for which you supply values are in italics.
[ ] Elements in square brackets are optional.
{x | y | z} Alternative keywords are grouped in braces and separated by vertical bars.
[ x | y | z ] Optional alternative keywords are grouped in brackets and separated by vertical
bars.
string A nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.

2
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter
Screen examples use these conventions:
This document uses the following conventions:
Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the
manual.
Caution Means reader be careful. In this situation, you might do something that could result in equipment damage
or loss of data.
Related Documentation
Documentation for Cisco Nexus 5000 Series Switches and Cisco Nexus 2000 Series Fabric Extenders is
available at the following URL:
http://www.cisco.com/en/US/products/ps9670/tsd_products_support_series_home.html
The documentation set includes the following types of documents:
•Licensing Information Guide
•Release Notes
•Installation and Upgrade Guides
•Configuration Guides
•Configuration Examples and TechNotes
•Programming Guides
•Operations Guides
•Error and System Message Guides
•Field Notices
•Security Advisories, Responses and Notices
•Troubleshooting Guide
•Command References
•MIB Reference Guide
screen font Terminal sessions and information that the switch displays are in screen font.
boldface screen
font
Information you must enter is in boldface screen font.
italic screen font Arguments for which you supply values are in italic screen font.
< > Nonprinting characters, such as passwords, are in angle brackets.
[ ] Default responses to system prompts are in square brackets.
!, # An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.

3
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter
Obtaining Documentation and Submitting a Service Request
Documentation Feedback
To provide technical feedback on this document or to report an error or ommission, please send your
comments to nexu[email protected]. We appreciate your feedback.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a
service request, and gathering additional information, see What’s New in Cisco Product Documentation
at: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html.
Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised
Cisco technical documentation as an RSS feed and delivers content directly to your desktop using a
reader application. The RSS feeds are a free service.

4
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter

17
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
New and Changed Information
This chapter provides release-specific information for each new and changed feature in the Cisco Nexus
5500 Series NX-OS Layer 2 Interfaces Command Reference. The latest version of this document is
available at the following Cisco website:
http://www.cisco.com/en/US/products/ps9670/prod_command_reference_list.html
To check for additional information about this Cisco NX-OS Release, see the Cisco Nexus 6000 Series
NX-OS Release Notes, Release 6.0 available at the following Cisco website:
http://www.cisco.com/en/US/products/ps9670/prod_release_notes_list.html
New and Changed Information for Cisco NX-OS Releases
This section includes the following topics:
•New and Changed Information for Cisco NX-OS Release 6.0(2)N1(2), page 17
New and Changed Information for Cisco NX-OS Release 6.0(2)N1(2)
Table 1 summarizes the new and changed features for Cisco NX-OS Release 6.0(2)N1(2) and tells you
where they are documented.
Table 1 New and Changed Information for Release 6.0(2)N1(2)
Feature Description Where Documented
QSFP+ GEM This feature was introduced. •B Commands
•C Commands
•D Commands
•I Commands
•M Commands
•S Commands
•Show Commands

18
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter

11
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
B Commands
This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with B.

12
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter B Commands
bandwidth (interface)
bandwidth (interface)
To set the inherited and received bandwidth values for an interface, use the bandwidth command. To
restore the default values, use the no form of this command.
bandwidth {kbps | inherit [kbps]}
no bandwidth {kbps | inherit [kbps]}
Syntax Description
Command Default 1000000 kbps
Command Modes Interface configuration mode
Subinterface configuration mode
Command History
Usage Guidelines The bandwidth command sets an informational parameter to communicate only the current bandwidth
to the higher-level protocols; you cannot adjust the actual bandwidth of an interface using this command.
The bandwidth inherit command controls how a subinterface inherits the bandwidth of its main
interface.
The no bandwidth inherit command enables all subinterfaces to inherit the default bandwidth of the
main interface, regardless of the configured bandwidth. If a bandwidth is not configured on a
subinterface, and you use the bandwidth inherit command, all subinterfaces will inherit the current
bandwidth of the main interface. If you configure a new bandwidth on the main interface, all
subinterfaces will use this new value.
If you do not configure a bandwidth on the subinterface and you configure the bandwidth inherit
command on the main interface, the subinterfaces will inherit the specified bandwidth.
In all cases, if an interface has an explicit bandwidth setting configured, then that interface will use that
setting, regardless of whether the bandwidth inheritance setting is in effect.
Examples This example shows how to configure the badwidth for a Layer 2 interface:
switch(config)# interface ethernet 1/5
switch(config-if)# bandwidth 1000
switch(config-if)#
kbps Informational bandwidth in kilobits per second. Valid values are from 1 to
10000000.
inherit (Optional) Specifies that the bandwidth be inherited from the parent
interface.
Release Modification
5.2(1)N1(1) This command was introduced.

13
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter B Commands
bandwidth (interface)
This example shows how to configure subinterfaces to inherit the bandwidth from the parent routed
interface:
switch(config)# interface ethernet 1/5
switch(config-if)# no switchport
switch(config-if)# bandwidth inherit 30000
switch(config-if)# interface ethernet 1/1.1
switch(config-subif)#
Related Commands Command Description
show interface Displays the interface configuration information.

14
Cisco Nexus 5500 Series NX-OS Layer 2 Interfaces Command Reference
OL-27880-02
Chapter B Commands
beacon (interface)
beacon (interface)
To turn on the beacon LED for a port of an interface, use the beacon command. To turn off the beacon
LED for the interface, use the no form of this command.
beacon
no beacon
Syntax Description This command has no arguments or keywords.
Command Default None
Command Modes Interface configuration mode
Command History
Usage Guidelines Use the beacon command to toggle the port LED of an interface to easily identify each time a beacon is
sent to check for pending packets on the interface.
Examples This example shows how to turn on the locator beacon LED for a specific interface:
switch(config)# interface ethernet 2/1
switch(config-if)# beacon
This example shows how to turn off the locator beacon LED for a specific interface:
switch(config)# interface ethernet 2/1
switch(config-if)# no beacon
Related Commands
Release Modification
5.2(1)N1(1) This command was introduced.
Command Description
show interface Displays configuration information for an interface.