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

mdc-admin

mdc-operator

Parameters

ip ip-address: Displays binding information about the specified assigned IP address. If you do not specify an IP address, this command displays binding information about all assigned IP addresses.

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 assigned IP addresses in the specified address pool. The pool name is a case-insensitive string of 1 to 63 characters. If you do not specify an address pool, this command displays binding information about assigned IP addresses in all address pools.

Usage guidelines

The binding information can be used by other security modules only when the DHCP server is configured on the gateway of DHCP clients.

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

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 2015   Auto(C)
                 662e-3030-3033-2d45-
                 7468-6572-6e65-74
10.1.1.3         1111-1111-1111        After 2100            Static(C)

Table 9: 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 2015 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 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