Debian Codegraph @

upstream/opensuse-tumbleweed/man1/uucp.1

raw
1 '\"
2 .\" $Id: uucp.1,v 1.12 2002/03/05 22:13:33 ian Rel $
3 .\"
4 .TH uucp 1 "Taylor UUCP 1.07"
5 .SH NAME
6 uucp \- Unix to Unix copy
7 .SH SYNOPSIS
8 .B uucp
9 [ options ] source-file destination-file
10 .PP
11 .B uucp
12 [ options ] source-file... destination-directory
13 .SH DESCRIPTION
14 The
15 .I uucp
16 command copies files between systems. Each
17 .I file
18 argument is either a pathname on the local machine or is of the form
19 .IP
20 system!path
21 .LP
22 which is interpreted as being on a remote system.
23 In the first form, the contents of the first file are copied to the
24 second. In the second form, each source file is copied into the
25 destination directory.
26
27 A file be transferred to or from
28 .I system2
29 via
30 .I system1
31 by using
32 .IP
33 system1!system2!path.
34 .LP
35
36 Any pathname that does not begin with / or ~ will be appended to the
37 current directory (unless the
38 .B \-W
39 or
40 .B \--noexpand
41 option is used); this resulting path will not necessarily exist on a
42 remote system. A pathname beginning with a simple ~ starts at the
43 UUCP public directory; a pathname beginning with ~name starts at the
44 home directory of the named user. The ~ is interpreted on the
45 appropriate system. Note that some shells will interpret a simple ~
46 to the local home directory before
47 .I uucp
48 sees it; to avoid this the ~ must be quoted.
49
50 Shell metacharacters ? * [ ] are interpreted on the appropriate
51 system, assuming they are quoted to prevent the shell from
52 interpreting them first.
53
54 The copy does not take place immediately, but is queued up for the
55 .I uucico
56 (8) daemon; the daemon is started immediately unless the
57 .B \-r
58 or
59 .B \-\-nouucico
60 switch is given. In any case, the next time the remote system is called the
61 file(s) will be copied.
62 .SH OPTIONS
63 The following options may be given to
64 .I uucp.
65 .TP 5
66 .B \-c, \-\-nocopy
67 Do not copy local source files to the spool directory. If they are
68 removed before being processed by the
69 .I uucico
70 (8) daemon, the copy will fail. The files must be readable by the
71 .I uucico
72 (8) daemon, and by the invoking user. This is the default.
73 .TP 5
74 .B \-C, \-\-copy
75 Copy local source files to the spool directory.
76 .TP 5
77 .B \-d, \-\-directories
78 Create all necessary directories when doing the copy. This is the
79 default.
80 .TP 5
81 .B \-f, \-\-nodirectories
82 If any necessary directories do not exist for the destination path,
83 abort the copy.
84 .TP 5
85 .B \-R, \-\-recursive
86 If any of the source file names are directories, copy their contents
87 recursively to the destination (which must itself be a directory).
88 .TP 5
89 .B \-g grade, \-\-grade grade
90 Set the grade of the file transfer command. Jobs of a higher grade
91 are executed first. Grades run 0 ... 9 A ... Z a ... z from high to
92 low.
93 .TP 5
94 .B \-m, \-\-mail
95 Report completion or failure of the file transfer by
96 .I mail
97 (1).
98 .TP 5
99 .B \-n user, \-\-notify user
100 Report completion or failure of the file transfer by
101 .I mail
102 (1) to the named
103 user on the remote system.
104 .TP 5
105 .B \-r, \-\-nouucico
106 Do not start
107 .I uucico
108 (8) daemon immediately; merely queue up the file transfer for later
109 execution.
110 .TP 5
111 .B \-j, \-\-jobid
112 Print jobid on standard output. The job may be
113 later cancelled by passing the jobid to the
114 .B \-k
115 switch of
116 .I uustat
117 (1).
118 It is possible for some complex operations to produce more than one
119 jobid, in which case each will be printed on a separate line. For
120 example
121 .br
122 .in +0.5i
123 .nf
124 uucp sys1!~user1/file1 sys2!~user2/file2 ~user3
125 .fi
126 .in -0.5i
127 will generate two separate jobs, one for the system
128 .I sys1
129 and one for the system
130 .I sys2.
131 .TP 5
132 .B \-W, \-\-noexpand
133 Do not prepend remote relative path names with the current directory.
134 .TP 5
135 .B \-t, \-\-uuto
136 This option is used by the
137 .I uuto
138 shell script. It causes
139 .I uucp
140 to interpret the final argument as
141 .I system!user.
142 The file(s) are sent to
143 .I ~/receive/USER/LOCAL
144 on the remote system, where
145 .I USER
146 is from the final argument and
147 .I LOCAL
148 is the local UUCP
149 system name. Also,
150 .I uucp
151 will act as though
152 .I \-\-notify user
153 were specified.
154 .TP 5
155 .B \-x type, \-\-debug type
156 Turn on particular debugging types. The following types are
157 recognized: abnormal, chat, handshake, uucp-proto, proto, port,
158 config, spooldir, execute, incoming, outgoing. Only abnormal, config,
159 spooldir and execute are meaningful for
160 .I uucp.
161
162 Multiple types may be given, separated by commas, and the
163 .B \-\-debug
164 option may appear multiple times. A number may also be given, which
165 will turn on that many types from the foregoing list; for example,
166 .B \-\-debug 2
167 is equivalent to
168 .B \-\-debug abnormal,chat.
169 .TP 5
170 .B \-I file, \-\-config file
171 Set configuration file to use. This option may not be available,
172 depending upon how
173 .I uucp
174 was compiled.
175 .TP 5
176 .B \-v, \-\-version
177 Report version information and exit.
178 .TP 5
179 .B \-\-help
180 Print a help message and exit.
181 .SH SEE ALSO
182 mail(1), uux(1), uustat(1), uucico(8)
183 .SH BUGS
184 Some of the options are dependent on the capabilities of the
185 .I uucico
186 (8) daemon on the remote system.
187
188 The
189 .I \-n
190 and
191 .I \-m
192 switches do not work when transferring a file from one remote system
193 to another.
194
195 File modes are not preserved, except for the execute bit. The
196 resulting file is owned by the uucp user.
197 .SH AUTHOR
198 Ian Lance Taylor
199 <[email protected]>