Skip to content

v1.4.0

Latest

Choose a tag to compare

@Criseda Criseda released this 25 Sep 22:54
cc46de7

Port scans name the services they find:

  • Named Open Ports: Every open port is named from an embedded table of about 6,000 TCP ports. The table combines the official IANA service registry with a curated overlay of friendly labels, categories and common unofficial uses (RDP instead of ms-wbt-server, Home Assistant on 8123). The official IANA name is always reported alongside the label, and ports known only from common use have none. No network lookups, no flags.
  • --json Port Fields: Port events gain service, iana, description and category, each null when unknown. Existing fields are unchanged, and summary.open_ports is still a list of numbers. NetScannerDesktop shows these as columns in its Port scan table. See docs/README.md for the fields and categories.
  • Port Table: Text output streams Open port: 3389 (RDP). The closing Open ports: 22, 80 line is replaced by an aligned PORT / SERVICE / IANA / DESCRIPTION table with a count and elapsed time, like -s. ⚠️ Behavior change for scripts that scrape the text; use --json.
  • Generator Tooling: scripts/generate_ports.py packs the IANA registry and scripts/port_overlay.txt into src/core/data/ports.bin, and reports which ports changed since the last run.
$ ns -p 192.168.1.10 1-1024
Open port: 22 (SSH)
Open port: 80 (HTTP)
Open port: 445 (SMB)
PORT   SERVICE               IANA             DESCRIPTION
22     SSH                   ssh              The Secure Shell (SSH) Protocol
80     HTTP                  http             World Wide Web HTTP
445    SMB                   microsoft-ds     Windows file sharing (SMB over TCP)
3 open ports (1.2s)

$ ns -p 192.168.1.10 3389 --json
{"type":"port","port":3389,"service":"RDP","iana":"ms-wbt-server","description":"Remote Desktop Protocol (Windows)","category":"remote"}
{"type":"summary","open_ports":[3389],"elapsed_ms":4}

Assets Included

  • windows.zip: Windows x86_64 standalone executable (ns.exe)
  • linux-x86_64.zip: Linux x86_64 standalone binary (ns)
  • linux-arm64.zip: Linux ARM64 standalone binary (ns)
  • macos-arm64.zip / macos-x86_64.zip: coming shortly. macOS binaries must be built and codesigned on a Mac; without the signature, macOS hides the ARP table.

SHA-256:

4636bfb26b6bff26f111bddc1dabb4e5377f8b2f08c475be6de3905688c97222  windows.zip
c0ebfc615e78694ca11089af7c7914165d740cb007e4eaa235a888d6babd8341  linux-x86_64.zip
2776e74e064f7d824f974c302883d8af835087ded190ea4dbdab091731eda378  linux-arm64.zip

Full changelog: v1.3.0...v1.4.0