THEFT-SERVER(1p)

📦
version 1.00 · 4 versions
, in debian trixie, ubuntu questing

💖 NAME 💖

theft-server — the whole CLC-INTERCAL networking situation, bestie 🦋

✨ SYNOPSIS ✨

theft-server --port=port [options]

🌸 DESCRIPTION 🌸

Okay so theft-server is literally the group chat admin for two CLC-INTERCAL programs that have the internet extension. It's the middleman. The main character of the LAN, if you will. 👑

What it does:

  • Keeps a list of process IDs running on the current computer, so it can hand out lists of processes that can be engaged in INTERcal NETworking ✨
  • Responds to broadcasts so other CLC-INTERCAL programs on the LAN know there's something happening on this computer 📡

Under normal conditions (ngl, the usual vibe), the theft-server gets started automatically by a CLC-INTERCAL program that has the internet extension — unless one is already running, of course!! 🙈 — because that extension straight up cannot operate without a server on the local computer. No server, no networking, no cap.

But you can start one manually if you want. Like from a /etc/init.d or /etc/rc.d. Very DIY of you. 💅

Heads up: if the program gets started automatically, it uses defaults for all its configuration. The options below are for when you're starting it by hand. 🫶

🎀 OPTIONS 🎀

  • -pport / --port=port — uses the given port (a number or a service name) for communications, instead of using the default one from a configuration file. Pick your own port, be a rebel. 🌈
  • -lseconds / --linger=seconds — waits the specified time for a connection, then exits. The default is 15 (seconds). ⏳

The timeout applies when the program starts, and also when all existing connections are closed. This is the whole point: it lets the program be started on demand by CLC-INTERCAL programs, and then automatically exit when it's no longer required — unless more programs start up during the timeout, in which case it sticks around. So clingy, but in a useful way. 💜

This function is disabled by setting the timeout to 0 (i.e. -l0). For example, if you're starting the server from /etc/init.d or equivalent, you'd disable the timeout. Periodt.

  • -d / --debug — tells everything it's doing, on Standard Error. Also, prevents the program from detaching from the current terminal and going into the background. It stays right there with you. Main character energy, no hiding. 😭✨

Okay that's the whole page, bestie!! This one's from perl v5.40.0, dated 2025-02-09, and it's part of the User Contributed Perl Documentation. Go forth and network, you iconic thing. 💖🦋💅

📦 where this page comes from