Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation

Solutions

Featured solutions AI Campus and branch Data center WAN Security Service provider Cloud operator Industries
Campus and Branch

Welcome to the NOW Way to Wi-Fi

Take your networking performance to new heights with a modern, cloud-native, AI-Native architecture. Only Juniper can help you unleash the full potential of Wi-Fi 7 with our AI-Native platform for innovation.
Prepare for liftoff
Business intelligence analyst dashboard on virtual screen. Big data Graphs Charts.

AI Data Center Networking

Juniper’s AI data center solution is a quick way to deploy high performing AI training and inference networks that are the most flexible to design and easiest to manage with limited IT resources.
Find out more
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Zero trust security

Ops4AI Lab

Visit our lab in Sunnyvale, CA and see our AI data center solution for yourself. You can try out your own model’s functionality and performance, too.
Visit the lab
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Higher Education

Shaping Student Experiences: The NOW Way to Build Higher Education Networks

Join Juniper Networks CIO Sharon Mandell and a virtual summit of C-level IT leaders from prestigious institutions as they discuss ongoing efforts to support digital transformation.
Register to attend
Hand on tablet with healthcare overlay of graphics

Security in healthcare

In this IDC Spotlight report, discover how AI networking can automate and strengthen a healthcare ecosystem to defeat criminals and prevent loss. 
Gain insights into ecosystem security
Retail

The Future of In-Store Technologies

Join us for an enlightening webinar with Kevin McCartan, Senior IT Service Delivery Engineer at Musgrave; retail guru Jack Stratten of Insider Trends; and Christian Gilby, Director of Product Marketing at Juniper Networks, as they discuss the future of in-store technologies.
Reserve my spot

Products

Wireless access Wired access SD-WAN / SASE Routing and switching Security Mist AI™ Management software Network operating system Blueprint for AI-Native Acceleration Optics
  • Operations
ACX7020 router

Juniper ACX7020 Cloud Metro Access Router

Legacy networks simply cannot meet the demands of today’s rapidly evolving metro landscape. Unlock a new generation of highly scalable architectures and automated operations with the Juniper ACX7020. 
Learn more
EX4000 Ethernet Switch

Next-gen AI-Native EX4000 line of switches

Lack of AI innovation from your current networking vendor slowing you down? Embrace Juniper’s cloud-native, AI-Native access switches that support every level and layer, across nearly every deployment.
Discover how
The Q and AI text with an image of Bob Friday and Kedar Dhuru.

The Q&AI Podcast

Delivering practical solutions and enriching discussions, this podcast series is a vital resource for those seeking an in-depth exploration of AI's transformative potential.
Catch the latest episode

Services

Services
Services AI Care

Juniper AI Care Services Revolutionize Your Service Experience

Our industry-first AI-Native services couple AIOps with our deep expertise across the full network life cycle. You can move from reactive response to proactive insight and action.
Explore AI Care Services
Services AI Data Center

Juniper AI Data Center Deployment Services Optimize Your AI Model Runs

We use our expertise and validated designs to help design, deploy, validate and tune networks, including GPUs and storage, to get the most from your AI infrastructure operation.
Learn about AI Data Center Deployment Services

Partners

Partners

Support and Documentation

Support and Documentation

Learn

About Juniper Training Events The Feed Resources Technology learning topics Thought leadership and insights
Audience raising hands up while businessman is speaking in training at the office.

Juniper certification and training news

See the latest
Ringing of the bell

All global events

See the latest
AI-native-now

AI-Native NOW event series

Register now
Juniper's Christina Hendrix at the head of a conference table. With the text "The NOW Way to Network" overlayed, with "NOW" emphasizing the "O" in green color.

The NOW Way to Network

Watch the video series
AI Native Now

Executive insights

Dive deep with leading experts and thought leaders on all the topics that matter most to your business, from AI to network security to driving rapid, relevant transformation for your business.
Learn more
A keynote speaker giving a presentation at a conference. There are dozens of people sitting around them. The presentation is displayed via projector on all the walls in the room.

Leadership voices

Juniper Networks’ leaders operate on the front lines of creating the network of the future. Take a look around to see what’s on their minds.
Watch now
Bob Friday and Jessica Garrison speaking

Bob Friday Talks

Join Bob as he ventures into all the knowns -- and -- unknowns -- of AI.
Catch the latest episode
Documentation
Menu
License Guide
Quick Starts
Validated Designs
Explore Pathfinder Apps
CLI Explorer
Feature Explorer
Hardware Compatibility Tool
Port Checker
Browse All
Collapse

Pathfinder Apps

All

By Software

By Hardware

