uucp(1C) USER COMMANDS 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 pat-
name 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 path-
name 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 desti-
nation 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 direc-
tory).
(4) anything else is prefixed by the current direc-
tory.
Last change: Basic Networking Utilities 1
uucp(1C) USER COMMANDS uucp(1C)
If the result is an erroneous pathname for the remote sys-
tem, 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 direc-
tory 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 ser-
vice grade. The uuglist command can determine
whether it is appropriate to use the single
letter/number or a string of alphanumeric charac-
ters 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 com-
pleted.
-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
Last change: Basic Networking Utilities 2
uucp(1C) USER COMMANDS uucp(1C)
increases to 9, more detailed debugging informa-
tion 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.
These options cause uulog to print logging information:
-ssys Print information about file transfer work involv-
ing system sys.
-fsystem Does a "tail -f" of the file transfer log for sys-
tem. (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 per-
son on the remote system to send them to you. For the same
Last change: Basic Networking Utilities 3
uucp(1C) USER COMMANDS uucp(1C)
reasons you will probably not be able to send files to arbi-
trary 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.
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 ver-
sions of uucp.
NOTES
Protected files and files that are in protected directories
that are owned by the requester can be sent by uucp. How-
ever, 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.
Last change: Basic Networking Utilities 4