NAME

uux − remote system command execution

SYNOPSIS

uux [ − ] [ −nrz ] [ −gx ] [ −xn ] command-string

AVAILABILITY

This command is available with the uucp software installation option.  Refer to Installing the SunOS for information on how to install optional software. 

DESCRIPTION

uux will gather 0 or more files from various systems, execute a command on a specified system and send the standard output to a file on a specified system. 

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:

• a full pathname;

• a pathname preceded by ~xxx/; where xxx is a username on the specified system and is replaced by that user’s login directory;

• a pathname preceded by ‘~/’; such a pathname is replaced by the “public uucp” directory on the remote machine;

• anything else is prefixed by the current directory. 

The ‘−’ option sends the standard input to the uux command as the standard input to the command-string. 

Any special shell characters such as <>, ;, and | should be quoted either by quoting the entire command-string, or quoting the special characters as individual arguments. 

OPTIONS

−n Do not return any indication by mail(1) of success or failure of the job. 

−r Do not start uucico, just queue the job. 

−z Return an indication by mail only if the job fails. 

−gx Set service grade or classification to x.Thedefaultis A. 

−xn Set debugging level to n. (5, 7, and 9 are good numbers to try; they give increasing amounts of detail.)

EXAMPLE

The command

uux "!diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !fi.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. 

FILES

/var/spool/uucp spool directory

/usr/lib/uucp/∗ other data and programs

SEE ALSO

mail(1), uucp(1C), sendmail(8)

System and Network Administration

WARNING

An installation may, and for security reasons generally will, limit the list of commands executable on behalf of an incoming request from uux.  Typically, a restricted site will permit little other than the receipt of mail using uux. 

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. 

There is no notification of denial of execution on the remote machine. 

Sun Release 4.0  —  Last change: 21 December 1987