show dhcp server binding
Syntax
show dhcp server binding
<address>
<interfaces-vlan>
<brief | detail | summary>
<interface interface-name>
<interface-tag interface-tag-name>
<interfaces-vlan>
<interfaces-wildcard>
<logical-system logical-system-name>
<routing-instance routing-instance-name>
Description
Display the address bindings in the client table on the extended Dynamic Host Configuration Protocol (DHCP) local server.
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:
|
brief | detail | summary |
(Optional) Display the specified level of output about active client
bindings. The default is |
interface interface-name |
(Optional) Display information about active client bindings on the specified interface. You can optionally filter on VLAN ID and SVLAN ID. |
interface-tag interface-tag-name |
(Optional) Displays the binding information for the specified interface-tag. |
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
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.
Field Name |
Field Description |
Level of Output |
---|---|---|
|
Summary counts of the total number of DHCP clients and the number of DHCP clients in each state. |
|
|
IP address of the DHCP client. |
|
|
Session ID of the subscriber session. |
|
|
Hardware address of the DHCP client. |
|
|
Number of seconds in which lease expires. |
|
|
State of the address binding table on the extended DHCP local server:
|
|
|
Interface on which the request was received. |
|
|
Date and time at which the client’s IP address lease expires. |
|
|
Number of seconds in which lease expires. |
|
|
Date and time at which the client’s IP address lease started. |
|
|
Lease time violation has occurred. |
|
|
Date and time at which the router received the last packet. |
|
|
Client’s incoming interface. |
|
|
Name of the Interface tag. |
|
|
S-VLAN ID of the client’s incoming interface. |
|
|
VLAN ID of the client’s incoming interface. |
|
|
Name of the IP demultiplexing (demux) interface. |
|
|
IP address of DHCP server. |
|
|
Interface of DHCP server. |
|
|
Name of address pool used to assign client IP address lease. |
|
|
State of the liveness detection status for a subscriber’s Bidirectional Forwarding Detection (BFD) protocol session: Note:
This output field displays status only when liveness detection has been explicitly configured for a subscriber and the liveness detection protocol is actively functioning for that subscriber.
|
|
|
Internally generated name of the dynamic agent circuit identifier (ACI) interface set. |
|
|
Index number of the dynamic ACI interface set. |
|
|
Identifier of the dynamic ACI interface set entry in the session database. |
|
|
DHCP client profile name. |
|
|
DHCP server profile name. |
|
|
IPv6 prefix of peer. |
|
|
IPv6 address of peer. |
|
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>
show dhcp server binding
user@host> show dhcp server binding IP address Session Id Hardware address Expires State Interface 192.51.100.15 6 00:00:5e:00:53:01 86180 BOUND ge-1/0/0.0 192.51.100.16 7 00:00:5e:00:53:02 86180 BOUND ge-1/0/0.0 192.51.100.17 8 00:00:5e:00:53:03 86180 BOUND ge-1/0/0.0 192.51.100.18 9 00:00:5e:00:53:04 86180 BOUND ge-1/0/0.0 192.51.100.19 10 00:00:5e:00:53:05 86180 BOUND ge-1/0/0.0
show dhcp server binding detail
user@host> show dhcp server binding detail Client IP Address: 192.51.100.15 Hardware Address: 00:00:5e:00:53: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 Interface tag: None Server Ip Address: 192.51.100.9 Server Interface: none Session Id: 6 Client Pool Name: 6 Liveness Detection State: UP Client IP Address: 192.51.100.16 Hardware Address: 00:00:5e:00:53: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 Lease time violated: yes Incoming Client Interface: ge-1/0/0.0 Server Ip Address: 192.51.100.9 Server Interface: none Session Id: 7 Client Pool Name: 7 Liveness Detection State: UP
When DHCP binding is configured with dual-stack, we get the following output:
user@host> show dhcp server binding detail Client IP Address: 192.51.100.10 Hardware Address: 00:00:64:03:01:02 State: BOUND(LOCAL_SERVER_STATE_BOUND) Protocol-Used: DHCP Lease Expires: 2016-11-07 08:30:39 PST Lease Expires in: 43706 seconds Lease Start: 2016-11-04 11:00:37 PDT Last Packet Received: 2016-11-06 09:00:39 PST Incoming Client Interface: ae0.3221225472 Interface tag: None Client Interface Svlan Id: 2000 Client Interface Vlan Id: 1 Server Ip Address: 192.51.100.2 Session Id: 2 Client Pool Name: my-v4-pool Client Profile Name: dhcp-retail Dual Stack Group: my-dual-stack Dual Stack Peer Prefix: 2001:db8:ffff:0:4::/64 Dual Stack Peer Address: 2001:db8:0:8003::1/128
show dhcp server binding detail (ACI Interface Set Configured)
user@host> show dhcp server binding detail Client IP Address: 192.51.100.14 Hardware Address: 00:00:5e:00:53: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 Interface tag: None Client Interface Svlan Id: 1802 Client Interface Vlan Id: 302 Demux Interface: demux0.1073741832 Server Identifier: 192.51.100.202 Session Id: 11 Client Pool Name: poolA Client Profile Name: DEMUXprofile Liveness Detection State: UP 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 192.51.100.15 6 00:00:5e:00:53: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 192.51.100.16 7 00:00:5e:00:53:02 86124 BOUND ge-1/1/0:10-100
show dhcp server binding <ip-address>
user@host> show dhcp server binding 192100.19 IP address Session Id Hardware address Expires State Interface 192.51.100.19 10 00:00:5e:00:53: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 192.51.100.15 6 00:00:5e:00:53: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:00:5e:00:53:02 86346 BOUND ge-1/0/0.1073741827 192.168.0.16 41 00:00:5e:00:53: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:00:5e:00:53:04 86361 BOUND ge-1/3/0.110 192.168.0.8 23 00:00:5e:00:53:03 86361 BOUND ge-1/3/0.110 192.168.0.7 22 00:00:5e:00:53:02 86361 BOUND ge-1/3/0.110
Release Information
Command introduced in Junos OS Release 9.0.
Options interfaces-vlan and interfaces-wildcard added in Junos OS Release 12.1.