uucp(1C) (Basic Networking Utilities) uucp(1C)
NAME
uucp, uulog, uuname - UNIX-to-UNIX system copy
SYNOPSIS
uucp [ options ] source-files destination-file
uulog [ options ] system
uuname [ options ]
DESCRIPTION
uucp
uucp copies files named by the source-file arguments to the
destination-file argument. A source file name may be a path name on
your machine, or, may have the form:
system-name!path-name
where system-name is taken from a list of system names that uucp
knows about. The destination system-name may also include a list of
system names such as
system-name!system-name!...!system-name!path-name
In this case, an attempt is made to send the file, via the specified
route, to the destination. Care should be taken to ensure that
intermediate nodes in the route are willing to forward information
(see WARNINGS below for restrictions).
The shell metacharacters ?, * and [...] appearing in path-name will
be expanded on the appropriate system.
Path names may be one of:
(1) a full path name;
(2) a path name preceded by ~user where user is a login name
on the specified system and is replaced by that user's
login directory;
(3) a path name preceded by ~/destination where destination is
appended to /var/spool/uucppublic; (NOTE: This
destination will be treated as a file name unless more
than one file is being transferred by this request or the
destination is already a directory. To ensure that it is
a directory, follow the destination with a '/'. For
example ~/dan/ as the destination will make the directory
/var/spool/uucppublic/dan if it does not exist and put the
requested file(s) in that directory).
(4) anything else is prefixed by the current directory.
8/91 Page 1
uucp(1C) (Basic Networking Utilities) uucp(1C)
If the result is an erroneous path name for the remote system, the
copy will fail. If the destination-file is a directory, the last
part of the source-file name is used.
uucp removes execute permissions across the transmission and gives
0666 read and write permissions (see chmod(2)).
The following options are interpreted by uucp:
-c Do not copy local file to the spool directory for transfer
to the remote machine (default).
-C Force the copy of local files to the spool directory for
transfer.
-d Make all necessary directories for the file copy (default).
-f Do not make intermediate directories for the file copy.
-ggrade grade can be either a single letter/number or a string of
alphanumeric characters defining a service grade. The
uuglist command can determine whether it is appropriate to
use the single letter/number or a string of alphanumeric
characters as a service grade. The output from the uuglist
command will be a list of service grades that are available
or a message that says to use a single letter/number as a
grade of service.
-j Output the uucp job identification string on the standard
output. This job identification can be used by uustat to
obtain the status of a uucp job or to terminate a uucp job.
It is valid as long as the job remains queued on the local
system.
-m Send mail to the requester when the copy is completed.
-nuser Notify user on the remote system that a file was sent.
-r Do not start the file transfer, just queue the job.
-sfile Report status of the transfer to file. This option
overrides the -m option.
-xdebug_level
Produce debugging output on standard output. debug_level
is a number between 0 and 9; as it increases to 9, more
detailed debugging information is given. This option may
not be available on all systems.
Page 2 8/91
uucp(1C) (Basic Networking Utilities) uucp(1C)
uulog
uulog queries a log file of uucp or uuxqt transactions in file
/var/uucp/.Log/uucico/system or /var/uucp/.Log/uuxqt/system.
These options cause uulog to print logging information:
-ssys Print information about file transfer work involving system
sys.
-fsystem Does a "tail -f" of the file transfer log for system. (You
must hit BREAK to exit this function.)
Other options used in conjunction with the above options are:
-x Look in the uuxqt log file for the given system.
-number Indicates that a "tail" command of number lines should be
executed.
uuname
uuname lists the names of systems known to uucp. uuname recognizes
the following options:
-c Returns the names of systems known to cu. (The two lists
are the same, unless your machine is using different
Systems files for cu and uucp. See the Sysfiles file.)
-l Return the local system name.
FILES
/var/spool/uucpspool directories
/var/spool/uucppublic/*public directory for receiving and
sending
/usr/lib/uucp/*other program files
/etc/uucp/* other data files
SEE ALSO
mail(1), uuglist(1C), uustat(1C), uux(1C), uuxqt(1M).
chmod(2) in the Programmer's Reference Manual.
WARNINGS
For security reasons, the domain of remotely accessible files may be
severely restricted. You will very likely not be able to access
files by path name; ask a responsible person on the remote system to
send them to you. For the same reasons you will probably not be able
to send files to arbitrary path names. As distributed, the remotely
accessible files are those whose names begin /var/spool/uucppublic
(equivalent to ~/).
8/91 Page 3
uucp(1C) (Basic Networking Utilities) uucp(1C)
All files received by uucp will be owned by uucp.
The -m option will only work sending files or receiving a single
file. Receiving multiple files specified by special shell characters
? * [...] will not activate the -m option.
The forwarding of files through other systems may not be compatible
with the previous version of uucp. If forwarding is used, all
systems in the route must have compatible versions of uucp.
BUGS
Protected files and files that are in protected directories that are
owned by the requester can be sent by uucp. However, if the
requester is root, and the directory is not searchable by "other" or
the file is not readable by "other", the request will fail.
Page 4 8/91