uucp(1) DG/UX R4.11MU05 uucp(1)
NAME
uucp, uulog, uuname - UNIX-to-UNIX system copy
SYNOPSIS
uucp [ options ] source-files destination-file
uulog [ options ] [ [ -s ] system ... ]
uulog [ options ] -fsystem
uuname [ -l ] [ -c ]
DESCRIPTION
uucp
uucp copies files named by the source-file arguments to the
destination-file argument. A filename can be a pathname 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 CAUTIONS and BUGS below for
restrictions. Care should be taken to ensure that intermediate nodes
in the route are willing to forward information (see CAUTIONS below
for restrictions).
The shell metacharacters ?, * and [...] appearing in path-name 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 ~/destination where destination is
appended to /usr/spool/uucppublic; (NOTE: This
destination will be treated as a filename 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 create 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 pathname for the remote system the copy
will fail. If the destination-file is a directory, 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.
-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 pathname.
-xdebug_level
Produce debugging output on standard output. The
debug_level is a number between 0 and 9; higher numbers
give more detailed information.
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:
-ssystem ...
Print information about file transfer work involving system
system. The system argument does not require `-s' to be
present (e.g., ``uulog system'' is allowed). One or more
system arguments may be present, separated by blanks (e.g.,
``uulog gotham bam-bam'').
-fsystem Does a ``tail -f'' of the file transfer log for system.
(You must press ^C to exit this function.)
-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 lists
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.
EXAMPLES
uucp -d -m file? sys_2!/usr/spool/uucppublic
The above example will send any files that begin with file and have
one other character at the end of the name (such as file1, file2,
file3, etc.) to sys_2. All of the files will be deposited into the
/usr/spool/uucppublic on sys_2. With the included options,
directories will be created as needed, and the user will be notified
by mail about the file transfer.
FILES
/usr/spool/uucp spool directories
/usr/spool/uucppublic public directory for receiving and sending
(/usr/spool/uucppublic)
/usr/lib/uucp directory containing program files
/etc/uucp directory containing data and program files
SEE ALSO
mail(1), uustat(1), uux(1), uucico(1M), uuxqt(1M), chmod(2),
cap_defaults(5).
CAUTIONS
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 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 ~/).
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 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. However, if the
requester is a user with appropriate privilege and the directory is
not searchable by "other" or the file is not readable by "other", the
request will fail.
For systems supporting the DG/UX Capability Option, appropriate
privilege is defined as having one or more specific capabilities
enabled in the effective capability set of the user. See
cap_defaults(5) for the default capabilities for this command.
On generic DG/UX systems, appropriate privilege means that your
process has an effective UID of root. See the
appropriate_privilege(5) man page for more information.
Licensed material--property of copyright holder(s)