uucp(1) MachTen Programmer’s 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 pathname begin-
ning with a simple ~ starts at the UUCP public directory;
a pathname beginning with ~name starts at the home direc-
tory 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 appro-
priate 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 immedi-
ately unless the -r or --nouucico switch is given. In any
case, the next time the remote system 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 direc-
tory. 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) daemon, 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.

-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 opera-
tions 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 directory.

-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 uucp.

Multiple types may be given, separated by commas, and
the --debug option may appear multiple times. A num-
ber 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.

FILES
The file names may be changed at compilation time or by
the configuration file, so these are only approximations.

/etc/uucp/config - Configuration file.
/usr/spool/uucp - UUCP spool directory.
/usr/spool/uucp/Log - UUCP log file.
/usr/spool/uucppublic - Default UUCP public directory.

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 resulting file is owned by the uucp user.

AUTHOR
Ian Lance Taylor <ian@airs.com>

MachTen Taylor UUCP 1.05 3