Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

TechLibrary
Navigation

show dhcp server binding

Syntax

show dhcp server binding<address><brief | detail | summary><interface interface-name><interfaces-vlan><interfaces-wildcard><logical-system logical-system-name><routing-instance routing-instance-name>

Release Information

Command introduced in Junos OS Release 9.0.

Options interfaces-vlan and interfaces-wildcard added in Junos OS Release 12.1.

Description

Display the address bindings in the client table on the extended Dynamic Host Configuration Protocol (DHCP) local server.

Note: If you delete the DHCP server configuration, DHCP server bindings might still remain. To ensure that DHCP bindings are removed, issue the clear dhcp server binding command before you delete the DHCP server configuration.

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.
  • session-id—The specified session ID.
brief | detail | summary
—

(Optional) Display the specified level of output about active client bindings. The default is brief, which produces the same output as show dhcp server binding.

interface interface-name
—

(Optional) Display information about active client bindings on the specified interface. You can optionally filter on VLAN ID and SVLAN ID.

interfaces-vlan
—

(Optional) Show the binding state information on the interface VLAN ID and S-VLAN ID.

interfaces-wildcard
—

(Optional) The set of interfaces on which to show the binding state information. This option supports the use of the wildcard character (*).

logical-system logical-system-name
—

(Optional) Display information about active client bindings for DHCP clients on the specified logical system.

routing-instance routing-instance-name
—

(Optional) Display information about active client bindings for DHCP clients on the specified routing instance.

Required Privilege Level

view

 

Related Documentation

 

List of Sample Output

show dhcp server binding
show dhcp server binding detail
show dhcp server binding detail (ACI Interface Set Configured)
show dhcp server binding interface <vlan-id>
show dhcp server binding interface <svlan-id>
show dhcp server binding <ip-address>
show dhcp server binding <session-id>
show dhcp server binding summary
show dhcp server binding <interfaces-vlan>
show dhcp server binding <interfaces-wildcard>

Output Fields

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

Table 1: show dhcp server binding Output Fields

Field Name

Field Description

Level of Output

number clients,
(number init,
number bound,
number selecting,
number requesting,
number renewing,
number releasing)

Summary counts of the total number of DHCP clients and the number of DHCP clients in each state.

summary

IP address

IP address of the DHCP client.

brief
detail

Session Id

Session ID of the subscriber session.

brief
detail

Hardware address

Hardware address of the DHCP client.

brief
detail

Expires

Number of seconds in which lease expires.

brief
detail

State

State of the address binding table on the extended DHCP local server:

  • BOUND—Client has active IP address lease.
  • FORCERENEW—Client has received forcerenew message from server.
  • INIT—Initial state.
  • RELEASE—Client is releasing IP address lease.
  • RENEWING—Client sending request to renew IP address lease.
  • REQUESTING—Client requesting a DHCP server.
  • SELECTING—Client receiving offers from DHCP servers.

brief
detail

Interface

Interface on which the request was received.

brief

Lease Expires

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

detail

Lease Expires in

Number of seconds in which lease expires.

detail

Lease Start

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

detail

Last Packet Received

Date and time at which the router received the last packet.

detail

Incoming Client Interface

Client’s incoming interface.

detail

Client Interface Svlan Id

S-VLAN ID of the client’s incoming interface.

detail

Client Interface Vlan Id

VLAN ID of the client’s incoming interface.

detail

Demux Interface

Name of the IP demultiplexing (demux) interface.

detail

Server IP Address or Server Identifier

IP address of DHCP server.

detail

Server Interface

Interface of DHCP server.

detail

Client Pool Name

Name of address pool used to assign client IP address lease.

detail

ACI Interface Set Name

Internally generated name of the dynamic agent circuit identifier (ACI) interface set.

detail

ACI Interface Set Index

Index number of the dynamic ACI interface set.

detail

ACI Interface Set Session ID

Identifier of the dynamic ACI interface set entry in the session database.

detail

Sample Output

show dhcp server binding

user@host> show dhcp server binding
IP address        Session Id  Hardware address   Expires     State      Interface
100.20.20.15      6           00:10:94:00:00:01  86180       BOUND      ge-1/0/0.0          
100.20.20.16      7           00:10:94:00:00:02  86180       BOUND      ge-1/0/0.0          
100.20.20.17      8           00:10:94:00:00:03  86180       BOUND      ge-1/0/0.0          
100.20.20.18      9           00:10:94:00:00:04  86180       BOUND      ge-1/0/0.0          
100.20.20.19      10          00:10:94:00:00:05  86180       BOUND      ge-1/0/0.0

