WSDD2(8)

🎀 WSDD2(8) — NAME 🎀

hii bestie welcome to section 8 of the manual (System Administration tools, the daemon zone, very main character 💅) — the page is literally called WSDD2 and the star of it is:

• wsdd2 — server to provide WSDD/LLMNR services to clients

that's the whole NAME section. short, sweet, ate 💖

---

✨ SYNOPSIS ✨

wsddd2 [-h] [-d] [-4] [-6] [-u] [-t] [-l] [-w] [-L] [-W] [-i <intrerface>] [-H <hostname>] [-N <netbiosname>] [-G <workgroup>] [-b <kvlist>]

---

🌈 DESCRIPTION 🌈

okay so wsdd2 is the server daemon that provides WSDD (Web Services Dynamic Discovery) and also LLMNR (Link-Local Multicast Name Resolution) services, primarily for Windows clients, on both IPv4 and IPv6. both. at the same time. no cap 🫶

wsdd2's WSDD protocol handler multicasts Hello and Bye messages by itself over UDP, responds with ProbeMatch and ResolveMatch messages in response to Probe and Resolve queries respectively over UDP, and sends HTTP response messages to HTTP property query POST messages over TCP. like, it just does all that. unprompted. queen behavior 👑

wsdd2's LLMNR protocol handler responds to LLMNR multicast query messages over UDP and to LLMNR unicast query messages over TCP.

wsdd2 uses and listens on the following ports:

• 3702 UDP — WSDD multicast group addresses 239.255.255.250 and ff02::c.
• 3702 TCP — WSDD property query over HTTP.
• 5355 UDP — LLMNR query multicast group addresses 224.0.0.252 and ff02::1:3.
• 5355 TCP — LLMNR query unicast.

---

💅 OPTIONS 💅

• -h — display a simple help message to stdout, including the values of the parameters that are currently in effect.
• -d — fork off a child process to become daemon.
• -4 -6 — respond only to IPv4 and IPv6 respectively. the default is equivalent to -4 -6.
• -u -t — respond only to UDP and TCP respectively. the default is equivalent to -u -t.
• -l -w — respond only to LLMNR and WSDD respectively. the default is equivalent to -l -w.
• -L — print out LLMNR debug messages to stdout. stack multiple -L's to increment the debug level. yes, more L's = more lore 🔍
• -W — print out WSDD debug messages to stdout. multiple -W's to increment the debug level.
• -i <interface> — use only the specified interface to reply to incoming requests. specifying "any" or leaving the option out causes wsdd2 to listen on every IPv4 or IPv6 capable interface, excluding those that have names matching LeafNets, docker*, veth*, tun*, ppp*, zt*.
• -H <hostname> — use the specified string as host name instead of the first label before . of the system host name retrieved with gethostname(3) or uname(3) functions.
• -N <nebiosname> — use the specified string as NETBIOS machine name instead of the value returned by the testparm -s --parameter-name="netbios name" command or the system host name.
• -G <workgroup> — use the specified string as workgroup name instead of the value returned by the testparm -s --parameter-name="workgroup" command or the "WORKGROUP" default value.
• -b "key1:val1,key2:val2,..." — set WSDD query over HTTP response values in a comma-delimited list. the valid/necessary keys are: vendor, model, serial, sku, vendorurl, modelurl, presentationurl. this option overrides /proc/sys/dev/boot/info readouts.

---

👑 WSDD PROPERTY QUERY RESPONSE 👑

wsdd2 responds to property queries using the following values over HTTP. if a value may be set with multiple methods, the latter in the method list has precedence. (read that twice, bestie, order matters fr fr)

• Vendor — value retrieved from /proc/sys/dev/boot/info or set with the -b option.
• Model — value retrieved from /proc/sys/dev/boot/info or set with the -b option.
• Serial — value retrieved from /proc/sys/dev/boot/info or set with the -b option or 0.
• SKU — value retrieved from /proc/sys/dev/boot/info or set with the -b option.
• ModelURL — value set with the -b option.
• VendorURL — value set with the -b option.
• PresentationURL — value set with the -b option.

---

🎀 FILES 🎀

• /etc/samba/smb.conf — this is the default location of the Samba configuration file.
• /etc/machine-id — a single line text file containing a host-unique UUID in the form of 32 lowercase hex digits used by systemd-id128(1). see machine-id(5).
• /proc/sys/dev/boot/info — a list of key:value entries for WSDD query over HTTP response values.

---

🚨 SIGNALS 🚨

sending the wsdd2 a SIGHUP will cause it to restart. restarting will bind the daemon to new interfaces but will not reparse testparm(1)'s output and other parameters, nor re-evaluate command line options — stop and start the daemon again for that, okay? 😤 an address change, addition, or deletion on a network interface will restart wsdd2 as well.

SIGTERM and SIGINT will terminate wsdd2 gracefully with WSDD "Bye" messages. so polite. so demure. 🦋

---

🦋 SEE ALSO 🦋

testparm(1), systemd-id128(1).

---

⭐ STANDARDS ⭐

the WSDD protocol is described in detail in "Web Services Dynamic Discovery (WS-Discovery) Version 1.1" OASYS Standard, 1 July 2009 at

http://docs.oasis-open.org/ws-dd/discovery/1.1/os/wsdd-discovery-1.1-spec-os.html

LLMNR complies with RFC4795.

---

🌸 AUTHOR 🌸

Hiro Sugawara at NETGEAR authored the code. wsdd2 was inspired by and uses some code from the wsdd/llmnr extension for smbd created by Tobias Waldvogel, Jose M. Prieto, and possibly other contributors. legends only, honestly 🙌

---

and that's the page bestie, we're done 🫶 this one's source/version is WSDD, dated 02/05/2021, and it lives at WSDD2(8) — go forth and be discovered ✨🎀💖