Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation

show dhcp relay statistics

Syntax

show dhcp relay statistics <logical-system logical-system-name><routing-instance routing-instance-name>

Syntax

Syntax for EX Series switches:

show dhcp relay statistics <routing-instance routing-instance-name>

Release Information

Command introduced in Junos OS Release 8.3.

Command introduced in Junos OS Release 12.1 for EX Series switches.

Command introduced in Junos OS Release 12.1X48R3 for PTX Series Packet Transport Switches.

Description

Display Dynamic Host Configuration Protocol (DHCP) relay statistics.

Options

logical-system logical-system-name

(On routers only) (Optional) Perform this operation on the specified logical system. If you do not specify a logical system name, statistics are displayed for the default logical system.

routing-instance routing-instance-name

(Optional) Perform this operation on the specified routing instance. If you do not specify a routing instance name, statistics are displayed for the default routing instance.

Required Privilege Level

view

List of Sample Output

show dhcp relay statistics

Output Fields

Table 1 lists the output fields for the show dhcp relay statistics command. Output fields are listed in the approximate order in which they appear.

Table 1: show dhcp relay statistics Output Fields

Field Name

Field Description

Packets dropped

Number of packets discarded by the extended DHCP relay agent application due to errors. Only nonzero statistics appear in the Packets dropped output. When all of the Packets dropped statistics are 0 (zero), only the Total field appears.

  • Total—Total number of packets discarded by the extended DHCP relay agent application.
  • Bad hardware address—Number of packets discarded because an invalid hardware address was specified.
  • Bad opcode—Number of packets discarded because an invalid operation code was specified.
  • Bad options—Number of packets discarded because invalid options were specified.
  • Invalid server address—Number of packets discarded because an invalid server address was specified.
  • No available addresses—Number of packets discarded because there were no addresses available for assignment.
  • No interface match—Number of packets discarded because they did not belong to a configured interface.
  • No routing instance match—Number of packets discarded because they did not belong to a configured routing instance.
  • No valid local address—Number of packets discarded because there was no valid local address.
  • Packet too short—Number of packets discarded because they were too short.
  • Read error—Number of packets discarded because of a system read error.
  • Send error—Number of packets that the extended DHCP relay application could not send.
  • Option 60—Number of packets discarded containing DHCP option 60 vendor-specific information.
  • Option 82—Number of packets discarded because DHCP option 82 information could not be added.

Messages received

Number of DHCP messages received.

  • BOOTREQUEST—Number of BOOTP protocol data units (PDUs) received
  • DHCPDECLINE—Number of DHCP PDUs of type DECLINE received
  • DHCPDISCOVER—Number of DHCP PDUs of type DISCOVER received
  • DHCPINFORM—Number of DHCP PDUs of type INFORM received
  • DHCPRELEASE—Number of DHCP PDUs of type RELEASE received
  • DHCPREQUEST—Number of DHCP PDUs of type REQUEST received

Messages sent

Number of DHCP messages sent.

  • BOOTREPLY—Number of BOOTP PDUs transmitted
  • DHCPOFFER—Number of DHCP OFFER PDUs transmitted
  • DHCPACK—Number of DHCP ACK PDUs transmitted
  • DHCPNACK—Number of DHCP NACK PDUs transmitted
  • DHCPFORCERENEW—Number of DHCP FORCERENEW PDUs transmitted

Packets forwarded

Number of packets forwarded.

  • BOOTREQUEST—Number of BOOTREQUEST protocol data units (PDUs) forwarded
  • BOOTREPLY—Number of BOOTREPLY protocol data units (PDUs) forwarded

Sample Output

show dhcp relay statistics

user@host> show dhcp relay statistics
Packets dropped:
    Total                      30
    Bad hardware address       1
    Bad opcode                 1
    Bad options                3
    Invalid server address     5
    No available addresses     1
    No interface match         2
    No routing instance match  9
    No valid local address     4
    Packet too short           2
    Read error                 1
    Send error                 1
    Option 60                  1
    Option 82                  2

Messages received:
    BOOTREQUEST                116
    DHCPDECLINE                0
    DHCPDISCOVER               11
    DHCPINFORM                 0
    DHCPRELEASE                0
    DHCPREQUEST                105

Messages sent:
    BOOTREPLY                  0
    DHCPOFFER                  2
    DHCPACK                    1
    DHCPNAK                    0
    DHCPFORCERENEW             0

Packets forwarded:
    Total                      4
    BOOTREQUEST                2
    BOOTREPLY                  2

Published: 2013-03-14

Published: 2013-03-14