ud...r(3tcl)

💖 NAME 💖

udpcluster — UDP Peer-to-Peer cluster, bestie. That's the whole vibe. We're talking peer-to-peer networking over UDP, no fancy handshake drama, just vibes and packets. 🦋

---

✨ SYNOPSIS ✨

package require Tcl 8.5 9

package require udpcluster ?0.3.4?

package require ip

package require nettool

package require comm

package require interp

package require dicttool

package require cron

Like, that's a whole little friend group of packages you're pulling in. Not just one. All of them. Slay. 💅

---

🌸 DESCRIPTION 🌸

Okay so listen. This package is a lightweight alternative to Zeroconf. That's it, that's the pitch, no cap.

What it does: it uses UDP packets to fill up a table of services that each node on a local network is offering. Every participant broadcasts a key/value list in plain UTF-8 — and that list says which ports are open, and what protocols you should expect to be hanging out on those ports. And the best part? Developers are free to add any additional key/value pairs beyond those. Go wild. Add your own keys. Main character energy. ✨

💫 Using udpcluster 💫

For every service you wish to publish, invoke this:

cluster::publish echo@[cluster::macid] {port 10000 protocol echo}

To query what services are available on the local network:

set results [cluster::search PATTERN]
# And inside that result...
echo@LOCALMACID {
   port 10000
   protocol echo
}

To unpublish a service:

cluster::unpublish echo@[cluster::macid]

Results will Historical Notes:

Okay so this next bit is literally how the page says it, word for word, I'm not touching it. 🫶

This tool was originally known as nns::cluster, but as development progressed, it was clear that it wasn't interacting with any of the other facilities in NNS. So. It got a rebrand. Iconic, honestly. 💅

---

😭 BUGS, IDEAS, FEEDBACK 😭

Not me having to say this, but: this document, and the package it describes, will undoubtedly contain bugs and other problems. Fr fr. That's just how it is, bestie. 💀

Please report such in the category nameserv of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. And please also report any ideas for enhancements you may have for either package and/or documentation — we want the ideas too, not just the bug reports. 🫶

When proposing code changes, please provide unified diffs, i.e the output of diff -u.

Also, heads up: attachments are strongly preferred over inlined patches. Attachments can be made by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar. Iykyk. 🎀

---

🌈 KEYWORDS 🌈

• name service
• server

---

👑 CATEGORY 👑

Networking

---

💜 COPYRIGHT 💜

Copyright (c) 2016-2018 Sean Woods <yoda@etoyoc.com>

---

And that's the whole page, bestie — brought to you by tcllib, version 0.3.4, page ud...r(3tcl). Go publish some services. 💖✨🎀🦋🌸💅🫶