lsleases.org

lsleases(1) | lsleases User Manual

NAME

lsleases – Controls the lsleasesd daemon.

SYNOPSIS

lsleases [options]

DESCRIPTION

lsleases displays captured ip addresses.

It can be used in two modes:

Client

lsleases communicates with the lsleasesd daemon to list captured ip addresses.

The daemon runs in the background and keeps a cache, so you don’t miss any assigned ip address.

Standalone

You can start lsleases with the -s flag, then it captures the datagrams itself and doesn’t need a running dameon. The downsite is, that it can only capture the datagrams when it runs.

OPTIONS

Multiple Flags have to be specified individually and separated by blanks

-h

print help and exit

-v

debug output

-vv

trace output

detailed logging with caller locations

-V

print version and exit

-s

standalone mode

In this mode lsleases is the daemon and the client in one program and captures the datagrams itself.

-c

clear leases history

-w

watch leases

client polls server every second for new leases

-x

shutdown server

EXAMPLES

list captured leases

j@main:~ ⟩ lsleases
Ip               Mac                Host
192.168.1.152    80:d0:9b:xx:xx:xx  android-6298296f6184995a
192.168.1.122    b8:27:eb:xx:xx:xx  raspberrypi
192.168.1.155    5c:cf:7f:xx:xx:xx  NODE-931BFD

watch for new leases

j@main:~ ⟩ lsleases -w
Captured   Ip               Mac                Host
16:23:29   192.168.1.152    80:d0:9b:xx:xx:xx  android-6298296f6184995a
... output hangs here - one minute later, a raspberry boots up
16:24:29   192.168.1.122    b8:27:eb:xx:xx:xx  raspberrypi
<CTRL-C>

In this mode lsleases displays already captured DHCP leases and polls the lsleasesd server every second for new captured DHCP leases. To exit the program, hit ‘<CTRL-C>’.

VERSION

@version@

SEE ALSO

lsleasesd(1)

HOMEPAGE

http://github.com/j-keck/lsleases

Please report bugs and feature requests in the issue tracker.