Return to dhcp_release.1 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / dnsmasq / contrib / lease-tools

dnsmasq 2.76

.TH DHCP_RELEASE 1
.SH NAME
dhcp_release \- Release a DHCP lease on a the local dnsmasq DHCP server.
.SH SYNOPSIS
.B dhcp_release <interface> <address> <MAC address> <client_id>
.SH "DESCRIPTION"
A utility which forces the DHCP server running on this machine to release a 
DHCP lease.
.PP
Send a DHCPRELEASE message via the specified interface to tell the
local DHCP server to delete a particular lease. 

The interface argument is the interface in which a DHCP
request _would_ be received if it was coming from the client, 
rather than being faked up here.
   
The address argument is a dotted-quad IP addresses and mandatory. 
   
The MAC address is colon separated hex, and is mandatory. It may be 
prefixed by an address-type byte followed by -, eg

10-11:22:33:44:55:66

but if the address-type byte is missing it is assumed to be 1, the type 
for ethernet. This encoding is the one used in dnsmasq lease files.

The client-id is optional. If it is "*" then it treated as being missing.
.SH NOTES
MUST be run as root - will fail otherwise.
.SH LIMITATIONS
Only usable on IPv4 DHCP leases.
.SH SEE ALSO
.BR dnsmasq (8)
.SH AUTHOR
This manual page was written by Simon Kelley <simon@thekelleys.org.uk>.