|
|
1.1 root 1: ''' $Id: uucico.8,v 1.1 93/07/30 07:54:33 bin Exp Locker: bin $
2: .TH uucico 8 "Taylor UUCP 1.04"
3: .SH NAME
4: uucico \- UUCP file transfer daemon
5: .SH SYNOPSIS
6: .B uucico
7: [ options ]
8: .SH DESCRIPTION
9: The
10: .I uucico
11: daemon processes file transfer requests queued by
12: .I uucp
13: (1) and
14: .I uux
15: (1). It is started when
16: .I uucp
17: or
18: .I uux
19: is run (unless they are given the
20: .B \-r
21: option). It is also typically started periodically using
22: entries in the
23: .I crontab
24: table(s).
25:
26: When invoked with the
27: .B \-r1
28: option or the
29: .B \-s
30: or
31: .B \-S
32: option, the daemon will place a call to a remote system, running in
33: master mode.
34: Otherwise the daemon will start in slave mode, accepting a
35: call from a remote system. Typically a special login name will be set
36: up for UUCP which automatically invokes
37: .I uucico
38: when a call is made.
39:
40: When
41: .I uucico
42: terminates, it invokes the
43: .I uuxqt
44: (8) daemon, unless the
45: .B \-q
46: option is given;
47: .I uuxqt
48: (8) executes any work orders created by
49: .I uux
50: (1) on a remote system, and any work orders created locally which have
51: received remote files for which they were waiting.
52:
53: If a call fails,
54: .I uucico
55: will normally refuse to retry the
56: call until a certain (configurable) amount of time
57: has passed. This may be overriden by the
58: .B -f
59: or the
60: .B -S
61: option.
62:
63: The
64: .B \-l
65: or
66: .B \-e
67: option may be used to force
68: .I uucico
69: to produce its own prompts of "login: " and "Password:". When another
70: daemon calls in, it will see these prompts and log in as usual; the
71: login name and password will be checked against a separate list kept
72: specially for
73: .I uucico
74: rather than the
75: .I /etc/passwd
76: file. The
77: .B \-l
78: option will prompt once and then exit. The
79: .B \-e
80: option will prompt again after the first session is over; in this mode
81: .I uucico
82: will permanently control a port.
83:
84: If
85: .I uucico
86: receives a SIGQUIT, SIGTERM or SIGPIPE signal, it will cleanly abort
87: any current conversation with a remote system and exit. If it
88: receives a SIGHUP signal it will abort any current conversation, but
89: will continue to place calls to (if invoked with
90: .B \-r1)
91: and accept calls from (if invoked with
92: .B \-e)
93: other systems. If it receives a
94: SIGINT signal it will finish the current conversation, but will not
95: place or accept any more calls.
96: .SH OPTIONS
97: The following options may be given to
98: .I uucico.
99: .TP 5
100: .B \-r1
101: Start in master mode (call out to a system); implied by
102: .B \-s
103: or
104: .B \-S.
105: If no system is specified, call any system for which work is waiting
106: to be done.
107: .TP 5
108: .B \-r0
109: Start in slave mode. This is the default.
110: .TP 5
111: .B \-s system
112: Call the named system.
113: .TP 5
114: .B \-S system
115: Call the named system, ignoring any required wait.
116: .TP 5
117: .B \-f
118: Ignore any required wait for any systems to be called.
119: .TP 5
120: .B \-l
121: Prompt for login name and password using "login: " and "Password:".
122: This allows
123: .I uucico
124: to be easily run from
125: .I inetd
126: (8). The login name and password are checked against the UUCP
127: password file, which has no connection to the file
128: .I /etc/passwd.
129: .TP 5
130: .B \-p port
131: Specify a port to call out on or to listen to. In slave mode, this
132: implies
133: .B \-e.
134: .TP 5
135: .B \-e
136: Enter endless loop of login/password prompts and slave mode daemon
137: execution. The program will not stop by itself; you must use
138: .I kill
139: (1) to shut it down.
140: .TP 5
141: .B \-w
142: After calling out (to a particular system when
143: .B \-s
144: or
145: .B \-S
146: is specifed, or to all systems which have work when
147: .B \-r1
148: is specifed), begin an endless loop as with
149: .B \-e.
150: .TP 5
151: .B \-q
152: Do not start the
153: .I uuxqt
154: (8) daemon when finished.
155: .TP 5
156: .B \-c
157: If no calls are permitted at this time, then don't make the call, but
158: also do not put an error message in the log file and do not update the
159: system status (as reported by
160: .I uustat
161: (1)). This can be convenient for automated polling scripts, which may
162: want to simply attempt to call every system rather than worry about
163: which particular systems may be called at the moment.
164: .TP 5
165: .B \-D
166: Do not detach from the controlling terminal. Normally
167: .I uucico
168: detaches from the terminal before each call out to another system and
169: before invoking
170: .I uuxqt.
171: This option prevents this.
172: .TP 5
173: .B \-x type, \-X type
174: Turn on particular debugging types. The following types are
175: recognized: abnormal, chat, handshake, uucp-proto, proto, port,
176: config, spooldir, execute, incoming, outgoing.
177:
178: Multiple types may be given, separated by commas, and the
179: .B \-x
180: option may appear multiple times. A number may also be given, which
181: will turn on that many types from the foregoing list; for example,
182: .B \-x 2
183: is equivalent to
184: .B \-x abnormal,chat.
185:
186: The debugging output is sent to the debugging file, usually one of
187: /usr/spool/uucp/Debug, /usr/spool/uucp/DEBUG, or
188: /usr/spool/uucp/.Admin/audit.local.
189: .TP 5
190: .B \-I file
191: Set configuration file to use. This option may not be available,
192: depending upon how
193: .I uucico
194: was compiled.
195: .TP 5
196: .B \-u login
197: This option is ignored. It is only included because some versions of
198: uucpd invoke
199: .I uucico
200: with it.
201: .SH FILES
202: The file names may be changed at compilation time or by the
203: configuration file, so these are only approximations.
204:
205: .br
206: /usr/lib/uucp/config - Configuration file.
207: .br
208: /usr/lib/uucp/passwd - Default UUCP password file.
209: .br
210: /usr/spool/uucp -
211: UUCP spool directory.
212: .br
213: /usr/spool/uucp/Log -
214: UUCP log file.
215: .br
216: /usr/spool/uucppublic -
217: Default UUCP public directory.
218: .br
219: /usr/spool/uucp/Debug -
220: Debugging file.
221: .SH SEE ALSO
222: kill(1), uucp(1), uux(1), uustat(1), uuxqt(8)
223: .SH AUTHOR
224: Ian Lance Taylor
225: ([email protected] or uunet!airs!ian)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.