NAME

uux − unix to unix command execution

SYNOPSIS

uux [ options ] 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. 

The following 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. 

Uux returns an ASCII string on the standard output which is the job number.  This job number can be used by uustat to obtain the status or terminate a job. 

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/lib/uucp/L.sysList of system names and when to call them
/usr/lib/uucp/L-cmdList of commands for uuxqt to execute
/usr/lib/uucp/L-devicesList of device codes and speeds
/usr/lib/uucp/L-dialcodesList of phone numbers in L.sys
/usr/lib/uucp/SYSTEMNAMEName of this system
/usr/lib/uucp/USERFILEList of users and required pathname
prefixes
/usr/lib/uucp/uucicocopy in, copy out program; called by uucp
/usr/lib/uucp/uucleanspool directory cleanup program; called by
uucp
/usr/lib/uucp/uuxqtcommand execution program; called by uucp
/usr/spool/uucpspool directory

SEE ALSO

uucp(1C)
uuclean(1M)

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. 

Version 2.3  —  July 04, 1985