| Simon Kelley | 7de060b | 2011-08-26 17:24:52 +0100 | [diff] [blame] | 1 | .TH DHCP_RELEASE 1 |
| 2 | .SH NAME |
| 3 | dhcp_release \- Release a DHCP lease on a the local dnsmasq DHCP server. |
| 4 | .SH SYNOPSIS |
| 5 | .B dhcp_release <interface> <address> <MAC address> <client_id> |
| 6 | .SH "DESCRIPTION" |
| 7 | A utility which forces the DHCP server running on this machine to release a |
| 8 | DHCP lease. |
| 9 | .PP |
| 10 | Send a DHCPRELEASE message via the specified interface to tell the |
| 11 | local DHCP server to delete a particular lease. |
| 12 | |
| 13 | The interface argument is the interface in which a DHCP |
| 14 | request _would_ be received if it was coming from the client, |
| 15 | rather than being faked up here. |
| 16 | |
| 17 | The address argument is a dotted-quad IP addresses and mandatory. |
| 18 | |
| 19 | The MAC address is colon separated hex, and is mandatory. It may be |
| 20 | prefixed by an address-type byte followed by -, eg |
| 21 | |
| 22 | 10-11:22:33:44:55:66 |
| 23 | |
| 24 | but if the address-type byte is missing it is assumed to be 1, the type |
| 25 | for ethernet. This encoding is the one used in dnsmasq lease files. |
| 26 | |
| 27 | The client-id is optional. If it is "*" then it treated as being missing. |
| 28 | .SH NOTES |
| 29 | MUST be run as root - will fail otherwise. |
| Simon Kelley | 1c10b9d | 2013-04-23 10:58:35 +0100 | [diff] [blame] | 30 | .SH LIMITATIONS |
| 31 | Only usable on IPv4 DHCP leases. |
| Simon Kelley | 7de060b | 2011-08-26 17:24:52 +0100 | [diff] [blame] | 32 | .SH SEE ALSO |
| 33 | .BR dnsmasq (8) |
| 34 | .SH AUTHOR |
| 35 | This manual page was written by Simon Kelley <simon@thekelleys.org.uk>. |
| 36 | |
| 37 | |