show ip dhcp-server subnet

Displays information on a DHCP subnet.

Syntax

Command Parameters

[A.B.C.D/X]
Specifies a subnet network address and mask. Include this optional parameter to view information on a specific subnet.
detail
Include this optional parameter to view a more detailed summary.

Command Mode

User EXEC

Command Output

The show ip dhcp-server subnet [A.B.C.D/X] [detail] command displays the following information:

Output field

Description

SUBNET

Displays the subnet network address and mask.

IP ADDRESS RANGE

Displays the starting and ending IP addresses of the address pool.

TOTAL ADDRESSES

Displays the total number of addresses that the pool allows irrespective of whether those addresses are leased currently.

LEASED ADDRESSES

Displays the total number of addresses that are leased currently.

Lease-Time

Displays the lease expiration timer that is configured for the subnet.

TFTP Server IP

Displays the IP address of the TFTP server that the subnet uses.

TFTP Server Name

Displays the server name of the TFTP server that the subnet uses.

TFTP Bootfile-Name

Displays the filename of the boot image file that the subnet uses.

Domain name

Displays the subnet domain name.

Netbios-name-server

Displays the NetBIOS name server that the subnet uses.

Netbios-type

Displays the node type for the NetBIOS name server that the subnet uses.

Router

Displays the IP address(es) of the subnet router (s).

DNS

Displays the IP address(es) of the DNS server(s) that the subnet uses.

NTP Server

Displays the IP address(es) of the NTP server(s) that the subnet uses.

DHCP Custom Option <224-254>

Displays the subnet data value that is assigned to any DHCP Custom Option(s). Depending on the Custom Option, this value may be an IPv4 address, integer, or string.

Example

The following example shows output for the show ip dhcp-server subnet command:

Switch:1#show ip dhcp-server subnet
========================================================================================
                                 DHCP Server Subnets Info
========================================================================================
SUBNET            IP ADDRESS RANGE               TOTAL ADDRESSES    LEASED ADDRESSES
----------------------------------------------------------------------------------------
192.0.2.0/24      192.0.2.1 - 192.0.2.254              254                0
198.51.100.0/24   198.51.100.1 - 198.51.100.80          80                2
----------------------------------------------------------------------------------------
 Total Number of DHCP Server subnets displayed: 2
----------------------------------------------------------------------------------------

The following example shows output for the show ip dhcp-server subnet detail command:

Switch:1#show ip dhcp-server subnet detail
================================================================================
                       DHCP Server Subnets Detailed Info
================================================================================

================================================================================
                             Subnet 192.0.2.0/24
================================================================================
IP Address Range          : 192.0.2.1 - 192.0.2.254
Total Addresses           : 254
Leased Addresses          : 0
Lease-Time                : 4000
TFTP Server IP            : 0.0.0.0
TFTP Server Name          :
TFTP Bootfile-Name        :
Domain Name               :
Netbios-name-server       : 0.0.0.0
Netbios-type              : 0x0

Router 1                  : 192.0.2.5

DNS 1                     : 203.0.113.14
DNS 2                     : 203.0.113.15

================================================================================
                              Subnet 198.51.100.0/24
================================================================================
IP Address Range          : 198.51.100.1 - 198.51.100.80
Total Addresses           : 80
Leased Addresses          : 2
Lease-Time                : 4000
TFTP Server IP            : 203.0.113.20
TFTP Server Name          :
TFTP Bootfile-Name        :
Domain Name               :
Netbios-name-server       : 0.0.0.0
Netbios-type              : 0x0

Router 1                  : 198.51.100.79
Router 2                  : 198.51.100.80
NTP Server 1              : 203.0.113.34
Custom-Option 250         : 203.0.113.23
--------------------------------------------------------------------------------
 Total Number of DHCP Server subnets displayed: 2
--------------------------------------------------------------------------------