display ip-pool pool-usage pool

Function

The display ip-pool pool-usage pool command displays the usage of the address pool.

This command is supported only on the NetEngine 8000 F1A.

Format

display ip-pool pool-usage { pool-name [ pool-name ] | all | vpn-instance [ vpn-instance ] }

Parameters

Parameter	Description	Value
pool-name pool-name	Specifies the name of an address pool. If pool-name is not specified, the usage of all local IPv4 address pools will be displayed. If pool-name is specified, the usage of a specific IPv4 address pool will be displayed.	The value is a string of 1 to 128 case-insensitive characters.
all	Displays the usage of all IPv4 address pools, including the local, remote and server address pools. The number of addresses in the remote address pool is the number of IP addresses in the network segment of the gateway.	-
vpn-instance vpn-instance	Specifies the name of a VPN instance name.	The value is a string of 1 to 31 case-insensitive characters.

Parameter

Description

Value

pool-name pool-name

Specifies the name of an address pool. If pool-name is not specified, the usage of all local IPv4 address pools will be displayed. If pool-name is specified, the usage of a specific IPv4 address pool will be displayed.

The value is a string of 1 to 128 case-insensitive characters.

all

Displays the usage of all IPv4 address pools, including the local, remote and server address pools. The number of addresses in the remote address pool is the number of IP addresses in the network segment of the gateway.

vpn-instance vpn-instance

Specifies the name of a VPN instance name.

The value is a string of 1 to 31 case-insensitive characters.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
ippool	read

Usage Guidelines

Usage Scenario

If all is specified, the address utilization of all address pools and the bound VPN instances are displayed.

If pool-name is specified without specific address pool name, the address utilization rate of all address pools will be displayed; otherwise, the address utilization rate of the specified address pool will be displayed.

If vpn-instance is specified without VPN instance name, the address utilization rate of all VPN instances will be displayed; otherwise, the address utilization rate of the specified VPN instance will be displayed.

Precautions

In VS mode, this command is supported only by the admin VS.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about the address pools bound to a VPN instance.

<HUAWEI> display ip-pool pool-usage vpn-instance
  ------------------------------------------------------------
  VPN-Instance name                PoolLen    Used    Ratio
  ------------------------------------------------------------
  v4                                 65278       0       0%
  ------------------------------------------------------------
  Total statistics                   65278       0       0%
  ------------------------------------------------------------

# Display information about all address pools.

[~HUAWEI] display ip-pool  pool-usage pool-name
  ---------------------------------------------------------------
  Pool name                         PoolLen     Used        Ratio
  ---------------------------------------------------------------
  huawei                            19          9           47%      
  v4                                0           0           0%       
  v4pool                            14          7           50%      
  zy                                199         149         74%      
  ------------------------------------------------------------------
  Total statistics                  232         165         71%      
  ------------------------------------------------------------------

# Display information about the specified address pool name huawei

[~80] display ip-pool  pool-usage pool-name huawei
  ---------------------------------------------------------------
  Pool name                         PoolLen     Used        Ratio
  ---------------------------------------------------------------
  huawei                            19          9           47%      
  ------------------------------------------------------

**Table 1** Description of the **display ip-pool pool-usage pool** command output
Item	Description
VPN-Instance name	Name of a VPN instance.
PoolLen	Total number of IPv4 addresses in the domain.
Used	Number of used IPv4 addresses in the domain.
Ratio	Usage of the IPv4 address pool of the domain.
Total statistics	Total number of address pools bound to a VPN instance.