SysIII/usr/src/man/man1/uucp.1c

.TH UUCP 1C
.SH NAME
uucp, uulog, uuname \- unix to unix copy
.SH SYNOPSIS
.B uucp
[ option ] \s+3.\^.\^.\s0
source-file \s+3.\^.\^.\s0  destination-file
.PP
.B uulog
[ option ] \s+3.\^.\^.\s0
.PP
.B uuname
.SH DESCRIPTION
.I Uucp\^
copies files named by the
.I source-file\^
arguments to the
.I destination-file\^
argument.
A file name may be a path name on your machine, or may 
have the form:
.PP
.RS .5i
system-name!path-name
.RE
.PP
where
.I system-name\^
is taken from a list of system names which
.I uucp\^
knows about.
Shell metacharacters
.B ?\(**[\^]
appearing in
.I path-name\^
will be expanded on the appropriate system.
.PP
Path names may be one of:
.PP
.TP
(1)
a full path name;
.TP
(2)
a path name preceded by
.BI ~ user\^
where
.I user\^
is a login name on the specified system
and is replaced by that user's login directory;
.TP
(3)
a path name preceded by
.BI ~/ user\^
where
.I user\^
is a login name on the specified system
and is replaced by that user's directory under \s-1PUBDIR\s+1;
.TP
(4)
anything else is prefixed by the current directory.
.PP
If the result is an erroneous path name for the remote system
the copy will fail.
If the
.I destination-file\^
is a directory, the last part of the
.I source-file\^
name is used.
.ig
If a simple
.I ~user\^
destination is inaccessible to 
.IR uucp ,
data is copied to a spool directory and the user
is notified by
.IR mail (1).
..
.PP
.I Uucp\^
preserves execute permissions across the transmission
and gives 0666 read and write permissions (see
.IR chmod (2)).
.PP
The following options are interpreted by
.IR uucp :
.TP .5i
.B \-d
Make all necessary directories for the file copy (default).
.TP 
.B \-f
Do not make intermediate directories for the file copy.
.TP
.B \-c
Use the source file when copying out rather than
copying the file to the spool directory (default).
.TP
.B \-C
Copy the source file to the spool directory.
.TP 
.B \-m
Send mail to the requester when the copy is complete.
.TP
.BI \-n user\^
Notify
.I user\^
on the remote system that a file was sent.
.TP
.BI \-e sys\^
Send the
.I uucp\^
command to system
.I sys\^
to be executed there.
(Note \- this will only be successful if the remote
machine allows the
.I uucp\^
command to be executed by
.BR /usr/lib/uucp/uuxqt .)
.PP
.I Uulog\^
maintains a summary log
of 
.I uucp\^
and
.IR uux (1C)
transactions in the file
.B /usr/spool/uucp/\s-1LOGFILE\s0
by gathering
information from partial log files named
.BR /usr/spool/uucp/\s-1LOG\s0.\(**.? .
(These files will only be created if the
.SM
.B LOGFILE
is being used by another process.)
It removes the partial log files.
.ne 3
.PP
The options cause 
.I uulog
to print logging information:
.TP .5i
.BI \-s sys\^
Print information about work involving system
.IR sys .
.TP
.BI \-u user\^
Print information about work done for the specified
.IR user .
.PP
.I Uuname\^
lists the uucp names of known systems.
The
.B \-l
option returns the local system name.
.SH FILES
.PD 0
.TP 1.5i
/usr/spool/uucp
spool directory
.TP
/usr/spool/uucppublic
public directory for receiving and sending (\s-1PUBDIR\s0)
.TP
/usr/lib/uucp/\(**
other data and program files
.PD
.SH SEE ALSO
mail(1), uux(1C).
.br
.I "Uucp Implementation Description\^"
by D. A. Nowitz.
.SH WARNING
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 path name;
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 path names.
As distributed, the remotely accessible files are
those whose names begin
.B /usr/spool/uucppublic
(equivalent to
.B ~nuucp
or just
.BR ~ ).
.SH BUGS
.br
All files received by
.I uucp\^
will be owned by
.IR uucp .
.br
The \fB\-m\fP option will only work sending files or receiving
a single file.
(Receiving multiple files specified by special shell
characters \fB?\(**[]\fP will not activate
the \fB\-m\fP option.)