display dhcp server ip-in-use

Syntax

display dhcp server ip-in-use { all | ip ip-address | pool [ pool-name ] } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all: Displays binding information about all DHCP address pools.

ip ip-address: Displays binding information about a specific IP address.

pool [ pool-name ]: Displays binding information about a specific address pool. The pool name is a string of 1 to 35 characters. If no pool name is specified, this command displays binding information about all address pools.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display dhcp server ip-in-use to display binding information about DHCP address pools or an IP address.

Related commands: reset dhcp server ip-in-use.

Examples

# Display binding information about all DHCP address pools.

<Sysname> display dhcp server ip-in-use all
Pool utilization: 0.39%
 IP address    Client-identifier/    Lease expiration        Type
                  Hardware address
 10.1.1.1       4444-4444-4444        NOT Used                  Manual
 10.1.1.2      3030-3030-2e30-3030-   May  1 2009 14:02:49      Auto:COMMITTED
               662e-3030-3033-2d45-
               7468-6572-6e65-7430-
               2f31

 --- total 2 entry ---

Table 7: Command output

Field

Description

Pool utilization

Utilization rate of IP addresses in a DHCP address pool, which is the ratio of assigned IP addresses to assignable IP addresses in the DHCP address pool.

  • When binding information about all DHCP address pools is displayed, this field displays the total utilization rate of IP addresses in all DHCP address pools.

  • When binding information about a specific DHCP address pool is displayed, this field displays the utilization rate of IP addresses in the DHCP address pool.

  • When binding information about a specific IP address is displayed, this field is not displayed.

IP address

Bound IP address.

Client-identifier/Hardware address

Client’s ID or MAC of the binding.

Lease expiration

Lease expiration time:

  • Specific time (May 1 2009 14:02:49 in this example)—Time when the lease expires.

  • NOT Used—The IP address of the static binding has not been assigned to the specific client.

  • Unlimited—Infinite lease expiration time.

Type

Binding types:

  • Manual—Static binding.

  • Auto:OFFERED—The binding sent in the DHCP-OFFER message from the server to the client.

  • Auto:COMMITTED—The binding sent in the DHCP-ACK message from the server to the client.

In the output from the display dhcp server ip-in-use command, the lease duration of a used static binding is displayed as Unlimited instead of the actual lease duration. To display the actual lease duration, use the display this command in DHCP address pool view.