show ip dhcp-client statistics

Last Updated : Oct 21, 2015 |

Displays the DHCP Client statistics counters.

When you use this command in the interface context, the output displays the counters of the interface. When you use this command in the general context, the output displays the sum of all DHCP client counters, for all interfaces on which it is configured.

When the ip address dhcp command is used, the DHCP Client statistics counters for the relevant interface are cleared. The global parameters are not cleared.

Syntax

show ip dhcp-client statistics

User level

read-only

Context

interface: FastEthernet

Examples

To show the DHCP Client statistics counters in the interface context:

Gxxx-001(config-if:FastEthernet 10/3)# show ip dhcp-client statistics
DHCP client interface statistics:
Tx counters:
Discover          : 1
Request           : 1
Decline           : 0
Release           : 0
Rx counters:
Offer             : 1
Ack               : 1
Nak               : 0

To show the DHCP Client statistics counters in the general context:

Gxxx-001# show ip dhcp-client statistics
DHCP clients total statistics:
Tx counters:
Discover          : 1
Request           : 2
Decline           : 0
Release           : 0
Rx counters:
Offer             : 1
Ack               : 2
Nak               : 0

Output fields

Name

Description

Tx counters

The number of transmitted packets of the following types

Discover

A DHCP Client’s first packet, to discover a DHCP server and request an IP address allocation

Request

A DHCP Client packet to request/renew a specific IP address offered/allocated by the DHCP server

Decline

A DHCP client packet sent when discovering congestion with the IP address allocated by the DHCP server

Release

A DHCP client release packet sent when releasing the IP address allocated by the DHCP server

Rx counters

The number of received packets of the following types:

Offer

A DHCP server packet sent as a response to a DHCP client Discover packet, containing the offered IP address

Ack

A DHCP server acknowledgement of the DHCP client request packet

Nak

A DHCP server refusal packet to a DHCP client request