DOKK / manpages / debian 11 / clc-intercal / theft-server.1p.en
THEFT-SERVER(1p) User Contributed Perl Documentation THEFT-SERVER(1p)

theft-server - CLC-INTERCAL networking

theft-server --port=port [options]

The theft-server mediates the communication between two CLC-INTERCAL programs with the internet extension. It keeps a list of process IDs running on the current computer so it can provide lists of processes which can be engaged in INTERcal NETworking; it also responds to broadcasts allowing other CLC-INTERCAL programs on the LAN to know there is something happening on this computer.

Under normal conditions, the theft-server is started automatically by a CLC-INTERCAL programs with the internet extension (unless one is already running, of course!) because the extension cannot operate without a server on the local computer. However, it is possible to start one manually, for example from a /etc/init.d or /etc/rc.d.

If the program is started automatically, it uses defaults for all its configuration; when started manually, it accepts the following options:

Uses the given port (number or service name) for communications, instead of using the default one from a configuration file.
Waits the specified time for a connection, then exit. The default is 600 (10 minutes). The timeout applies when the program starts and also when all existing connections are closed. This allows the program to be started on demand by CLC-INTERCAL programs, and to automatically exit when no longer required (unless more programs start up during the timeout).

This function is disabled by setting the timeout to 0 (i.e. -l0); for example, if starting the server from /etc/init.d or equivalent one would disable the timeout.

Tells everything it's doing (on Standard Error). Also, prevents the program from detaching from the current terminal and going into the background.

IPv6 is not yet implemented.

Hey! The above document had some coding errors, which are explained below:

You forgot a '=back' before '=head1'
2021-01-07 perl v5.32.0