1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
|
'\"
.\" $Id: uucico.8,v 1.20 2002/03/05 22:20:48 ian Rel $
.\"
.TH uucico 8 "Taylor UUCP 1.07"
.SH NAME
uucico \- UUCP file transfer daemon
.SH SYNOPSIS
.B uucico
[ options ]
.SH DESCRIPTION
The
.I uucico
daemon processes file transfer requests queued by
.I uucp
(1) and
.I uux
(1). It is started when
.I uucp
or
.I uux
is run (unless they are given the
.B \-r
option). It is also typically started periodically using
entries in the
.I crontab
table(s).
When invoked with
.B \-r1,
.B \-\-master,
.B \-s,
.B \-\-system,
or
.B \-S,
the daemon will place a call to a remote system, running in master
mode. Otherwise the daemon will start in slave mode, accepting a call
from a remote system. Typically a special login name will be set up
for UUCP which automatically invokes
.I uucico
when a call is made.
When
.I uucico
terminates, it invokes the
.I uuxqt
(8) daemon, unless the
.B \-q
or
.B \-\-nouuxqt
option is given;
.I uuxqt
(8) executes any work orders created by
.I uux
(1) on a remote system, and any work orders created locally which have
received remote files for which they were waiting.
If a call fails,
.I uucico
will normally refuse to retry the
call until a certain (configurable) amount of time
has passed. This may be overridden by the
.B -f,
.B --force,
or
.B -S
option.
The
.B \-l,
.B \-\-prompt,
.B \-e,
or
.B \-\-loop
options may be used to force
.I uucico
to produce its own prompts of "login: " and "Password:". When another
daemon calls in, it will see these prompts and log in as usual. The
login name and password will normally be checked against a separate
list kept specially for
.I uucico
rather than the
.I /etc/passwd
file; it is possible on some systems to direct
.I uucico
to use the
.I /etc/passwd
file. The
.B \-l
or
.B \--prompt
option will prompt once and then exit; in this mode the UUCP
administrator or the superuser may use the
.B \-u
or
.B \--login
option to force a login name, in which case
.I uucico
will not prompt for one.
The
.B \-e
or
.B \--loop
option will prompt again after the first session is over; in this mode
.I uucico
will permanently control a port.
If
.I uucico
receives a SIGQUIT, SIGTERM or SIGPIPE signal, it will cleanly abort
any current conversation with a remote system and exit. If it
receives a SIGHUP signal it will abort any current conversation, but
will continue to place calls to (if invoked with
.B \-r1
or
.B \-\-master)
and accept calls from (if invoked with
.B \-e
or
.B \-\-loop)
other systems. If it receives a
SIGINT signal it will finish the current conversation, but will not
place or accept any more calls.
.SH OPTIONS
The following options may be given to
.I uucico.
.TP 5
.B \-r1, \-\-master
Start in master mode (call out to a system); implied by
.B \-s,
.B \-\-system,
or
.B \-S.
If no system is specified, call any system for which work is waiting
to be done.
.TP 5
.B \-r0, \-\-slave
Start in slave mode. This is the default.
.TP 5
.B \-s system, \-\-system system
Call the named system.
.TP 5
.B \-S system
Call the named system, ignoring any required wait. This is equivalent
to
.B \-s system \-f.
.TP 5
.B \-f, \-\-force
Ignore any required wait for any systems to be called.
.TP 5
.B \-g, \-\-grade
Limit outgoing call to a given grade.
.TP 5
.B \-l, \-\-prompt
Prompt for login name and password using "login: " and "Password:".
This allows
.I uucico
to be easily run from
.I inetd
(8). The login name and password are checked against the UUCP
password file, which probably has no connection to the file
.I /etc/passwd.
The
.B \-\-login
option may be used to force a login name, in which cause
.I uucico
will only prompt for a password.
.TP 5
.B \-p port, \-\-port port
Specify a port to call out on or to listen to.
.TP 5
.B \-e, \-\-loop
Enter endless loop of login/password prompts and slave mode daemon
execution. The program will not stop by itself; you must use
.I kill
(1) to shut it down.
.TP 5
.B \-w, \-\-wait
After calling out (to a particular system when
.B \-s,
.B \-\-system,
or
.B \-S
is specified, or to all systems which have work when just
.B \-r1
or
.B \-\-master
is specified), begin an endless loop as with
.B \-\-loop.
.TP 5
.B \-q, \-\-nouuxqt
Do not start the
.I uuxqt
(8) daemon when finished.
.TP 5
.B \-c, \-\-quiet
If no calls are permitted at this time, then don't make the call, but
also do not put an error message in the log file and do not update the
system status (as reported by
.I uustat
(1)). This can be convenient for automated polling scripts, which may
want to simply attempt to call every system rather than worry about
which particular systems may be called at the moment. This option
also suppresses the log message indicating that there is no work to be
done.
.TP 5
.B \-C, \-\-ifwork
Only call the system named by
.B \-s,
.B \-\-system
or
.B \-S
if there is work for that system.
.TP 5
.B \-D, \-\-nodetach
Do not detach from the controlling terminal. Normally
.I uucico
detaches from the terminal before each call out to another system and
before invoking
.I uuxqt.
This option prevents this.
.TP 5
.B \-u name, \-\-login name
Set the login name to use instead of that of the invoking user. This
option may only be used by the UUCP administrator or the superuser.
If used with
.B \-\-prompt,
this will cause
.I uucico
to prompt only for the password, not the login name.
.TP 5
.B \-z, \-\-try-next
If a call fails after the remote system is reached, try the next
alternate rather than simply exiting.
.TP 5
.B \-i type, \-\-stdin type
Set the type of port to use when using standard input. The only
support port type is TLI, and this is only available on machines which
support the TLI networking interface. Specifying
.B \-iTLI
causes
.I uucico
to use TLI calls to perform I/O.
.TP 5
.B \-x type, \-X type, \-\-debug type
Turn on particular debugging types. The following types are
recognized: abnormal, chat, handshake, uucp-proto, proto, port,
config, spooldir, execute, incoming, outgoing.
Multiple types may be given, separated by commas, and the
.B \-\-debug
option may appear multiple times. A number may also be given, which
will turn on that many types from the foregoing list; for example,
.B \-\-debug 2
is equivalent to
.B \-\-debug abnormal,chat.
The debugging output is sent to the debugging file, which may be
printed using
.I uulog -D.
.TP 5
.B \-I file, \-\-config file
Set configuration file to use. This option may not be available,
depending upon how
.I uucico
was compiled.
.TP 5
.B \-v, \-\-version
Report version information and exit.
.TP 5
.B \-\-help
Print a help message and exit.
.SH SEE ALSO
kill(1), uucp(1), uux(1), uustat(1), uuxqt(8)
.SH AUTHOR
Ian Lance Taylor
<ian@airs.com>
|