"""One-shot Linux listener inventory for 9web. Never connects to a listener. Only socket-inode ownership establishes a process/listener relationship. Parent commands can identify a launcher, but never turn an arbitrary Node socket into HTTP. Output deliberately omits full argv/environment (which may hold secrets). """ import ipaddress import json import os import socket import sys def recognize(argv): if not argv: return None exe = os.path.basename(argv[0]) args = argv[1:] if exe in ('miniserve', '9web'): return exe, 'https' if '--tls-cert' in args else 'http', 'recognized executable' if exe.startswith('python') and any(args[i:i+2] == ['-m', 'http.server'] for i in range(len(args))): return 'python http.server', 'http', 'python -m http.server' if exe == 'typst' and 'watch' in args: return 'typst watch', 'http', 'typst watch' # Require a CLI entrypoint, not a substring anywhere in arbitrary arguments. if exe in ('node', 'nodejs', 'bun') and args: entry = args[0].replace('\\', '/') if entry.endswith(('/vite/bin/vite.js', '/vite/bin/vite.mjs')): return 'vite', 'https' if '--https' in args else 'http', 'Vite CLI entrypoint' if '/wrangler/' in entry and 'dev' in args: return 'wrangler dev', 'http', 'Wrangler dev entrypoint' return None def inventory(web_pid=None, web_ports=()): owners = {} for name in os.listdir('/proc'): if not name.isdecimal(): continue base = '/proc/' + name try: argv = open(base + '/cmdline', 'rb').read(65536).decode(errors='replace').rstrip('\0').split('\0') exe = os.path.basename(os.readlink(base + '/exe')) cwd = os.readlink(base + '/cwd') fds = os.listdir(base + '/fd') except (OSError, ValueError): continue recognized = recognize([exe] + argv[1:]) # 9web has both HTTP and 9P sockets. Its own configured listeners are # supplied separately by the catalogue, never inferred from its name. if exe == '9web': recognized = None for fd in fds: try: link = os.readlink(base + '/fd/' + fd) except OSError: continue if link.startswith('socket:['): owners.setdefault(link[8:-1], []).append(dict( pid=int(name), process=exe, cwd=cwd, recognized=recognized)) rows = [] for table, family in [('tcp', socket.AF_INET), ('tcp6', socket.AF_INET6)]: try: lines = open('/proc/net/' + table).readlines()[1:] except OSError: continue for line in lines: fields = line.split() if fields[3] != '0A': continue raw, port = fields[1].split(':') packed = b''.join(int(raw[i:i+8], 16).to_bytes(4, sys.byteorder) for i in range(0, len(raw), 8)) address = socket.inet_ntop(family, packed) inode = fields[9] processes = {p['pid']: p for p in owners.get(inode, [])} recognized = [p for p in processes.values() if p['recognized']] p = recognized[0] if recognized else next(iter(processes.values()), None) rec = p['recognized'] if p else None if web_pid in processes and int(port, 16) in web_ports: p = processes[web_pid] rec = ('9web', 'http', '9web known HTTP listener') rows.append(dict(id=table + '-' + inode, address=address, port=int(port, 16), protocol=rec[1] if rec else 'unknown', service=rec[0] if rec else None, pid=p['pid'] if p else None, process=p['process'] if p else None, cwd=p['cwd'] if p else None, local=ipaddress.ip_address(address).is_loopback, evidence=('socket inode ownership; ' + rec[2]) if rec else ('socket inode ownership; unrecognized protocol' if p else 'process ownership unavailable'))) return sorted(rows, key=lambda r: (r['port'], r['address'])) if __name__ == '__main__': print(json.dumps(inventory(int(sys.argv[1]), [int(p) for p in sys.argv[2].split(',')]) if len(sys.argv) == 3 else inventory()))