display ip ipv6-prefix

Function

The display ip ipv6-prefix command displays an IPv6 prefix list.

Format

display ip ipv6-prefix [ ipv6-prefix-name ]

Parameters

Parameter	Description	Value
ipv6-prefix-name	Specifies the name of an IPv6 prefix list. If ipv6-prefix-name is not specified, all the configured IPv6 prefix lists are displayed.	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

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

An IPv6 prefix list is used to filter IPv6 addresses. You can run the display ipv6 ip-prefix command to:

View detailed information about a configured IPv6 prefix list.
Check whether the IPv6 prefix list is deleted after running the undo ip ipv6-prefix command.
View the number of routes that match or do not match the route-policy in an IPv6 prefix list.

Precautions

The display ipv6 ip-prefix command:

Displays the configuration information of a specified IPv6 prefix list if the name of the IPv6 prefix list is specified.
Displays the configuration information of all IPv6 prefix lists if the name of the IPv6 prefix list is not specified.
Does not display any information, if the IPv6 prefix list does not exist in the system or the IPv6 prefix list that is queried does not exist.

Before collecting the number of routes that match or do not match the route-policy in an IPv6 prefix list in a specified length of time, run the reset ip ipv6-prefix command to clear the original statistics.

Example

# Display all the IPv6 prefix lists.

<sysname> display ip ipv6-prefix

  Prefix-list6 abc
  Description prefixok
  Permitted 0
  Denied 0
  index:   10             permit  ::/0
  index:   20             permit  ::/1              ge  1   le  128

**Table 1** Description of the **display ip ipv6-prefix** command output
Item	Description
Prefix-list6	Name of the IPv6 prefix list.
Description	Description of an IPv6 prefix list. This field is displayed only after a description is configured using the ip ipv6-prefix ipv6-prefix-name description text command.
Permitted	Number of routes that match the route-policy.
Denied	Number of routes that do not match the route-policy.
index	Index of the entry in the IPv6 prefix list.
permit	Contents of the entry in the IPv6 prefix list.
ge	Greater than or equal to.
le	Less than or equal to.