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.

prev	up	next
display dhcp server forbidden-ip	home	display dhcp server statistics