ip bandwidth-percent eigrp
To configure the percentage of bandwidth that may be used by Enhanced IGRP (EIGRP) on an interface, use the ip bandwidth-percent eigrp command in interface configuration mode. To restore the default value, use the no form of this command.
ip bandwidth-percent eigrp as-number percent
no ip bandwidth-percent eigrp as-number percent
Syntax Description
as-number
Autonomous system number.
percent
Percent of bandwidth that EIGRP may use.
Defaults
50 percent
Command Modes
Interface configuration
Command History
Release Modification
11.2
This command was introduced.
Usage Guidelines
EIGRP will use up to 50 percent of the bandwidth of a link, as defined by the bandwidth interface configuration command. This command may be used if some other fraction of the bandwidth is desired. Note that values greater than 100 percent may be configured. The configuration option may be useful if the bandwidth is set artificially low for other reasons.
Examples
The following example allows EIGRP to use up to 75 percent (42 kbps) of a 56-kbps serial link in autonomous system 209:
interface serial 0
bandwidth 56
ip bandwidth-percent eigrp 209 75
Related Commands
Command Description
bandwidth (interface)
Sets a bandwidth value for an interface.
bandwidth (interface)
To set and communicate the current bandwidth value for an interface to higher-level protocols, use the bandwidth command in interface configuration mode. 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. For a full bandwidth DS3 line, enter the value 44736.
inherit
(Optional) Inherited bandwidth. Specifies how a subinterface inherits the bandwidth of its main interface.
Defaults
Default bandwidth values are set during startup; the bandwidth values can be displayed using the show interfaces EXEC command.
Command Modes
Interface configuration
Command History
Release Modification
10.0
This command was introduced.
12.2T
The inherit keyword was added.
Usage Guidelines
Bandwidth Information
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.
--------------------------------------------------------------------------------
Changing Bandwidth
For some media, such as Ethernet, the bandwidth is fixed; for other media, such as serial lines, you can change the actual bandwidth by adjusting hardware. For both classes of media, you can use the bandwidth configuration command to communicate the current bandwidth to the higher-level protocols.
Bandwidth Inheritance
Before the introduction of the bandwidth inherit command option, when the bandwidth value was changed on the main interface, existing subinterfaces did not inherit the bandwidth value from the main interface. If the subinterface was created before the bandwidth was changed on the main interface, then the subinterface would receive the default bandwidth of the main interface, not the configured bandwidth. Additionally, if the router was subsequently reloaded, the bandwidth of the subinterface would then change to the bandwidth configured on the main interface.
The bandwidth inherit command controls how a subinterface inherits the bandwidth of its main interface. This functionality eliminates the inconsistencies related to whether or not the router has been reloaded and what the order was in entering the commands.
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 kbps 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 or not the bandwidth inheritance setting is in effect.
Examples
The following example shows how to set the full bandwidth for DS3 transmissions:
Router(config)# interface serial 0
Router(config-if)# bandwidth 44736
Related Commands
Command Description
show interfaces
Displays statistics for all interfaces configured on the router.