UUX(1C) DOMAIN/IX SYS5 UUX(1C)
NAME
uux - UNIX-to-UNIX system command execution
USAGE
uux [ options ] command-string
DESCRIPTION
Uux gathers zero or more files from various systems, exe-
cutes a command on a specified system, and then sends stan-
dard output to a file on a specified system. Note that, for
security reasons, many installations limit the list of com-
mands executable on behalf of an incoming request from uux.
Many sites permit little more than the receipt of mail(1)
via uux.
The command-string is made up of one or more arguments that
look like a Shell command line, except that system name! may
prefix the command and filenames. A null system name is
interpreted as the local system.
Filenames may be one of the following:
a full pathname
a pathname preceded by ~xxx where xxx is a log-in name
on the specified system and is replaced by that user's
log-in directory
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 by quoting
the special characters as individual arguments.
Uux attempts to get all files to the execution system. For
output files, the filename must be escaped using
parentheses. Uux notifies 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, any machine can execute cmd.
If machines are specified, only the listed machines can exe-
cute cmd. If the desired command is not listed in L.cmds,
then no machine can execute that command.
Printed 12/4/86 UUX-1
UUX(1C) DOMAIN/IX SYS5 UUX(1C)
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.
The environment variable JOBNO and the -j option are used to
control the listing of the uux job number on standard out-
put. If the environment variable JOBNO is undefined or set
to OFF, the job number is not listed (this is the default).
If uux is then invoked with the -j option, the job number is
listed. If the environment variable JOBNO is set to ON and
is exported, a job number is written to standard output each
time uux is invoked. In this case, the -j option suppresses
output of the job number.
OPTIONS
- Make the standard input to uux the standard input to
the command-string.
-n Send no notification to user.
-mfile
Report status of the transfer in file. If file is omit-
ted, send mail to the requester when the copy is com-
pleted.
-j Control writing of the uucp(1C) job number to standard
output. Uux associates a job number with each request.
This job number can be used by uustat(1C) to obtain
status or terminate the job.
-xnumber
Print debugging information up to degree number.
EXAMPLES
To get the f1 files from the ``usg'' and ``pwba'' machines,
execute a diff(1) command, and put the results in f1.diff in
the local directory:
# uux ``!diff usg!/usr/dan/f1 pwba!/a4/dan/f1 >
To send a
uucp(1C) command to system ``a'' to get /usr/file from sys-
tem ``b'' and send it to system ``c'':
# uux a!uucp b!/usr/file \(c!/usr/file\)
UUX-2 Printed 12/4/86
UUX(1C) DOMAIN/IX SYS5 UUX(1C)
CAUTIONS
Only the first command of a shell pipeline may have a system
name! in it. All other commands are executed on the system
of the first command.
The use of the asterisk (*) shell metacharacter will prob-
ably 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. Uux ignores any excess characters.
FILES
/usr/spool/uucp spool directory
/usr/spool/uucppublic public directory (PUBDIR)
/usr/lib/uucp/* other data and programs
RELATED INFORMATION
mail(1), uucp(1C).
Also refer to the discussion of uucp in the Domain/IX System
Administrator's Reference.
Printed 12/4/86 UUX-3