nnslog(1)

✨ nnslog(1) ✨

okay bestie, welcome to the nnslog page 💖 this is a Name service facility situation, specifically the Commandline Logging Client Application. yes it's giving very "I just want to watch the server breathe" energy. stay with me, it's actually so good.

---

🌸 SYNOPSIS 🌸

nnslog ?-host host? ?-port port?

that's it. that's the whole vibe. two optional flags and she's off 👑

---

🦋 DESCRIPTION 🦋

first things first, bestie: go read Name service facility, introduction before this. it's the prerequisite, no skipsies 🙈

so. the app this doc is about, nnslog, is a simple command line client for the nano name service facility, which is brought to you by the Tcllib packages nameserv and nameserv::server. yes, both. they're a package duo, they come as a set 💅

what does it actually do? it's basically

nns search -continuous *

but with a different output formatting. that's the whole difference, no cap. instead of continuously showing you the current contents of the server all over your terminal like a little live dashboard, it just logs every received add/remove event to stdout. event comes in, it gets logged. event comes in, it gets logged. that's the bit. that's the service ✨

important psa: this name service facility has literally nothing to do with the Internet's Domain Name System, aka DNS. like, zero. different thing entirely. if you came here looking for a package that deals with DNS, bestie you're in the wrong building — go check out dns and resolv instead, both also found in Tcllib 🫶

---

💫 USE CASES 💫

nnslog was written with one main use case in mind, and honestly she serves it:

1. Monitoring the name service for all changes and logging them in a text terminal. 📝

that's the dream. that's the assignment. and she ate.

---

🎀 COMMAND LINE 🎀

nnslog ?-host host? ?-port port?

so here's what happens when you run her: the command connects to the specified name service, sets up a search for all changes, and then prints all received events to stdout, with each event on its own line. one event per line. clean. readable. iconic.

the command will not exit until it is explicitly terminated by the user. like, she's committed. she's not leaving. you have to leave. 😭

and here's the lowkey impressive part: she will especially survive the loss of the connection to the name service, and will reestablish the search and log when the connection is restored. she's down but she's never out. main character resilience fr fr 🔥

the options for specifying the name service get explained a little further down, in the OPTIONS section. keep scrolling bestie 👇

---

💅 OPTIONS 💅

this section describes all the options available to the user of the application. there are two. two little guys. both optional. let's go:

• -host name|ipaddress — if you don't specify this, it defaults to localhost. it specifies the name or ip-address of the host the name service you want to talk to is running on. 🏠
• -port number — if you don't specify this, it defaults to 38573. it specifies the TCP port the name service you want to talk to is listening on for requests. 📮

that's the whole option list. short, sweet, slays.

---

🙈 BUGS, IDEAS, FEEDBACK 🙈

okay real talk for a sec. this document, and the package it describes, will undoubtedly contain bugs and other problems. obviously. everything does. it's fine. we're fine.

so please report such things 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 the package and/or the documentation. ideas are welcome. we love ideas. 💖

when proposing code changes, please provide unified diffs, i.e. the output of diff -u. yes, exactly that. no "here's roughly what I changed" prose, we want the diff bestie 🫶

also note, and this is a strong preference: attachments are strongly preferred over inlined patches. to attach something, go to the Edit form of the ticket immediately after its creation, and then use the left-most button in the secondary navigation bar. that's the one. the left-most one. you got this 💅

---

🌈 SEE ALSO 🌈

• nameserv(3tcl)
• nameserv::common(3tcl)

go read these too, they're the extended universe 🦋

---

⭐ KEYWORDS ⭐

• application
• client
• name service

---

👑 CATEGORY 👑

Networking

---

💜 COPYRIGHT 💜

Copyright (c) 2008 Andreas Kupries <andreas_kupries@users.sourceforge.net>

---

and that's the page bestie!! brought to you by tcllib, version 1.0 — she's an icon, she's a legend, and she is the moment. log those events, stay connected, and never forget that you have to terminate her yourself 😭✌️