To suppress networks from being advertised in outbound NHRP updates (registration or
resolution), use the distribute-list command in router
configuration mode. To delete the distribute list and remove it from the running
configuration file, use the no form of this command.
distribute-list
{
acl-number
|
ext-acl-number
|
acl-name
|
route-map
route-map-name
|
prefix
list-name
gateway
prefix-list
|
gateway
prefix-list
}
out
[
interface-type
interface-number
]
no
distribute-list
{
acl-number
|
ext-acl-number
|
acl-name
|
route-map
route-map-name
|
prefix
list-name
gateway
prefix-list
|
gateway
prefix-list
}
out
[
interface-type
interface-number
]
Syntax Description
|
acl-number
|
IP access list number. The access list defines which networks are to
be received and which are to be suppressed in routing updates.
Range: 1–199.
|
| ext-acl-number |
Expanded access list number.
Range: 1300–1999.
|
| acl-name |
Standard access-list name.
|
|
prefix
list-name
|
Name of a prefix list. The prefix list defines which networks are to
be received and which are to be suppressed in routing updates, based
upon matching prefixes.
|
| gateway prefix-list |
Gateway based on which the incoming updates are filtered.
|
| route-map route-map-name |
Name of the route map that defines which networks are to be installed
in the routing table and which are to be filtered from the routing
table.
|
| out |
Applies the access list to outgoing routing updates.
|
| interface-type |
Optional: Interface type.
|
| interface-number |
Optional: Interface number on which the access list should be applied
to incoming updates. If no interface is specified, the access list
will be applied to all incoming updates. The
interface-type and
interface-number arguments can
apply if you specify an access list.
|
Command Default
If this command is configured, the distribute list will default to permitting all
traffic.
Command Modes
Router configuration (config-router)
Address family configuration (config-router-af)
Command History
|
Release
|
Modification
|
|
Cisco IOS XE Gibraltar 16.12.1
|
This command was introduced.
|
Usage Guidelines
The distribute-list
out command is used to filter outbound NHRP updates. An
access list, prefix list, gateway, or route map must be defined prior to
configuration of this command. Standard and expanded access lists are supported. IP
prefix lists are used to filter based on the bit length of the prefix. An entire
network, subnet, supernet, or single host route can be specified. Prefix list and
access list configuration is mutually exclusive when configuring a distribute list.
The command takes effect only for subsequent updates. Hence, the session must be
reset with the clear
ip
nhrp command for this change to take effect immediately.
Note |
Interface type and number arguments may be displayed in the CLI depending on the version of Cisco IOS software you are using.
However, the interface arguments are not supported in any Cisco IOS software release.
|
Addresses not specified in the distribute-list command will not be advertised in
outgoing routing updates after a distribute list is configured.
To suppress networks or routes from being received in inbound updates, use the distribute-list
in command.
Examples
In the following example, a prefix list and distribute list are defined to configure the nhrp routing process to advertise
only network 192.168.0.0. An outbound route refresh is initiated to activate the distribute-list.
Router(config)# ip prefix-list BLUE permit 192.168.0.0/16
Router(config)# router nhrp 50000
Router(config-router)# distribute-list prefix BLUE out
Router(config-router)# end
Router# clear ip nhrp
In the following example, an access list and a distribute list are defined to
configure the nhrp routing process to advertise only network 192.168.0.0.
Router(config)# access-list 1 permit 192.168.0.0 0.0.255.255
Router(config)# access-list 1 deny 0.0.0.0 255.255.255.255
Router(config)# router nhrp 50000
Router(config-router)# distribute-list 1 out
Router(config-router)# end
Router# clear ip nhrp
Feedback