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 ] -ssystem
uulog [ options ] system
uulog [ options ] -fsystem
uuname [ -l ] [ -c ]
DESCRIPTION
uucp
uucp copies files named by the source-file arguments to the
destination-file argument. A 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 system-name may also be a list of
names such as
system-name!system-name!...!system-name!path-name
in which case an attempt is made to send the file via the
specified route, to the destination. See WARNINGS and BUGS
below for restrictions. Care should be taken to ensure that
intermediate nodes in the route are willing to forward
information (see WARNINGS below for restrictions).
The following shell metacharacters are disallowed in
system-name:
` ; & | ^ < > ( ) <CR> <TAB> <SPACE>
Path names may be one of:
(1) a full path name;
Page 1 May 1989
UUCP(1C) (Basic Networking Utilities) UUCP(1C)
(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 /usr/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 /usr/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.
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 preserves 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.
Page 2 May 1989
UUCP(1C) (Basic Networking Utilities) UUCP(1C)
-ggrade Grade is a single letter/number; lower ascii
sequence characters will cause the job to be
transmitted earlier during a particular
conversation.
-j Output the job identification ASCII string on the
standard output. This job identification can be
used by uustat to obtain the status or terminate a
job.
-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. Note that
the file must be a full path name.
-xdebug_level
Produce debugging output on standard output. The
debug_level is a number between 0 and 9; higher
numbers give more detailed information.
(Debugging will not be available if uucp was
compiled with -DSMALL.)
uulog
uulog queries a log file of uucp or uuxqt transactions in a
file /usr/spool/uucp/.Log/uucico/system or
/usr/spool/uucp/.Log/uuxqt/system.
The 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
Page 3 May 1989
UUCP(1C) (Basic Networking Utilities) UUCP(1C)
system. (You must hit BREAK to exit this
function.) Other options used in conjunction with
the above:
-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. The -c
option 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.) The
-l option returns the local system name.
FILES
/usr/spool/uucpspool directories
/usr/spool/uucppublic/*public directory for receiving and
sending (/usr/spool/uucppublic)
/usr/lib/uucp/*other data and program files
SEE ALSO
mail(1), uustat(1C), uux(1C).
uuxqt(1M) in the System Administrator's Reference Manual.
chmod(2) in the Programmer's Reference Manual.
WARNINGS
The domain of remotely accessible files can (and for obvious
security reasons, usually should) be severely restricted.
You will very likely not be able to fetch 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
/usr/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
Page 4 May 1989
UUCP(1C) (Basic Networking Utilities) UUCP(1C)
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 the same version
of uucp.
BUGS
Protected files and files that are in protected directories
that are owned by the requester can be sent by uucp using
the -C option. However, if the requestor is root, and the
directory is not searchable by "other" or the file is not
readable by "other", the request will fail.
Page 5 May 1989