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 |
Intended bandwidth, in kilobits per second. The range is from 1 to 10000000. |
inherit |
(Optional) Specifies the inherited bandwidth such as how a subinterface inherits the bandwidth of its main interface. |
Command Default
1000000 kbps
Command Modes
Interface configuration mode
Command History
Release |
Modification |
---|---|
4.0 |
This command was introduced. |
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.
![]() Note |
This is a routing parameter only. It does not affect the physical interface. |
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 inherit the current bandwidth of the main interface. If you configure a new bandwidth on the main interface, all subinterfaces 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 inherit the specified bandwidth.
In all cases, if an interface has an explicit bandwidth setting configured, that interface uses that setting, regardless of whether the bandwidth inheritance setting is in effect.
This command does not require a license.
Examples
This example shows how to configure all subinterfaces off this main interface to inherit the configured bandwidth:
switch(config-if)# bandwidth inherit 30000