nx_socket_list.nx

nx_socket_list.nx -- NS-2.5 of NISHI_NAS_CONTROL_ROADMAP. Bits-up substrate for "which process is listening on which TCP port". Closes the diagnostic gap from 2026-05-21 -- when the operator couldn't tell what was serving :443 because `netstat -tlnp` and `ss -tlnp` required sudo on the NAS. This tool reads /proc directly: no sudo, no third-party, no DSM-managed surfaces. Mechanism (pure bits-up): 1. Read /proc/net/tcp + /proc/net/tcp6 2. Filter state column == "0A" (TCP_LISTEN) 3. Extract local-port (hex) + inode (decimal) 4. Walk /proc/<pid>/fd/* symlinks 5. Match each socket:[N] target to LISTEN inodes 6. Read /proc/<pid>/cmdline (null-separated bytes) 7. Emit: PORT PID CMDLINE V1 scope: IPv4 only (parses /proc/net/tcp). V2 adds /proc/net/tcp6. V1 reads up to 64 listening sockets and 4096 processes -- generous for a NAS but bounded. V2 grows dynamically. Usage: nx_socket_list # lists ALL LISTEN ports nx_socket_list 443 # filter to port 443 (V2 -- argv)