xref: /illumos-gate/usr/src/man/man1c/uuto.1c (revision e153cda9f9660e385e8f468253f80e59f5d454d7)

Sun Microsystems, Inc. gratefully acknowledges The Open Group for
permission to reproduce portions of its copyrighted documentation.
Original documentation from The Open Group can be obtained online at
http://www.opengroup.org/bookstore/.

The Institute of Electrical and Electronics Engineers and The Open
Group, have given us permission to reprint portions of their
documentation.

In the following statement, the phrase ``this text'' refers to portions
of the system documentation.

Portions of this text are reprinted and reproduced in electronic form
in the SunOS Reference Manual, from IEEE Std 1003.1, 2004 Edition,
Standard for Information Technology -- Portable Operating System
Interface (POSIX), The Open Group Base Specifications Issue 6,
Copyright (C) 2001-2004 by the Institute of Electrical and Electronics
Engineers, Inc and The Open Group. In the event of any discrepancy
between these versions and the original IEEE and The Open Group
Standard, the original IEEE and The Open Group Standard is the referee
document. The original Standard can be obtained online at
http://www.opengroup.org/unix/online.html.

This notice shall appear on any product containing this material.

The contents of this file are subject to the terms of the
Common Development and Distribution License (the "License").
You may not use this file except in compliance with the License.

You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions
and limitations under the License.

When distributing Covered Code, include this CDDL HEADER in each
file and include the License file at usr/src/OPENSOLARIS.LICENSE.
If applicable, add the following below this CDDL HEADER, with the
fields enclosed by brackets "[]" replaced with your own identifying
information: Portions Copyright [yyyy] [name of copyright owner]


Copyright 1989 AT&T
Portions Copyright (c) 1992, X/Open Company Limited
Copyright (c) 1995, Sun Microsystems, Inc. All Rights Reserved.

UUTO 1C "Mar 28, 1995"
NAME
uuto, uupick - public UNIX-to-UNIX system file copy
SYNOPSIS

uuto [-mp] source-file... destination

uupick [-s system]
DESCRIPTION
"uuto"

uuto sends source-file to destination. uuto uses the uucp(1C) facility to send files, while it allows the local system to control the file access. A source-file name is a path name on your machine. Destination has the form:

system[!system] ... !user

where system is taken from a list of system names that uucp knows about. User is the login name of someone on the specified system.

The files (or sub-trees if directories are specified) are sent to PUBDIR on system, where PUBDIR is a public directory defined in the uucp source. By default, this directory is /var/spool/uucppublic. Specifically the files are sent to

PUBDIR/receive/user/mysystem/files.

The recipient is notified by mail(1) of the arrival of files.

"uupick"

uupick accepts or rejects the files transmitted to the user. Specifically, uupick searches PUBDIR for files destined for the user. For each entry (file or directory) found, the following message is printed on standard output:

from system sysname: [file file-name] [dir dirname] ?

uupick then reads a line from standard input to determine the disposition of the file: <new-line>

Go to next entry.

d

Delete the entry.

m [ dir ]

Move the entry to named directory dir. If dir is not specified as a complete path name (in which $HOME is legitimate), a destination relative to the current directory is assumed. If no destination is given, the default is the current directory.

a [ dir ]

Same as m above, except it moves all the files sent from system.

p

Print the content of the file.

q

Stop.

EOT (control-d)

Same as q.

!command

Escape to the shell to do command.

*

Print a command summary.

OPTIONS
"uuto"

The following options are supported by uuto: -m

Send mail to the sender when the copy is complete.

-p

Copy the source file into the spool directory before transmission.

"uupick"

The following option is supported by uupick: -s system

Search only the PUBDIR for files sent from system.

OPERANDS

The following operands are supported for uuto: destination

A string of the form: system-name\|!\|user where system-name is taken from a list of system names that uucp knows about; see uuname. The argument user is the login name of someone on the specified system. The destination system-name can also be a list of names such as system-name\|!\|system-name\|!\|.\|.\|. \|!\|system-name\|!\|user 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 intermediate nodes in the route are willing to forward information.

source-file

A pathname of a file on the local system to be copied to destination.

ENVIRONMENT VARIABLES

See environ(5) for descriptions of the following environment variables that affect the execution of uuto and uupick: LC_TYPE, LC_MESSAGES, and NLSPATH.

EXIT STATUS

The following exit values are returned: 0

Successful completion.

>0

An error occurred.

FILES
PUBDIR

/var/spool/uucppublic public directory

SEE ALSO

mail(1), uucp(1C), uustat(1C), uux(1C), uucleanup(1M), attributes(5)

NOTES

In order to send files that begin with a dot (for instance, .profile), the files must be qualified with a dot. For example, the following files are correct:

\| .profile .prof* .profil?

The following files are incorrect:

*prof* ?profile