uux(1C) uux(1C)
NAME
uux - UNIX®-to-UNIX system command execution
SYNOPSIS
uux [-] [-mfile] [-n] command-string
DESCRIPTION
uux will gather zero or more files from various systems,
execute a command on a specified system and then send
standard 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
file names may be prefixed by system-name!. A null system-
name is interpreted as the local system.
File names may be one of
(1)
a full path name;
(2)
a path name 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 file name must be
escaped 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
can execute cmd. If the desired command is not listed in
Page 1 (last mod. 1/16/87)
uux(1C) uux(1C)
L.cmds then no machine can execute that command.
Redirection of standard input and output is usually
restricted to files in PUBDIR. Directories into which
redirection is allowed must be specified in
/usr/lib/uucp/USERFILE by the system administrator. See the
``Using UUCP'' in Oreo 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.
-n Send no notification to user.
-mfile Report status of the transfer in file. If file is
omitted, send mail to the requester when the copy is
completed.
-j Control writing of the uucp job number to standard
output.
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
standard output. If the environment variable JOBNO is
undefined 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.
EXAMPLE
uux !diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !f1.diff
will get the f1 files from the usg and pwba machines,
execute 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/ux
Page 2 (last mod. 1/16/87)
uux(1C) uux(1C)
/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 prefixes
/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 Oreo Communications User's Guide.
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
significant. Any excess characters are ignored.
Page 3 (last mod. 1/16/87)