Learn More
Pathfinder HomeCLI ExplorerCompliance AdvisorFeature ExplorerHardware Compatibility ToolJunos XML API ExplorerJunos YANG Data Model ExplorerPort CheckerPower CalculatorSNMP MIB ExplorerSystem Log Explorer
CLI ExplorerFeature ExplorerJunos XML API ExplorerJunos YANG Data Model ExplorerSNMP MIB ExplorerSystem Log Explorer
Compliance AdvisorFeature ExplorerHardware Compatibility ToolPort CheckerPower Calculator
Home Documentation Junos OS Junos CLI Reference CLI Reference S

Junos CLI Reference

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
ON THIS PAGE
keyboard_arrow_right

show dhcp relay binding

date_range 13-Sep-24
arrow_backward
arrow_forward

Syntax

content_copy zoom_out_map
show dhcp relay binding 
<address>
<brief>
<detail>
<interface interface-name>
<interface-tag interface-tag-name>
<interfaces-vlan>
<interfaces-wildcard>
<ip-address | mac-address>
<logical-system logical-system-name>
<routing-instance routing-instance-name>
<summary>

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.

  • session-id—The specified session ID.

brief

(Optional) Display brief information about the active client bindings. This is the default, and produces the same output as show dhcp relay binding.

detail

(Optional) Display detailed client binding information.

interface interface-name

(Optional) Perform this operation 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 binding state information. This option supports the use of the wildcard character (*).

logical-system logical-system-name

(Optional) Perform this operation on the specified logical system.

routing-instance routing-instance-name

(Optional) Perform this operation on the specified routing instance.

summary

(Optional) Display a summary of DHCP client information.

Required Privilege Level

view

Output Fields

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

Table 1: show dhcp relay binding Output Fields

Field Name

Field Description

Level of Output

