summaryrefslogtreecommitdiff
path: root/static/unix-v10/man1/uucp.1
blob: 9620cf28e1fffa8e36e5c10e7fcfcbded1fa37d7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
.\"@(#)uucp.1c	5.2
.TH UUCP 1
.CT 1 comm_mach
.SH NAME
uucp, uulog, uuname \- unix-to-unix remote file copy
.SH SYNOPSIS
.B uucp
[
.I options ...
]
.I source ... destination
.PP
.B uulog
[
.I option ...
]
[
.I system
]
.PP
.B uuname
[
.B -l
]
.SH DESCRIPTION
.I Uucp\^
copies
.I source
files to the
.I destination
file or directory.
A file name may be an ordinary path name, or may
have the form:
.IP
.IB system-name ! filename
.PP
where
.I system-name\^
is a computer that
.I uucp\^
knows about.
.PP
Quoted shell metacharacters
.BR ? ,
.B \(**
and
.B [ ]
appearing in a remote
.I filename
will be expanded on the remote system.
.PP
Path names may be:
.TP
(1)
a full path name;
.TP
(2)
a path name preceded by
.BI ~ user /
where
.I user\^
is a login name on the specified system
and is replaced by that user's login directory;
.TP
(3)
a path name preceded by
.BI ~/ destination\^
where
.B ~
stands for
.FR /usr/spool/uucppublic .
The destination will be treated as a file name unless
more than one file is being transferred by this request,
the destination is already a directory,
or the destination ends with 
.LR / .
For example,
.L ~/dan/
as the destination will make the directory
.L /usr/spool/uucppublic/dan
if it does not exist, and put the requested file(s)
in that directory.
.TP
(4)
anything else is prefixed by the current directory.
.PP
If the result is an erroneous path name for the remote system
the copy will fail.
If the
.I destination\^
is a directory, the basename of the
.I filename
is used.
.ig
If a simple
.I ~user\^
destination is inaccessible to
.IR uucp ,
data is copied to a spool directory and the user
is notified by
.IR mail (1).
..
.I Uucp\^
preserves execute permissions across the transmission
and gives 0666 read and write permissions (see
.IR chmod (2)).
.PP
For obvious security reasons,
the domain of remotely accessible files may
be severely restricted.
You will very likely not be able to fetch files
by path name;
ask a responsible person on the remote system to
send them to you.
Similarly you will probably not be able
to send files to arbitrary path names.
By default, the only remotely accessible files are
those whose names begin
.F /usr/spool/uucppublic/
(equivalent to
.LR ~/ ).
.PP
The options are
.TF -ggrade
.TP
.B -C
Copy files in their present state to a spool directory for later transfer.
.PD 0
.B -c
Do not copy to the spool directory; 
send files in their state at the time of transmission
(default).
.TP
.B -d
Make all necessary directories for the file copy (default).
.TP
.B -f
Do not make intermediate directories for the file copy.
.TP
.BI -g grade\^
Grade is a single letter/number;
earlier
.SM ASCII 
sequence characters will cause the job to be transmitted
earlier during a particular conversation.
The default is
.BR N .
.TP
.B -j
Output the job identification
.SM ASCII
string on the standard output.
This job identification can be used by
.I uustat\^
to obtain the status
or terminate a job.
.TP
.B -m
Send mail to the requester when the copy is
completed.
.TP
.BI -n user\^
Notify
.I user\^
on the remote system that a file was sent.
.TP
.B -r
Don't start the file transfer, just queue the job.
.TP
.BI -x debug-level\^
Produce debugging output.
The
.I debug_level
is a number between 0 and 9;
higher numbers give more detailed information.
.PD
.PP
.I Uulog\^
queries a log file
of
.I uucp\^
or
.I uuxqt
transactions, optionally limited to a given
.I system.
Its options are
.TF -ggrade
.TP
.B -f
.PD 0
Print recent transactions
and follow further transactions as they occur.
.TP
.B -x
Look in the uuxqt log file for the given system.
.TP
.BI - number\^
Print the last
.I number
transactions.
.PD
.PP
.I Uuname\^
lists the uucp names of known systems.
The
.B -l
option returns the local system name.
.SH FILES
.PD 0
.TF/usr/spool/uucp/.Log/uuxqt/system
.TP
.F /usr/spool/uucp
spool directories
.TP
.F /usr/spool/uucppublic
public directory for receiving and sending
.TP
.F /usr/lib/uucp/*
other data and program files
.TP
.BI /usr/spool/uucp/.Log/uuxqt/ system
log of uuxqt transactions with
.I system
.TP
.BI /usr/spool/uucp/.Log/uucico/ system
log of uucp transactions with
.I system
.PD
.SH SEE ALSO
.IR uuto (1),
.IR mail (1),
.IR push (1),
.IR rcp (1),
.IR uux (1),
.IR uustat (1),
.IR uucico (8)
.br
P. Honeyman,
`UUCP\(emthe Program that Wouldn't Go Away',
this manual, Volume 2
.SH BUGS
For various reasons remote systems may decline to forward
files transmitted through them.
.br
All files received by
.I uucp\^
will be owned by user `uucp'.
.br
Option
.B -m
works only with a single file.
.br
.I Uucp
may run under a daemon userid, in which case files
to be sent need general read permission.