bb-eco scan
Scan a subnet for network devices (TCP port probe + HTTP enrichment)
Usage
bb-eco scan <cidr> [options]
Arguments
| Name | Description |
|---|---|
<cidr> | CIDR range to scan (e.g., 192.168.1.0/24) |
Options
| Option | Description |
|---|---|
--concurrency <concurrency> | Max concurrent connections (default: 50) |
--csv | Output in CSV format |
--json | Output in JSON format |
--ports <ports> | Comma-separated TCP ports to probe (default: 80,443,1901,5001,8080,9000) |
--scan-timeout <scan-timeout> | Per-port TCP timeout in milliseconds (default: 2000) |
--timeout <timeout> | Override default timeout in milliseconds |
--verbose | Enable verbose/debug output |
-?, -h, --help | Show help and usage information |
Examples
Probe an IP range for devices — including hardware that doesn't answer UPnP/SSDP discovery, such as devices across a VPN:
bb-eco scan 192.168.0.80/28
Scanning 192.168.0.80/28 (14 hosts)...
[192.168.0.91] ED-004 (role: Industrial)
[192.168.0.88] Brainboxes ES-257 Ethernet to Serial (role: Industrial)
[192.168.0.89] ED-588 (role: Industrial)
Scanned 14/14 — 3 found
Scan complete: 3 device(s) found.
IP MAC Name Manufacturer Model Role WebURL
------------ --- ------------------------------------ ------------ ----------------------------- ---------- -----------------------
192.168.0.91 ED-004 Brainboxes Brainboxes Ethernet to Serial Industrial http://192.168.0.91:80/
192.168.0.88 Brainboxes ES-257 Ethernet to Serial Brainboxes Brainboxes Ethernet to Serial Industrial http://192.168.0.88:80/
192.168.0.89 ED-588 Brainboxes Brainboxes Ethernet to Serial Industrial http://192.168.0.89:80/
The scanner identifies non-Brainboxes web servers too (printers, switches, PLCs), classifying each host by role where it can. Results stream in as hosts respond — progress is shown from the first moment, and each dead host costs at most one probe timeout.
Tune the sweep for large ranges:
bb-eco scan 10.0.0.0/22 --concurrency 100 --scan-timeout 1000
This page is auto-generated from the live CLI help text. Do not edit by hand - re-run node scripts/gen-cli-reference.mjs after changes. Example sections are maintained in docs/cli-examples/ in the bb-eco repo.