UUCP(1C) Communication Commands UUCP(1C)
NAME
uucp, uulog, uuname - UNIX-to-UNIX system copy
SYNOPSIS
uucp [
-c |
-C] [
-d |
-f] [
-ggrade] [
-jmr] [
-nuser] [
-sfile]
[
-xdebug_level]
source-file destination-file uulog [
-ssys] [
-fsystem] [
-x] [
-number]
system uuname [
-c |
-l]
DESCRIPTION
uucp The
uucp utility copies files named by the
source-file arguments to the
destination-file argument.
uulog The
uulog utility queries a log file of
uucp or
uuxqt transactions in
file
/var/uucp/.Log/uucico/system or
/var/uucp/.Log/uuxqt/system.
uuname The
uuname utility lists the names of systems known to
uucp.
OPTIONS
uucp The following options are supported by
uucp:
-c Does not copy local file to the spool directory for
transfer to the remote machine (default).
-C Forces the copy of local files to the spool directory
for transfer.
-d Makes all necessary directories for the file copy
(default).
-f Does not make intermediate directories for the file
copy.
-g grade grade can be either a single letter, number, or a
string of alphanumeric characters defining a service
grade. The
uuglist command can determine whether it is
appropriate to use the single letter, number, or a
string of alphanumeric characters as a service grade.
The output from the
uuglist command is a list of
service grades that are available, or a message that
says to use a single letter or number as a grade of
service.
-j Prints the
uucp job identification string on standard
output. This job identification can be used by
uustat to obtain the status of a
uucp job or to terminate a
uucp job. The
uucp job is valid as long as the job
remains queued on the local system.
-m Sends mail to the requester when the copy is complete.
-n user Notifies
user on the remote system that a file was
sent.
When multiple
-n options are passed in,
uucp only
retains the value specified for the last
-n option.
This is the only user notified.
-r Does not start the file transfer, just queue the job.
-s file Reports status of the transfer to
file. This option is
accepted for compatibility, but it is ignored because
it is insecure.
-x debug_level Produce debugging output on standard output.
debug_level is a number between 0 and 9. As
debug_level increases to 9, more detailed debugging information is
given. This option may not be available on all systems.
uulog The following options cause
uulog to print logging information:
-s sys Prints information about file transfer work involving system
sys.
-f system Executes a
tail -f command of the file transfer log for
system. You must press BREAK to exit this function.
Other options used in conjunction with the above options are:
-x Looks in the
uuxqt log file for the given system.
-number Executes a
tail command of
number lines.
uuname The following options are supported by
uuname:
-c Displays 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.
-l Displays the local system name.
OPERANDS
The source file name may be a path name on your machine, or may have the
form:
system-name!
pathname where
system-name is taken from a list of system names that
uucp knows
about.
source_file is restricted to no more than one
system-name. The
destination
system-name may also include a list of system names such as
system-name!
system-name!...!
system-name!
pathname In this case, an attempt is made to send the file, using the specified
route, to the destination. Care should be taken to ensure that
intermediate nodes in the route are willing to forward information. See
NOTES for restrictions.
For C-Shell users, the exclamation point (
!) character must be surrounded
by single quotes (
'), or preceded by a backslash (
\).
The shell metacharacters
?,
* and
[...] appearing in
pathname are
expanded on the appropriate system.
Pathnames may be one of the following:
1. An absolute 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
/var/spool/uucppublic. This destination is 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 the destination is a directory, follow it with a
forward slash (
/). For example,
~/dan/ as the destination
creates the directory
/var/spool/uucppublic/dan if it does not
exist and put the requested file(s) in that directory.
Anything else is prefixed by the current directory.
If the result is an erroneous path name for the remote system, the copy
fails. If the
destination-file is a directory, the last part of the
source-file name is used.
Invoking
uucp with shell wildcard characters as the remote
source-file invokes the
uux(1C) command to execute the
uucp command on the remote
machine. The remote
uucp command spools the files on the remote machine.
After the first session terminates, if the remote machine is configured
to transfer the spooled files to the local machine, the remote machine
initiates a call and send the files; otherwise, the user must "call" the
remote machine to transfer the files from the spool directory to the
local machine. This call can be done manually using
Uutry(8), or as a
side effect of another
uux(1C) or
uucp call.
Notice that the local machine must have permission to execute the uucp
command on the remote machine in order for the remote machine to send the
spooled files.
uucp removes execute permissions across the transmission and gives
0666 read and write permissions (see
chmod(2)).
ENVIRONMENT VARIABLES
See
environ(7) for descriptions of the following environment variables
that affect the execution of
uucp:
LANG,
LC_ALL,
LC_COLLATE,
LC_CTYPE,
LC_MESSAGES,
LC_TIME,
NLSPATH, and
TZ.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
FILES
/etc/uucp/* other data files
/var/spool/uucp spool directories
/usr/lib/uucp/* other program files
/var/spool/uucppublic/* public directory for receiving and sending
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
SEE ALSO
mail(1),
uuglist(1C),
uustat(1C),
uux(1C),
chmod(2),
attributes(7),
environ(7),
standards(7),
Uutry(8),
uuxqt(8)NOTES
For security reasons, the domain of remotely accessible files may be
severely restricted. You probably are not able to access files by path
name. Ask a responsible person on the remote system to send them to you.
For the same reasons you are probably not able to send files to arbitrary
path names. As distributed, the remotely accessible files are those whose
names begin
/var/spool/uucppublic (equivalent to
~/).
All files received by
uucp are owned by
uucp.
The
-m option only works when sending files or receiving a single file.
Receiving multiple files specified by special shell characters
?,
&, and
[...] does 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 compatible versions of
uucp.
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
root, and the directory is not searchable by "other" or the file is not
readable by "other", the request fails.
Strings that are passed to remote systems may not be evaluated in the
same locale as the one in use by the process that invoked
uucp on the
local system.
Configuration files must be treated as C (or POSIX) locale text files.
March 9, 2005
UUCP(1C)