|
|
1.1 root 1: .\"@(#)uucp.1c 5.2
2: .TH UUCP 1C
3: .SH NAME
4: uucp, uulog, uuname \- unix to unix copy
5: .SH SYNOPSIS
6: .B uucp
7: [ options ]
8: source-files destination-file
9: .PP
10: .B uulog
11: [ options ]
12: .RB \-s \^system
13: .PP
14: or
15: .PP
16: .B uulog
17: [ options ]
18: .RB \-f \^system
19: .PP
20: .B uuname
21: [
22: .B \-l
23: ]
24: .SH DESCRIPTION
25: .SS Uucp.
26: .I Uucp\^
27: copies files named by the
28: .I source-file\^
29: arguments to the
30: .I destination-file\^
31: argument.
32: A file name may be a path name on your machine, or may
33: have the form:
34: .PP
35: .RS .5i
36: system-name!path-name
37: .RE
38: .PP
39: where
40: .I system-name\^
41: is taken from a list of system names that
42: .I uucp\^
43: knows about.
44: The
45: .I system-name\^
46: may also be a list of names such as
47: .PP
48: .RS .5i
49: system-name!system-name!...!system-name!path-name
50: .RE
51: .PP
52: in which case an attempt is made to send the file via the specified route,
53: to the destination.
54: (see BUGS below for restrictions)
55: Care should be taken to ensure that intermediate nodes in the
56: route are willing to foward information.
57: .PP
58: The shell metacharacters
59: .BR ? ,
60: .B \(**
61: and
62: .B [\|.\|.\|.\|]
63: appearing in
64: .I path-name\^
65: will be expanded on the appropriate system.
66: .PP
67: Path names may be one of:
68: .PP
69: .RS
70: .TP
71: (1)
72: a full path name;
73: .TP
74: (2)
75: a path name preceded by
76: .BI ~ user\^
77: where
78: .I user\^
79: is a login name on the specified system
80: and is replaced by that user's login directory;
81: .TP
82: (3)
83: a path name preceded by
84: .BI ~/ destination\^
85: where
86: .I destination\^
87: is appended to \s-1/usr/spool/uucppublic\s+1;
88: (\fBNOTE:\fR This destination will be treated as a file name unless
89: more than one file is being transfered by this request or
90: the destination is already a directory.
91: To \fBensure\fR that it is a directory, follow the destination with a '/'.
92: For example ~/dan/ as the destination will make the directory
93: /usr/spool/uucppublic/dan if it does not exist and put the requested file(s)
94: in that directory).
95: .TP
96: (4)
97: anything else is prefixed by the current directory.
98: .RE
99: .PP
100: If the result is an erroneous path name for the remote system
101: the copy will fail.
102: If the
103: .I destination-file\^
104: is a directory, the last part of the
105: .I source-file\^
106: name is used.
107: .ig
108: If a simple
109: .I ~user\^
110: destination is inaccessible to
111: .IR uucp ,
112: data is copied to a spool directory and the user
113: is notified by
114: .IR mail (1).
115: ..
116: .PP
117: .I Uucp\^
118: preserves execute permissions across the transmission
119: and gives 0666 read and write permissions (see
120: .IR chmod (2)).
121: .PP
122: The following options are interpreted by
123: .IR uucp :
124: .TP .5i
125: .B \-c
126: Don't copy local file to the spool directory for transfer to the remote
127: machine (default).
128: .TP .5i
129: .B \-C
130: Force the copy of local files to the spool directory for transfer.
131: .TP .5i
132: .B \-d
133: Make all necessary directories for the file copy (default).
134: .TP .5i
135: .B \-f
136: Do not make intermediate directories for the file copy.
137: .TP .5i
138: .BI \-g grade\^
139: Grade is a single letter/number;
140: lower ASCII sequence characters will cause the job to be transmitted
141: earlier during a particular conversation.
142: .TP .5i
143: .B \-j
144: Output the job identification
145: \s-1ASCII\s+1 string on the standard output.
146: This job identification can be used by
147: .I uustat\^
148: to obtain the status
149: or terminate a job.
150: .TP .5i
151: .B \-m
152: Send mail to the requester when the copy is
153: completed.
154: .TP .5i
155: .BI \-s file\^
156: Report status of the transfer to
157: .I file.\^
158: .TP .5i
159: .BI \-n user\^
160: Notify
161: .I user\^
162: on the remote system that a file was sent.
163: .TP .5i
164: .B \-r
165: Don't start the file transfer, just queue the job.
166: .TP .5i
167: .BI \-x debug-level\^
168: Produce debugging output on stdout.
169: The debug_level is a number between 0 and 9;
170: higher numbers give more detailed information.
171: .SS Uulog.
172: .PP
173: .I Uulog\^
174: queries a log file
175: of
176: .I uucp\^
177: or
178: .I uuxqt
179: transactions in a file
180: .BI /usr/spool/uucp/.Log/uucico/ system.
181: or
182: .BI /usr/spool/uucp/.Log/uuxqt/ system.
183: .ne 3
184: .PP
185: The options cause
186: .I uulog
187: to print logging information:
188: .TP .5i
189: .BI \-s sys\^
190: Print information about file transfer work involving system
191: .IR sys .
192: .TP .5i
193: .BI \-f sys\^
194: Does a ``tail -f'' of the file transfer log for system
195: .IR sys .
196: Other options used in conjunction with the above:
197: .TP .5i
198: .B \-x
199: Look in the uuxqt log file for the given system.
200: .TP .5i
201: .BI \- number\^
202: Indicates that a ``tail'' command of
203: .I number
204: lines should be done.
205: .SS Uuname.
206: .PP
207: .I Uuname\^
208: lists the uucp names of known systems.
209: The
210: .B \-l
211: option returns the local system name.
212: .SH FILES
213: .PD 0
214: .TP \w'/usr/spool/uucppublic/*\ \ 'u
215: /usr/spool/uucp
216: spool directories
217: .TP
218: /usr/spool/uucppublic/\(**
219: public directory for receiving and sending (\s-1/usr/spool/uucppublic\s0)
220: .TP
221: /usr/lib/uucp/\(**
222: other data and program files
223: .PD
224: .SH SEE ALSO
225: mail(1), uux(1C).
226: .SH WARNING
227: The domain of remotely accessible files can
228: (and for obvious security reasons, usually should)
229: be severely restricted.
230: You will very likely not be able to fetch files
231: by path name;
232: ask a responsible person on the remote system to
233: send them to you.
234: For the same reasons you will probably not be able
235: to send files to arbitrary path names.
236: As distributed, the remotely accessible files are
237: those whose names begin
238: .B /usr/spool/uucppublic
239: (equivalent to
240: .BR ~/ ).
241: .PP
242: All files received by
243: .I uucp\^
244: will be owned by
245: .IR uucp .
246: .br
247: The \fB\-m\fP option will only work sending files or receiving
248: a single file.
249: Receiving multiple files specified by special shell
250: characters \fB? \(** \|[\|.\|.\|.\|]\fP will not activate
251: the \fB\-m\fP option.
252: .P
253: The forwarding of files through other systems is NOT compataible
254: with the previous version of uucp. If forwarding is used, all
255: systems in the route must have the same version of uucp.
256: .SH BUGS
257: Protected files and files that are in protected directories
258: that are owned by the requestor can be sent by
259: .IR uucp .
260: However, if the requestor is root, and the directory is not searchable
261: by "other" or the file is not readable by "other",
262: the request will fail due to a bug in setuid().
263: .\" @(#)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.