show dhcp relay binding

Syntax


                        
                           show dhcp relay binding 
                           <detail>
                           <interface interface-name>
                           <ip-address | mac-address>
                           
                           <logical-system logical-system-name>
                           <routing-instance routing-instance-name>

Release Information

Command introduced in JUNOS Release 8.3.

interface and mac-address options added in JUNOS Release 8.4.

Description

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

Options

detail — (Optional) Display detailed client binding information.

interface interface-name — (Optional) Perform this operation on the specified interface.

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.

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 ip-address
show dhcp relay binding ip-address detail
show dhcp relay binding mac-address

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 bound, number selecting, number renewing, number rebinding)	Summary counts of the total number of DHCP clients and the number of DHCP clients in each state	detail none
IP address	IP address of the DHCP client.	All levels
Hardware address	Hardware address of the DHCP client.	All levels
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
State	State of the DHCP relay address binding table on the DHCP client: init—Initial state. reboot—Client sends DHCP DISCOVER request. select—Client receives offers from DHCP servers. request—Client requests a DHCP server. add—Client is in process of being added. delete—Client is in process of being deleted. bound—Client has active IP address lease. renew—Client sends request to renew IP address lease. rebind—Client broadcasts request to renew IP address lease.	detail
Active binding information	Information about active IP address binding: IP address—IP address of the DHCP client. Hardware address—Hardware address of the DHCP client. Request received on—(detail level only) Interface on which the client request was received. relayed by—(detail level only) IP address on which the client request was relayed.	All levels (unless specified otherwise) when command includes ip-address or mac-address value
Lease information	Information about the client's IP address lease: Type—Type of IP address lease; always DHCP. Obtained at—Date and time at which the client's IP address lease was obtained. Expires at—Date and time at which the client's IP address lease expires. State—(detail level only) State of the DHCP relay address binding table on the DHCP client.	All levels (unless specified otherwise) when command includes ip-address or mac-address value

Sample Output

show dhcp relay binding

user@host> show dhcp relay binding

10 clients, (10 bound, 0 selecting, 0 renewing, 0 rebinding)

IP address       Hardware address   Type     Lease expires at
100.20.0.152     00:10:95:01:00:01  active   2007-02-15 05:25:47 PST
100.20.0.153     00:10:95:01:00:02  active   2007-02-15 05:25:48 PST
100.20.0.154     00:10:95:01:00:03  active   2007-02-15 05:25:49 PST
100.20.0.155     00:10:95:01:00:04  active   2007-02-15 05:25:50 PST
100.20.0.156     00:10:95:01:00:05  active   2007-02-15 05:25:51 PST
100.20.0.157     00:10:95:01:00:06  active   2007-02-15 05:25:52 PST
100.20.0.158     00:10:95:01:00:07  active   2007-02-15 05:25:53 PST
100.20.0.159     00:10:95:01:00:08  active   2007-02-15 05:25:54 PST
100.20.0.160     00:10:95:01:00:09  active   2007-02-15 05:25:55 PST
100.20.0.161     00:10:95:01:00:0a  active   2007-02-15 05:25:56 PST

show dhcp relay binding detail

user@host> show dhcp relay binding detail

10 clients, (10 bound, 0 selecting, 0 renewing, 0 rebinding)

IP address       Hardware address   Type     Lease expires            State
100.20.0.152     00:10:95:01:00:01  active   2007-02-15 05:25:47 PST  bound
100.20.0.153     00:10:95:01:00:02  active   2007-02-15 05:25:48 PST  bound
100.20.0.154     00:10:95:01:00:03  active   2007-02-15 05:25:49 PST  bound
100.20.0.155     00:10:95:01:00:04  active   2007-02-15 05:25:50 PST  bound
100.20.0.156     00:10:95:01:00:05  active   2007-02-15 05:25:51 PST  bound
100.20.0.157     00:10:95:01:00:06  active   2007-02-15 05:25:52 PST  bound
100.20.0.158     00:10:95:01:00:07  active   2007-02-15 05:25:53 PST  bound
100.20.0.159     00:10:95:01:00:08  active   2007-02-15 05:25:54 PST  bound
100.20.0.160     00:10:95:01:00:09  active   2007-02-15 05:25:55 PST  bound
100.20.0.161     00:10:95:01:00:0a  active   2007-02-15 05:25:56 PST  bound

show dhcp relay binding interface

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

1 clients, (1 bound, 0 selecting, 0 renewing, 0 rebinding)

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

user@host> show dhcp relay binding 100.20.4.138

Active binding information:
    IP address           100.20.4.138
    Hardware address     00:10:95:01:00:01
 
Lease information:
    Type                 DHCP
    Obtained at          2007-02-14 06:37:33 PST
    Expires at           2007-02-15 06:37:33 PST

show dhcp relay binding ip-address detail

user@host> show dhcp relay binding 100.20.32.1
                           detail

Active binding information:
    IP address           100.20.32.1
    Hardware address     90:00:00:01:00:01
    Request received on  fe-0/0/2.0, relayed by 100.20.32.2
 
Lease information:
    Type                 DHCP
    Obtained at          2007-01-29 15:43:27 EST
    Expires at           2007-01-29 15:53:27 EST
    State                rebind

show dhcp relay binding mac-address

user@host> show dhcp relay binding 90:00:00:01:00:01

Active binding information:
    IP address                     100.20.32.1
    Hardware address         90:00:00:01:00:01

Lease information:
    Type                DHCP
    Obtained at         2007-01-17 11:28:47 PST
    Expires at          2007-01-17 11:38:47 PST