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-security binding

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show dhcp-security binding
<detail>
<interface interface-name>
<ip-address ip-address>
<ip-source-guard ip-sg-name>
<statistics>
<vlan vlan-name>

Description

Display the DHCP snooping database information.

Options

detail (Optional) Display the DHCP snooping database information along with various DHCP client options. The option information associated with a binding is displayed in Code-Length-Value triplet. The option values are displayed as a hex dump.
interface interface-name

(Optional) Display the DHCP snooping database information for an interface.

ip-address ip-address

(Optional) Display the DHCP snooping database information for an IP address.

vlan vlan-name

(Optional) Display the DHCP snooping database information for a VLAN.

Required Privilege Level

view

Output Fields

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

Table 1: show dhcp-security binding Output Fields

Field Name

Field Description

Level of Output

IP Address

IP address of the network device; bound to the MAC address.

All levels

MAC address

MAC address of the network device; bound to the IP address.

All levels

VLAN

VLAN name of the network device whose MAC address is shown.

All levels

Expires

The time, in seconds, remaining before the lease of the IP address to the MAC address expires. This field is 0 for static entries.

All levels

State

State of the address binding:

  • BOUND: IP address is leased to the MAC address for a limited period of time.

  • INIT: Initial state.

  • RELEASE: Client is releasing IP address lease.

  • REQUESTING: Client is requesting a server.

  • SELECTING: Client is receiving offers from servers.

  • RENEWING: Client is sending a request to renew the IP address lease.

  • RECONFIGURE: Client has received a reconfigure message from the server.

  • STATIC: IP address is attached to a fixed MAC address.

All levels

Interface

Interface address (port).

All levels

Sample Output

show dhcp-security binding

content_copy zoom_out_map
user@device> show dhcp-security binding             

IP address        MAC address         Vlan     Expires State   Interface
10.1.1.10         00:10:00:20:00:01   vlan20   0       STATIC  ge-0/0/4.0          
10.1.1.18         00:10:94:00:00:34   vlan20   86287   BOUND   ge-0/0/6.0          
10.1.1.15         00:10:94:00:00:55   vlan20   86265   BOUND   ge-0/0/4.0          
10.1.1.16         00:10:94:00:00:56   vlan20   86265   BOUND   ge-0/0/4.0          
10.1.1.19         00:10:94:00:00:5b   vlan20   86287   BOUND   ge-0/0/6.0          
10.1.1.20         00:10:94:00:00:5c   vlan20   86287   BOUND   ge-0/0/6.0          
10.1.1.21         00:10:94:00:00:5d   vlan20   86287   BOUND   ge-0/0/6.0          
10.1.1.17         00:10:94:00:00:68   vlan20   86265   BOUND   ge-0/0/4.0          

show dhcp-security binding detail

content_copy zoom_out_map
user@device> show dhcp-security binding detail

IP address: 20.1.1.16 ​
MAC address: 00:10:94:00:00:03 ​
Vlan: snoop-vlan ​
Lease Expires in: 589 ​
State: BOUND    ​
Interface: ge-0/0/13.0 ​
DHCP Client Options:  ​
  Option: 53, Length: 1, Value: 03 ​
  Option: 57, Length: 2, Value: 02 40 ​
  Option: 61, Length: 7, Value: 01 00 10 94 00 00 03​

show dhcp-security binding interface

content_copy zoom_out_map
user@device> show dhcp-security binding interface ge-0/0/6             

IP address        MAC address         Vlan     Expires State   Interface
10.1.1.18         00:10:94:00:00:34   vlan20   86282   BOUND   ge-0/0/6.0          
10.1.1.19         00:10:94:00:00:5b   vlan20   86282   BOUND   ge-0/0/6.0          
10.1.1.20         00:10:94:00:00:5c   vlan20   86282   BOUND   ge-0/0/6.0          
10.1.1.21         00:10:94:00:00:5d   vlan20   86282   BOUND   ge-0/0/6.0          

show dhcp-security binding ip-address

content_copy zoom_out_map
user@device> show dhcp-security binding ip-address

IP address     MAC address  		    Vlan         Expires     State      Interface
10.1.1.18      00:10:94:00:00:34     vlan20       86282       BOUND      ge-0/0/6.0

show dhcp-security binding vlan

content_copy zoom_out_map
user@device> show dhcp-security binding vlan vlan20

IIP address     MAC address  		    Vlan         Expires     State      Interface
10.1.1.18       00:10:94:00:00:34    vlan20       86282       BOUND      ge-0/0/6.0

Release Information

Command introduced in Junos OS Release 12.1.

detail option introduced in Junos OS Release 23.1.

footer-navigation