Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

TechLibrary
Navigation

show dhcp relay binding

Syntax

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

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.

Command introduced in Junos OS Release 12.1X48R3 for PTX Series Packet Transport Routers.

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.

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

 

Related Documentation

 

List of Sample Output

show dhcp relay binding
show dhcp relay binding detail
show dhcp relay binding interface
show dhcp relay binding interface vlan-id
show dhcp relay binding interface svlan-id
show dhcp relay binding ip-address
show dhcp relay binding mac-address
show dhcp relay binding session-id
show dhcp relay binding <interfaces-vlan>
show dhcp relay binding <interfaces-wildcard>
show dhcp relay binding summary

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.

briefdetail

Session Id

Session ID of the subscriber session.

briefdetail

Hardware address

Hardware address of the DHCP client.

briefdetail

Expires

Number of seconds in which the lease expires.

briefdetail

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.

briefdetail

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

Incoming Client Interface

Client’s incoming interface.

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

Sample Output

show dhcp relay binding

user@host> show dhcp relay binding
IP address        Session Id  Hardware address   Expires     State      Interface
100.20.32.11      41          00:10:94:00:00:01  86371       BOUND      ge-1/0/0.0          
100.20.32.12      42          00:10:94:00:00:02  86371       BOUND      ge-1/0/0.0          
100.20.32.13      43          00:10:94:00:00:03  86371       BOUND      ge-1/0/0.0          
100.20.32.14      44          00:10:94:00:00:04  86371       BOUND      ge-1/0/0.0          
100.20.32.15      45          00:10:94:00:00:05  86371       BOUND      ge-1/0/0.0

show dhcp relay binding detail

user@host> show dhcp relay binding detail
Client IP Address:  100.20.32.11
     Hardware Address:             00:10:94:00:00: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
     Last Packet Received:         2009–07–20 11:00:06 PDT
     Incoming Client Interface:    ge-1/0/0.0
     Server Ip Address:            100.20.22.2
     Server Interface:             none
     Bootp Relay Address:          100.20.32.2
     Session Id:                   41

Client IP Address:  100.20.32.12
     Hardware Address:             00:10:94:00:00: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
     Server Ip Address:            100.20.22.2
     Server Interface:             none
     Bootp Relay Address:          100.20.32.2
     Session Id:                   42

show dhcp relay binding interface

user@host> show dhcp relay binding interface fe-0/0/2
IP address       Hardware address   Type     Lease expires at
100.20.32.1      90:00:00:01:00:01  active   2007-03-27 15:06:20 EDT

show dhcp relay binding interface vlan-id

user@host> show dhcp relay 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 relay binding interface svlan-id

user@host> show dhcp relay 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 relay binding ip-address

user@host> show dhcp relay binding 100.20.32.13
IP address        Session Id  Hardware address   Expires     State      Interface
100.20.32.13      43          00:10:94:00:00:03  86293       BOUND      ge-1/0/0.0

show dhcp relay binding mac-address

user@host> show dhcp relay binding 00:10:94:00:00:05
IP address        Session Id  Hardware address   Expires     State      Interface
100.20.32.15      45          00:10:94:00:00:05  86279       BOUND      ge-1/0/0.0

show dhcp relay binding session-id

user@host> show dhcp relay binding 41
 IP address        Session Id  Hardware address   Expires     State      Interface
100.20.32.11      41          00:10:94:00:00:01  86305       BOUND      ge-1/0/0.0

show dhcp relay binding <interfaces-vlan>

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: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 relay binding <interfaces-wildcard>

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

show dhcp relay binding summary

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

Published: 2014-04-23

Previous Page Next Page