Command:

distribute-list


Mode:

Router(config-router)#


Syntax:

 

distribute-list {access-list number | gateway | prefix} in | out [type number]

no distribute-list {access-list number | gateway | prefix} in | out [type number]


Syntax Description:

 

in

Filters incoming updates

out

Filters outgoing updates

access-list number | prefix | gateway 

A standard IP access list number. The access list defines which networks are to be received or sent (depending on whether the in or out parameter is used) and defines which networks are to be suppressed in routing updates. The keyword gateway filters incoming updates based on gateway. The keyword prefix filters based on prefixes contained in routing updates.

type

(Optional) Interface type. If no interface is specified, the access list will be applies to all incoming or outgoing updates (depending on whether the in or out parameter is used). 

number

(Optional) Interface number on which the access list is applied to incoming or outgoing updates (depending on whether the in or out parameter is used).

Command Description:

 

The distribute-list command is used to filter networks received or transmitted in routing updates. A network is defined using a standard access list. The optional [type number] argument allows filtering on a specific interface.


Example:

 

Router(config-router)#distribute-list 5 in serial 0/0


Misconceptions:

The distribute-list command works with all routing protocols (unlike some other methods of controlling routing updates). However, with OSPF, routes cannot be filtered from entering the OSPF database. The distribute-list in command only filters routes from entering the routing table, but it does not prevent link-state packets from being propagated. The command distribute-list out works only on routes being redistributed by ASBRs into OSPF. The command can be applied to external type 2 and external type 1 routes, but not to intra-area and inter-area routes.


Related Commands:

 

access-list (IP standard)

 

access-list (IP extended)

 

passive-interface

 

redistribute

 


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

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