B Commands

This chapter describes the Cisco NX-OS Ethernet and virtual Ethernet commands that begin with B.

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

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.

 
Command Default

1000000 kbps

 
Command Modes

Interface configuration mode
Subinterface configuration mode

 
Command History

Release
Modification

4.0(0)N1(1a)

This command was introduced.

5.0(3)N1(1)

Support for Layer 3 interfaces was added.

 
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)#
 

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.

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

Release
Modification

5.1(3)N1(1)

This command was introduced.

 
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

Command
Description

show interface

Displays configuration information for an interface.

 

bind (virtual Ethernet interface)

To bind an interface to a virtual Ethernet interface, use the bind command. To remove the binding of an interface, use the no form of this command.

bind interface ethernet slot / port channel number

no bind interface ethernet slot / port channel number

 
Syntax Description

interface ethernet

Specifies that the virtual Ethernet interface be bound to a specified Ethernet interface.

slot / port

Ethernet interface slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

channel

Specifies that the virtual Ethernet interface be bound to a specified EtherChannel interface.

number

EtherChannel number. The range is from 1 to 65535.

 
Command Default

Disabled

 
Command Modes

Virtual Ethernet interface configuration mode

 
Command History

Release
Modification

5.1(3)N1(1)

This command was introduced.

Examples

This example shows how to bind a virtual Ethernet interface 10 to an Ethernet interface:

switch(config)# interface vethernet 10
switch(config-if)# bind interface ethernet 1/1 channel 101
switch(config-if)#
 

 
Related Commands

Command
Description

interface vethernet

Configures a virtual Ethernet interface.

show interface ethernet

Displays information about Ethernet interfaces.

show interface vethernet

Displays the specified virtual Ethernet interface, attributes, and status.

show running-config interface

Displays the running configuration of an interface.