uux(1C) uux(1C)
NAME
uux - UNIX-to-UNIX system command execution
SYNOPSIS
uux [-] [-ggrade] [-j] [-l] [-mfile] [-n] [-p] [-r] [-
xlevel] [-z] command-string
DESCRIPTION
uux will gather zero or more files from various systems, ex-
ecute a command on a specified system, and then send stan-
dard output to a file on a specified system. Note that for
security reasons, many installations will limit the list of
commands executable on behalf of an incoming request from
uux. Many sites will permit little more than the receipt of
mail (see mail(1)) via uux.
The command-string is made up of one or more arguments that
look like a shell command line, except that the command and
filenames may be prefixed by system-name!. A null system-
name is interpreted as the local system.
Filenames may be one of the following:
(1)
A full pathname.
(2)
A pathname preceded by ~xxx where xxx is a login name on
the specified system and is replaced by that user's login
directory.
(3)
Anything else is prefixed by the current directory.
Any special shell characters such as <>;| should be quoted
either by quoting the entire command-string, or quoting the
special characters as individual arguments.
uux will attempt to get all files to the execution system.
For files which are output files, the filename must be es-
caped by using parentheses.
uux will notify you if the requested command on the remote
system was disallowed. The response comes by remote mail
from the remote machine. Executable commands are listed in
/usr/lib/uucp/L.cmds on the remote system. The format of
the L.cmds file is
cmd,machine1,machine2,...
If no machines are specified, then any machine can execute
cmd. If machines are specified, only the listed machines
April, 1990 1
uux(1C) uux(1C)
can execute cmd. If the desired command is not listed in
L.cmds, then no machine can execute that command.
Redirection of standard input and output is usually res-
tricted to files in PUBDIR. Directories into which redirec-
tion is allowed must be specified in /usr/lib/uucp/USERFILE
by the system administrator. See ``Using UUCP'' in A/UX
Communications User's Guide.
The following flag options are interpreted by uux.
- The standard input to uux is made the standard input
to the command-string.
-ggrade Sets transmit priority to the level grade. The ar-
gument grade is a single letter or number. Lower
ASCII-sequence characters will cause the job to be
transmitted earlier during a particular conversa-
tion.
-j Controls writing of the uucp job number to standard
output.
-l Tries to make a link from the original file to the
spool directory. If the link cannot be made, then
copy the file.
-mfile Reports the status of the transfer in file. If file
is omitted, send mail to the requester when the copy
is completed.
-n Sends no notification to user.
-p Takes the input for the command-string from a pipe;
the same as -.
-r Queues the job, but does not start the file
transfer.
-xlevel Produces debugging output on the standard output.
The level is a number between 0 and 9; higher
numbers give more information than lower numbers.
-z Notifies the user if the command succeeds.
uux associates a job number with each request. This job
number can be used by uustat to obtain status or terminate
the job.
The environment variable JOBNO and the -j flag option are
used to control the listing of the uux job number on stan-
dard output. If the environment variable JOBNO is undefined
2 April, 1990
uux(1C) uux(1C)
or set to OFF, the job number will not be listed (default).
If uucp is then invoked with the -j flag option, the job
number will be listed. If the environment variable JOBNO is
set to ON and is exported, a job number will be written to
standard output each time uux is invoked. In this case, the
-j flag option will suppress output of the job number.
EXAMPLES
uux !diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !f1.diff
will get the f1 files from the usg and pwba machines, exe-
cute a diff command, and put the results in f1.diff in the
local directory.
uux a!uucp b!/usr/file \(c!/usr/file\)
will send a uucp command to system a to get /usr/file from
system b and send it to system c.
FILES
/usr/bin/uux
/usr/lib/uucp/L.sys list of system names and when to call
them
/usr/lib/uucp/L.cmds
list of commands for uuxqt to execute
/usr/lib/uucp/L-devices
list of device codes and speeds
/usr/lib/uucp/L-dialcodes
list of phone numbers in L.sys
/usr/lib/uucp/SYSTEMNAME
name of this system
/usr/lib/uucp/USERFILE
list of users and required pathname pre-
fixes
/usr/lib/uucp/uucico
copy in, copy out program; called by
uucp
/usr/lib/uucp/uuclean
spool directory cleanup program; called
by uucp
/usr/lib/uucp/uuxqt command execution program; called by
uucp
/usr/spool/uucp spool directory
/usr/spool/uucppublic
public directory (PUBDIR)
SEE ALSO
uucp(1C), mail(1), uuclean(1M).
``Using UUCP'' in A/UX Communications User's Guide.
April, 1990 3
BUGS
Only the first command of a shell pipeline may have a
system-name!. All other commands are executed on the system
of the first command.
The use of the shell metacharacter * will probably not do
what you want it to do. The shell tokens << and >> are not
implemented.
Only the first six characters of the system-name are signi-
ficant; excess characters are ignored.
4 April, 1990