1DHCP_RELEASE(1)             General Commands Manual            DHCP_RELEASE(1)
2
3
4

NAME

6       dhcp_release - Release a DHCP lease on a the local dnsmasq DHCP server.
7

SYNOPSIS

9       dhcp_release <interface> <address> <MAC address> <client_id>
10

DESCRIPTION

12       A  utility  which  forces  the  DHCP  server running on this machine to
13       release a DHCP lease.
14
15       Send a DHCPRELEASE message via the  specified  interface  to  tell  the
16       local DHCP server to delete a particular lease.
17
18       The interface argument is the interface in which a DHCP request _would_
19       be received if it was coming from the client, rather than  being  faked
20       up here.
21
22       The address argument is a dotted-quad IP addresses and mandatory.
23
24       The  MAC  address  is  colon separated hex, and is mandatory. It may be
25       prefixed by an address-type byte followed by -, eg
26
27       10-11:22:33:44:55:66
28
29       but if the address-type byte is missing it is assumed to be 1, the type
30       for ethernet. This encoding is the one used in dnsmasq lease files.
31
32       The  client-id is optional. If it is "*" then it treated as being miss‐
33       ing.
34

NOTES

36       MUST be run as root - will fail otherwise.
37

LIMITATIONS

39       Only usable on IPv4 DHCP leases.
40

SEE ALSO

42       dnsmasq(8)
43

AUTHOR

45       This manual page was written by Simon Kelley <simon@thekelleys.org.uk>.
46
47
48
49
50
51                                                               DHCP_RELEASE(1)