theft-server(1) CLC-INTERCAL networking

SYNOPSIS

theft-server --port=port [options]

DESCRIPTION

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:

-pport / --port=port
Uses the given port (number or service name) for communications, instead of using the default one from a configuration file.
-lseconds / --linger=seconds
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.

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

BUGS

IPv6 is not yet implemented.

POD ERRORS

Hey! The above document had some coding errors, which are explained below:
Around line 215:
You forgot a '=back' before '=head1'