.\" Copyright (c) 1996 Michael Sadd (sadd@cornell.edu)
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"
.TH REXEC 1 "August 15, 1999"
.SH NAME
rexec -- remote execution client for an exec server
.SH SYNOPSIS
.B rexec 
[  
.B \-a \-c \-d \-h \-n \-s
] [--] host command
.SH DESCRIPTION
.B Rexec
calls the 
.B rexec(3)
routine to act as a client for the remote host's
.B rexecd(8)
server.  
.PP
It asks that ``command'' be run on the host computer,
using username/password authentication. See 
.B rexec(3)
and
.B rexecd(8)
for details of the protocol.
.SH OPTIONS
.B Rexec
accepts the following options:
.\"
.LP
\fB\-a\fP
.IP
Do not set up an auxiliary channel for standard error from command;
the remote standard error and output are then both returned on the
local standard output.  By default, 
.B rexec
asks that a separate channel be set up for diagnostic output
from the remote command.
.\"
.LP
\fB\-c\fP
.IP
Do not close remote standard input when local standard input closes.
Normally the standard input to the remote command is closed when
the local standard input is closed.
.\"
.LP
\fB\-d\fP
.IP
Turn on debugging information. In particular the command sent to the
remote host will be echoed.
.\"
.LP
\fB\-h\fP
.IP
Print a usage message.
.\"
.LP
\fB\-n\fP
.IP
Explicitly prompt for name and password.  Otherwise,
$HOME/.netrc will be scanned for login information.
.\"
.LP
\fB\-s\fP
.IP
Do not echo signals received by the rexec onto the remote
process.  Normally, signals which can be trapped are passed
on to the remote process; then, when you type CNTRL-C, the remote
process terminates as well.
.\"
.LP
\fB\--\fP
.IP
Signals end of options to
.B rexec
to allow option switches in ``command.''
.PP
The only option that is very useful is -n; 
even then, if you have not
set up a password in $HOME/.netrc, you should still be prompted.
.SH EXAMPLE
.PP
rexec othermachine -- cat ">remote_file; date" <local_file
.PP
will send local_file to the othermachine as remote_file.

.SH BUGS
When a signal is received locally, the signal is passed to the remote
command using
blocking i/o.  Even though it is only one byte, this may result
in delay in teminating the local command if communications are slow.
Also, the signal remains raised in the local rexec procedure, so
typically the remote command cannot ask for further user input
after the signal is sent.
.PP
It is annoying to have to use the ``--'' flag to include options in
the remote command without quoting them.  This is because the GNU
getopt(3) routine is being called.  This behavior may be corrected 
by setting the POSIXLY_CORRECT environtmental variable.
.PP
Please send bug reports or system incompatibilities to the author.
.SH "SEE ALSO"
rexec(3), rexecd(8)
.SH AUTHOR
.PP
Michael Sadd 
.br
sadd@msc.cornell.edu
.br
http://www.msc.cornell.edu/~sadd/