ipv6 prefix-list
ipv6 prefix-list
{
name
|
sequence-number
}
deny
ipv6-prefix/prefix-length
[
ge
ge-value
]
[
le
le-value
]
ipv6 prefix-list
{
name
|
sequence-number
}
description
string
ipv6 prefix-list
{
name
|
sequence-number
}
permit
ipv6-prefix/prefix-length
[
ge
ge-value
]
[
le
le-value
]
ipv6 prefix-list
{
name
|
sequence-number
}
seq
sequence-number
permit
ipv6-prefix/prefix-length
[
ge
ge-value
]
[
le
le-value
]
ipv6 prefix-list
{
name
|
sequence-number
}
seq
sequence-number
deny
ipv6-prefix/prefix-length
[
ge
ge-value
]
[
le
le-value
]
no ipv6 prefix-list
name
A prefix-list is not created.
- deny ip-prefix/prefix-length
- Denies a packet that contains a route specified in the prefix list. The prefix list matches only on the specified prefix/prefix length, unless you use the ge ge-value or le le-value parameters.
- le le-value
- Specifies a maximum range of prefix lengths, up to 128, from the le-value to the prefix-length parameter.
- permit ip-prefix/prefix-length
- Permits a packet that contains a route specified in the prefix list. The prefix list matches only on the specified prefix/prefix length, unless you use the ge ge-value or le le-value parameters.
Global configuration mode
An IPv6 prefix list is composed of one or more conditional statements that execute a permit or deny action if a packet matches a specified prefix. In prefix lists with multiple statements, you can specify a sequence number for each statement. The specified sequence number determines the order in which the statement appears in the prefix.
You can configure an IPv6 prefix list on a global basis, then use it as input to other commands or processes, such as route aggregation, route redistribution, route distribution, route maps, and so on. When a device interface sends or receives an IPv6 packet, it applies the statements within the IPv6 prefix list in their order of appearance to the packet. As soon as a match occurs, the device takes the specified action (permit or deny the packet) and stops further comparison for that packet.
You can use permit statements in the prefix list to specify the traffic that you want to send to the other feature. If you use deny statements, the traffic specified by the deny statements is not supplied to the other feature. You can configure up to one hundred IPv6 prefix lists.
You must specify the ipv6-prefix parameter in hexadecimal using 16-bit values between colons as documented in RFC 4291. You must specify the prefix-length parameter as a decimal value. A slash mark (/) must follow the ipv6-prefix parameter and precede the prefix-length parameter.
The ge-value or le-value you specify must meet the following condition for prefix-length:
ge-value <= le-value <= 128
If you do not specify ge ge-value or le le-value, the prefix list matches only on the exact prefix you specify with the ipv6-prefix/prefix-length parameter.
Prefix lists can be applied to RIPng globally using the separate
prefix-list command) or at the interface level using the separate
ipv6 rip prefix-list command. If both global IPv6 RIP prefix list and interface IPv6 rip prefix list are
enabled, routes are filtered based on the interface prefix list.
The
no form of the command deletes a prefix list.
The following example creates a prefix-list that allows routes with the prefix 2001:db8::/32 to be included in RIPng routing updates sent from Ethernet interface 3/1/1.
device# configure terminal device(config)# ipv6 prefix-list routesfor2001 permit 2001:db8::/32 device(config) # interface ethernet 3/1/1 device(config-if-e1000-3/1/1)# ipv6 rip prefix-list routesfor2001 out
The following example creates a prefix-list that allows routes with the prefix 2001:db8::/32 to be included in RIPng routing updates sent from all the IPv6 RIP interfaces on the device.
device# configure terminal device(config)# ipv6 prefix-list routesfor2001 permit 2001:db8::/32 device(config)# ipv6 router rip device(config-ripng-router)# distribute-list prefix-list routesfor2001 out