Mercurial > repo

comparison interps/clc-intercal/inst/man/man1/theft-server.1p @ 996:859f9b4339e6

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
<Gregor> tar xf egobot.tar.xz
author HackBot
date Sun, 09 Dec 2012 19:30:08 +0000
parents
children
comparison
equal deleted inserted replaced
995:6883f5911eb7 996:859f9b4339e6
1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings. \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 . ds -- \(*W-
28 . ds PI pi
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31 . ds L" ""
32 . ds R" ""
33 . ds C` ""
34 . ds C' ""
35 'br\}
36 .el\{\
37 . ds -- \|\(em\|
38 . ds PI \(*p
39 . ds L" ``
40 . ds R" ''
41 'br\}
42 .\"
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
44 .ie \n(.g .ds Aq \(aq
45 .el .ds Aq '
46 .\"
47 .\" If the F register is turned on, we'll generate index entries on stderr for
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49 .\" entries marked with X<> in POD. Of course, you'll have to process the
50 .\" output yourself in some meaningful fashion.
51 .ie \nF \{\
52 . de IX
53 . tm Index:\\$1\t\\n%\t"\\$2"
54 ..
55 . nr % 0
56 . rr F
57 .\}
58 .el \{\
59 . de IX
60 ..
61 .\}
62 .\"
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64 .\" Fear. Run. Save yourself. No user-serviceable parts.
65 . \" fudge factors for nroff and troff
66 .if n \{\
67 . ds #H 0
68 . ds #V .8m
69 . ds #F .3m
70 . ds #[ \f1
71 . ds #] \fP
72 .\}
73 .if t \{\
74 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
75 . ds #V .6m
76 . ds #F 0
77 . ds #[ \&
78 . ds #] \&
79 .\}
80 . \" simple accents for nroff and troff
81 .if n \{\
82 . ds ' \&
83 . ds ` \&
84 . ds ^ \&
85 . ds , \&
86 . ds ~ ~
87 . ds /
88 .\}
89 .if t \{\
90 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
96 .\}
97 . \" troff and (daisy-wheel) nroff accents
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105 .ds ae a\h'-(\w'a'u*4/10)'e
106 .ds Ae A\h'-(\w'A'u*4/10)'E
107 . \" corrections for vroff
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110 . \" for low resolution devices (crt and lpr)
111 .if \n(.H>23 .if \n(.V>19 \
112 \{\
113 . ds : e
114 . ds 8 ss
115 . ds o a
116 . ds d- d\h'-1'\(ga
117 . ds D- D\h'-1'\(hy
118 . ds th \o'bp'
119 . ds Th \o'LP'
120 . ds ae ae
121 . ds Ae AE
122 .\}
123 .rm #[ #] #H #V #F C
124 .\" ========================================================================
125 .\"
126 .IX Title "THEFT-SERVER 1p"
127 .TH THEFT-SERVER 1p "2008-03-29" "perl v5.14.2" "User Contributed Perl Documentation"
128 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
129 .\" way too many mistakes in technical documents.
130 .if n .ad l
131 .nh
132 .SH "NAME"
133 theft\-server \- CLC\-INTERCAL networking
134 .SH "SYNOPSIS"
135 .IX Header "SYNOPSIS"
136 \&\fBtheft-server\fR \-\-port=\fIport\fR [options]
137 .SH "DESCRIPTION"
138 .IX Header "DESCRIPTION"
139 The \fBtheft-server\fR mediates the communication between two CLC-INTERCAL
140 programs with the \fIinternet\fR extension. It keeps a list of process IDs
141 running on the current computer so it can provide lists of processes which
142 can be engaged in INTERcal NETworking; it also responds to broadcasts
143 allowing other CLC-INTERCAL programs on the \s-1LAN\s0 to know there is something
144 happening on this computer.
145 .PP
146 Under normal conditions, the \fBtheft-server\fR is started automatically
147 by a CLC-INTERCAL programs with the \fIinternet\fR extension (unless one
148 is already running, of course!) because the extension cannot operate
149 without a server on the local computer. However, it is possible to
150 start one manually, for example from a \fI/etc/init.d\fR or \fI/etc/rc.d\fR.
151 .PP
152 If the program is started automatically, it uses defaults for all its
153 configuration; when started manually, it accepts the following options:
154 .IP "\fB\-p\fR\fIport\fR / \fB\-\-port\fR=\fIport\fR" 4
155 .IX Item "-pport / --port=port"
156 Uses the given \fIport\fR (number or service name) for communications,
157 instead of using the default one from a configuration file.
158 .IP "\fB\-l\fR\fIseconds\fR / \fB\-\-linger\fR=\fIseconds\fR" 4
159 .IX Item "-lseconds / --linger=seconds"
160 Waits the specified time for a connection, then exit. The default is
161 600 (10 minutes). The timeout applies when the program starts and also
162 when all existing connections are closed. This allows the program to
163 be started on demand by CLC-INTERCAL programs, and to automatically
164 exit when no longer required (unless more programs start up during
165 the timeout).
166 .Sp
167 This function is disabled by setting the timeout to 0 (i.e. \fB\-l\fR\fI0\fR);
168 for example, if starting the server from \fI/etc/init.d\fR or equivalent
169 one would disable the timeout.
170 .IP "\fB\-d\fR / \fB\-\-debug\fR" 4
171 .IX Item "-d / --debug"
172 Tells everything it's doing (on Standard Error). Also, prevents the
173 program from detaching from the current terminal and going into the
174 background.
175 .SH "BUGS"
176 .IX Header "BUGS"
177 IPv6 is not yet implemented.
178 .SH "POD ERRORS"
179 .IX Header "POD ERRORS"
180 Hey! \fBThe above document had some coding errors, which are explained below:\fR
181 .IP "Around line 215:" 4
182 .IX Item "Around line 215:"
183 You forgot a '=back' before '=head1'