[unix-history] / usr / man / man1 / uux.1c

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