man(1) Manual page archive


     UUX(1)                                                     UUX(1)

     NAME
          uux - unix to unix command execution

     SYNOPSIS
          uux [ options ] command-arg ...

     DESCRIPTION
          Uux will execute a command on a specified system with files
          and standard output on specified files and systems.  For
          security reasons, most machines allow only selected commands
          to be run, perhaps only receipt of incoming mail.

          The command-args make up a sh(1) command with with command
          and file arguments possibly written system!file.  A missing
          system is interpreted as the local system.  Files may be
          prefixed by ~xxx/ to represent the home directory for login
          name xxx on the specified system.

          Uux copies all files to the execution system.  Files to be
          returned as outputs must be enclosed in (escaped) parenthe-
          ses.  Files must have general read permission.

          The options are

          -aname  Use name as the user identification replacing the
                  initiator user-id.  (Notification will be returned
                  to the user.)
          -b      Return standard input to the command if the exit
                  status is non-zero.
          -c      Don't copy local file to the spool directory for
                  transfer to the remote machine (default).
          -C      Force the copy of local files to the spool directory
                  for transfer.
          -ggrade Grade is a single letter/number; earlier ASCII
                  sequence characters will cause the job to be trans-
                  mitted earlier during a particular conversation.
                  The default is N.
          -j      Place the jobid, an ASCII string, on the standard
                  output.  The jobid can be used by uustat(1) to
                  obtain the status or terminate a job.
          -n      Suppress mail notification about failures.
          -p
          -       Take the standard input to uux as the standard input
                  to the executed command.
          -r      Don't start the file transfer, just queue the job.
          -sfile  Report status of the transfer in file.
          -xdebug Produce debugging output on stdout.  Debug is a num-
                  ber between 0 and 9; higher numbers give more
                  detailed information.

     UUX(1)                                                     UUX(1)

          -z      Notify the user if the command succeeds.

     FILES
          spool directory
          other data and programs

     SEE ALSO
          uucp(1), uucico(8), uustat(1)

     BUGS
          All the commands in a shell pipeline are executed on the
          machine of the first command.
          Because files are gathered into a common directory, two
          files for one command cannot have the same basename.  This
          won't work: uux "a!diff  b!/usr/dan/xyz c!/usr/dan/xyz >
          !xyz.diff".