show ip dhcp-relay counters

Display information about the Dynamic Host Configuration Protocol (DHCP) relay counters.

Syntax

show ip dhcp-relay counters
show ip dhcp-relay counters [option82]
show ip dhcp-relay counters [option82] [vrf WORD<1-16>]
show ip dhcp-relay counters [option82] [vrf WORD<1-16>] [vrfids <0-512>]
show ip dhcp-relay counters [option82] [vrfids <0-512>]
show ip dhcp-relay counters [vrf WORD<1-16>]
show ip dhcp-relay counters [vrf WORD<1-16>] [vrfids WORD<0-512>]
show ip dhcp-relay counters [vrfids WORD<0-512>]

Command Parameters

option82: Shows statistics for the relay agent option.
vrf WORD<1-16>: Specifies the name of the VRF.
vrfids <0-512>: Specifies the ID of the VRF. The value is an integer in the range of 0 to 512.

Default

None

Command Mode

User EXEC

Command Output

The show ip dhcp-relay counters option82 command displays the following information:


Output field	Description
INTERFACE	Shows the VLAN or port associated with the respective relay interface.
IP ADDR	Shows the IP address of the respective relay interface.
FOUND OPT82	Shows the number of packets received that included option82. This number increases every time a valid DHCP packet that contains option82 arrives on the respective relay interface.
DROP PKT	Shows the number of packets the interface did not forward. This number increases every time a DHCP packet that has option82 arrives on a relay interface but is not forwarded on the interface towards the server; the path towards the relay can include additional DHCP relays. To determine the cause of the drop, you must enable trace on level 170.
CIRC ID	Show the circuit ID associated with the respective interface.
ADD CIRC	Shows on how many packets the circuit ID was inserted for that interface. This number increases every time the relay adds a circuit id sub-option in a generated option82 packet to send on an interface towards the server. If you expect this value to increase but it does not, and the interface does not drop a packet, it is possible the packet does not have enough space to insert the option. You must enable trace on level 170 to determine the cause.
DEL CIRC	Shows on how many packets the circuit id was removed for that interface. This number increases every time the relay removes a circuit id sub-option from an option82 packet received on a interface towards the server.
REMOTE ID	Shows the remote ID associated with the respective interface. The value is the MAC address of the interface.
ADD REMID	Shows on how many packets the remote ID was inserted for that interface. This number increases every time the relay adds a remote id sub-option in a generated option82 packet to send through an interface towards a server. If you expect this value to increase but it does not, and the interface does not drop a packet, it is possible the packet does not have enough space to insert the option. You must enable trace on level 170 to determine the cause.
DEL REMID	Shows on how many packets the remote ID was removed for that interface. This number increases every time the relay removes a remote id sub-option from an option82 packet received on an interface towards a server.

Example

Switch:1>show ip dhcp-relay counters option82
==========================================================================================
                     DHCP Counters Option82 - GlobalRouter
==========================================================================================
               IP            FOUND DROP CIRC ADD  DEL   REMOTE             ADD    DEL
INTERFACE      ADDR          OP82  PKT  ID   CIRC CIRC  ID                 REMID   REMID
------------------------------------------------------------------------------------------
Port 1/12     192.0.1.10     0     0    395    0   0    00:24:7f:9d:0a:00   0     0     
Vlan40        192.0.1.20     0     0    2088   0   0    00:24:7f:9d:0a:01   0     0