nx_lan_scan.nx

nx_lan_scan.nx -- shared sovereign LAN sweep primitive (no main). WHY THIS EXISTS (rule 15, DRY through shared libraries): two organs now ask the SAME question -- "is host H open on port P?" -- nx_printer_ctl (printer discovery/survey) and nx_iot_ctl (home-electronics inventory). If each keeps its own copy of the sweep, one gets fixed and the other silently does not, and the two tools then DISAGREE about the same LAN while both look healthy. The attribution rule they must agree on is the reason to share, not the line count. The implementation is lifted VERBATIM from the proven, gate-green pctl_discover_scan / pctl_probe_host (nx_printer_ctl_lib), so behaviour is identical BY CONSTRUCTION rather than by re-derivation. SCALE LAW (learned the hard way, banked in the iot-printer-fabric memory): any organ that fans out network I/O over MCP must bound total latency to the tools-daemon fork-capture window, or the call returns status=0 with no output while working fine on the CLI. Three rules, all encoded below: 1. BATCHED -- fire all 254 non-blocking connects first, then poll. 2. POLL-UNTIL-RESOLVED -- a single poll() returns as soon as ANY fd is ready (the ~250 instantly-refused hosts) BEFORE a real host finishes its handshake, so it finds NOTHING. Mark each fd done as its revents fire (write 0xff over the pollfd fd bytes so poll ignores it next round) and keep polling the still-connecting ones. 3. TIGHT BUDGET -- responsive devices answer in <50ms; unreachable hosts must not be waited on. Open iff POLLOUT && !POLLERR && !POLLHUP. license_tier: ORIGINAL No hw writes (Rule 26).