Manual Pages for UNIX Darwin command on man uux

uux(1) uux(1)

NAME

uux - Remote command execution over UUCP

SYNOPSIS

uuuuxx [ options ] command

DESCRIPTION

The uux command is used to execute a command on a remote system, or to

execute a command on the local system using files from remote systems. The command is not executed immediately; the request is queued until the uucico (8) daemon calls the system and executes it. The daemon is

started automatically unless one of the -rr or --nnoouuuucciiccoo options is

given.

The actual command execution is done by the uuxqt (8) daemon.

File arguments can be gathered from remote systems to the execution system, as can standard input. Standard output may be directed to a file on a remote system.

The command name may be preceded by a system name followed by an excla-

mation point if it is to be executed on a remote system. An empty sys-

tem name is taken as the local system. Each argument that contains an exclamation point is treated as naming a file. The system which the file is on is before the exclamation point, and the pathname on that system follows it. An empty system name is taken as the local system; this must be used to transfer a file to a

command being executed on a remote system. If the path is not abso-

lute, it will be appended to the current working directory on the local

system; the result may not be meaningful on the remote system. A path-

name may begin with ~/, in which case it is relative to the UUCP public directory (usually /usr/spool/uucppublic or /var/spool/uucppublic) on the appropriate system. A pathname may begin with ~name/, in which case it is relative to the home directory of the named user on the appropriate system. Standard input and output may be redirected as usual; the pathnames used may contain exclamation points to indicate that they are on remote systems. Note that the redirection characters must be quoted so that

they are passed to uux rather than interpreted by the shell. Append

redirection (>>) does not work. All specified files are gathered together into a single directory before execution of the command begins. This means that each file must have a distinct base name. For example,

uux 'sys1!diff sys2!~user1/foo sys3!~user2/foo >!foo.diff'

will fail because both files will be copied to sys1 and stored under the name foo. Arguments may be quoted by parentheses to avoid interpretation of exclamation points. This is useful when executing the uucp command on a remote system.

A request to execute an empty command (e.g., uux sys!) will create a

poll file for the specified system.

The exit status of uux is one of the codes found in the header file

ssyysseexxiittss..hh.. In particular, EEXXOOKK ( 00 ) indicates success, and EEXXTTEEMMPP-

FFAAIILL ( 7755 ) indicates a temporary failure. OOPPTTIIOONNSS

The following options may be given to uux.

-,, -pp,, --ssttddiinn

Read standard input and use it as the standard input for the com-

mand to be executed.

-cc,, --nnooccooppyy

Do not copy local files to the spool directory. This is the default. If they are removed before being processed by the uucico (8) daemon, the copy will fail. The files must be readable by the

uucico (8) daemon, as well as the by the invoker of uux.

-CC,, --ccooppyy

Copy local files to the spool directory.

-ll,, --lliinnkk

Link local files into the spool directory. If a file can not be linked because it is on a different device, it will be copied

unless one of the -cc or --nnooccooppyy options also appears (in other

words, use of --lliinnkk switches the default from --nnooccooppyy to

--ccooppyy)).. If the files are changed before being processed by the

uucico (8) daemon, the changed versions will be used. The files must be readable by the uucico (8) daemon, as well as by the

invoker of uux.

-gg ggrraaddee,, --ggrraaddee ggrraaddee

Set the grade of the file transfer command. Jobs of a higher grade are executed first. Grades run 0 ... 9 A ... Z a ... z from high to low.

-nn,, --nnoottiiffiiccaattiioonn==nnoo

Do not send mail about the status of the job, even if it fails.

-zz,, --nnoottiiffiiccaattiioonn==eerrrroorr

Send mail about the status of the job if an error occurs. For

many uuxqt daemons, including the Taylor UUCP uuxqt, this is the

default action; for those, --nnoottiiffiiccaattiioonn==eerrrroorr will have no

effect. However, some uuxqt daemons will send mail if the job

succeeds unless the --nnoottiiffiiccaattiioonn==eerrrroorr option is used, and some

other uuxqt daemons will not send mail if the job fails unless the

--nnoottiiffiiccaattiioonn==eerrrroorr option is used.

-rr,, --nnoouuuucciiccoo

Do not start the uucico (8) daemon immediately; merely queue up the execution request for later processing.

-jj,, --jjoobbiidd

Print jobids on standard output. A jobid will be generated for each file copy operation required to perform the operation. These

file copies may be cancelled by passing the jobid to the --kkiillll

switch of uustat (1), which will make the execution impossible to complete.

-aa aaddddrreessss,, --rreeqquueessttoorr aaddddrreessss

Report job status to the specified e-mail address.

-xx ttyyppee,, --ddeebbuugg ttyyppee

Turn on particular debugging types. The following types are rec-

ognized: abnormal, chat, handshake, uucp-proto, proto, port, con-

fig, spooldir, execute, incoming, outgoing. Only abnormal, con-

fig, spooldir and execute are meaningful for uux.

Multiple types may be given, separated by commas, and the --ddeebbuugg

option may appear multiple times. A number may also be given, which will turn on that many types from the foregoing list; for

example, --ddeebbuugg 22 is equivalent to --ddeebbuugg aabbnnoorrmmaall,,cchhaatt..

-II ffiillee,, --ccoonnffiigg ffiillee

Set configuration file to use. This option may not be available,

depending upon how uux was compiled.

-vv,, --vveerrssiioonn

Report version information and exit.

--hheellpp

Print a help message and exit. EEXXAAMMPPLLEESS

uux -z - sys1!rmail user1

Execute the command ``rmail user1'' on the system sys1, giving it as

standard input whatever is given to uux as standard input. If a fail-

ure occurs, send a message using mail (1).

uux 'diff -c sys1!~user1/file1 sys2!~user2/file2 >!file.diff'

Fetch the two named files from system sys1 and system sys2 and execute diff putting the result in file.diff in the current directory. The

current directory must be writable by the uuxqt (8) daemon for this to

work.

uux 'sys1!uucp ~user1/file1 (sys2!~user2/file2)'

Execute uucp on the system sys1 copying file1 (on system sys1) to sys2. This illustrates the use of parentheses for quoting. RREESSTTRRIICCTTIIOONNSS The remote system may not permit you to execute certain commands. Many remote systems only permit the execution of rmail and rnews.

Some of the options are dependent on the capabilities of the uuxqt (8)

daemon on the remote system.

mail(1), uustat(1), uucp(1), uucico(8), uuxqt(8)

BUGS

Files can not be referenced across multiple systems.

Too many jobids are output by --jjoobbiidd,, and there is no good way to can-

cel a local execution requiring remote files. AUTHOR Ian Lance Taylor (ian@airs.com)