


      UUX(1)                      (UNIX 5.0)                     UUX(1)



      NAME
           uux - unix to unix command execution

      SYNTAX
           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.

           As an example, the command

                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.

           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.  For example, the command

                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''.

           Uux will notify you if the requested command on the remote



      Page 1                                          (73 A2 02MT REV1)






      UUX(1)                      (UNIX 5.0)                     UUX(1)



           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.

      FILES
           /usr/lib/uucp/spool   spool directory
           /usr/lib/uucp/*       other data and programs

      SEE ALSO
           uuclean(1), uucp(1), and the UUCP description in the ROS
           Utility Guide.

      BUGS
           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 command of a shell pipeline may have a
           system-name.  All other commadns are executed on the system
           of the first command.




















      Page 2                                          (73 A2 02MT REV1)



