diff options
Diffstat (limited to 'web/discover.py')
| -rw-r--r-- | web/discover.py | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/web/discover.py b/web/discover.py new file mode 100644 index 0000000..8c750c1 --- /dev/null +++ b/web/discover.py @@ -0,0 +1,93 @@ +"""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 registered 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())) |
