Debian Codegraph @

upstream/opensuse-tumbleweed/man8/uucico.8

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