number clients,(number init, number bound, number selecting, number requesting, number renewing, number rebinding, 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

Generated Remote ID

Remote ID generated by the Option 82 Agent Remote ID (suboption 1)

detail

Hardware address

Hardware address of the DHCP client.

brief detail

Expires

Number of seconds in which the lease expires.

brief detail

State

State of the DHCP relay address binding table on the DHCP client:

  • BOUND—Client has an active IP address lease.

  • INIT—Initial state.

  • REBINDING—Client is broadcasting a request to renew the IP address lease.

  • RELEASE—Client is releasing the IP address lease.

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

  • REQUESTING—Client is requesting a DHCP server.

  • SELECTING—Client is receiving offers from DHCP servers.

brief detail

Interface

Incoming client interface.

brief

Lease Expires

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

detail

Lease Expires in

Number of seconds in which the lease expires.

detail

Lease Start

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

detail

Lease time violated

Lease time violation has occurred.

detail

Incoming Client Interface

Client’s incoming interface.

detail

Interface tag

Name of the Interface tag.

detail

Server IP Address

IP address of the DHCP server.

detail

Server Interface

Interface of the DHCP server.

detail

Bootp Relay Address

IP address of BOOTP relay.

detail

Type

Type of DHCP packet processing performed on the router:

  • active—Router actively processes and relays DHCP packets.

  • passive—Router passively snoops DHCP packets passing through the router.

All levels

Lease expires at

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

All levels

Dual Stack Group

Name of dual stack that is configured with the DHCP binding.

detail

Dual Stack Peer Prefix

Prefix of dual stack DHCPv6 peer.

detail

Dual Stack Peer Address

Address of the dual stack DHCPv6 peer.

detail

Note:

When you configure dhcp relay and EVPN multihoming, you may notice that the CLI output for the show dhcp relay binding command may not display the physical interface and vlan id information.

Sample Output

show dhcp relay binding

content_copy zoom_out_map
user@host> show dhcp relay binding
IP address        Session Id  Hardware address   Expires     State      Interface
192.51.100.11     41          00:00:5e:00:53:01  86371       BOUND      ge-1/0/0.0          
192.51.100.12     42          00:00:5e:00:53:02  86371       BOUND      ge-1/0/0.0          
192.51.100.13     43          00:00:5e:00:53:03  86371       BOUND      ge-1/0/0.0          
192.51.100.14     44          00:00:5e:00:53:04  86371       BOUND      ge-1/0/0.0          
192.51.100.15     45          00:00:5e:00:53:05  86371       BOUND      ge-1/0/0.0

show dhcp relay binding detail

content_copy zoom_out_map
user@host> show dhcp relay binding detail


Client IP Address:  192.51.100.11
     Hardware Address:             00:00:5e:00:53:01
     State:                        BOUND(DHCP_RELAY_STATE_BOUND_ON_INTF_DELETE)
     Lease Expires:                2009-07-21 11:00:06 PDT
     Lease Expires in:             86361 seconds
     Lease Start:                  2009-07-20 11:00:06 PDT
     Lease time violated:          yes
     Last Packet Received:         2009–07–20 11:00:06 PDT
     Incoming Client Interface:    ge-1/0/0.0
     Interface tag:                None
     Server Ip Address:            192.51.100.22
     Server Interface:             none
     Bootp Relay Address:          192.51.100.32
     Session Id:                   41
     Dual Stack Group:             dual-stack-retail6
     Dual Stack Peer Prefix:       2001:db8:0:4::/64
     Dual Stack Peer Address:      2001:db8:1:0:8003::1/128

Client IP Address:  192.51.100.12
     Hardware Address:             00:00:5e:00:53:02
     State:                        BOUND(DHCP_RELAY_STATE_BOUND_ON_INTF_DELETE)
     Lease Expires:                2009-07-21 11:00:06 PDT
     Lease Expires in:             86361 seconds
     Lease Start:                  2009-07-20 11:00:06 PDT
     Last Packet Received:         2009–07–20 11:00:06 PDT
     Incoming Client Interface:    ge-1/0/0.0
     Interface tag:                None
     Server Ip Address:            192.51.100.22
     Server Interface:             none
     Bootp Relay Address:          192.51.100.32
     Session Id:                   42
     Generated Remote ID           host:ge-1/0/0:100

show dhcp relay binding interface

content_copy zoom_out_map
user@host> show dhcp relay binding interface fe-0/0/2

IP address       Hardware address   Type     Lease expires at
192.51.100.1      00:00:5e:00:53:01  active   2007-03-27 15:06:20 EDT

show dhcp relay binding interface vlan-id

content_copy zoom_out_map
user@host> show dhcp relay 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:94  86124       BOUND      ge-1/1/0:100

show dhcp relay binding interface svlan-id

content_copy zoom_out_map
user@host> show dhcp relay 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:92  86124       BOUND      ge-1/1/0:10-100

show dhcp relay binding interface-tag <interface-tag-name>

content_copy zoom_out_map
user@host> show dhcp relay binding interface-tag sample_tag

IP address        Session Id  Hardware address   Expires     State      Interface
192.2.1.1          2           00:10:94:00:00:01     740       BOUND     ge-0/0/1.3221225472

show dhcp relay binding interface-tag interface-tag-name detail

content_copy zoom_out_map
user@host> show dhcp relay binding interface-tag AGF_IFD detail      
     Client IP Address:  192.168.0.100
     Hardware Address:             00:34:44:44:44:44
     State:                        BOUND(RELAY_STATE_BOUND)
     Lease Expires:                2023-05-02 11:22:44 PDT
     Lease Expires in:             2575 seconds
     Lease Start:                  2023-05-02 09:52:44 PDT
     Last Packet Received:         2023-05-02 10:22:44 PDT
     Incoming Client Interface:    demux0.3221225472
     Interface tag name:           AGF_IFD
     Client Interface Svlan Id:    1
     Client Interface Vlan Id:     1
     Demux Interface:              demux0.3221225491
     Server Ip Address:            192.168.0.50
     Server Interface:             none
     Bootp Relay Address:          192.168..1
     Session Id:                   8
     Client Profile Name:          dhcp-profile
     Generated Circuit ID:         aci1
     Generated Remote ID:          ari1
     Relay Id Length:              31
     Relay Id:                     /0x00020000/0x00000583/0x01000000/0x00000000
     Relay Id:                     /0x30303a32/0x363a3838/0x3a64373a/0x66373a

show dhcp relay binding ip-address

content_copy zoom_out_map
user@host> show dhcp relay binding 192.51.100.13
IP address        Session Id  Hardware address   Expires     State      Interface
192.51.100.13      43          00:00:5e:00:53:03  86293       BOUND      ge-1/0/0.0

show dhcp relay binding mac-address

content_copy zoom_out_map
user@host> show dhcp relay binding 00:00:5e:00:53:05
IP address        Session Id  Hardware address   Expires     State      Interface
192.51.100.15      45          00:00:5e:00:53:05  86279       BOUND      ge-1/0/0.0

show dhcp relay binding session-id

content_copy zoom_out_map
user@host> show dhcp relay binding 41
 IP address        Session Id  Hardware address   Expires     State      Interface
192.51.100.11      41          00:00:5e:00:53:53  86305       BOUND      ge-1/0/0.0

show dhcp relay binding <interfaces-vlan>

content_copy zoom_out_map
user@host> show dhcp relay 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 relay binding <interfaces-wildcard>

content_copy zoom_out_map
user@host> show dhcp relay 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

show dhcp relay binding summary

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

Release Information

Command introduced in Junos OS Release 8.3.

Options interface and mac-address added in Junos OS Release 8.4.

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

Related Documentation

arrow_backward PREVIOUS show dhcp relay binding (Security)
NEXT arrow_forward show dhcp relay lockout-entries
footer-navigation

© 1999 - 2025 Juniper Networks, Inc. All rights reserved.

Scroll to top