Documentation
¶
Overview ¶
Command demoseed builds a synthetic LAN Sheriff database for screenshots and the README's recordings.
Why this is a script and not a mode ¶
The obvious design is `lan-sheriff --demo`, and it was rejected. This is a security tool: something a person consults to decide whether a device on their network is behaving. A build of it that can render fabricated traffic as though it were observed is a liability no banner fully retires, the screenshot outlives the banner, the support question does not mention it, and somebody eventually sees invented findings and believes them.
A repo script has none of that. Nothing here is compiled into the binary, and the database it writes has to be pointed at deliberately with --data-dir.
Why not just screenshot a real network ¶
Because a real one is somebody's home. Hostnames, internal addressing, the places they actually connect to and, through the map origin, roughly where they live. None of that belongs in a public README, and redacting it after the fact is the kind of job that is done correctly four times out of five.
The household below is invented. The organizations are real, because a map of plausible destinations is the whole point, but no capture produced any of it.
go run ./scripts/demoseed -out /tmp/ls-demo ./lan-sheriff serve --data-dir /tmp/ls-demo