# Monitoring DHCP Local Server Leases

#### Purpose

Display lease information for a specific IP address or for all DHCP local server leases.

#### Action

To display information about a specific DHCP local server lease:

    host1#show ip dhcp-local leases 192.168.0.3

                              Dhcp Local Leases
                              -----------------
    Address            Hardware         Lease          Initiated/Renewed
    ------------   -----------------   --------   ----------------------------
    192.168.0.3    10-06-10-00-10-33   120        THU SEP 08 2005 08:02:11 UTC

    Address                 Expiration            Remaining
    ------------   ----------------------------   ---------
    192.168.0.3    THU SEP 08 2005 08:04:11 UTC   79

    Address            Initial Lease Start
    ------------   ----------------------------
    192.168.0.3    THU SEP 08 2005 08:01:12 UTC

To display information about all DHCP local server leases:

    host1#show ip dhcp-local leases

                              Dhcp Local Leases
                              -----------------
    Address            Hardware         Lease          Initiated/Renewed
    ------------   -----------------   --------   ----------------------------
    192.168.0.2    10-06-10-00-10-32   120        THU JUL 06 2006 08:02:11 UTC
    192.168.0.3    10-06-10-00-10-33   120        THU JUL 06 2006 08:02:11 UTC
    192.168.55.4   10-06-10-00-10-34   (600)      THU JUL 06 2006 09:57:22 UTC
    192.168.55.5   10-06-10-00-10-35   infinite   THU JUL 06 2006 08:03:10 UTC
    Address                 Expiration            Remaining
    ------------   ----------------------------   ---------
    192.168.0.2    THU JUL 06 2006 08:04:11 UTC   80
    192.168.0.3    THU JUL 06 2006 08:04:11 UTC   80
    192.168.55.4   THU JUL 06 2006 10:07:22 UTC   575
    192.168.55.5   THU JUL 06 2006 08:04:11 UTC   infinite
    Address            Initial Lease Start
    ------------   ----------------------------
    10.1.0.2       THU JUL 06 2006 08:01:12 UTC
    10.1.0.3       THU JUL 06 2006 08:01:12 UTC
    192.168.55.4   THU JUL 06 2006 09:54:19 UTC
    192.168.55.5   THU JUL 06 2006 08:03:10 UTC

#### Meaning

Table 116 lists the show ip dhcp-local leases command output fields.

Table 116: show ip dhcp-local leases Output Fields

Field Name | Field Description
--- | ---
Address | IP address
Hardware | MAC address of the subscriber’s computer
Lease | Infinite, or the number of seconds in which the IP address is available; grace period in parentheses for clients in the grace period
Initiated/Renewed | Day, date, and time the lease was most recently initiated or renewed; start time of grace period for clients in the grace period
Expiration | Day, date, and time the lease expires; expiration time of grace period for clients in the grace period
Remaining | Infinite, or the number of seconds remaining in the lease, if any; remaining time of grace period for clients in the grace period
Initial Lease Start | Day, date, and time the lease was initiated

#### Related Documentation

- show ip dhcp-local leases