Commit | Line | Data |
---|---|---|
f68c9796 KB |
1 | .\" Copyright (c) 1988 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
136bc9c9 | 4 | .\" |
f68c9796 KB |
5 | .\" @(#)uux.1 6.4 (Berkeley) %G% |
6 | .\" | |
7 | .TH UUX 1 "" | |
136bc9c9 KM |
8 | .AT 3 |
9 | .SH NAME | |
10 | uux \- unix to unix command execution | |
11 | .SH SYNOPSIS | |
12 | .B uux | |
13 | [ | |
83c2cb4e KM |
14 | .B - |
15 | ] [ | |
16 | .B -cClLnprz | |
17 | ] [ | |
18 | .BI -a name | |
19 | ] [ | |
20 | .BI -g grade | |
21 | ] [ | |
22 | .BI -x debug | |
136bc9c9 KM |
23 | ] |
24 | command-string | |
25 | .SH DESCRIPTION | |
f19ea302 JB |
26 | .I Uux\^ |
27 | will gather zero or more files from various systems, | |
136bc9c9 | 28 | execute a command on a specified system |
f19ea302 | 29 | and then send standard output to a file on a specified |
136bc9c9 KM |
30 | system. |
31 | .PP | |
83c2cb4e KM |
32 | The |
33 | .I command-string | |
34 | is made up of one or more arguments that look | |
f19ea302 | 35 | like a Shell command line, |
136bc9c9 | 36 | except that the command and file names |
f19ea302 JB |
37 | may be prefixed by |
38 | .IB system-name !\fR.\fP | |
39 | A null \fIsystem-name\fP is interpreted as the local system. | |
136bc9c9 KM |
40 | .PP |
41 | File names may be one of | |
42 | .IP | |
f19ea302 | 43 | (1) a full path name; |
136bc9c9 | 44 | .IP |
f19ea302 | 45 | (2) a path name preceded by |
83c2cb4e | 46 | .BI ~ user |
136bc9c9 | 47 | where |
83c2cb4e | 48 | .I user |
f19ea302 | 49 | is a login name on the specified system |
136bc9c9 | 50 | and is replaced by that user's login directory; |
136bc9c9 | 51 | .IP |
83c2cb4e KM |
52 | (3) a path name prefixed by |
53 | .BR ~; | |
54 | where | |
55 | .B ~ | |
56 | is expanded to the system's public directory (usually /usr/spool/uucppublic); | |
57 | .IP | |
58 | (4) a partial pathname, which is prefixed by the current directory. | |
136bc9c9 | 59 | .PP |
f19ea302 | 60 | As an example, the command |
136bc9c9 | 61 | .IP |
f19ea302 | 62 | uux "\^!diff usg!/usr/dan/file1 pwba!/a4/dan/file2 > !~/dan/file.diff\^" |
136bc9c9 | 63 | .PP |
f19ea302 JB |
64 | will get the \fBfile1\fP and \fBfile2\fP files |
65 | from the ``usg'' and ``pwba'' machines, | |
136bc9c9 | 66 | execute a |
83c2cb4e | 67 | .IR diff (1) |
136bc9c9 | 68 | command |
f19ea302 | 69 | and put the results in \fBfile.diff\fP in the |
83c2cb4e | 70 | local /usr/spool/uucppublic/dan/ directory. |
136bc9c9 | 71 | .PP |
83c2cb4e | 72 | Any special shell characters, such as \fB<>;|\fP, should be quoted either |
f19ea302 | 73 | by quoting the entire \fIcommand-string\fP, or quoting the special |
136bc9c9 | 74 | characters as individual arguments. |
f19ea302 | 75 | .PP |
83c2cb4e | 76 | .I Uux |
f19ea302 JB |
77 | will attempt to get all files to the execution system. |
78 | For files that are output files, the file name must be escaped using | |
79 | parentheses. | |
80 | For example, the command | |
81 | .IP | |
82 | uux a!wc b!/usr/file1 \\(c!/usr/file2 \\) | |
83 | .PP | |
84 | get \fB/usr/file1\fP from system ``b'' and send it to system ``a'', | |
85 | perform a \fIwc\fP command on that file | |
86 | and send the result of the | |
87 | .I wc | |
88 | command to system ``c''. | |
89 | .PP | |
90 | .I Uux\^ | |
91 | will notify you by mail if the requested command on the remote | |
92 | system was disallowed. | |
93 | This notification can be turned off by the \fB\-n\fP option. | |
94 | .PP | |
95 | The following \fIoptions\fP are interpreted by | |
96 | .IR uux : | |
97 | .TP .5i | |
98 | .B \- | |
99 | The standard input to | |
100 | .I uux | |
101 | is made the standard input to the | |
102 | .IR command-string . | |
103 | .TP .5i | |
104 | .BI \-a name | |
105 | Use | |
106 | .I name | |
107 | as the user identification replacing the initiator user-id. | |
108 | .TP .5i | |
109 | .B \-c | |
83c2cb4e KM |
110 | Do not copy local file to the spool directory for transfer to the remote |
111 | machine (this is the default). | |
f19ea302 JB |
112 | .TP .5i |
113 | .B \-C | |
114 | Force the copy of local files to the spool directory for transfer. | |
115 | .TP .5i | |
116 | .BI \-g grade | |
83c2cb4e KM |
117 | .I Grade |
118 | is a single letter/number, from | |
119 | .B 0 | |
120 | to | |
121 | .BR 9 , | |
122 | .B A | |
123 | to | |
124 | .BR Z , | |
125 | or | |
126 | .B a | |
127 | to | |
128 | .BR z ; | |
129 | .B 0 | |
130 | is the highest, and | |
131 | .B z | |
132 | is the lowest grade. | |
133 | The default is | |
134 | .BR A ; | |
135 | by comparison | |
f68c9796 | 136 | .IR uucp (1) |
83c2cb4e KM |
137 | defaults to |
138 | .B n | |
139 | and mail is usually sent at grade | |
140 | .BR C . | |
141 | Lower grades should be specified for high-volume jobs, such as news. | |
f19ea302 JB |
142 | .TP .5i |
143 | .B \-l | |
144 | Try and make a link from the original file to the spool directory. | |
83c2cb4e | 145 | If the link cannot be made, copy the file. |
f19ea302 JB |
146 | .TP .5i |
147 | .B \-n | |
83c2cb4e | 148 | Do not notify the user when the command completes. |
f19ea302 JB |
149 | .TP .5i |
150 | .B \-p | |
151 | Same as \-: | |
152 | The standard input to | |
153 | .I uux | |
154 | is made the standard input to the | |
155 | .IR command-string . | |
156 | .TP .5i | |
157 | .B \-r | |
83c2cb4e | 158 | Do not start the file transfer, just queue the job. |
f19ea302 JB |
159 | .TP .5i |
160 | .BI \-x debug | |
161 | Produce debugging output on stdout. | |
162 | The debug is a number between 0 and 9; | |
83c2cb4e KM |
163 | higher numbers give more detailed information. Debugging is permitted |
164 | only for privileged users (specifically, those with read access to | |
165 | .IR L.sys (5) . | |
f19ea302 JB |
166 | .TP .5i |
167 | .B \-z | |
83c2cb4e | 168 | Notify the user only if the command fails. |
f19ea302 JB |
169 | .TP .5i |
170 | .B \-L | |
83c2cb4e KM |
171 | Start up |
172 | .I uucico | |
173 | with the \fB-L\fP flag. This will force | |
174 | calls to be made to local sites only (see | |
f68c9796 | 175 | .IR uucico (8)). |
136bc9c9 | 176 | .SH FILES |
f19ea302 JB |
177 | .PD 0 |
178 | .TP 22 | |
179 | /usr/spool/uucp | |
180 | spool directories | |
181 | .TP | |
182 | /usr/lib/uucp/\(** | |
83c2cb4e | 183 | UUCP configuration data and daemons |
f19ea302 | 184 | .PD |
136bc9c9 | 185 | .SH SEE ALSO |
f68c9796 | 186 | uucp(1), uucico(8), uuxqt(8). |
83c2cb4e KM |
187 | .SH WARNING |
188 | For security reasons, many installations will | |
189 | limit the list of | |
190 | commands executable on behalf of an incoming request from | |
191 | .IR uux . | |
192 | Many sites will permit little more than | |
193 | the receipt of mail (see | |
194 | .IR mail (1)) | |
195 | via | |
196 | .IR uux . | |
136bc9c9 KM |
197 | .SH BUGS |
198 | Only the first command of a shell pipeline may | |
f19ea302 JB |
199 | have a |
200 | .IB system-name !\fR. | |
136bc9c9 KM |
201 | All other commands are executed on the system of the first |
202 | command. | |
83c2cb4e | 203 | .PP |
136bc9c9 | 204 | The use of the shell metacharacter |
f19ea302 | 205 | .B \(** |
136bc9c9 | 206 | will probably not do what you want it to do. |
83c2cb4e | 207 | .PP |
f19ea302 JB |
208 | The shell tokens |
209 | .B << | |
210 | and | |
211 | .B >> | |
212 | are not implemented. | |
83c2cb4e KM |
213 | .PP |
214 | When invoking | |
215 | .I uux | |
216 | from | |
217 | .IR csh (1), | |
218 | the `!' character must be prefixed by the `\\' escape to inhibit | |
219 | .IR csh 's | |
220 | history mechanism. (Quotes are not sufficient.) |