|
|
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: .\" @(#)uucp.1 6.5 (Berkeley) 6/29/90
6: .\"
7: .TH UUCP 1 "June 29, 1990"
8: .AT 3
9: .SH NAME
10: uucp \- unix to unix copy
11: .SH SYNOPSIS
12: .B uucp
13: [
14: .B \-acCdfmr
15: ] [
16: .BI \-n user
17: ] [
18: .BI \-g grade
19: ] [
20: .BI \-s spool
21: ] [
22: .BI \-x debug
23: ] source-file.... destination-file
24: .SH DESCRIPTION
25: .I Uucp
26: copies files named by the source-file arguments
27: to the destination-file argument.
28: A file name may be a pathname on your machine, or may
29: have the form
30: .IP
31: system-name!pathname
32: .LP
33: where `system-name' is taken from a list of system names
34: that
35: .I uucp
36: knows about.
37: Shell metacharacters ?*[] appearing in the pathname part
38: will be expanded on the appropriate system.
39: .PP
40: Pathnames may be one of:
41: .IP (1)
42: a full pathname;
43: .IP (2)
44: a pathname preceded by
45: .BI ~ user;
46: where
47: .I user
48: is a userid on the specified system
49: and is replaced by that user's login directory;
50: .IP (3)
51: a pathname prefixed by
52: .BR ~ ,
53: where
54: .B ~
55: is expanded into the system's public directory (usually /var/spool/uucppublic);
56: .IP (4)
57: a partial pathname, which is prefixed by the current directory.
58: .PP
59: If the result is an erroneous pathname for the remote system,
60: the copy will fail.
61: If the destination-file is a directory, the last part of the
62: source-file name is used.
63: .ig
64: If a simple
65: .I ~user
66: destination is inaccessible to
67: .IR uucp ,
68: data is copied to a spool directory and the user
69: is notified by
70: .IR mail (1).
71: ..
72: .PP
73: .I Uucp
74: preserves execute permissions across the transmission
75: and gives 0666 read and write permissions (see
76: .IR chmod (2)).
77: .PP
78: The following options are interpreted by
79: .IR uucp .
80: .TP
81: .B \-a
82: Avoid doing a
83: .I getwd
84: to find the current directory.
85: (This is sometimes used for efficiency.)
86: .TP
87: .B \-c
88: Use the source file when copying out rather than
89: copying the file to the spool directory.
90: (This is the default.)
91: .TP
92: .B \-C
93: Copy the source file to the spool directory and transmit
94: the copy.
95: .TP
96: .B \-d
97: Make all necessary directories for the file copy.
98: (This is the default.)
99: .TP
100: .B \-f
101: Do not make intermediate directories for the file copy.
102: .TP
103: .BI \-g grade
104: .I Grade
105: is a single letter/number; lower ASCII sequence characters
106: will cause a job to be transmitted earlier during a particular conversation.
107: Default is `n'. By way of comparison,
108: .IR uux (1)
109: defaults to `A'; mail is usually sent at `C'.
110: .TP
111: .B \-m
112: Send mail to the requester when the copy is complete.
113: .TP
114: .BI \-n user
115: Notify
116: .I user
117: on remote system (i.e., send
118: .I user
119: mail) that a file was sent.
120: .TP
121: .B \-r
122: Do not start the transfer, just queue the job.
123: .TP
124: .BI \-s spool
125: Use
126: .I spool
127: as the spool directory instead of the default.
128: .TP
129: .BI \-x debug
130: Turn on the debugging at level
131: .I debug.
132: .SH FILES
133: /var/spool/uucp - spool directory
134: .br
135: /usr/lib/uucp/* - other data and program files
136: .SH SEE ALSO
137: uux(1), mail(1)
138: .PP
139: D. A. Nowitz and M. E. Lesk,
140: .IR "A Dial-Up Network of UNIX Systems" .
141: .PP
142: D. A. Nowitz,
143: .IR "Uucp Implementation Description" .
144: .SH WARNING
145: The domain of remotely accessible files can
146: (and for obvious security reasons, usually should)
147: be severely restricted.
148: You will very likely not be able to fetch files
149: by pathname;
150: ask a responsible person on the remote system to
151: send them to you.
152: For the same reasons you will probably not be able
153: to send files to arbitrary pathnames.
154: .SH BUGS
155: .br
156: All files received by
157: .I uucp
158: will be owned by the uucp administrator (usually UID 5).
159: .PP
160: The
161: .B \-m
162: option will only work sending files or receiving
163: a single file.
164: (Receiving multiple files specified by special shell
165: characters ?*[] will not activate
166: the
167: .B \-m
168: option.)
169: .PP
170: At present
171: .I uucp
172: cannot copy to a system several "hops" away, that is, a command of
173: the form
174: .PP
175: .nf
176: uucp myfile system1!system2!system3!yourfile
177: .fi
178: .PP
179: is not permitted. Use
180: .IR uusend (1)
181: instead.
182: .PP
183: When invoking
184: .I uucp
185: from
186: .IR csh (1),
187: the `!' character must be prefixed by the `\e' escape to inhibit
188: .IR csh 's
189: history mechanism. (Quotes are not sufficient.)
190: .PP
191: .I Uucp
192: refuses to copy a file that does not give read access to ``other'';
193: that is, the file must have at least 0444 modes.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.