if-match ipv6 next-hop prefix-list

Function

The if-match ipv6 next-hop prefix-list command configures a filtering rule that is based on next-hop addresses of IPv6 routes.

The undo if-match ipv6 next-hop prefix-list command cancels the configuration.

By default, no filtering rule based on next-hop addresses of IPv6 routes is configured.

Format

if-match ipv6 next-hop prefix-list ipv6-prefix-name

undo if-match ipv6 next-hop prefix-list ipv6-prefix-name

Parameters

Parameter	Description	Value
prefix-list ipv6-prefix-name	Specifies the name of the IPv6 prefix list.	The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Parameter

Description

Value

prefix-list ipv6-prefix-name

Specifies the name of the IPv6 prefix list.

The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

Route-policy view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
route-base	write

Usage Guidelines

Usage Scenario

The filtering rule (based on the destination addresses, next hop addresses, or source addresses of IPv6 routes) configured using this command takes effect only after an IPv6 prefix or an ACL is configured.

If the if-match ipv6 next-hop prefix-list aa command is used but the ip ipv6-prefix aa is not configured, all routes are permitted. This is the same case when the ACL is used.
If the if-match ipv6 next-hop prefix-list aa command is used after the ip ipv6-prefix aa permit 2001:db8:1::1 128 command is used, the routes with the next hop address 2001:db8:1::1 are permitted. This is the same case when the ACL is used.

Prerequisites

A route-policy has been configured using the route-policy command.

An IPv6 prefix has been configured using the ip ipv6-prefix command.

Configuration Impact

When you filter routes based on the next hop addresses of IPv6 routes, the routes that match the filtering rule are permitted and the route that do not match the filtering rule are denied.

Precautions

If the next hop address or source address of a route to be filtered is 0::0, by default, the system matches the route and considers its mask length as 0.

If the next hop address or source address of a route to be filtered is not 0::0, by default, the system matches the route and considers its mask length as 128.

Example

# Define a rule to match the routes with the IPv6 routing information in the IPv6 prefix list named p1.

<HUAWEI> system-view
[~HUAWEI] route-policy policy permit node 10
[*HUAWEI-route-policy] if-match ipv6 address prefix-list p1
[*HUAWEI-route-policy] if-match ipv6 next-hop prefix-list p1
[*HUAWEI-route-policy] if-match ipv6 route-source prefix-list p1