uucp manpage

Search topic

Section

uucp(1) General Commands Manual uucp(1)
NAME
uucp - Unix to Unix copy
SYNOPSIS
uucp [ options ] source-file destination-file
uucp [ options ] source-file... destination-directory
DESCRIPTION
The uucp command copies files between systems. Each file argument is
either a pathname on the local machine or is of the form
system!path
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 system2 via system1 by using
system1!system2!path.
Any pathname that does not begin with / or ~ will be appended to the
current directory (unless the -W or --noexpand option is used); this
resulting path will not necessarily exist on a remote system. A path-
name 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
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
uucico (8) daemon; the daemon is started immediately unless the -r or
--nouucico switch is given. In any case, the next time the remote sys-
tem is called the file(s) will be copied.
OPTIONS
The following options may be given to uucp.
-c, --nocopy
Do not copy local source files to the spool directory. If they
are removed before being processed by the uucico (8) daemon, the
copy will fail. The files must be readable by the uucico (8) dae-
mon, and by the invoking user.
-C, --copy
Copy local source files to the spool directory. This is the
default.
-d, --directories
Create all necessary directories when doing the copy. This is the
default.
-f, --nodirectories
If any necessary directories do not exist for the destination
path, abort the copy.
-R, --recursive
If any of the source file names are directories, copy their con-
tents recursively to the destination (which must itself be a
directory).
-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.
-m, --mail
Report completion or failure of the file transfer by mail (1).
-n user, --notify user
Report completion or failure of the file transfer by mail (1) to
the named user on the remote system.
-r, --nouucico
Do not start uucico (8) daemon immediately; merely queue up the
file transfer for later execution.
-j, --jobid
Print jobid on standard output. The job may be later cancelled by
passing the jobid to the -k switch of 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
uucp sys1!~user1/file1 sys2!~user2/file2 ~user3
will generate two separate jobs, one for the system sys1 and one
for the system sys2.
-W, --noexpand
Do not prepend remote relative path names with the current direc-
tory.
-t, --uuto
This option is used by the uuto shell script. It causes uucp to
interpret the final argument as system!user. The file(s) are sent
to ~/receive/USER/LOCAL on the remote system, where USER is from
the final argument and LOCAL is the local UUCP system name. Also,
uucp will act as though --notify user were specified.
-x type, --debug type
Turn on particular debugging types. The following types are rec-
ognized: abnormal, chat, handshake, uucp-proto, proto, port, con-
fig, spooldir, execute, incoming, outgoing. Only abnormal, con-
fig, spooldir and execute are meaningful for uucp.
Multiple types may be given, separated by commas, and the --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, --debug 2 is equivalent to --debug abnormal,chat.
-I file, --config file
Set configuration file to use. This option may not be available,
depending upon how uucp was compiled.
-v, --version
Report version information and exit.
--help
Print a help message and exit.
SEE ALSO
mail(1), uux(1), uustat(1), uucico(8)
BUGS
Some of the options are dependent on the capabilities of the uucico (8)
daemon on the remote system.
The -n and -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 result-
ing file is owned by the uucp user.
AUTHOR
Ian Lance Taylor <ian@airs.com>
Taylor UUCP 1.07 uucp(1)