Technical Documentation

Related Topics
clear dhcp server binding

show dhcp server binding

Syntax

show dhcp server binding<brief | detail | summary><interface interface-name><ip-address | mac-address><logical-system logical-system-name><routing-instance routing-instance-name>

Release Information

Command introduced in Junos OS Release 9.0.

Description

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

Options

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.

Note: You cannot use the interface interface-name option with the show dhcp server binding command for DHCP passive clients (clients that are added as a result of DHCP snooped packets). For passive clients, the interface that is shown is not guaranteed to be the next-hop interface to the client, as is the case for active clients.

ip-address

(Optional) IP address of the DHCP client.

mac-address

(Optional) MAC address of the DHCP client.

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

List of Sample Output

show dhcp server binding
show dhcp server binding detail
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

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. 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
Incoming Client Interface	Client’s incoming interface.	detail
Server IP Address	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

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(bound)
     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(bound)
     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 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)