Technical Documentation

clear dhcp relay binding

Syntax

clear dhcp relay binding <(all | ip-address | mac-address)><interface interface-name><logical-system logical-system-name><routing-instance routing-instance-name>

Release Information

Command introduced in Junos OS Release 8.3.

all and interface options added in Junos OS Release 8.4.

Description

Clear the binding state of a Dynamic Host Configuration Protocol (DHCP) client from the client table.

Options

all: (Optional) Clear the binding state for all DHCP clients.
interface interface-name: (Optional) Clear the binding state for DHCP clients 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) Clear the binding state for DHCP clients on the specified logical system.
routing-instance routing-instance-name: (Optional) Clear the binding state for DHCP clients on the specified routing instance.

Required Privilege Level

view

List of Sample Output

clear dhcp relay binding
clear dhcp relay binding all
clear dhcp relay binding interface

Output Fields

Table 1 lists the output fields for the clear dhcp relay binding command.

Table 1: clear 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

clear dhcp relay binding

The following sample output displays the address bindings in the DHCP client table before and after the clear dhcp relay binding command is issued.

user@host> show dhcp relay binding

IP address       Hardware address   Type     Lease expires at
100.20.32.1      90:00:00:01:00:01  active   2007-02-08 16:41:17 EST

user@host> clear dhcp relay binding 100.20.32.1