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.