troglobit/man
ssdp-scan(1) General Commands Manual ssdp-scan(1)

ssdp-scan —
Scan for SSDP capable devices on attached networks

ssdp-scan [
-hj
] [
-l LEVEL
] [
-t SEC
] [
IFACE [
IFACE [
...
]
]
]

ssdp-scan is a tool for scanning for Simple Service Discovery Protocol (SSDP) capable devices on attached networks. It sends M-SEARCH * to 239.255.255.250 to continuously update a list of SSDP hosts.

The following command line options are available:
Show program help text.
JSON output, best used with -t SEC option.
LEVEL
Set log level to one of the following, default notice:
Disable all logging
Error conditions
Warning conditions
Normal but significant condition (default)
Informational
Debug-level messages
Timeout and exit after SEC seconds.
[
IFACE
]
By default ssdp-scan runs on all IPv4 capable interfaces, except loopback. If interface names are given as arguments, ssdp-scan will run only on them.

$ ssdp-scan -j -t 3 
ssdp-scan: Auto-stop in 3 seconds ... 
[ 
  { 
    "name": "ReadyNAS Ultra [readynas]", 
    "url": "https://192.168.1.171/admin/" 
  }, 
  { 
    "name": "readynas: ReadyNAS Ultra 4", 
    "url": "http://192.168.1.171:8200/" 
  }, 
  { 
    "name": "Kodi (LibreELEC)", 
    "url": "http://192.168.1.226:8080/" 
  } 
]

ssdp-scan is very impatient. In order to scan for hosts it sends M-SEARCH * messages every other second, which can result in lots of replies, which in turn causes ssdp-scan to retrieve XML files from each replying host. Be careful.
Unless started with the -t SEC option, ssdp-scan does not terminate on its own. Instead, it scans continuously until the user stops it by pressing Ctrl-C.
ssdp-scan does not rely on a local SSDP responder. It has no dependencies besides a standard UNIX libc.

ssdpd(8)

ssdp-scan was written by Joachim Wiberg ⟨troglobit@gmail.com⟩ to test ssdpd in complex network topologies. It is modeled on mdns-scan(1).
June 3, 2023 Debian

Maintained in troglobit/ssdp-responder as man/ssdp-scan.1. Send corrections there, or read it on the mirror.