nameserv::common(3tcl)

📦
version 2.0 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 nameserv::common — the shared-girlies edition 💖

okay so bestie, you've stumbled into nameserv::common(3tcl) and honestly? it's giving backstage-pass energy. this is the shared definitions page for the Name service facility. it's not the main character here, but the main characters literally cannot function without it. 🎀

✨ SYNOPSIS ✨

package require Tcl 8.5 9

package require nameserv::common ?0.2?

::nameserv::common::port

🌸 DESCRIPTION 🌸

okay first things first: go read Name service facility, introduction before you read this. like, fr fr. it's the pre-req. 🙈

so here's the tea — this package is internal. it is of no interest to users. i know, i know, heartbreaking. but hear me out: it's the glue. it provides the commands of the name service facility that are shared between the client and the server, and those two live in the packages nameserv::server and nameserv (which is the client, bestie, in case you were squinting). 💅

this service is built on top of the package comm and for the package comm. it's a whole situationship. 🦋

⚠️ and NO, it has nothing to do with the Internet's Domain Name System. zero. none. not even a little. if you came here hunting for a package that deals with DNS, pls go look at Tcllib's packages dns and resolv instead. this is a different vibe entirely, i promise. 😭

👑 API 👑

the package exports exactly one command. one. single. icon. as specified below:

  • ::nameserv::common::port — the result you get back from this command is the id of the default TCP/IP port that a nameservice server will listen on, and that a name service client will try to connect to. that's it, that's the whole command, and honestly? it ate. ✨

💀 BUGS, IDEAS, FEEDBACK 💀

ngl, this document — and the package it describes — will undoubtedly contain bugs and other problems. like, guaranteed. so pls pls pls report them in the category nameserv of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. 🫶

also! if you have ideas for enhancements for either the package and/or the documentation, send those along too. we want them. we're obsessed with them actually. 🌈

when you're proposing code changes, pls provide unified diffs, i.e. the output of diff -u. that's the format. that's the one. don't freestyle it bestie. 💜

and one more thing (sorry not sorry): attachments are strongly preferred over inlined patches. you can attach stuff 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. go forth and attach. 🎀

🌟 SEE ALSO 🌟

  • nameserv::client(3tcl)
  • nameserv::server(3tcl)

🍓 KEYWORDS 🍓

client, name service, server

💅 CATEGORY 💅

Networking

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

and that's the whole page, bestie!! this lil writeup is from tcllib, version 0.2, and it's stamped with the name nameserv::common(3tcl). stay slay, stay connected, and may your ports always be the default one. 💖✨🦋

📦 where this page comes from