ident(3tcl)

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

💖 ident — the Ident protocol client, bestie edition 💖

okay so this is ident(3tcl), aka the Identification protocol client, and it lives in the tcllib collection. sit down, hydrate, and let me tell you everything 🫶

✨ NAME ✨

ident — Ident protocol client 💅

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require ident ?0.44?

::ident::query socket ?callback?

🦋 DESCRIPTION 🦋

so the ident package is literally a client implementation of the ident protocol, exactly as defined in RFC 1413 (http://www.rfc-editor.org/rfc/rfc1413.txt). it's giving "I go ask the other side who they are" energy, no cap.

💜 ::ident::query socket ?callback?

this command queries the ident daemon on the remote side of the socket you hand it, and it returns the result of the query as a dictionary. 🎀

here's the tea: if you interpret that dictionary as a list, the first key is always resp-type, and it can have one of these three values: USERID, ERROR, and FATAL. let's break them down, bestie:

  • USERID — this is the slay outcome 🔥 it indicates a successful response. two more keys and their associated values come back with it: opsys, and user-id.
  • ERROR — this means the ident server has returned an error 😭 a second key named error is present, and its value contains the error-type field from the server response.
  • FATAL — fatal errors happen when no ident server is listening on the remote side, or when the ident server gives a response that does not conform to the RFC 💀 a detailed error message is returned under the error key.
so like… USERID = we ate. ERROR = the server said no. FATAL = nobody's home or they're speaking nonsense. periodt.

🙈 BUGS, IDEAS, FEEDBACK 🙈

ngl, this document, and the package it describes, will undoubtedly contain bugs and other problems. it's not perfect, nothing is 💔 please report such in the category ident of the Tcllib Trackers [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 love a glow-up suggestion ✨

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

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. iykyk 💅

👑 KEYWORDS 👑

ident, identification, rfc 1413

🌈 CATEGORY 🌈

Networking

Copyright (c) 2004 Reinhard Max <max@tclers.tk>

okay that's the whole vibe check, bestie — go query some sockets responsibly, and remember: this was tcllib 0.44, from the ident(3tcl) page. mwah 💖✨🌸🦋💅🫶

📦 where this page comes from