nameserv::common(n)

πŸ“¦
version 2.0 Β· 2 versions
, in fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

πŸ’– nameserv::common(n) β€” the shared-brain cell of the Name service facility πŸ’–

okay bestie, welcome to nameserv::common, a manual page from the tcllib crew. it lives in the Name service facility section of the manual, and it is genuinely the most "backstage crew" page you will ever read. let's get into it πŸŽ€


✨ NAME ✨

nameserv::common β€” Name service facility, shared definitions 🫢


🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require nameserv::common ?0.2?

::nameserv::common::port

like yes, that's the whole vibe. three little lines. iconic. πŸ‘‘


πŸ¦‹ DESCRIPTION πŸ¦‹

okay so first thing's first: please read Name service facility, introduction before you do literally anything else here. it's the prerequisite, no skipping, i'm watching πŸ’…

now the tea: this package is internal and of no interest to users. not me telling you to go home 😭 it's just that it only exists to hold the commands of the name service facility that are shared</> between the client and the server β€” which are the ones implemented by the packages nameserv::server and nameserv (that's the client, bestie).

and a very important vibe check: this service is built on top of and for the package comm. it has nothing to do with the Internet's Domain Name System. if you came here looking for a package that deals with that DNS, the page is redirecting you to Tcllib's packages dns and resolv. different girlies entirely. ✨


πŸ’œ API πŸ’œ

the package exports exactly one command, as specified below:

  • ::nameserv::common::port β€” the result this command hands back 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. she serves one fact and serves it flawlessly πŸ“

😭 BUGS, IDEAS, FEEDBACK 😭

real talk: this document, and the package it describes, will undoubtedly contain bugs and other problems. no cap. 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 the package and/or the documentation β€” we want them, fr fr 🫢

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

also note further that 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. yes it's a whole little quest. you got this. 🌈


πŸ”₯ SEE ALSO πŸ”₯

  • nameserv::client(n)
  • nameserv::server(n)

⭐ 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 was nameserv::common(n) from tcllib, version 0.2 β€” shoutout to the source and the version for holding it down, mwah πŸ’…βœ¨

πŸ“¦ where this page comes from