![[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] / 43BSDReno / usr.bin / uucp|
Return to uux.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / uucp |
1.1 root 1: .\" Copyright (c) 1988, 1990 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)uux.1 6.5 (Berkeley) 6/24/90
6: .\"
7: .TH UUX 1 "October 24, 1988"
8: .AT 3
9: .SH NAME
10: uux \- unix to unix command execution
11: .SH SYNOPSIS
12: .B uux
13: [
14: .B -
15: ] [
16: .B -cClLnprz
17: ] [
18: .BI -a name
19: ] [
20: .BI -g grade
21: ] [
22: .BI -x debug
23: ]
24: command-string
25: .SH DESCRIPTION
26: .I Uux\^
27: will gather zero or more files from various systems,
28: execute a command on a specified system
29: and then send standard output to a file on a specified
30: system.
31: .PP
32: The
33: .I command-string
34: is made up of one or more arguments that look
35: like a Shell command line,
36: except that the command and file names
37: may be prefixed by
38: .IB system-name !\fR.\fP
39: A null \fIsystem-name\fP is interpreted as the local system.
40: .PP
41: File names may be one of
42: .IP
43: (1) a full path name;
44: .IP
45: (2) a path name preceded by
46: .BI ~ user
47: where
48: .I user
49: is a login name on the specified system
50: and is replaced by that user's login directory;
51: .IP
52: (3) a path name prefixed by
53: .BR ~;
54: where
55: .B ~
56: is expanded to the system's public directory (usually /var/spool/uucppublic);
57: .IP
58: (4) a partial pathname, which is prefixed by the current directory.
59: .PP
60: As an example, the command
61: .IP
62: uux "\^!diff usg!/usr/dan/file1 pwba!/a4/dan/file2 > !~/dan/file.diff\^"
63: .PP
64: will get the \fBfile1\fP and \fBfile2\fP files
65: from the ``usg'' and ``pwba'' machines,
66: execute a
67: .IR diff (1)
68: command
69: and put the results in \fBfile.diff\fP in the
70: local /var/spool/uucppublic/dan/ directory.
71: .PP
72: Any special shell characters, such as \fB<>;|\fP, should be quoted either
73: by quoting the entire \fIcommand-string\fP, or quoting the special
74: characters as individual arguments.
75: .PP
76: .I Uux
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
110: Do not copy local file to the spool directory for transfer to the remote
111: machine (this is the default).
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
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
136: .IR uucp (1)
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.
142: .TP .5i
143: .B \-l
144: Try and make a link from the original file to the spool directory.
145: If the link cannot be made, copy the file.
146: .TP .5i
147: .B \-n
148: Do not notify the user when the command completes.
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
158: Do not start the file transfer, just queue the job.
159: .TP .5i
160: .BI \-x debug
161: Produce debugging output on stdout.
162: The debug is a number between 0 and 9;
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) .
166: .TP .5i
167: .B \-z
168: Notify the user only if the command fails.
169: .TP .5i
170: .B \-L
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
175: .IR uucico (8)).
176: .SH FILES
177: .PD 0
178: .TP 22
179: /var/spool/uucp
180: spool directories
181: .TP
182: /usr/lib/uucp/\(**
183: UUCP configuration data and daemons
184: .PD
185: .SH SEE ALSO
186: uucp(1), uucico(8), uuxqt(8).
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 .
197: .SH BUGS
198: Only the first command of a shell pipeline may
199: have a
200: .IB system-name !\fR.
201: All other commands are executed on the system of the first
202: command.
203: .PP
204: The use of the shell metacharacter
205: .B \(**
206: will probably not do what you want it to do.
207: .PP
208: The shell tokens
209: .B <<
210: and
211: .B >>
212: are not implemented.
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.)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.