.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "THEFT-SERVER 1p"
.TH THEFT-SERVER 1p "2023-05-18" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
theft\-server \- CLC\-INTERCAL networking
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBtheft-server\fR \-\-port=\fIport\fR [options]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \fBtheft-server\fR mediates the communication between two CLC-INTERCAL
programs with the \fIinternet\fR 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 \s-1LAN\s0 to know there is something
happening on this computer.
.PP
Under normal conditions, the \fBtheft-server\fR is started automatically
by a CLC-INTERCAL programs with the \fIinternet\fR 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 \fI/etc/init.d\fR or \fI/etc/rc.d\fR.
.PP
If the program is started automatically, it uses defaults for all its
configuration; when started manually, it accepts the following options:
.IP "\fB\-p\fR\fIport\fR / \fB\-\-port\fR=\fIport\fR" 4
.IX Item "-pport / --port=port"
Uses the given \fIport\fR (number or service name) for communications,
instead of using the default one from a configuration file.
.IP "\fB\-l\fR\fIseconds\fR / \fB\-\-linger\fR=\fIseconds\fR" 4
.IX Item "-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).
.Sp
This function is disabled by setting the timeout to 0 (i.e. \fB\-l\fR\fI0\fR);
for example, if starting the server from \fI/etc/init.d\fR or equivalent
one would disable the timeout.
.IP "\fB\-d\fR / \fB\-\-debug\fR" 4
.IX Item "-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.
.SH "BUGS"
.IX Header "BUGS"
IPv6 is not yet implemented.
.SH "POD ERRORS"
.IX Header "POD ERRORS"
Hey! \fBThe above document had some coding errors, which are explained below:\fR
.IP "Around line 215:" 4
.IX Item "Around line 215:"
You forgot a '=back' before '=head1'