uucp(1C) uucp(1C)
NAME
uucp, uulog, uuname - UNIX® system to UNIX system copy
SYNOPSIS
uucp [-c] [-C] [-d] [-esys] [-f] [-j] [-mfile] [-nuser] [-r]
source-files destination-file
uulog [-ssys] [-uuser]
uuname [-l] [-v]
DESCRIPTION
uucp
uucp copies files named by the source-file arguments to the
destination-file argument. A filename may be a pathname on
your machine, or may have the form:
system-name!pathname
where system-name is taken from a list of system names which
uucp knows about. The system-name may also be a list of
names such as
system-name!system-name! . . . !system-name!pathname
in which case an attempt is made to send the file via the
specified route, and only to a destination in PUBDIR (see
below). Care should be taken to insure that intermediate
nodes in the route are willing to forward information.
The shell metacharacters ?, * and [...] appearing in
pathname will be expanded on the appropriate system.
Pathnames 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 ~/user where user is a login
name on the specified system and is replaced by that
user's directory under PUBDIR, where PUBDIR is the
public directory on the remote machine to which all
uucp users have access and at which they enter.
(4) anything else. uucp prefixes it by the current
directory.
If the result is an erroneous pathname for the remote
system, the copy will fail. If the destination-file is a
Page 1 (last mod. 1/16/87)
uucp(1C) uucp(1C)
directory, the last part of the source-file name is used.
If a simple user destination is inaccessible to uucp, data
are copied to a spool directory and the user is notified by
mail(1).
uucp preserves execute permissions across the transmission
and gives 0666 read and write permissions (see chmod(2)).
The following flag options are interpreted by uucp:
-d Make all necessary directories for the file copy
(default).
-f Do not make intermediate directories for the file
copy.
-c Use the source file when copying out rather than
copying the file to the spool directory (default).
-C Copy the source file to the spool directory.
-mfile Report status of the transfer in file. If file is
omitted, send mail to the requester when the copy is
completed.
-nuser Notify user on the remote system that a file was
sent.
-esys Send the uucp command to system sys to be executed
there. This will be successful only if the remote
machine allows the uucp command to be executed by
/usr/lib/uucp/uuxqt.
-r Queue job, but do not start the file transfer
process. By default, a file transfer process is
started each time uucp is evoked.
-j Control writing of the uucp job number to standard
output (see below).
uucp associates a job number with each request. This job
number can be used by uustat to obtain status or terminate
the job.
The environment variable JOBNO and the -j flag option are
used to control the listing of the uucp job number on
standard output. If the environment variable JOBNO is
undefined or set to OFF, the job number will not be listed
(default). If uucp is then invoked with the -j flag option,
the job number will be listed. If the environment variable
Page 2 (last mod. 1/16/87)
uucp(1C) uucp(1C)
JOBNO is set to ON and is exported, a job number will be
written to standard output each time uucp is invoked. In
this case, the -j flag option will suppress output of the
job number.
uulog
uulog queries a summary log of uucp and uux(1C) transactions
in the file /usr/spool/uucp/LOGFILE.
The flag options cause uulog to print logging information:
-ssys Print information about work involving system sys.
If sys is not specified, then logging information
for all systems will be printed.
-uuser Print information about work done for the specified,
user. If user is not specified, then logging
information for all users will be printed.
uuname
uuname lists the uucp names of known systems. The -l flag
option returns the local system name. The -v flag option
will print additional information about each system. A
description will be printed for each system that has a line
of information in /usr/lib/uucp/ADMIN. The format of ADMIN
is:
sysname tab description tab
EXAMPLE
uucp file1 ucbvax! /usr/spool/uucppublic/file2
sends file1 from the local machine, via the uucp network, to
the ucbvax machine, where it is saved as file
/usr/spool/uucppublic/file2.
FILES
/usr/bin/uucp
/usr/bin/uulog
/usr/bin/uuname
/usr/spool/uucp spool directory
/usr/spool/uucppublic
public directory for receiving and
sending (PUBDIR)
/usr/lib/uucp/* other data and program files
SEE ALSO
mail(1), uux(1C), chgnod(1M), chmod(2),
``Using UUCP'' in Oreo Local System Administration.
WARNING
The domain of remotely accessible files may (and for obvious
Page 3 (last mod. 1/16/87)
uucp(1C) uucp(1C)
security reasons, usually should) be severely restricted.
Very likely, you will not be able to fetch 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 /usr/spool/uucppublic (equivalent to nuucp or
just ).
NOTES
In order to send files that begin with a dot (e.g.,
.profile) the files must be qualified with a dot. For
example: .profile, .prof*, .profil? are correct; whereas
*prof*, ?profile are incorrect.
uucp will not generate a job number for a strictly local
transaction.
BUGS
All files received by uucp will be owned by uucp.
The -m flag option will only work sending files or receiving
a single file. Receiving multiple files specified by
special shell characters ? * [...] will not activate the -m
flag option.
The -m flag option will not work if all transactions are
local or if uucp is executed remotely via the -e flag
option.
The -n flag option will function only when the source and
destination are not on the same machine.
Only the first six characters of a system-name are
significant. Any excess characters are ignored.
Page 4 (last mod. 1/16/87)