Home › Documentation › FAQ
Frequently asked questions
- Which platforms are supported?
- Linux. The code is written so the portable parts compile elsewhere
(platform-specific files sit behind
*_linux.gobuild tags andGOOS=darwin go vetmust stay clean), but everything that matters — raw sockets,AF_PACKETcapture,tc netem, monitor-mode injection — is Linux. There is no Windows or macOS support and none is planned for v17. - Which tools need root?
gnulte(shaping and spoofing),gnulte-wifi(injection),gnulte-traceandgnulte-top(raw sockets).gnulte-lanandgnulte-scanrun unprivileged with reduced coverage (no flows screen, no per-host rates),gnulte-devicesandgnulte-doctorneed no privileges at all.- Do I need arp-scan, arping, tcpdump, ping or traceroute?
- No. Since v16.6–v16.10 (the Unplugged programme) ARP sweeping, ICMP echo,
packet capture and path probing are implemented in-process. The only external
programs the toolkit invokes are
tcandiptables, which are the kernel interface, not wrappers around anything. - Why does it need
tcandiptablesat all? - Because that is how the Linux kernel configures traffic shaping and forwarding. A program cannot netem a qdisc without them, and reimplementing netlink for two ioctls would be a dependency in disguise.
- Where does GNULTE store its data?
- State under
~/.config/gnulte-go/(settings, the shared device store, the acceptance record, profiles, the watch timeline) and reports under~/GNULTE Reports/. Nothing is written outside your home directory except the binaries in/usr/local/bin. - What is the “safety record”?
- An explicit authorised-use acceptance record stored in
~/.config/gnulte-go/acceptance.json. Consent-gated tools ask once and remember;--reset-safetyon any tool clears it. The state of the record is part ofgnulte-doctor's report. - Will it shape my own machine or the gateway?
- No. The engine refuses to target the gateway or the machine it runs on, and every parameter is validated before the run starts with its impact estimated out loud.
- Is there a GUI?
- No. The tools are terminal applications; the interactive ones are full-screen console UIs. Reports are self-contained HTML files you can open in any browser.
- Can I script it?
- Yes. Every tool supports
--jsonat minimum; most also support--csvor--yaml,--quietand an explicit--duration.gnulte-doctorexits non-zero on failure so a script can gate on it. - How do I report a bug?
- Open an issue on the
issue tracker
with
gnulte-doctor --jsonoutput, the exact command line, your distribution and kernel version. - What licence is it?
- GPL-3.0-or-later. The
full text ships in the repository as
LICENSE. - May I use it on a network at work or school?
- Only if you own it or are explicitly authorised to test it. Authorisation from your own desk is not authorisation. See authorised use.