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