Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show dhcp client binding

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show dhcp client binding
[<address> |interface <interface-name>]
 routing-instance <routing-instance name>
[brief | detail | summary ]
logical-system
tenant

Description

Display the address bindings in the Dynamic Host Configuration Protocol (DHCP) client table.

Options

address

(Optional) Display DHCP binding information for a specific client identified by one of the following entries:

  • ip-address—The specified IP address.

  • mac-address—The specified MAC address.

routing-instance <routing-instance name>

(Optional) Display DHCP binding information for DHCP clients on the specified routing instance.

interface <interface-name>

(Optional) Perform this operation on the specified interface.

brief

(Optional) Display brief information about the active client bindings.

detail

(Optional) Display detailed client binding information.

summary

(Optional) Display a summary of DHCP client information.

logical-system

(Optional) Displays the DHCP binding information for DHCP clients on the specified logical system.

tenant

(Optional) Displays the DHCP binding information for DHCP clients on the specified tenant system.

Required Privilege Level

view

Output Fields

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

Table 1: show dhcp client binding Output Fields

Field Name

Field Description

IP address

IP address of the DHCP client.

Hardware address

Hardware address of the DHCP client.

Server

IP address of the DHCP server.

Expires

Number of seconds in which the lease expires.

State

State of the address binding table on the DHCP local server.

Interface

Interface on which the request was received.

Lease Expires

Date and time at which the client’s IP address lease expires.

Lease Expires in

Number of seconds in which the lease expires.

Lease Start

Date and time at which the client’s IP address lease started.

Vendor Identifier

Vendor identifier.

Server Identifier

IP address of the DHCP server.

Client IP Address

IP address of the DHCP client.

Sample Output

show dhcp client binding

content_copy zoom_out_map
user@host> show dhcp client binding
2 clients, (2 bound,  0 init, 0 discover, 0 renew, 0 rebind)
             
             IP address      Hardware address     Server      Expires     State      Interface
             10.1.1.89       00:0a:12:00:12:12    10.1.1.1    348         BOUND      fe-0/0/1.0
             20.1.1.90       00:0a:12:00:12:34    20.1.1.1    568         BOUND      fe-0/0/2.0

command-name

content_copy zoom_out_map
user@host> show dhcp client binding interface fe-0/0/1.0 detail
Client Interface: fe-0/0/1.0
               Hardware address:       00:0a:12:00:12:12
               State:                  BOUND
               Lease Expires:          2010-09-16 14:45:41 UTC
               Lease Expires in:       528 seconds
               Lease Start:            2010-09-16 14:35:41 UTC
               Vendor Identifier:      ether
               Server Identifier:      10.1.1.1
               Client IP Address:      10.1.1.89 
               update server           enabled
               
           DHCP Options :           
               Name: name-server, Value: [ 10.209.194.131, 198.51.110.2, 192.0.2.3 ]
               Name: server-identifier, Value: 10.1.1.1
               Name: router, Value: [ 10.1.1.80 ]
               Name: domain-name, Value: example-50

command-name

content_copy zoom_out_map
user@host> show dhcp client binding 10.1.1.89
IP address      Hardware address     Server      Expires     State      Interface
         10.1.1.89       00:0a:12:00:12:12    10.1.1.1    348         BOUND      fe-0/0/1.0

command-name

content_copy zoom_out_map
user@host> show dhcp client binding tenant TSYS1 routing-instance R1
IP address        Hardware address   Expires     State      Interface 
       33.33.33.3        00:50:56:b0:b8:21  1628        BOUND      ge-0/0/3.0 

command-name

content_copy zoom_out_map
user@host> show dhcp client binding detail tenant TSYS1 routing-instance R1
Client Interface/Id: ge-0/0/3.0                                       
     Hardware Address:             00:50:56:b0:b8:21                         
     State:                        BOUND(LOCAL_CLIENT_STATE_BOUND)           
     Lease Expires:                2018-04-26 16:24:34 UTC                   
     Lease Expires in:             1626 seconds                              
     Lease Start:                  2018-04-26 15:51:14 UTC                   
     Server Identifier:            11.11.11.1                                
     Client IP Address:            33.33.33.3                                
     Update Server                 No                                        
                                                                             
    DHCP options:                                                           
    Name: dhcp-lease-time, Value: 33 minutes, 20 seconds                     
    Name: server-identifier, Value: 11.11.11.1                               
    Name: router, Value: [ 33.33.33.1 ]                                      
    Name: subnet-mask, Value: 255.255.255.0                                  

Release Information

Statement introduced in Junos OS Release 12.1X44-D10.

The logical-system and tenant options are introduced in Junos OS Release 18.4R1.

footer-navigation