Technical Documentation

show dhcp relay binding

Syntax

show dhcp relay binding <brief><detail><interface interface-name><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.

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

Description

Display the address bindings in the Dynamic Host Configuration Protocol (DHCP) client table.

Options

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.

ip-address

(Optional) IP address of the DHCP client.

mac-address

(Optional) MAC address of the DHCP client.

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

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 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.

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

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(bound)
     Lease Expires:                2009-07-21 11:00:06 PDT
     Lease Expires in:             86361 seconds
     Lease Start:                  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(bound)
     Lease Expires:                2009-07-21 11:00:06 PDT
     Lease Expires in:             86361 seconds
     Lease Start:                  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 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: 2010-07-27

Help
|
My Account
|
Log Out