uucp(1)uucp(1)NAME
uucp, uulog, uuname, uutry - UNIX system to UNIX system copy
SYNOPSIS
[options] source_files destination_file
number]
system]... number]
debug_level]
DESCRIPTION
copies files named by the source_files argument to the destination
identified by the destination_file argument. When copying files to or
from a remote system, source_files and destination_file can be a path
name on the local system, or have the form:
where system_name is the name of a remote system in a list of system
names known to When copying files to (but not from) a remote system,
system_name can also be a chained list of remote system names such as:
in which case an attempt is made to send the file, via the specified
route, to the destination. Care should be taken to ensure that inter‐
mediate nodes in the route are configured to forward information (see
for restrictions).
The shell metacharacters and appearing in path_name are expanded on the
appropriate system.
path_name can be one of:
· A full path name.
· A path name preceded by where user is a login name on the speci‐
fied system and is replaced by that user's login directory. (If
an invalid login is specified, the default public directory is
used instead.
· A path name preceded by where destination is appended to
This destination is 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 destination is a directory,
append a to the destination argument. For example, as the desti‐
nation argument causes directory to be created if it does not
already exist, and places the requested file or files in that
directory.
· Anything else is prefixed by the current directory.
If an erroneous path name is specified for the remote system, the copy
fails. If destination_file is a directory, the file name part of the
source_file argument is used.
preserves execute permissions across the transmission and sets read and
write permissions to 0666 (see chmod(2) and Access Control Lists
below).
Options
recognizes the following options:
Do not copy local file to the spool directory for transfer to
the remote
machine (default).
Force the copy of local files to the spool directory for trans‐
fer.
Make all necessary directories for the file copy (default).
Do not make intermediate directories for the file copy.
grade is a single letter or number. A lower ASCII
sequence value for grade causes the job to be
transmitted earlier in a given conversation
between systems.
Output the ASCII job identification string on standard output.
This job identification can be used by to obtain
the status or terminate a job (see uustat(1)).
Send mail to the requester when the copy is completed.
Notify user on the remote system that a file was sent.
Do not start the file transfer; just queue the job.
Report status of the transfer to
file. Note that file must be a full path name.
Produce debugging on standard output.
debug_level is a number between 0 and 9; higher
numbers give more information.
uulog
queries a log file of transactions in a file system.
The following options cause to print logging information:
Print information about work involving
system.
Do a (see tail(1)) of the file transfer log for sys‐
tem.
Other options used in conjunction with the and options above are:
Search for the given system in the
file instead of in the log file.
Do a tail(1) command of number lines.
uuname
lists the names of known systems. returns the local system's default
name.
uutry
tests for the successful login to the remote system. This is executed
for checking communication channel.
Starts in the MASTER mode. The default is SLAVE mode.
Do work only for the system specified by
system. If there is no work for system on the
local spool directory, initiate a connection to
system to determine if system has work for the
local system. This option must be used if is
specified.
Produce debugging on standard output.
debug_level is a number between 0 and 9; higher
numbers give more information.
When started by a local program, is considered the MASTER and attempts
a connection to a remote system. If is started by a remote system, it
is considered to be in SLAVE mode.
Access Control Lists (ACLs)
A file's optional ACL entries are not preserved across transmission.
Instead, new files have a summary of the access modes (as returned in
by see stat(2)).
EXTERNAL INFLUENCES
Environment Variables
determines the format and contents of date and time strings displayed
by and commands.
determines the language in which messages are displayed by and com‐
mands.
If is not specified in the environment or is set to the empty string,
the value of is used as a default for each unspecified or empty vari‐
able. If is not specified or is set to the empty string, a default of
"C" (see lang(5)) is used instead of If any internationalization vari‐
able contains an invalid setting, and behave as if all international‐
ization variables are set to "C". See environ(5).
International Code Set Support
Single- and multibyte character code sets are supported with the excep‐
tion that multibyte-character file names are not supported.
WARNINGS
The domain of remotely accessible files can (and for obvious security
reasons, usually should) be severely restricted. In most cases, you
cannot fetch files by path name from a remote system. Ask a responsi‐
ble person on the remote system to send them to you. For the same rea‐
sons, you probably cannot send files to arbitrary path names. As dis‐
tributed, remotely accessible files are those whose names begin (equiv‐
alent to
All files received by are owned by
The option only works when sending files or when receiving a single
file. Receiving multiple files specified by special shell characters
and does not activate the option.
Protected files and files in protected directories owned by the
requester can be sent by However, if the requester is root and the
directory is not searchable by or the file is not readable by the
request fails.
should be executed only with a request file that exists in the direc‐
tory
FILES
Configuration files
Log and error files
Spool directories
Lock files
Public directory for receiving and sending
SEE ALSOmail(1), uux(1), uucico(1M), chmod(2), stat(2), acl(5).
O'Reilly & Associates, Inc. USA.
O'Reilly & Associates, Inc. USA.
STANDARDS CONFORMANCEuucp(1)