show system services dhcp client

Syntax

show system services dhcp client < interface-name > <statistics>

Release Information

Command introduced in Release 8.5 of Junos OS.

Description

Display information about DHCP clients.

Options

none—Display DHCP information for all interfaces.

interface-name —(Optional) Display DHCP information for the specified interface.

statistics—(Optional) Display DHCP client statistics.

Required Privilege Level

view and system

Related Topics

dhcp

request system services dhcp

List of Sample Output

show system services dhcp client
show system services dhcp client ge-0/0/1.0
show system services dhcp client statistics

Output Fields

Table 159 lists the output fields for the show system services dhcp client command. Output fields are listed in the approximate order in which they appear.

Table 159: show system services dhcp client Output Fields

Field Name

Field Description

Logical Interface Name

Name of the logical interface.

Client Status

State of the client binding.

Vendor Identifier

Vendor ID.

Server Address

IP address of the DHCP server.

Address obtained

IP address obtained from the DHCP server.

Lease Obtained at

Date and time the lease was obtained.

Lease Expires at

Date and time the lease expires.

DHCP Options

  • Name: server-identifier, Value:IP address of the name server.
  • Name: device, Value: IP address of the name device.
  • Name: domain-name, Value: Name of the domain.

Packets dropped

Total packets dropped.

Messages received

Number of the following DHCP messages received:

  • DHCPOFFER—First packet received on a logical interface when DHCP is enabled.
  • DHCPACK—When received from the server, the client sends an ARP request for that address and adds a (ARP response) timer for 4 seconds and stop the earlier timer added for DHCPACK.
  • DHCPNAK—When a DHCPNAK is received instead of DHCPACK, the logical interface sends a DHCPDISCOVER packet.

Messages sent

Number of the following DHCP messages sent:

  • DHCPDECLINE—Packet sent when ARP response is received and there is a conflict. The logical interface sends a new DHCPDISCOVER packet.
  • DHCPDISCOVER—Packet sent on the interface for which the DHCP client is enabled.
  • DHCPREQUEST—Packet sent to the DHCP server after accepting the DHCPOFFER. After sending the DHCPREQUEST, the device adds a retransmission-interval timer.
  • DHCPINFORM—Packet sent to the DHCP server for local configuration parameters.
  • DHCPRELEASE—Packet sent to the DHCP server to relinquish network address and cancel remaining lease.
  • DHCPRENEW—Packet sent to the DHCP server to renew the address. The next message to be sent will be a DHCPREQUEST message, which will be unicast directly to the server.
  • DHCPREBIND—Packet sent to any server to renew the address. The next message to be sent will be a DHCPREQUEST message, which will be broadcast.

Sample Output

show system services dhcp client

user@host> show system services dhcp client 
Logical Interface Name       ge-0/0/1.0
      Hardware address        00:0a:12:00:12:12
      Client Status           bound
      Vendor Identifier       ether
      Server Address          10.1.1.1
      Address obtained        10.1.1.89
      update server           enabled
      Lease Obtained at       2006-08-24 18:13:04 PST
      Lease Expires at        2006-08-25 18:13:04 PST
 DHCP Options :
           Name: name-server, Value: [ 10.209.194.131, 2.2.2.2, 3.3.3.3 ]
           Name: server-identifier, Value: 10.1.1.1
           Name: router, Value: [ 10.1.1.80 ]
           Name: domain-name, Value: netscreen-50

Sample Output

show system services dhcp client ge-0/0/1.0

user@host> show system services dhcp client ge-0/0/1.0 
Logical Interface name         ge-0/0/1.0 
Hardware address        00:12:1e:a9:7b:81
Client status           bound
Address obtained        30.1.1.20
Update server           disabled
Lease obtained at       2007-05-10 18:16:18 UTC
Lease expires at        2007-05-11 18:16:18 UTC
DHCP options:
    Name: server-identifier, Value: 30.1.1.2
Code: 1, Type: ip-address, Value: 255.255.255.0
Name: name-server, Value: [ 77.77.77.77, 55.55.55.55 ]
Name: domain-name, Value: englab.juniper.net

Sample Output

show system services dhcp client statistics

user@host> show system services dhcp client statistics 
Packets dropped:
    Total                      0
Messages received:
    DHCPOFFER                  0
    DHCPACK                    8
    DHCPNAK                    0
Messages sent:
    DHCPDECLINE                0
    DHCPDISCOVER               0
    DHCPREQUEST                1
    DHCPINFORM                 0
    DHCPRELEASE                0
    DHCPRENEW                  7
    DHCPREBIND                 0
Copyright© 1999-2010 Juniper Networks, Inc. All rights reserved.