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