uux(1) uux(1)
NAME
uux - UNIX-to-UNIX command execution
SYNOPSIS
uux[ option]... command-string
DESCRIPTION
uux fetches zero or more files from various systems, executes a com-
mand on a specified system, and sends the standard output of the com-
mand to a file on a specified system.
Caution:
For security reasons, the list of commands that can be executed
via uux is usually restricted. Many sites will permit little more
than the receipt of mail (see mail). The list of commands that
can be executed on a given system by remote systems is defined in
the configuration file /etc/uucp/Permissions.
OPTIONS
-a name
Send notification about completed commands on the remote system
to the login name name rather than the login name of the uux ini-
tiator.
-b Return the original standard input to the command if the exit
status of a uux command is not zero.
-c Do not copy local files to the spool directory for transfer to
the remote system.
This option is set by default.
-C Force the copy of local files to the spool directory for transfer
to the remote system.
-g grade
This option can be used to establish the service grade with which
files are transmitted by uux. If /etc/uucp/Grades exists, grade
must be one of the service grades listed by the uuglist command:
high, medium or low. Otherwise grade can be any single letter or
digit: 0,...,9,A,...,Z,a,...,z, where 0 designates the highest
grade, and z the lowest. The default service grade for uux jobs
is A. You should generally set a lower grade when large jobs are
involved.
By way of comparison: uucp defaults to Z; messages sent by mail
usually have service grade C.
-j Display the job identification string on standard output. This
job ID can be used by uustat to establish the job status or to
terminate the job.
Page 1 Reliant UNIX 5.44 Printed 11/98
uux(1) uux(1)
-n Do not notify the user when the command completes, even if the
command fails on the remote system.
-p Makes the standard input to uux the standard input to the speci-
fied command-string.
The -p option corresponds to the old - option, which is still
supported.
-r Simply queue the job without starting the file transfer process.
-s file
Report the status of the transfer to file.
-x debug
Turn on debugging at the specified debug level. This causes
debugging information to be printed on standard error when errors
occur. You may specify any number from 0 to 9 for debug; higher
numbers produce more detailed information.
-z Notify the user (by mail) only when the specified command
succeeds on the remote system.
-- If command-string begins with a dash (-), the end of the
command-line options must be marked with --.
command-string
Command to be executed.
The command-string is made up of one or more arguments that look
like a shell command line, except that the commands and file
names may be prefixed by ! or system-name!. If system-name is
omitted, the corresponding argument applies to the local system.
If you specify a shell pipeline for command-string, you can only
enter a system name for the first command in the pipeline; all
subsequent commands are executed on the named system.
You can specify a file name in any of the following four forms:
1. as an absolute path name.
2. as a relative path name; this path name is then prefixed by
the current directory.
3. as a path name preceded by ~user, where user must be an exist-
ing login name on the specified system; ~user is then replaced
by the login directory of the specified user.
4. as a path name in the form ~/destination; destination is then
appended to the specified system's public directory (usually
/var/spool/uucppublic).
Page 2 Reliant UNIX 5.44 Printed 11/98
uux(1) uux(1)
If the shell metacharacters ?, *, and [...] appear within a path
name as part of file name generation patterns, they will be
expanded on the system to which the path name refers.
Any shell metacharacters such as < > ; | , must be quoted either
by quoting the entire command-string, or by enclosing each meta-
character in double quotes.
The wildcard metacharacter * should not be used, as it will prob-
ably not do what you want it to. The shell tokens << and >> are
not implemented.
uux will attempt to get all files to the system on which the com-
mand is executed. You should therefore identify the file names of
output files on other systems by enclosing each such argument in
escaped parentheses, e.g: \(system!/usr/file\). In this case the
argument is read but not interpreted, although the parentheses
are stripped from the argument.
LOCALE
The LCMESSAGES environment variable governs the language in which
message texts are displayed.
LCTYPE governs character classes, character conversion (shifting) and
the behavior of character classes.
LCCOLLATE governs the collating sequence.
If LCMESSAGES, LCCTYPE or LCCOLLATE is undefined or is defined as
the null string, it defaults to the value of LANG. If LANG is likewise
undefined or null, the system acts as if it were not international-
ized.
The LCALL environment variable governs the entire locale. LCALL
takes precedence over all the other environment variables which affect
internationalization.
If any of the locale variables has an invalid value, the system acts
as if none of the variables were set.
If the shell metacharacters appear within a path name as part of file
name generation patterns, they will be expanded on the system to which
the path name refers.
On an internationalized system the results of the expansion are
governed by the values of the NLS variables LCCOLLATE and LCTYPE. In
this context note that if you use file name generation patterns in
square brackets, the collating sequence and character classification
may vary from system to system, and equivalence and character class
expressions and collating units may be undefined on non-internation-
alized systems.
Page 3 Reliant UNIX 5.44 Printed 11/98
uux(1) uux(1)
EXAMPLES
The command
$ uux "!diff usg!/usr/dan/file1 pwba!/a4/dan/file2 >
> !~/dan/file.diff"
will fetch the files /usr/dan/file1 and /a4/dan/file2 from the
machines usg and pwba to the local system, execute the diff command on
the local system, and write the standard output of diff to the local
file /var/spool/uucppublic/dan/file.diff.
FILES
/etc/uucp/Grades
Contains the list of service grades. May also include assignments
of service grades to individual users.
/etc/uucp/Permissions
List of commands that can be invoked from remote systems via uux
/usr/lib/uucp/*
UUCP internal files and commands not intended for the user
/var/spool/uucp
Spool directory
SEE ALSO
uucp(1), uuencode(1), uuglist(1), uustat(1).
Page 4 Reliant UNIX 5.44 Printed 11/98