uux(1C) uux(1C)NAME uux - runs a command on a remote system SYNOPSIS uux [-] [-aname] [-b] [-C] [-c] [-ggrade] [-j] [-n] [-p] [-r] [-sfile] [-xdebug-level] [-z] command-string ARGUMENTS - Causes the standard input to uux to be used as the standard input of the command specified by command-string. This argument has the same effect as the -p option. -alogin-name Uses the value of login-name, rather than using your login name, as the initiator of the uux request. If you use this option, notification messages are sent to the user whose login name is login-name. -b Returns in a notification message, the standard input that was provided to the uux command if the exit status is nonzero. -c Copies from the actual file rather than making a copy in the directory /usr/spool/uucp and uses that copy to make the transfer. This option is on by default. -C Makes a copy of a file to be transferred in the directory /usr/spool/uucp and uses the copy to make the transfer. command-string Specifies one or more arguments that look like a shell command line, except that the command and filenames may be prepended by system!, where system is the name of a system configured in the /usr/lib/uucp/Systems file. If you do not specify a system, uux runs the command on your local system. A filename consists of one of the following: ⊕ A full pathname. ⊕ A pathname preceded by ~login-name, where login-name is a login name of a user on the specified system and is replaced by the full pathname of that user's login directory. ⊕ A relative pathname, which uux converts to a full pathname by prepending the full pathname of the current directory. January 1992 1
uux(1C) uux(1C)-ggrade Specifies a grade. The value of grade is a string of one or more alphanumeric characters that specifies a service grade, or priority. To see the available grades, use the uuglist command, which displays a list of grades or a message that tells you to use a single letter or number. -j Writes the job identification string on the standard output. You can use the job identification with the uustat command to cancel a job or get its status. -n Prevents uux from notifying you if the command fails. If you do not use this option, uux sends you a mail message describing the failure. -p Causes the standard input to uux to be used as the standard input of the command specified by command-string. This argument has the same effect as a hyphen (-). -r Queues the job but does not start the file transfer. -sfile Reports the status of the transfer in the file specified by file. -xdebug-level Writes debugging information on the standard output. The value of debug-level is a number from 0 to 9. Higher numbers produce more detailed debugging information. -z Sends mail when the file transfer completes successfully. DESCRIPTION uux runs a command on a remote system. You can use uux to gather files from specified systems, run a command on the files on a specified system, and then send the standard output of the command to a file on a specified system. For security reasons, some system administrators limit to mail the commands that remote uux commands can run. The uux command sends mail to notify you if the remote system disallows the requested command. You can disable the notification by using the -n option. 2 January 1992
uux(1C) uux(1C)EXAMPLES Here is a command that gets the files fileA and fileB from system2 and system3, and uses them as arguments to diff, which is run on system1. The command puts the result of diff in the file file.diff in the directory /usr/spool/uucppublic, which is expanded from the tilde (~), on system4: uux "system1!diff system2!/home/dan/fileA \ system3!/a4/dan/fileB > \ !system4~/dan/file.diff" You should quote any special shell characters, such as comma (,), right angle bracket (>), semicolon (;), and pipe (|), either by enclosing the entire command string in quotation marks or by quoting the special characters as individual arguments. uux attempts to get all appropriate files to the specified system where they are processed. The filenames of output files must be escaped with parentheses. For example, if you are logged in on system1, and want to run uucp on system2 to copy a file from system2 to /tmp on system3, the following uux command would be appropriate: uux "system2!uucp system2!/usr/file (system3!/tmp)" The same command, but without parentheses, will fail because uux will attempt to put system3!/tmp on system2 prior to running uucp on system2. The following example gets the file /usr/file from system2 and sends it to system1, performs cut on that file, and sends the result to the file /usr/file on system3. Note that parentheses are not required in this example because the only ouput is the result of redirection. uux "system1!cut -f1 system2!/usr/file > system3!/usr/file" LIMITATIONS Only the first command of a shell pipeline can be preceded by a system value. All other commands are executed on the system specified by the first command. The asterisk shell metacharacter (*) does not expand as you probably want. The shell tokens << and >> are not implemented. The execution of commands on remote systems takes place in a directory known to uucp and its related commands. All files January 1992 3
uux(1C) uux(1C)required to run the command are put in this directory unless they already reside on the remote system. You must, therefore, take care to avoid name collisions that result in the overwriting of one file by another. For example, this command fails because the file xyz is first transferred from system2 and then overwritten by the transfer from system3, which results in only one argument for the diff command: uux "system1!diff system2!/home/dan/xyz \ system3!/home/dan/xyz > !xyz.diff" If diff is permitted on the remote system, this command does work because the file xyz is transferred to the execution directory from system3, then transferred to system1, and then compared with /home/dan/xyz on system1: uux "system1!diff system1!/home/dan/xyz \ system3!/home/dan/xyz > !xyz.diff" You can use uux to transfer protected files that you own and files that are in protected directories that you own. However, if you are logged in as root and your directories cannot be searched by other users, the request will fail. FILES /usr/bin/uux Executable file /usr/lib/uucp Directory of uucp commands and configuration files /usr/lib/uucp/Permissions File that limits the commands that uux can run /usr/spool/uucp Directory of queued uucp jobs SEE ALSO uucp(1C), uuglist(1C), uustat(1C) uuxqt(1M) in A/UX System Administrator's Reference Chapter 8, ``Setting Up the UUCP System,'' in A/UX Network System Administration 4 January 1992