uucp(1C) UNIX System V(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 patname on your machine, or,
may have the form:
system-name!pathname
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!pathname
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
NOTES below for restrictions).
The shell metacharacters ?, * and [...] appearing in pathname will be
expanded on the appropriate system.
Path names may be one of:
(1) a full pathname;
(2) a pathname preceded by ~user where user is a login name on the
specified system and is replaced by that user's login
directory;
(3) a pathname 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.
10/89 Page 1
uucp(1C) UNIX System V(Basic Networking Utilities) uucp(1C)
If the result is an erroneous pathname 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.
uulog
uulog queries a log file of uucp or uuxqt transactions in file
/var/uucp/.Log/uucico/system or /var/uucp/.Log/uuxqt/system.
Page 2 10/89
uucp(1C) UNIX System V(Basic Networking Utilities) uucp(1C)
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.
NOTES
For security reasons, the domain of remotely accessible files may be
severely restricted. You will very likely not be able to access files by
pathname; 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 pathnames. As distributed, the remotely accessible files are
those whose names begin /var/spool/uucppublic (equivalent to ~/).
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.
10/89 Page 3
uucp(1C) UNIX System V(Basic Networking Utilities) uucp(1C)
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.
NOTES
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 10/89