Command:

distribute-list out


Mode:

Router(config-router)#

Router(config-router-af)#


Syntax:

distribute-list {access-list-number | prefix prefix-list-name [gateway prefix-list-name]} out [interface-name | routing-process | as-number]
no distribute-list {access-list-number | prefix prefix-list-name [gateway prefix-list-name]} out [interface-name | routing-process | as-number]

 

Syntax Description:

access-list-number Standard IP access list number. The list defines which networks are to be received and which are to be suppressed in routing updates.
prefix prefix-list-name Name of a prefix list. The list defines which networks are to be received and which are to be suppressed in routing updates, based upon matching the network prefix to the prefixes in the list.
gateway prefix-list-name (Optional) Name of the prefix list to be applied to the gateway of the prefix being updated.
out Applies the access list to outgoing routing updates.
interface-name (Optional) Name of a particular interface.
routing-process (Optional) Name of a particular routing process, or the keyword static or connected.
as-number (Optional) Autonomous system number.

 

Command Description:

To suppress networks from being advertised in updates, use the distribute-list out command in address family or router configuration mode. To disable this function, use the no form of this command.

When redistributing networks, a routing process name can be specified as an optional trailing argument to the distribute-list command. Specifying an argument causes the access list or prefix list to be applied to only those routes derived from the specified routing process. After the process-specific access list or prefix list is applied, any access list or prefix list specified by a distribute-list command without a process name argument will be applied. Addresses not specified in the distribute-list command will not be advertised in outgoing routing updates.

Use the gateway keyword only with the prefix-list keyword.


Example:

The following example causes only one network (network 131.108.0.0) to be advertised by a RIP routing process:

Router(config)#access-list 1 permit 131.108.0.0
Router(config)#access-list 1 deny 0.0.0.0 255.255.255.255
Router(config)#router rip
Router(config-router)#network 131.108.0.0
Router(config-router)#distribute-list 1 out


Misconceptions:

This command is intended for use with distance-vector protocols. It can be used with link-state protocols, but it has no effect. Since link-state protocols advertise links instead of routes, this command does not filter outgoing updates.


Related Commands:

access-list (IP extended)
distribute-list in
ip prefix-list
redistribute

� Cisco Systems, Inc. 2001, 2002, 2003
World Wide Education

Converted from CHM to HTML with chm2web Pro 2.85 (unicode)