show dhcp server binding

Syntax




show dhcp server 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 9.0.

Description

Display the address bindings in the client table on the extended Dynamic Host Configuration Protocol (DHCP) local server.

Options

detail — (Optional) Display detailed information about all active client bindings.

interface interface-name — (Optional) Display information about active client bindings 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) Display information about active client bindings for DHCP clients on the specified logical system.

routing-instance routing-instance-name — (Optional) Display information about active client bindings for DHCP clients on the specified routing instance.

Required Privilege Level

view

List of Sample Output

show dhcp server binding
show dhcp server binding detail
show dhcp server binding ip-address
show dhcp server binding ip-address detail

Output Fields

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

Table 1: show dhcp server 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 or, for a client with a state of bound-grace, the time at which the grace period for the client’s IP address lease expires.	All levels
State	State of the address binding table on the extended DHCP local server: 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. bound-grace—Grace period for the client’s IP address lease is active in the client table; this entry is included in the summary counts line in the number bound category. 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 otherwise specified) 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 address binding table on the extended DHCP local server.	All levels (unless otherwise specified) when command includes ip-address or mac-address value

Sample Output

show dhcp server binding

user@host> show dhcp server binding

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

IP address       Hardware address   Type     Lease expires at
100.20.32.1      90:00:00:01:00:01  active   2007-01-17 11:38:47 PST
100.20.32.3      90:00:00:02:00:01  active   2007-01-17 11:38:41 PST
100.20.32.4      90:00:00:03:00:01  active   2007-01-17 11:38:01 PST
100.20.32.5      90:00:00:04:00:01  active   2007-01-17 11:38:07 PST
100.20.32.6      90:00:00:05:00:01  active   2007-01-17 11:38:47 PST

show dhcp server binding detail

user@host> show dhcp server binding detail

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

IP address       Hardware address   Type     Lease expires            State
100.20.32.1      90:00:00:01:00:01  active   2007-01-17 11:38:47 PST  rebind
100.20.32.3      90:00:00:02:00:01  active   2007-01-17 11:38:41 PST  rebind
100.20.32.4      90:00:00:03:00:01  active   2007-01-17 11:38:01 PST  rebind
100.20.32.5      90:00:00:04:00:01  active   2007-01-17 11:38:07 PST  rebind
100.20.32.6      90:00:00:05:00:01  active   2007-01-17 11:38:47 PST  rebind
100.20.32.6      90:00:00:06:00:01  active   2007-01-19 16:38:47 PST  bound-grace

show dhcp server binding ip-address

user@host> show dhcp server binding 100.20.32.1

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

show dhcp server binding ip-address detail

user@host> show dhcp server 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-17 11:28:47 PST
    Expires at            2007-01-17 11:38:47 PST
    State                 rebind