uux(1)
NAME
uux - Remote command execution over UUCP
SYNOPSIS
uux [ 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 -r or --nouucico 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
exclamation point if it is to be executed on a remote system. An empty
system 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
absolute, it will be appended to the current working directory on the
local system; the result may not be meaningful on the remote system. A
pathname 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
sysexits.h. In particular, EX_OK ( 0 ) indicates success, and
EX_TEMPFAIL ( 75 ) indicates a temporary failure.
OPTIONS
The following options may be given to uux.
-, -p, --stdin
Read standard input and use it as the standard input for the
command to be executed.
-c, --nocopy
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.
-C, --copy
Copy local files to the spool directory.
-l, --link
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 -c or --nocopy options also appears (in other
words, use of --link switches the default from --nocopy to
--copy). 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.
-g grade, --grade grade
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.
-n, --notification=no
Do not send mail about the status of the job, even if it fails.
-z, --notification=error
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, --notification=error will have no
effect. However, some uuxqt daemons will send mail if the job
succeeds unless the --notification=error option is used, and some
other uuxqt daemons will not send mail if the job fails unless the
--notification=error option is used.
-r, --nouucico
Do not start the uucico (8) daemon immediately; merely queue up
the execution request for later processing.
-j, --jobid
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 --kill
switch of uustat (1), which will make the execution impossible to
complete.
-a address, --requestor address
Report job status to the specified e-mail address.
-x type, --debug type
Turn on particular debugging types. The following types are
recognized: abnormal, chat, handshake, uucp-proto, proto, port,
config, spooldir, execute, incoming, outgoing. Only abnormal,
config, spooldir and execute are meaningful for uux.
Multiple types may be given, separated by commas, and the --debug
option may appear multiple times. A number may also be given,
which will turn on that many types from the foregoing list; for
example, --debug 2 is equivalent to --debug abnormal,chat.
-I file, --config file
Set configuration file to use. This option may not be available,
depending upon how uux was compiled.
-v, --version
Report version information and exit.
--help
Print a help message and exit.
EXAMPLES
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 failure 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.
RESTRICTIONS
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.
SEE ALSO
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 --jobid, and there is no good way to cancel a local execution requiring remote files.
AUTHOR
Ian Lance Taylor (ian@airs.com)
Taylor UUCP 1.07 uux(1)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
