UUCP(1C) BSD 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 copies files named by the source-file arguments to the destination-
file argument. A filename may be a pathname on a machine, or may have
the following form:
system name!pathname
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 via the specified
route, to the destination. See NOTES and BUGS below for restrictions.
Care should be taken to ensure that intermediate nodes in the route are
willing to forward information (see NOTES below for restrictions).
The question mark (?), asterisk (*), and bracketed ellipsis ([...])
shell metacharacters appearing in pathname are expanded on the
appropriate system.
Pathnames may be one of the following (anything else is prefixed by the
current directory):
o a full pathname
o a pathname preceded by ~user where user is a log-in name on the
specified system and is replaced by that user's log-in directory
o 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 slash mark (/). 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).
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.
uucp preserves execute permissions across the transmission, and gives
0666 read and write permissions. See chmod(2) for more information about
permissions. All files received by uucp will be owned by uucp.
uulog queries a summary log of uucp or uuxqt transactions in the files
/usr/spool/uucp/.Log/uucico/system, or /usr/spool/uucp/.Log/uuxqt/system.
uuname lists the names of systems known to uucp.
The BSD version of uucp supports the Vadic Autodialer.
OPTIONS
The following options are interpreted by uucp only:
-c Don't copy the 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. The -m
option only works sending files or receiving a single file.
Receiving multiple files specified by special shell characters
? * [...] will not activate the -m option.
-nuser Notify user on the remote system that a file was sent.
-r Don't start the file transfer, just queue the job (default).
-R Invoke uucico automatically to effect the transfer of uucp
files. By default, you must execute uucico manually on the node
on which it resides.
-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. (Debugging will not be available if uucp was
compiled with -DSMALL.)
uulog Options
The following options are used by uulog only; they cause uulog to print
logging information:
-ssys Print information about file transfer work involving system
sys.
-fsystem Do a tail -f of the file transfer log for system. (You must
press BREAK to exit this function.)
Other options used in conjunction with the above uulog options:
-x Look in the uuxqt log file for the given system.
-number Indicates that a tail command of number lines should be
executed.
uuname Options
The following options are used by uuname only:
-c Return the names of systems known to cu. This list should be
the same as the list of systems known to uucp, unless your
machine is using different Systems files for cu and uucp. See
the Sysfiles file.
-l Return the local system name.
NOTES
The domain of remotely accessible files may (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
with /usr/spool/uucppublic (equivalent to ~/).
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 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.
FILES
/usr/spool/uucp spool directory
/usr/spool/uucppublic
public directory for receiving and sending (PUBDIR)
/usr/lib/uucp/* other data and program files
uucp looks in /etc/net/uname to determine the site name for the local
system. If there is no such file, it assumes apollo1.
SEE ALSO
mail(1), uustat(1C), uux(1C), uuxqt(8), chmod(2);
Managing BSD System Software.