uux(1)uux(1)NAMEuux - UNIX system to UNIX system command execution
SYNOPSIS
[options] command-string
DESCRIPTION
gathers zero or more files from various systems, executes a command on
a specified system, then sends standard output to a file on a specified
system. Note that, for security reasons, many installations limit the
list of commands executable on behalf of an incoming request from Many
sites will permit little more than the receipt of mail (see mail(1),
mailx(1), and elm(1)) via
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 pre‐
fixed by A null system-name is interpreted as the local system.
File names can be one of the following:
· A full path name;
· A path name preceded by where xxx is a login name on the
specified system and is replaced by that user's login direc‐
tory. Note that if an invalid login is specified, the
default will be to the public directory
· A path name preceded by where destination is appended to
· A simple file name (which is prefixed by the current direc‐
tory). See uucp(1) for details.
For example, the command
gets files and from machines and and executes a diff(1) command, plac‐
ing the results in in the local directory
Any special shell characters such as or should be quoted, either by
quoting the entire command-string, or quoting the special characters as
individual arguments.
attempts to get all files to the execution system. For files that are
output files, the file name must be escaped using parentheses. For
example, the command
gets from system and sends it to system performs a command on the file,
and sends the result of the cut command to system
notifies you if the requested command on the remote system was disal‐
lowed. The list of commands allowed is specified in the file in The
response comes by remote mail from the remote machine.
recognizes the following options:
The standard input to
is made the standard input to the command-string.
Use name as the user identification replacing the
initiator user-ID (notification is returned to
the user).
Return whatever standard input was provided to the
command if the exit status is non-zero.
Do not copy the local file to the spool directory
for transfer to the remote machine (default).
Force the copy of local files to the spool directory for trans‐
fer.
grade is a single letter/number; lower ASCII sequence
characters cause the job to be transmitted ear‐
lier during a particular conversation.
Output the jobid (the job identification ASCII string) on
the standard output. This job identification can
be used by to obtain the status or terminate a
job (see uustat(1)).
Do not notify the user if the command fails.
Do not start the file transfer, just queue the job.
Report status of the transfer in
file.
Produce debugging output on standard output.
The debug_level is a number between 0 and 9. The
higher the number, the more detailed the informa‐
tion returned.
Send success notification to user.
WARNINGS
Only the first command of a shell pipeline can have a All other com‐
mands 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.
The execution of commands on remote systems takes place in an execution
directory known to the UUCP subsystem. All files required for the exe‐
cution are put into this directory unless they already reside on that
machine. Therefore, the simple file name (without path or machine ref‐
erence) must be unique within the request. The following command does
work:
but the command:
works (if is a permitted command).
Protected files and files that are in protected directories that are
owned by the requester can be sent in commands using However, if the
requester is and the directory is not searchable by the request fails.
FILES
configuration files
log and error files
spool directories
lock files
public directory
SEE ALSOmail(1), uuclean(1M), uucp(1).
Tim O'Reilly and Grace Todino,
O'Reilly & Associates, Inc. USA.
Grace Todino and Dale Dougherty,
O'Reilly & Associates, Inc. USA.
STANDARDS CONFORMANCEuux(1)
