UUX(1)UUX(1)NAMEuux - unix to unix command execution
SYNOPSISuux [-] [-flags] command-string
DESCRIPTION
Uux will gather zero or more files from various systems,
execute a command on a specified system and then send
standard output to a file on a specified system.
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.
File names may be one of
(1) a full path name;
(2) a path name preceded by \ (the \ is removed);
(3) a path name preceded by ~user where user is a login
name on the specified system and is replaced by that
user's login directory;
(4) a path name prefixed by ~/ where ~ is expanded to
the system's public directory (usually
/var/spool/uucppublic);
(5) a partial pathname, which is prefixed by the current
directory.
As an example, the command
uux "!diff usg!/usr/dan/file1 pwba!/a4/dan/file2 >
!~/dan/file.diff"
will get the file1 and file2 files from the `usg' and
`pwba' machines, execute a diff(1) command and put the
results in file.diff in the local
/var/spool/uucppublic/dan/ directory.
Uux will attempt to get all files to the execution system.
Any special shell characters, such as <>;|, should be
quoted either by quoting the entire command-string, or
quoting the special characters as individual arguments.
Arguments that contain characters meaningful to uux that
are meant to be interpreted remotely must be quoted with
parentheses. For example, the command
uux a!mail \(c!user\)
UUCP 1
UUX(1)UUX(1)
will execute the command ``mail c!user'' on system `a'.
Uux will notify you by mail if the requested command on
the remote system was disallowed. This notification can
be turned off by the -n option.
Uux reads the UUCP configuration file
OPTIONS
- The standard input to is made the standard input to
the command-string.
-aname
Use name as the user identification replacing the
initiator user-id.
-c Do not copy local file to the spool directory for
transfer to the remote machine (this is the default).
-C Force the copy of local files to the spool directory
for transfer.
-dspool
Change the spool directory from the default
[SPOOLDIR]. This should be either SPOOLDIR, or one of
the directories named in SPOOLALTDIRS (see
uuparams(5)).
-ggrade[incr]
Grade is a single letter/number, from 0 to 9, A to Z,
or a to z; 0 is the highest, and z is the lowest
grade. The default is A; by comparison uucp(1C)
defaults to n and mail is usually sent at grade C.
Lower grades should be specified for high-volume jobs,
such as news. The optional incr is a number used to
downgrade the job one grade for each incr bytes in the
data.
-l Try and make a link from the original file to the
spool directory. If the link cannot be made, copy the
file.
-L Start up uucico with the -L flag. This will force
calls to be made to local sites only (see uucico(8C)).
-mminsize
Abort if input data size is less than minsize.
-Mminsize
Equivalent to -m.
-n Do not notify the user when the command completes.
-p Same as -. The standard input to uux is made the
UUCP 2
UUX(1)UUX(1)
standard input to the command-string.
-Pparams
Alters the pathname for the UUCP parameters file
[default: `/etc/uucp/CONFIG']. (See uuparams(5) for
details.)
-r Do not start the file transfer, just queue the job.
-Sspool
Equivalent to -d.
-T[level]
Turns on routine tracing at level [default: 1]. If
tracing is not compiled in, this flag will have no
effect.
-xdebug
Produce debugging output on stdout. debug is a number
between 0 and 9; higher numbers give more detailed
information. Debugging is permitted only for
privileged users (specifically, those with read access
to L.sys(5)).
-z Notify the user only if the command fails.
FILES
/etc/uucp/CONFIG Current parameters for all UUCP programs
(see uuparams(5)).
LOGDIR/errors UUCP error log.
LOGDIR/uux/node Uux log for node.
PARAMSDIR/L.aliases
Aliases for remote system names.
PARAMSDIR/L.sys Remote system names.
SEE ALSOuucp(1), uuparams(5), uucico(8), uuxqt(8).
WARNING
For security reasons, many installations limit the list of
commands executable on behalf of an incoming request from
uux. Many sites permit little more than the receipt of
mail via uux (see mail(1)).
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.
The use of the shell metacharacter * will probably not do
what you want it to do.
The shell tokens << and >> are not implemented.
UUCP 3
UUX(1)UUX(1)
When invoking uux from csh(1), the `!' character must be
prefixed by the `\' escape to inhibit csh's history
mechanism. (Quotes are not sufficient.)
UUCP 4
