display ip ip-prefix

Function

The display ip ip-prefix command displays an IPv4 prefix list.

Format

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

Parameters

Parameter	Description	Value
ip-prefix-name	Specifies the name of an IPv4 prefix list. If ip-prefix-name is not specified, all the configured IPv4 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 IPv4 prefix list is used to filter IP addresses. You can run the display ip ip-prefix command to:

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

Precautions

The display ip ip-prefix command:

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

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

If The specified filter list does not exist is displayed in the command output, the specified IPv4 prefix list failed to be configured. To re-configure it, run the ip ip-prefix command in the system view.

Example

# Display the IPv4 prefix list named p1.

<sysname> display ip ip-prefix p1

  Prefix-list pl
  Description prefixok
  Permitted 0
  Denied 0
         index: 10      permit  192.168.0.0/16          ge  17  le  18

**Table 1** Description of the **display ip ip-prefix** command output
Item	Description
Prefix-list	Name of the IPv4 prefix list.
Description	Description of an IPv4 prefix list. This field is displayed only after a description is configured using the ip ip-prefix ip-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 IPv4 prefix list.
permit	Contents of the entry in the IPv4 prefix list.
ge	Greater than or equal to.
le	Less than or equal to.