| blob | 8daa285e586c00a817dc537a3d5064e56be4723a |
1 '\" te
2 .\" Copyright 1989 AT&T Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
3 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at
4 .\" http://www.opengroup.org/bookstore/.
5 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
6 .\" This notice shall appear on any product containing this material.
7 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
9 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
10 .TH UUCP 1C "Mar 9, 2005"
11 .SH NAME
12 uucp, uulog, uuname \- UNIX-to-UNIX system copy
13 .SH SYNOPSIS
14 .LP
15 .nf
16 \fBuucp\fR [\fB-c\fR | \fB-C\fR] [\fB-d\fR | \fB-f\fR] [\fB-g\fR\fIgrade\fR] [\fB-jmr\fR] [\fB-n\fR\fIuser\fR] [\fB-s\fR\fIfile\fR]
17 [\fB-x\fR\fIdebug_level\fR] \fIsource-file\fR \fIdestination-file\fR
18 .fi
20 .LP
21 .nf
22 \fBuulog\fR [\fB-s\fR\fIsys\fR] [\fB-f\fR\fIsystem\fR] [\fB-x\fR] [\fB-number\fR] \fIsystem\fR
23 .fi
25 .LP
26 .nf
27 \fBuuname\fR [\fB-c\fR | \fB-l\fR]
28 .fi
30 .SH DESCRIPTION
31 .SS "uucp"
32 .sp
33 .LP
34 The \fBuucp\fR utility copies files named by the \fIsource-file\fR arguments to
35 the \fIdestination-file\fR argument.
36 .SS "uulog"
37 .sp
38 .LP
39 The \fBuulog\fR utility queries a log file of \fBuucp\fR or \fBuuxqt\fR
40 transactions in file \fB/var/uucp/.Log/uucico/\fIsystem\fR\fR or
41 \fB/var/uucp/.Log/uuxqt/\fIsystem\fR\fR.
42 .SS "uuname"
43 .sp
44 .LP
45 The \fBuuname\fR utility lists the names of systems known to \fBuucp\fR.
46 .SH OPTIONS
47 .SS "uucp"
48 .sp
49 .LP
50 The following options are supported by \fBuucp\fR:
51 .sp
52 .ne 2
53 .na
54 \fB\fB-c\fR\fR
55 .ad
56 .RS 18n
57 Does not copy local file to the spool directory for transfer to the remote
58 machine (default).
59 .RE
61 .sp
62 .ne 2
63 .na
64 \fB\fB-C\fR\fR
65 .ad
66 .RS 18n
67 Forces the copy of local files to the spool directory for transfer.
68 .RE
70 .sp
71 .ne 2
72 .na
73 \fB\fB-d\fR\fR
74 .ad
75 .RS 18n
76 Makes all necessary directories for the file copy (default).
77 .RE
79 .sp
80 .ne 2
81 .na
82 \fB\fB-f\fR\fR
83 .ad
84 .RS 18n
85 Does not make intermediate directories for the file copy.
86 .RE
88 .sp
89 .ne 2
90 .na
91 \fB\fB-g\fR \fIgrade\fR\fR
92 .ad
93 .RS 18n
94 \fIgrade\fR can be either a single letter, number, or a string of alphanumeric
95 characters defining a service grade. The \fBuuglist\fR command can determine
96 whether it is appropriate to use the single letter, number, or a string of
97 alphanumeric characters as a service grade. The output from the \fBuuglist\fR
98 command is a list of service grades that are available, or a message that says
99 to use a single letter or number as a grade of service.
100 .RE
102 .sp
103 .ne 2
104 .na
105 \fB\fB-j\fR\fR
106 .ad
107 .RS 18n
108 Prints the \fBuucp\fR job identification string on standard output. This job
109 identification can be used by \fBuustat\fR to obtain the status of a \fBuucp\fR
110 job or to terminate a \fBuucp\fR job. The \fBuucp\fR job is valid as long as
111 the job remains queued on the local system.
112 .RE
114 .sp
115 .ne 2
116 .na
117 \fB\fB-m\fR\fR
118 .ad
119 .RS 18n
120 Sends mail to the requester when the copy is complete.
121 .RE
123 .sp
124 .ne 2
125 .na
126 \fB\fB-n\fR \fIuser\fR\fR
127 .ad
128 .RS 18n
129 Notifies \fIuser\fR on the remote system that a file was sent.
130 .sp
131 When multiple \fB-n\fR options are passed in, \fBuucp\fR only retains the value
132 specified for the last \fB-n\fR option. This is the only user notified.
133 .RE
135 .sp
136 .ne 2
137 .na
138 \fB\fB-r\fR\fR
139 .ad
140 .RS 18n
141 Does not start the file transfer, just queue the job.
142 .RE
144 .sp
145 .ne 2
146 .na
147 \fB\fB-s\fR \fIfile\fR\fR
148 .ad
149 .RS 18n
150 Reports status of the transfer to \fIfile\fR. This option is accepted for
151 compatibility, but it is ignored because it is insecure.
152 .RE
154 .sp
155 .ne 2
156 .na
157 \fB\fB-x\fR \fIdebug_level\fR\fR
158 .ad
159 .RS 18n
160 Produce debugging output on standard output. \fIdebug_level\fR is a number
161 between 0 and 9. As \fIdebug_level\fR increases to 9, more detailed debugging
162 information is given. This option may not be available on all systems.
163 .RE
165 .SS "uulog"
166 .sp
167 .LP
168 The following options cause \fBuulog\fR to print logging information:
169 .sp
170 .ne 2
171 .na
172 \fB\fB-s\fR \fIsys\fR\fR
173 .ad
174 .RS 13n
175 Prints information about file transfer work involving system \fIsys\fR.
176 .RE
178 .sp
179 .ne 2
180 .na
181 \fB\fB-f\fR \fIsystem\fR\fR
182 .ad
183 .RS 13n
184 Executes a \fBtail\fR \fB-f\fR command of the file transfer log for
185 \fIsystem\fR. You must press BREAK to exit this function.
186 .RE
188 .sp
189 .LP
190 Other options used in conjunction with the above options are:
191 .sp
192 .ne 2
193 .na
194 \fB\fB-x\fR\fR
195 .ad
196 .RS 11n
197 Looks in the \fBuuxqt\fR log file for the given system.
198 .RE
200 .sp
201 .ne 2
202 .na
203 \fB\fB-\fR\fInumber\fR\fR
204 .ad
205 .RS 11n
206 Executes a \fBtail\fR command of \fInumber\fR lines.
207 .RE
209 .SS "uuname"
210 .sp
211 .LP
212 The following options are supported by \fBuuname\fR:
213 .sp
214 .ne 2
215 .na
216 \fB\fB-c\fR\fR
217 .ad
218 .RS 6n
219 Displays the names of systems known to \fBcu\fR. The two lists are the same,
220 unless your machine is using different \fBSystems\fR files for \fBcu\fR and
221 \fBuucp\fR. See the \fBSysfiles\fR file.
222 .RE
224 .sp
225 .ne 2
226 .na
227 \fB\fB-l\fR\fR
228 .ad
229 .RS 6n
230 Displays the local system name.
231 .RE
233 .SH OPERANDS
234 .sp
235 .LP
236 The source file name may be a path name on your machine, or may have the form:
237 .sp
238 .in +2
239 .nf
240 \fIsystem-name\fR!\fIpathname\fR
241 .fi
242 .in -2
243 .sp
245 .sp
246 .LP
247 where \fIsystem-name\fR is taken from a list of system names that \fBuucp\fR
248 knows about. \fIsource_file\fR is restricted to no more than one
249 \fIsystem-name\fR. The destination \fIsystem-name\fR may also include a list of
250 system names such as
251 .sp
252 .in +2
253 .nf
254 \fIsystem-name\fR!\fIsystem-name\fR!...!\fIsystem-name\fR!\fIpathname\fR
255 .fi
256 .in -2
257 .sp
259 .sp
260 .LP
261 In this case, an attempt is made to send the file, using the specified route,
262 to the destination. Care should be taken to ensure that intermediate nodes in
263 the route are willing to forward information. See \fBNOTES\fR for restrictions.
264 .sp
265 .LP
266 For C-Shell users, the exclamation point (\fB!\fR) character must be surrounded
267 by single quotes (\fB\&'\fR), or preceded by a backslash (\fB\e\fR).
268 .sp
269 .LP
270 The shell metacharacters \fB?\fR, \fB*\fR and \fB[...]\fR appearing in
271 \fIpathname\fR are expanded on the appropriate system.
272 .sp
273 .LP
274 Pathnames may be one of the following:
275 .RS +4
276 .TP
277 1.
278 An absolute pathname.
279 .RE
280 .RS +4
281 .TP
282 2.
283 A pathname preceded by \fB~\fR\fIuser\fR where \fIuser\fR is a login name on
284 the specified system and is replaced by that user's login directory.
285 .RE
286 .RS +4
287 .TP
288 3.
289 A pathname preceded by \fB~\fR/\fIdestination\fR where \fIdestination\fR is
290 appended to \fB/var/spool/uucppublic\fR. This destination is treated as a
291 filename unless more than one file is being transferred by this request or the
292 destination is already a directory. To ensure that the destination is a
293 directory, follow it with a forward slash (\fB/\fR). For example, \fB~/dan/\fR
294 as the destination creates the directory \fB/var/spool/uucppublic/dan\fR if it
295 does not exist and put the requested file(s) in that directory.
296 .RE
297 .sp
298 .LP
299 Anything else is prefixed by the current directory.
300 .sp
301 .LP
302 If the result is an erroneous path name for the remote system, the copy fails.
303 If the \fIdestination-file\fR is a directory, the last part of the
304 \fIsource-file\fR name is used.
305 .sp
306 .LP
307 Invoking \fBuucp\fR with shell wildcard characters as the remote
308 \fIsource-file\fR invokes the \fBuux\fR(1C) command to execute the \fBuucp\fR
309 command on the remote machine. The remote \fBuucp\fR command spools the files
310 on the remote machine. After the first session terminates, if the remote
311 machine is configured to transfer the spooled files to the local machine, the
312 remote machine initiates a call and send the files; otherwise, the user must
313 "call" the remote machine to transfer the files from the spool directory to the
314 local machine. This call can be done manually using \fBUutry\fR(1M), or as a
315 side effect of another \fBuux\fR(1C) or \fBuucp\fR call.
316 .sp
317 .LP
318 Notice that the local machine must have permission to execute the uucp command
319 on the remote machine in order for the remote machine to send the spooled
320 files.
321 .sp
322 .LP
323 \fBuucp\fR removes execute permissions across the transmission and gives
324 \fB0666\fR read and write permissions (see \fBchmod\fR(2)).
325 .SH ENVIRONMENT VARIABLES
326 .sp
327 .LP
328 See \fBenviron\fR(5) for descriptions of the following environment variables
329 that affect the execution of \fBuucp\fR: \fBLANG\fR, \fBLC_ALL\fR,
330 \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBLC_TIME\fR,
331 \fBNLSPATH\fR, and \fBTZ\fR.
332 .SH EXIT STATUS
333 .sp
334 .LP
335 The following exit values are returned:
336 .sp
337 .ne 2
338 .na
339 \fB\fB0\fR\fR
340 .ad
341 .RS 6n
342 Successful completion.
343 .RE
345 .sp
346 .ne 2
347 .na
348 \fB\fB>0\fR\fR
349 .ad
350 .RS 6n
351 An error occurred.
352 .RE
354 .SH FILES
355 .sp
356 .ne 2
357 .na
358 \fB\fB/etc/uucp/*\fR\fR
359 .ad
360 .RS 27n
361 other data files
362 .RE
364 .sp
365 .ne 2
366 .na
367 \fB\fB/var/spool/uucp\fR\fR
368 .ad
369 .RS 27n
370 spool directories
371 .RE
373 .sp
374 .ne 2
375 .na
376 \fB\fB/usr/lib/uucp/*\fR\fR
377 .ad
378 .RS 27n
379 other program files
380 .RE
382 .sp
383 .ne 2
384 .na
385 \fB\fB/var/spool/uucppublic/*\fR\fR
386 .ad
387 .RS 27n
388 public directory for receiving and sending
389 .RE
391 .SH ATTRIBUTES
392 .sp
393 .LP
394 See \fBattributes\fR(5) for descriptions of the following attributes:
395 .sp
397 .sp
398 .TS
399 box;
400 c | c
401 l | l .
402 ATTRIBUTE TYPE ATTRIBUTE VALUE
403 _
404 Interface Stability Standard
405 .TE
407 .SH SEE ALSO
408 .sp
409 .LP
410 \fBmail\fR(1), \fBuuglist\fR(1C), \fBuustat\fR(1C), \fBuux\fR(1C),
411 \fBUutry\fR(1M), \fBuuxqt\fR(1M), \fBchmod\fR(2), \fBattributes\fR(5),
412 \fBenviron\fR(5), \fBstandards\fR(5)
413 .SH NOTES
414 .sp
415 .LP
416 For security reasons, the domain of remotely accessible files may be severely
417 restricted. You probably are not able to access files by path name. Ask a
418 responsible person on the remote system to send them to you. For the same
419 reasons you are probably not able to send files to arbitrary path names. As
420 distributed, the remotely accessible files are those whose names begin
421 \fB/var/spool/uucppublic\fR (equivalent to \fB~/\fR).
422 .sp
423 .LP
424 All files received by \fBuucp\fR are owned by \fBuucp\fR.
425 .sp
426 .LP
427 The \fB-m\fR option only works when sending files or receiving a single file.
428 Receiving multiple files specified by special shell characters \fB?\fR,
429 \fB&\fR, and \fB[\|.\|.\|.\|]\fR does not activate the \fB-m\fR option.
430 .sp
431 .LP
432 The forwarding of files through other systems may not be compatible with the
433 previous version of \fBuucp\fR. If forwarding is used, all systems in the route
434 must have compatible versions of \fBuucp\fR.
435 .sp
436 .LP
437 Protected files and files that are in protected directories that are owned by
438 the requester can be sent by \fBuucp\fR. However, if the requester is root, and
439 the directory is not searchable by "other" or the file is not readable by
440 "other", the request fails.
441 .sp
442 .LP
443 Strings that are passed to remote systems may not be evaluated in the same
444 locale as the one in use by the process that invoked \fBuucp\fR on the local
445 system.
446 .sp
447 .LP
448 Configuration files must be treated as C (or POSIX) locale text files.