show dhcp server binding detail

user@host> show dhcp server binding detail
Client IP Address:  100.20.20.15
     Hardware Address:             00:10:94:00:00:01
     State:                        BOUND(LOCAL_SERVER_STATE_BOUND_ON_INTF_DELETE)
     Lease Expires:                2009-07-21 10:10:25 PDT
     Lease Expires in:             86151 seconds
     Lease Start:                  2009-07-20 10:10:25 PDT
     Incoming Client Interface:    ge-1/0/0.0
     Server Ip Address:            100.20.20.9
     Server Interface:             none
     Session Id:                   6
     Client Pool Name:             6
     Client IP Address:            100.20.20.16
     Hardware Address:             00:10:94:00:00:02
     State:                        BOUND(LOCAL_SERVER_STATE_BOUND_ON_INTF_DELETE)
     Lease Expires:                2009-07-21 10:10:25 PDT
     Lease Expires in:             86151 seconds
     Lease Start:                  2009-07-20 10:10:25 PDT
     Incoming Client Interface:    ge-1/0/0.0
     Server Ip Address:            100.20.20.9
     Server Interface:             none
     Session Id:                   7
     Client Pool Name:             7

show dhcp server binding detail (ACI Interface Set Configured)

user@host> show dhcp server binding detail
Client IP Address:  100.20.22.14
     Hardware Address:             00:00:64:34:01:02
     State:                        BOUND(LOCAL_SERVER_STATE_BOUND)
     Lease Expires:                2012-03-13 09:53:32 PDT
     Lease Expires in:             82660 seconds
     Lease Start:                  2012-03-12 10:23:32 PDT
     Last Packet Received:         2012-03-12 10:23:32 PDT
     Incoming Client Interface:    demux0.1073741827
     Client Interface Svlan Id:    1802
     Client Interface Vlan Id:     302
     Demux Interface:              demux0.1073741832
     Server Identifier:            100.20.200.202
     Session Id:                   11
     Client Pool Name:             poolA
     Client Profile Name:          DEMUXprofile
     ACI Interface Set Name:       aci-1002-demux0.1073741827
     ACI Interface Set Index:      2
     ACI Interface Set Session ID: 6

show dhcp server binding interface <vlan-id>

user@host> show dhcp server binding interface ge-1/1/0:100
IP address        Session Id  Hardware address   Expires     State      Interface
200.20.20.15      6           00:10:94:00:00:01  86124       BOUND      ge-1/1/0:100

show dhcp server binding interface <svlan-id>

user@host> show dhcp server binding interface ge-1/1/0:10-100
IP address        Session Id  Hardware address   Expires     State      Interface
200.20.20.16      7           00:10:94:00:00:02  86124       BOUND      ge-1/1/0:10-100

show dhcp server binding <ip-address>

user@host> show dhcp server binding 100.20.20.19
IP address        Session Id  Hardware address   Expires     State      Interface
100.20.20.19      10          00:10:94:00:00:05  86081       BOUND      ge-1/0/0.0

show dhcp server binding <session-id>

user@host> show dhcp server binding 6
IP address        Session Id  Hardware address   Expires     State      Interface
200.20.20.15      6           00:10:94:00:00:01  86124       BOUND      ge-1/0/0.0

show dhcp server binding summary

user@host> show dhcp server binding summary
3 clients, (2 init, 1 bound, 0 selecting, 0 requesting, 0 renewing, 0 releasing)

show dhcp server binding <interfaces-vlan>

user@host> show dhcp server binding ge-1/0/0:100-200
IP address        Session Id  Hardware address   Expires     State      Interface
192.168.0.17      42          00:10:94:00:00:02  86346       BOUND      ge-1/0/0.1073741827 
192.168.0.16      41          00:10:94:00:00:01  86346       BOUND      ge-1/0/0.1073741827

show dhcp server binding <interfaces-wildcard>

user@host> show dhcp server binding ge-1/3/*
IP address        Session Id  Hardware address   Expires     State      Interface
192.168.0.9       24          00:10:94:00:00:04  86361       BOUND      ge-1/3/0.110        
192.168.0.8       23          00:10:94:00:00:03  86361       BOUND      ge-1/3/0.110        
192.168.0.7       22          00:10:94:00:00:02  86361       BOUND      ge-1/3/0.110

Published: 2014-04-23

Previous Page Next Page