![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to uucico.8 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / uucp|
Return to uucico.8 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / uucp |
1.1 root 1: .\" Copyright (c) 1988 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)uucico.8 6.5 (Berkeley) 6/24/90
6: .\"
7: .TH UUCICO 8 "June 24, 1990"
8: .UC 6
9: .SH NAME
10: uucico, uucpd \- transfer files queued by uucp or uux
11: .SH SYNOPSIS
12: .B /usr/lib/uucp/uucico
13: [
14: .BI \-d spooldir
15: ] [
16: .BI \-g grade
17: ] [
18: .BI \-r role
19: ] [
20: .B \-R
21: ] [
22: .BI \-s system
23: ] [
24: .BI \-x debug
25: ] [
26: .B \-L
27: ] [
28: .BI \-t turnaround
29: ]
30: .PP
31: .B uucpd
32: .SH DESCRIPTION
33: .I Uucico
34: performs the actual work involved in transferring files between
35: systems.
36: .IR Uucp (1)
37: and
38: .IR uux (1)
39: merely queue requests for data transfer which
40: .I uucico
41: processes.
42: .PP
43: The following options are available.
44: .TP 8
45: .BI \-d spooldir
46: Use
47: .I spooldir
48: as the spool directory. The default is /var/spool/uucp.
49: .TP 8
50: .BI \-g grade
51: Only send jobs of grade
52: .I grade
53: or higher this transfer.
54: The grade of a job is specified when the job is queued by
55: .I uucp
56: or
57: .IR uux .
58: .TP 8
59: .BI \-r role
60: .I role
61: is either 1 or 0; it indicates whether
62: .I uucico
63: is to start up in
64: master or slave role, respectively. 1 is used when running
65: .I uucico
66: by hand or from
67: .IR cron (8).
68: 0 is used when another system calls the local system.
69: Slave role is the default.
70: .TP 8
71: .B \-R
72: Reverse roles. When used with the
73: .B \-r1
74: option, this tells the remote system to begin sending its
75: jobs first, instead of waiting for the local machine to finish.
76: .TP 8
77: .BI \-s system
78: Call only system
79: .IR system .
80: If
81: .B \-s
82: is not specified, and \-r1 is specified,
83: .I uucico
84: will attempt to call all systems for which there is work.
85: If
86: .B \-s
87: is specified, a call will be made even if there is
88: no work for that system. This is useful for polling.
89: .TP 8
90: .BI \-x debug
91: Turn on debugging at level
92: .IR debug .
93: Level 5 is a good start when trying to find out why a call
94: failed. Level 9 is very detailed. Level 99 is absurdly verbose.
95: If
96: .I role
97: is 1 (master), output is normally written to the standard message
98: output
99: .IR stderr .
100: If
101: .I stderr
102: is unavailable, output is written to
103: .RI /var/spool/uucp/AUDIT/ system.
104: When
105: .I role
106: is 0 (slave), debugging output is always written to the AUDIT
107: file.
108: .TP 8
109: .B \-L
110: Only call ``local'' sites. A site is considered local if
111: the device-type field in
112: .I L.sys
113: is one of LOCAL, DIR or TCP.
114: .TP 8
115: .BI \-t turnaround
116: Use
117: .I turnaround
118: as the line turnaround time (in minutes) instead of the default 30. If
119: .I turnaround
120: is missing or 0, line turnaround will be disabled.
121: After
122: .I uucico
123: has been running in slave role for
124: .I turnaround
125: minutes, it will attempt to run in master role by negotiating with the
126: remote machine.
127: In earlier versions of
128: .IR uucico ,
129: a transfer of many large files in one direction would hold up mail
130: going in the other direction.
131: With the turnaround code working, the message flow will be more
132: bidirectional in the short term.
133: This option only works with newer
134: .IR uucico 's
135: and is ignored by older ones.
136: .PP
137: If
138: .I uucico
139: receives a
140: .B SIGFPE
141: (see
142: .IR kill (1)),
143: it will toggle the debugging on or off.
144: .PP
145: .I Uucpd
146: is the server for supporting uucp connections over networks.
147: .I Uucpd
148: listens for service requests at the port indicated in the ``uucp''
149: service specification; see \fIservices\fP\|(5).
150: The server provides login name and password authentication before starting up
151: .I uucico
152: for the rest of the transaction.
153: .PP
154: .I Uucico
155: is commonly used either of two ways: as a daemon run periodically by
156: .IR cron (8)
157: to call out to remote systems, and as a ``shell'' for remote systems
158: who call in.
159: For calling out periodically, a typical line in
160: .I crontab
161: would be:
162: .PP
163: .nf
164: 0 * * * * /usr/lib/uucp/uucico -r1
165: .fi
166: .PP
167: This will run
168: .I uucico
169: every hour in master role.
170: For each system that has transfer requests queued,
171: .I uucico
172: calls the system, logs in, and executes the transfers. The file
173: .IR L.sys (5)
174: is consulted for information about how to log in, while
175: .IR L-devices (5)
176: specifies available lines and modems for calling.
177: .PP
178: For remote systems to dial in, an entry in the
179: .IR passwd (5)
180: file must be created, with a login ``shell'' of
181: .IR uucico .
182: For example:
183: .PP
184: .nf
185: nuucp:Password:6:1::/var/spool/uucppublic:/usr/lib/uucp/uucico
186: .fi
187: .PP
188: The UID for UUCP remote logins is not critical, so long as it differs from
189: the UUCP Administrative login.
190: The latter owns the UUCP files, and assigning
191: this UID to a remote login would be an extreme security hazard.
192: .SH FILES
193: .ta \w'/var/spool/uucp/D.hostnameX/ 'u
194: .nf
195: /usr/lib/uucp/ UUCP internal files/utilities
196: /usr/lib/uucp/L-devices Local device descriptions
197: /usr/lib/uucp/L-dialcodes Phone numbers and prefixes
198: /usr/lib/uucp/L.aliases Hostname aliases
199: /usr/lib/uucp/L.cmds Remote command permissions list
200: /usr/lib/uucp/L.sys Host connection specifications
201: /usr/lib/uucp/USERFILE Remote directory tree permissions list
202: .PP
203: /var/spool/uucp/ Spool directory
204: /var/spool/uucp/AUDIT/* Debugging audit trails
205: /var/spool/uucp/C./ Control files directory
206: /var/spool/uucp/D./ Incoming data file directory
207: /var/spool/uucp/D.hostname/ Outgoing data file directory
208: /var/spool/uucp/D.hostnameX/ Outgoing execution file directory
209: /var/spool/uucp/CORRUPT/ Place for corrupted C. and D. files
210: /var/spool/uucp/ERRLOG UUCP internal error log
211: /var/spool/uucp/LOGFILE UUCP system activity log
212: /var/spool/uucp/LCK/LCK..* Device lock files
213: /var/spool/uucp/SYSLOG File transfer statistics log
214: /var/spool/uucp/STST/* System status files
215: /var/spool/uucp/TM./ File transfer temp directory
216: /var/spool/uucp/X./ Incoming execution file directory
217: .PP
218: /var/spool/uucppublic Public access directory
219: .fi
220: .SH SEE ALSO
221: uucp(1), uuq(1), uux(1), L-devices(5), L-dialcodes(5), L.aliases(5),
222: L.cmds(5), L.sys(5), uuclean(8), uupoll(8), uusnap(8), uuxqt(8)
223: .PP
224: D. A. Nowitz and M. E. Lesk,
225: .IR "A Dial-Up Network of UNIX Systems" .
226: .PP
227: D. A. Nowitz,
228: .IR "Uucp Implementation Description" .
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.