Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show dhcp relay binding

Syntax

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

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 interface-tag <interface-tag-name>

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

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

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.