Provided by: clc-intercal_1.0~4pre1.-94.-2-3_all bug

NAME

       theft-server - 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'