Home › Documentation › Tools › gnulte-devices
gnulte-devices(8) — instant inventory
The kernel's ARP/neighbour table turned into a full device list in one pass: vendor from the embedded OUI registry, mDNS hostnames, a device-type guess. No sweeps unless you ask, no root at all.
Requirements
- No privileges needed.
- By default reads the neighbour table only;
-sadds a ping sweep, which works better with root.
Synopsis
gnulte-devices [flags]
Options
| Flag | Description |
|---|---|
-s | also ping-sweep the subnet (default: ARP table only) |
-t N | parallel ping workers when scanning |
-i IFACE | network interface (default: auto-detect) |
-n | skip hostname resolution (fast) |
-c | output CSV |
-j | output JSON |
-y | output YAML |
-o FILE | write the table to a file |
-H FILE | write an HTML report to this file |
--oui-file FILE | merge an operator CSV vendor table (prefix,vendor) over the built-in OUI data |
-q | quiet: no banner, no status lines |
-v, --version | print version and exit |
Long aliases exist for every short flag (--csv, --json,
--yaml, --html FILE, --output FILE,
--scan, --no-hostnames, --interface IFACE,
--quiet).
Examples
gnulte-devices # instant inventory from the neighbour table
gnulte-devices -s # add a ping sweep of the subnet
gnulte-devices -s -H lan.html # inventory plus a filed HTML report
gnulte-devices -j -q # just the JSON, nothing else
Installation
Part of the GNULTE suite. Build and install everything at once;
git clone https://github.com/notmicrosoft2000-cmd/gnulte-go.git
cd gnulte-go
./build.sh # builds all eight binaries, runs go vet + go test ./...
sudo ./install.sh # installs to /usr/local/bin + safety docs
installs gnulte-devices to /usr/local/bin/gnulte-devices. See
installation for requirements.
Common errors
- The table is nearly empty
- The neighbour table is only a cache. Add
-sto ping-sweep the subnet first. - Resolving names is slow
- Skip it with
-nfor a fast, address-only inventory.
Related tools
- gnulte-scan — when you need ports and fingerprints too
- gnulte-lan — when you need to keep watching