NetBSD/gnu/libexec/uucp/uux/uux.1

235 lines
6.6 KiB
Groff

''' $Id: uux.1,v 1.1 1993/08/04 19:37:13 jtc Exp $
.TH uux 1 "Taylor UUCP 1.04"
.SH NAME
uux \- Remote command execution over UUCP
.SH SYNOPSIS
.B uux
[ options ] command
.SH DESCRIPTION
The
.I 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
.I uucico
(8) daemon calls the system and executes it. The daemon is
started automatically unless the
.B \-r
switch is given.
The actual command execution is done by the
.I 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) 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
.I 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,
.EX
uux 'sys1!diff sys2!~user1/foo sys3!~user2/foo >!foo.diff'
.EE
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
.I uucp
command on a remote system.
.SH OPTIONS
The following options may be given to
.I uux.
.TP 5
.B \-,\-p
Read standard input and use it as the standard input for the command
to be executed.
.TP 5
.B \-c
Do not copy local files to the spool directory. This is the default.
If they are
removed before being processed by the
.I uucico
(8) daemon, the copy will fail. The files must be readable by the
.I uucico
(8) daemon,
as well as the by the invoker of
.I uux.
.TP 5
.B \-C
Copy local files to the spool directory.
.TP 5
.B \-l
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
the
.B \-c
option also appears (in other words, use of
.B \-l
switches the default from
.B \-c
to
.B \-C).
If the files are changed before being processed by the
.I uucico
(8) daemon, the changed versions will be used. The files must be
readable by the
.I uucico
(8) daemon, as well as by the invoker of
.I uux.
.TP 5
.B \-g 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.
.TP 5
.B \-n
Do not send mail about the status of the job, even if it fails.
.TP 5
.B \-z
Send mail about the status of the job if an error occurs. For many
.I uuxqt
daemons, including the Taylor UUCP
.I uuxqt,
this is the default action; for those,
.B \-z
will have no effect. However, some
.I uuxqt
daemons will send mail if the job succeeds unless the
.B \-z
option is used, and some other
.I uuxqt
daemons will not send mail if the job fails unless the
.B \-z
option is used.
.TP 5
.B \-r
Do not start the
.I uucico
(8) daemon immediately; merely queue up the execution request for later
processing.
.TP 5
.B \-j
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
.B \-k
switch of
.I uustat
(1), which will make the execution impossible to complete.
.TP 5
.B \-a address
Report job status to the specified e-mail address.
.TP 5
.B \-x 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
.I uux.
Multiple types may be given, separated by commas, and the
.B \-x
option may appear multiple times. A number may also be given, which
will turn on that many types from the foregoing list; for example,
.B \-x 2
is equivalent to
.B \-x abnormal,chat.
.TP 5
.B \-I file
Set configuration file to use. This option may not be available,
depending upon how
.I uux
was compiled.
.SH EXAMPLES
.EX
uux -z - sys1!rmail user1
.EE
Execute the command ``rmail user1'' on the system sys1, giving it as
standard input whatever is given to
.I uux
as standard input. If a failure occurs, send a message using
.I mail
(1).
.EX
uux 'diff -c sys1!~user1/file1 sys2!~user2/file2 >!file.diff'
.EE
Fetch the two named files from system sys1 and system sys2 and execute
.I diff
putting the result in file.diff in the current directory. The current
directory must be writable by the
.I uuxqt
(8) daemon for this to work.
.EX
uux 'sys1!uucp ~user1/file1 (sys2!~user2/file2)'
.EE
Execute
.I uucp
on the system sys1 copying file1 (on system sys1) to sys2. This
illustrates the use of parentheses for quoting.
.SH RESTRICTIONS
The remote system may not permit you to execute certain commands.
Many remote systems only permit the execution of
.I rmail
and
.I rnews.
Some of the options are dependent on the capabilities of the
.I uuxqt
(8) daemon on the remote system.
.SH FILES
The file names may be changed at compilation time or by the
configuration file, so these are only approximations.
.br
/usr/lib/uucp/config - Configuration file.
.br
/usr/spool/uucp -
UUCP spool directory.
.br
/usr/spool/uucp/Log -
UUCP log file.
.br
/usr/spool/uucppublic -
Default UUCP public directory.
.SH SEE ALSO
mail(1), uustat(1), uucp(1), uucico(8), uuxqt(8)
.SH BUGS
Files can not be referenced across multiple systems.
Too many jobids are output by
.B \-j,
and there is no good way to cancel a local execution requiring remote
files.
.SH AUTHOR
Ian Lance Taylor
(ian@airs.com or uunet!airs!ian)