| Simon Kelley | 7de060b | 2011-08-26 17:24:52 +0100 | [diff] [blame] | 1 | .TH DHCP_LEASE_TIME 1 |
| 2 | .SH NAME |
| 3 | dhcp_lease_time \- Query remaining time of a lease on a the local dnsmasq DHCP server. |
| 4 | .SH SYNOPSIS |
| 5 | .B dhcp_lease_time <address> |
| 6 | .SH "DESCRIPTION" |
| 7 | Send a DHCPINFORM message to a dnsmasq server running on the local host |
| 8 | and print (to stdout) the time remaining in any lease for the given |
| 9 | address. The time is given as string printed to stdout. |
| 10 | |
| 11 | If an error occurs or no lease exists for the given address, |
| 12 | nothing is sent to stdout a message is sent to stderr and a |
| 13 | non-zero error code is returned. |
| 14 | |
| Simon Kelley | 1c10b9d | 2013-04-23 10:58:35 +0100 | [diff] [blame] | 15 | Requires dnsmasq 2.67 or later and may not work with other DHCP servers. |
| Simon Kelley | 7de060b | 2011-08-26 17:24:52 +0100 | [diff] [blame] | 16 | |
| Simon Kelley | 1c10b9d | 2013-04-23 10:58:35 +0100 | [diff] [blame] | 17 | The address argument is a dotted-quad IP addresses and mandatory. |
| 18 | .SH LIMITATIONS |
| 19 | Only works with IPv4 addresses and DHCP leases. |
| Simon Kelley | 7de060b | 2011-08-26 17:24:52 +0100 | [diff] [blame] | 20 | .SH SEE ALSO |
| 21 | .BR dnsmasq (8) |
| 22 | .SH AUTHOR |
| 23 | This manual page was written by Simon Kelley <simon@thekelleys.org.uk>. |
| 24 | |
| 25 | |