show ip dhcp-client

Last Updated : Oct 21, 2015 |
Displays the configuration of the DHCP client.
Prolog information
Metadata
Keywords:

Syntax

show ip dhcp-client (in the interface context)
show ip dhcp-client {interface-type interface-identifier | brief } (in the general context)

Parameters

Parameter
Description
Possible Values
Default Value
interface-type
The type of interface
FastEthernet
interface- identifier
The interface identifier
module number/port number
brief
A keyword indicating to display the configuration in brief

User level

read-only

Context

interface: FastEthernet

Example

To show the configuration of the DHCP client in the FastEthernet context:
Gxxx-001(config-if:FastEthernet )# show ip dhcp-client
DHCP Client Mode:                    Enable
Status:                              Bound.
IP address:                          10.1.1.2
Subnet Mask:                         255.255.255.0
Default Router:                      10.1.1.1 10.1.1.250
DHCP Server:                         10.1.2.20
Domain name:                         avaya.com
DNS Server:                          122.22.22.33 133.33.33.33
Lease Received (D:H:M:S):            2:2:3:4
Lease Remains (D:H:M:S):             1:2:3:4
Lease Rebind (D:H:M:S):              0:0:8:45
Lease Renew (D:H:M:S):               0:0:5:0
Lease Requested (D:H:M:S):           5:0:0:0
Host Name:                           Gxxx
-1
Client Identifier:                   01:11:22:33:44:55:66
Requested Options:                   default – router(3)
                                     Dns-servers(6)
                                     Domain-name(15)
Track-id:                            1
To show the configuration of the DHCP client in the general context:
Gxxx-001(super)# show ip dhcp-client brief
Interface             Status       IP address    Lease-Remain
                             (D:H:M:S)
---------             ------       ----------    ------------
Fastethernet      Bound         1.1.1.2        1:2:3:4

Output fields

Name
Description
DHCP Client Mode
Whether DHCP Client is Enabled or Disabled
Status
The status of the DHCP client:
  • Select. Sending DISCOVER packets.
  • Request. Requesting IP address after selecting from all the offered packets.
  • Bound. Receiving ACK packet and there is no conflict detection by sending ARP packets.
  • Rebind. 0.875 of the lease time has passed, so the renewal phase entered rebind.
  • Renew. 0.5 of the lease time has passed, so the device is trying to renew the lease until 0.875 of the lease time will have passed.
  • Release. The client released the lease.
  • Decline. The client detected an IP conflict by sending an ARP packet.
  • Idle. The client did not get an IP address and keeps trying after an Idle time (~40 seconds) to reach new IP address.
IP address
The IP address received from the DHCP server
Subnet Mask
The subnet mask received from the DHCP server
Default Router
The list of default routers received from the DHCP server
DHCP Server
The IP address of the DHCP server
Domain name
The DHCP client’s domain name received from the DHCP server
DNS Server
The list of available DNS servers received from the DHCP server
Lease Received
The amount of time the DHCP server grants the DHCP client an IP address
Lease Remains
The amount of time remaining until the expiration of the current lease.
Lease Rebind
The amount of time remaining until the rebind phase (0.875 of the lease time)
Lease Renew
The amount of time remaining until the renew phase (0.5 of the lease time)
Lease Requested
The lease requested by the DHCP client (see ip dhcp client lease)
Host Name
The host name of the DHCP client. The default value is the gateway’s hostname, unless otherwise specified using the ip dhcp client hostname command.
Client Identifier
The client identifier of the DHCP client. The value is the MAC address of the interface, unless otherwise specified using the ip dhcp client client-id command.
Requested Options
The options requested by the DHCP client from the DHCP server. These options include:
  • The default routers
  • The available DNS servers
  • The domain name
These options can be changed using the ip dhcp client request command.
Track-id
The index of the object tracker monitoring the route, if applied