show ip dhcp-client

Last Updated : Oct 21, 2015 |

Displays the configuration of the DHCP client.

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