display dhcp server ip-in-use

Use display dhcp server ip-in-use to display binding information about assigned IP addresses.

Syntax

display dhcp server ip-in-use [ [ ip ip-address ] [ vpn-instance vpn-instance-name ] | pool pool-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ip ip-address: Displays binding information about the specified IP address.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays binding information about assigned IP addresses for the public network.

pool pool-name: Displays binding information about the specified IP address pool. The pool name is a case-insensitive string of 1 to 63 characters.

Usage guidelines

If you do not specify any parameters, this command displays binding information about all assigned DHCP addresses.

If the lease deadline exceeds the year 2100, the lease expiration time is displayed as After 2100.

The client binding information can be used by other security modules such as IP source guard only when the DHCP server is configured on the gateway of DHCP clients.

Examples

# Display binding information about all assigned DHCP addresses.

<Sysname> display dhcp server ip-in-use
IP address       Client identifier/    Lease expiration      Type
                 Hardware address
10.1.1.1         4444-4444-4444        Not used              Static(F)
10.1.1.2         3030-3030-2e30-3030-  May 1 14:02:49 2009   Auto(C)
                 662e-3030-3033-2d45-
                 7468-6572-6e65-74
10.1.1.3         1111-1111-1111        After 2100            Static(C)

Table 8: Command output

Field	Description
IP address	IP address assigned.
Client identifier/Hardware address	Client ID or hardware address.
Lease expiration	Lease expiration time: Exact time (May 1 14:02:49 2009 in this example)—Time when the lease will expire. Not used—The IP address of the static binding has not been assigned to the specific client. Unlimited—Infinite lease expiration time. After 2100—The lease will expire after 2100.
Type	Binding types: Static(F)—A free static binding whose IP address has not been assigned. Static(O)—An offered static binding whose IP address has been selected and sent by the DHCP server in a DHCP-OFFER packet to the client. Static(C)—A committed static binding whose IP address has been assigned to the DHCP client. Auto(O)—An offered temporary dynamic binding whose IP address has been dynamically selected by the DHCP server and sent in a DHCP-OFFER packet to the DHCP client. Auto(C)—A committed dynamic binding whose IP address has been dynamically assigned to the DHCP client.

Related commands

reset dhcp server ip-in-use

prev	up	next
display dhcp server free-ip	home	display dhcp server pool