.\" SCCSID: @(#)uux.1c	8.1	9/11/90.TH uux 1c.SH Nameuux \- unix to unix command execution.SH Syntax.NXR "uux command".B uux[\fB\-\fR] \fIcommand-string\fR.SH DescriptionThe.PN uuxcommand gathers 0 or more files from various systems,executes a command on a specified system,and sends standard output to a file on a specifiedsystem..PPThe .I command-string is made up of one or more arguments that look like a shell command line,except that the command and file namesmay be prefixed by system-name!.A null system-name is interpreted as the local system..PPFile names may be one of the following:.IP \(bu 5A pathname .IP \(bu 5A pathname preceded by.IR ~xxx,where.I xxxis a userid on the specified systemand is replaced by that user's login directory.IP \(bu 5Any other syntax that is prefixed by the current directory..PPFor example, the following command line gets the f1 files from the usg and pwba machines, executes a.PN diffcommand and puts the results in f1.diff in the local directory..EXuux "!diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !f1.diff".EE.PPWhen using special shell characters such as <>'!, you should eitherquote the entire .I command-string,or you should quote the special characters as individual arguments..PPThe.PN uuxcommand attempts to get all files to the execution system.  If both the file and command are located on different remote sites, the file is first brought to the local system and is then transferred to the execution system..PPIf you want to include files as arguments to a command, but youdo not want those files to be processed by .PN uux ,enclose the filename in parentheses.  For example:.EXuux a!uucp b!/usr/file (c!/usr/file).EEThe previous example sends a .PN uucpcommand to system .PN a.  The .PN /usr/fileis transferred from system .PN b to the local system, and then is passed to system .PN a.  When .PN /usr/filearrives at system .PN a the .PN uucpcommand executes and sends .PN /usr/fileto system .PN c ..PPIf the request is not allowed on the remote system, the .PN uuxcommandnotifies you.  This response is sent through remote mailfrom the remote machine..SH Options.IP "\fB\\-c, \-l\fR" 0.3i Do not copy local file to the spool directory for transferto the remote machine.  This is the default..IP "\fB\-g\fIgrade\fR" 0.3iSpecifies the.I gradewhich is a single letter or number from 0 to 9, A to Z, or a to z.The highest grade is 0, the lowest grade is z.  The default isA.  Lower grades should be specified for high-volume jobs, suchas news..IP \fB\-n\fR 0.3i Sends no notification to user..IP "\fB\-p, -\fR" 0.3iReads stdin..IP \fB\-r\fR 0.3iQueues the job, but does not start the file transfer..IP \fB\-x\fIdebug\fR 0.3iProduces debugging output on stdout.  The.I debugoption is a number between 0 and 9.  Higher numbers provide more detailedinformation.  Debugging is permitted only for those users with readaccess to .MS L.sys 5 ..IP \fB\-z\fR 0.3iNotify the user if the command fails..SH WarningAn installation may limit the list ofcommands executable on behalf of an incoming request from.PN uux .Typically, a restricted site permits little other thanthe receipt of mail through.PN uux ..SH RestrictionsOnly the first command of a shell pipeline mayhave a system-name!.All other commands are executed on the system of the firstcommand..PPThe use of the shell metacharacter asterisk (*) shell metacharactermay not behave as you expect.The shell tokens (<<  >>) are not implemented..PPYou are not notified when execution on a remote machine is denied.Only commands listed in .PN /usr/lib/uucp/L.cmdson the remote system are executed at the remote system..SH Files.DT/usr/spool/uucp	spool directory.br/usr/lib/uucp/*	other data and programs.SH See Alsouucp(1c).br"Uucp Implementation Description".I ULTRIX Supplementary DocumentsVol. III: System Manager