Commit | Line | Data |
---|---|---|
f68c9796 KB |
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. | |
aafc3782 | 4 | .\" |
6d2c240b | 5 | .\" @(#)uucico.8 6.5 (Berkeley) %G% |
f68c9796 KB |
6 | .\" |
7 | .TH UUCICO 8 "" | |
aafc3782 JB |
8 | .UC 6 |
9 | .SH NAME | |
4d9d48c2 | 10 | uucico, uucpd \- transfer files queued by uucp or uux |
aafc3782 | 11 | .SH SYNOPSIS |
5f25fb9e | 12 | .B /usr/lib/uucp/uucico |
aafc3782 JB |
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 | ] | |
4d9d48c2 | 30 | .PP |
6d2c240b | 31 | .B uucpd |
aafc3782 | 32 | .SH DESCRIPTION |
5f25fb9e | 33 | .I Uucico |
aafc3782 JB |
34 | performs the actual work involved in transferring files between |
35 | systems. | |
f68c9796 | 36 | .IR Uucp (1) |
aafc3782 | 37 | and |
f68c9796 | 38 | .IR uux (1) |
5f25fb9e KM |
39 | merely queue requests for data transfer which |
40 | .I uucico | |
41 | processes. | |
aafc3782 JB |
42 | .PP |
43 | The following options are available. | |
44 | .TP 8 | |
45 | .BI \-d spooldir | |
46 | Use | |
47 | .I spooldir | |
6d2c240b | 48 | as the spool directory. The default is /var/spool/uucp. |
aafc3782 JB |
49 | .TP 8 |
50 | .BI \-g grade | |
51 | Only send jobs of grade | |
52 | .I grade | |
53 | or higher this transfer. | |
5f25fb9e KM |
54 | The grade of a job is specified when the job is queued by |
55 | .I uucp | |
56 | or | |
57 | .IR uux . | |
aafc3782 JB |
58 | .TP 8 |
59 | .BI \-r role | |
60 | .I role | |
5f25fb9e KM |
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 | |
aafc3782 | 65 | .I uucico |
5f25fb9e KM |
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. | |
aafc3782 JB |
76 | .TP 8 |
77 | .BI \-s system | |
78 | Call only system | |
79 | .IR system . | |
80 | If | |
81 | .B \-s | |
5f25fb9e | 82 | is not specified, and \-r1 is specified, |
aafc3782 JB |
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 | |
5f25fb9e | 88 | no work for that system. This is useful for polling. |
aafc3782 JB |
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. | |
5f25fb9e KM |
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 | |
6d2c240b | 103 | .RI /var/spool/uucp/AUDIT/ system. |
5f25fb9e KM |
104 | When |
105 | .I role | |
106 | is 0 (slave), debugging output is always written to the AUDIT | |
107 | file. | |
aafc3782 JB |
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. | |
5f25fb9e KM |
121 | After |
122 | .I uucico | |
123 | has been running in slave role for | |
aafc3782 | 124 | .I turnaround |
5f25fb9e KM |
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. | |
aafc3782 JB |
131 | With the turnaround code working, the message flow will be more |
132 | bidirectional in the short term. | |
5f25fb9e KM |
133 | This option only works with newer |
134 | .IR uucico 's | |
135 | and is ignored by older ones. | |
aafc3782 JB |
136 | .PP |
137 | If | |
138 | .I uucico | |
139 | receives a | |
140 | .B SIGFPE | |
141 | (see | |
5f25fb9e | 142 | .IR kill (1)), |
aafc3782 JB |
143 | it will toggle the debugging on or off. |
144 | .PP | |
4d9d48c2 JB |
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 | |
5f25fb9e KM |
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: | |
aafc3782 | 162 | .PP |
5f25fb9e KM |
163 | .nf |
164 | 0 * * * * /usr/lib/uucp/uucico -r1 | |
165 | .fi | |
166 | .PP | |
167 | This will run | |
aafc3782 | 168 | .I uucico |
5f25fb9e KM |
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 | |
6d2c240b | 185 | nuucp:Password:6:1::/var/spool/uucppublic:/usr/lib/uucp/uucico |
5f25fb9e KM |
186 | .fi |
187 | .PP | |
188 | The UID for UUCP remote logins is not critical, so long as it differs from | |
4d9d48c2 | 189 | the UUCP Administrative login. |
5f25fb9e KM |
190 | The latter owns the UUCP files, and assigning |
191 | this UID to a remote login would be an extreme security hazard. | |
aafc3782 | 192 | .SH FILES |
6d2c240b | 193 | .ta \w'/var/spool/uucp/D.hostnameX/ 'u |
5f25fb9e KM |
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 | |
6d2c240b TH |
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 | |
5f25fb9e | 217 | .PP |
6d2c240b | 218 | /var/spool/uucppublic Public access directory |
5f25fb9e | 219 | .fi |
aafc3782 | 220 | .SH SEE ALSO |
f68c9796 KB |
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) | |
5f25fb9e KM |
223 | .PP |
224 | D. A. Nowitz and M. E. Lesk, | |
225 | .IR "A Dial-Up Network of UNIX Systems" . | |
226 | .PP | |
aafc3782 | 227 | D. A. Nowitz, |
5f25fb9e | 228 | .IR "Uucp Implementation Description" . |