projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| abef38b1 C |
1 | .TH UUX 1C "18 January 1983" |
| 2 | .UC 4 | |
| 3 | .SH NAME | |
| 4 | uux \- unix to unix command execution | |
| 5 | .SH SYNOPSIS | |
| 6 | .B uux | |
| 7 | [ | |
| 8 | .B \- | |
| 9 | ] | |
| 10 | command-string | |
| 11 | .SH DESCRIPTION | |
| 12 | .I Uux | |
| 13 | will gather 0 or more files from various systems, | |
| 14 | execute a command on a specified system | |
| 15 | and send standard output to a file on a specified | |
| 16 | system. | |
| 17 | .PP | |
| 18 | The command-string is made up of one or more arguments that look | |
| 19 | like a shell command line, | |
| 20 | except that the command and file names | |
| 21 | may be prefixed by system-name!. | |
| 22 | A null system-name is interpreted as the local system. | |
| 23 | .PP | |
| 24 | File names may be one of | |
| 25 | .IP | |
| 26 | (1) a full pathname; | |
| 27 | .IP | |
| 28 | (2) a pathname preceded by | |
| 29 | .IR ~xxx ; | |
| 30 | where | |
| 31 | .I xxx | |
| 32 | is a userid on the specified system | |
| 33 | and is replaced by that user's login directory; | |
| 34 | .br | |
| 35 | .IP | |
| 36 | (3) anything else is prefixed by the current directory. | |
| 37 | .PP | |
| 38 | The `\-' option will cause the standard input to the | |
| 39 | .I uux | |
| 40 | command to be the standard input to the command-string. | |
| 41 | .PP | |
| 42 | For example, the command | |
| 43 | .IP | |
| 44 | uux "!diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !fi.diff" | |
| 45 | .PP | |
| 46 | will get the f1 files from the usg and pwba machines, | |
| 47 | execute a | |
| 48 | .I diff | |
| 49 | command | |
| 50 | and put the results in f1.diff in the local directory. | |
| 51 | .PP | |
| 52 | Any special shell characters such as <>;| should be quoted either | |
| 53 | by quoting the entire command-string, or quoting the special | |
| 54 | characters as individual arguments. | |
| 55 | .SH FILES | |
| 56 | .DT | |
| 57 | /usr/spool/uucp spool directory | |
| 58 | .br | |
| 59 | /usr/lib/uucp/* other data and programs | |
| 60 | .SH SEE ALSO | |
| 61 | uucp(1C) | |
| 62 | .br | |
| 63 | D. A. Nowitz, | |
| 64 | .I Uucp Implementation Description | |
| 65 | .SH WARNING | |
| 66 | An installation may, and for security reasons | |
| 67 | generally will, limit the list of | |
| 68 | commands executable on behalf of an incoming request from | |
| 69 | .IR uux . | |
| 70 | Typically, a restricted site will permit little other than | |
| 71 | the receipt of mail via | |
| 72 | .IR uux . | |
| 73 | .SH BUGS | |
| 74 | Only the first command of a shell pipeline may | |
| 75 | have a system-name!. | |
| 76 | All other commands are executed on the system of the first | |
| 77 | command. | |
| 78 | .br | |
| 79 | The use of the shell metacharacter | |
| 80 | .B * | |
| 81 | will probably not do what you want it to do. | |
| 82 | .br | |
| 83 | The shell tokens << and >> are not implemented. | |
| 84 | .br | |
| 85 | There is no notification of denial of execution | |
| 86 | on the remote machine. |