summaryrefslogtreecommitdiffstats
path: root/upstream/archlinux/man1/uucp.1
blob: be6ce8b364e04378901ef64f3da6cb1165f24562 (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
''' $Id: uucp.1,v 1.12 2002/03/05 22:13:33 ian Rel $
.TH uucp 1 "Taylor UUCP 1.07"
.SH NAME
uucp \- Unix to Unix copy
.SH SYNOPSIS
.B uucp
[ options ] source-file destination-file
.PP
.B uucp
[ options ] source-file... destination-directory
.SH DESCRIPTION
The
.I uucp
command copies files between systems.  Each
.I file
argument is either a pathname on the local machine or is of the form
.IP
system!path
.LP
which is interpreted as being on a remote system.
In the first form, the contents of the first file are copied to the
second.  In the second form, each source file is copied into the
destination directory.

A file be transferred to or from
.I system2
via
.I system1
by using
.IP
system1!system2!path.
.LP

Any pathname that does not begin with / or ~ will be appended to the
current directory (unless the
.B \-W
or
.B \--noexpand
option is used); this resulting path will not necessarily exist on a
remote system.  A pathname beginning with a simple ~ starts at the
UUCP public directory; a pathname beginning with ~name starts at the
home directory of the named user.  The ~ is interpreted on the
appropriate system.  Note that some shells will interpret a simple ~
to the local home directory before
.I uucp
sees it; to avoid this the ~ must be quoted.

Shell metacharacters ? * [ ] are interpreted on the appropriate
system, assuming they are quoted to prevent the shell from
interpreting them first.

The copy does not take place immediately, but is queued up for the
.I uucico
(8) daemon; the daemon is started immediately unless the 
.B \-r
or
.B \-\-nouucico
switch is given.  In any case, the next time the remote system is called the
file(s) will be copied.
.SH OPTIONS
The following options may be given to
.I uucp.
.TP 5
.B \-c, \-\-nocopy
Do not copy local source files to the spool directory.  If they are
removed before being processed by the
.I uucico
(8) daemon, the copy will fail.  The files must be readable by the
.I uucico
(8) daemon, and by the invoking user.
.TP 5
.B \-C, \-\-copy
Copy local source files to the spool directory.  This is the default.
.TP 5
.B \-d, \-\-directories
Create all necessary directories when doing the copy.  This is the
default.
.TP 5
.B \-f, \-\-nodirectories
If any necessary directories do not exist for the destination path,
abort the copy.
.TP 5
.B \-R, \-\-recursive
If any of the source file names are directories, copy their contents
recursively to the destination (which must itself be a directory).
.TP 5
.B \-g grade, \-\-grade grade
Set the grade of the file transfer command.  Jobs of a higher grade
are executed first.  Grades run 0 ... 9 A ... Z a ... z from high to
low.
.TP 5
.B \-m, \-\-mail
Report completion or failure of the file transfer by
.I mail
(1).
.TP 5
.B \-n user, \-\-notify user
Report completion or failure of the file transfer by
.I mail
(1) to the named
user on the remote system.
.TP 5
.B \-r, \-\-nouucico
Do not start
.I uucico
(8) daemon immediately; merely queue up the file transfer for later
execution.
.TP 5
.B \-j, \-\-jobid
Print jobid on standard output.  The job may be
later cancelled by passing the jobid to the
.B \-k
switch of
.I uustat
(1).
It is possible for some complex operations to produce more than one
jobid, in which case each will be printed on a separate line.  For
example
.br
.in +0.5i
.nf
uucp sys1!~user1/file1 sys2!~user2/file2 ~user3
.fi
.in -0.5i
will generate two separate jobs, one for the system
.I sys1
and one for the system
.I sys2.
.TP 5
.B \-W, \-\-noexpand
Do not prepend remote relative path names with the current directory.
.TP 5
.B \-t, \-\-uuto
This option is used by the 
.I uuto
shell script.  It causes
.I uucp
to interpret the final argument as
.I system!user.
The file(s) are sent to
.I ~/receive/USER/LOCAL
on the remote system, where
.I USER
is from the final argument and
.I LOCAL
is the local UUCP
system name.  Also,
.I uucp
will act as though
.I \-\-notify user
were specified.
.TP 5
.B \-x type, \-\-debug type
Turn on particular debugging types.  The following types are
recognized: abnormal, chat, handshake, uucp-proto, proto, port,
config, spooldir, execute, incoming, outgoing.  Only abnormal, config,
spooldir and execute are meaningful for
.I uucp.

Multiple types may be given, separated by commas, and the
.B \-\-debug
option may appear multiple times.  A number may also be given, which
will turn on that many types from the foregoing list; for example,
.B \-\-debug 2
is equivalent to
.B \-\-debug abnormal,chat.
.TP 5
.B \-I file, \-\-config file
Set configuration file to use.  This option may not be available,
depending upon how
.I uucp
was compiled.
.TP 5
.B \-v, \-\-version
Report version information and exit.
.TP 5
.B \-\-help
Print a help message and exit.
.SH SEE ALSO
mail(1), uux(1), uustat(1), uucico(8)
.SH BUGS
Some of the options are dependent on the capabilities of the
.I uucico
(8) daemon on the remote system.

The 
.I \-n
and
.I \-m
switches do not work when transferring a file from one remote system
to another.

File modes are not preserved, except for the execute bit.  The
resulting file is owned by the uucp user.
.SH AUTHOR
Ian Lance Taylor
<ian@airs.com>