uucp(1) CLIX uucp(1)
NAME
uucp - Runs the UNIX-to-UNIX system copy program
SYNOPSIS
uucp [flag ... ] source-files destination-file
FLAGS
-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 The grade argument 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 stdout.
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 stdout. 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.)
DESCRIPTION
The uucp command 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
2/94 - Intergraph Corporation 1
uucp(1) CLIX uucp(1)
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!pathname
in which case an attempt is made to send the file with the specified route
to the destination. (See CAUTIONS for restrictions.) Care should be
taken to ensure that intermediate nodes in the route are willing to
forward information (see CAUTIONS for restrictions).
The shell metacharacters, ? * [...], that appear in pathname will be
expanded on the appropriate system.
Pathnames can be one of the following:
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 transfered by this request
or the destination is already a directory. To ensure that it is a
directory, follow the destination with a slash (/). 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 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.
The uucp command preserves execute permissions across the transmission and
gives0666 read and write permissions (see chmod()).
EXAMPLES
1. To copy the file /tmp/file2 to system2, with system1, and place the
file in usr/tmp/out.report (probably in /usr/spool/uucppublic
directory), use the following:
uucp -C /tmp/file2 system1!system2!usr/tmp/out.report
2. To perform the same copy as above, but queue the job instead of
sending it immediately, use the following command line:
2 Intergraph Corporation - 2/94
uucp(1) CLIX uucp(1)
uucp -m -r /tmp/file2 system1!system2!usr/tmp/out.report
FILES
/usr/spool/uucp Spool directories
/usr/spool/uucppublic/* Public directory for receiving and sending
(/usr/spool/uucppublic)
/usr/lib/uucp/* Other data and program files
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 flag will only work sending files or receiving a single file.
Receiving multiple files specified by special shell characters, ? * [...],
will not activate the -m flag.
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.
DIAGNOSTICS
Protected files and files that are in protected directories that are owned
by the requestor can be sent by uucp. 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.
Some possible error messages follow:
No work directory - dirname - get help
The /Usr/Spool/Uucp/.Workspace directory is missing.
bad system: sysname
The uuname does not recognize this system. Check spelling and then
check /usr/lib/uucp/Systems file for errors.
uucp failed completely (code)
No files were sent.
2/94 - Intergraph Corporation 3
uucp(1) CLIX uucp(1)
uucp failed partially: # file(s) sent; # error(s)
Some files were sent, some failed.
permission denied
You do not have permission to perform this copy.
use cp command
Do not try to uucp files to this machine.
EXIT VALUES
The uucp command returns 0 on success. If there is a syntax error it
returns 2. If there is a source file error, 6 is returned; a destination
file error returns 7. A negative errorcode indicates complete or partial
uucp failure.
RELATED INFORMATION
Commands: mail(1), uustat(1), uux(1), uuxqt(1)
Functions: chmod(2)
4 Intergraph Corporation - 2/94