# Monitoring the Maximum Number of Available Leases

#### Purpose

Display the maximum number of leases available for each VPI/VCI, VLAN, Ethernet subnetwork, or POS access interface type, or for a specific interface or subinterface.

#### Action

To display the maximum number of leases available for each interface type:

    host1(config)#show ip dhcp-local limits

    *****************************************
         DHCP Local Server Address Limits
    ATM Limit      - 48000
    VLAN Limit     - 48000
    POS Limit      - 1000
    Ethernet Limit - 48000

To display information about the maximum number of leases for a specific interface:

    host1(config)#show ip dhcp-local limits interface atm 3/1

            Dhcp Local Interface Limits
            ---------------------------
                                         Total
    Interface   Limit   Count   Denied   Denied
    ---------   -----   -----   ------   ------
    atm 3/1     300     127     5        29

To display information about the maximum number of leases on all interfaces:

    host1(config)#show ip dhcp-local limits interface

               Dhcp Local Interface Limits
               ---------------------------
                                              Total
    Interface        Limit   Count   Denied   Denied
    ---------        -----   -----   ------   ------
    fastEthernet0/0  200     0       0        0
    atm 3/1          300     127     5        29
    atm 4/2          5000    0       0        0
    atm 5/1          5000    15      2        5
    pos 2/1          1000    0       0        0

#### Meaning

Table 138 lists the show ip dhcp-local limits command output fields.

Table 138: show ip dhcp-local limits Output Fields

Field Name | Field Description
--- | ---
ATM Limit | Number of leases available for each VPI/VCI
VLAN Limit | Number of leases available for each VLAN
POS Limit | Number of leases available for each POS access interface
Ethernet Limit | Number of leases available for each Ethernet subnet
Limit | Number of leases available to the specified interface or subinterface; indicates the configured value for the interface type unless a specific lease value is configured for the particular interface
Count | Number of active leases on the interface
Denied | Number of lease requests denied during the current denial period; this number is reset to zero (and the denial period restarted) when the number of active leases no longer exceeds the configured limit
Total Denied | Total number of lease requests denied on the interface since the interface became active

#### Related Documentation

- show ip dhcp-local limits