manual/netkit/original/man1/rexec.1

   1 .\" Copyright (c) 1996 Michael Sadd (sadd@cornell.edu)
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"
  33 .TH REXEC 1 "August 15, 1999"
  34 .SH NAME
  35 rexec -- remote execution client for an exec server
  36 .SH SYNOPSIS
  37 .B rexec
  38 [
  39 .B \-a \-c \-d \-h \-n \-s
  40 ] [--] host command
  41 .SH DESCRIPTION
  42 .B Rexec
  43 calls the
  44 .B rexec(3)
  45 routine to act as a client for the remote host's
  46 .B rexecd(8)
  47 server.
  48 .PP
  49 It asks that ``command'' be run on the host computer,
  50 using username/password authentication. See
  51 .B rexec(3)
  52 and
  53 .B rexecd(8)
  54 for details of the protocol.
  55 .SH OPTIONS
  56 .B Rexec
  57 accepts the following options:
  58 .\"
  59 .LP
  60 \fB\-a\fP
  61 .IP
  62 Do not set up an auxiliary channel for standard error from command;
  63 the remote standard error and output are then both returned on the
  64 local standard output.  By default,
  65 .B rexec
  66 asks that a separate channel be set up for diagnostic output
  67 from the remote command.
  68 .\"
  69 .LP
  70 \fB\-c\fP
  71 .IP
  72 Do not close remote standard input when local standard input closes.
  73 Normally the standard input to the remote command is closed when
  74 the local standard input is closed.
  75 .\"
  76 .LP
  77 \fB\-d\fP
  78 .IP
  79 Turn on debugging information. In particular the command sent to the
  80 remote host will be echoed.
  81 .\"
  82 .LP
  83 \fB\-h\fP
  84 .IP
  85 Print a usage message.
  86 .\"
  87 .LP
  88 \fB\-n\fP
  89 .IP
  90 Explicitly prompt for name and password.  Otherwise,
  91 $HOME/.netrc will be scanned for login information.
  92 .\"
  93 .LP
  94 \fB\-s\fP
  95 .IP
  96 Do not echo signals received by the rexec onto the remote
  97 process.  Normally, signals which can be trapped are passed
  98 on to the remote process; then, when you type CNTRL-C, the remote
  99 process terminates as well.
 100 .\"
 101 .LP
 102 \fB\--\fP
 103 .IP
 104 Signals end of options to
 105 .B rexec
 106 to allow option switches in ``command.''
 107 .PP
 108 The only option that is very useful is -n;
 109 even then, if you have not
 110 set up a password in $HOME/.netrc, you should still be prompted.
 111 .SH EXAMPLE
 112 .PP
 113 rexec othermachine -- cat ">remote_file; date" <local_file
 114 .PP
 115 will send local_file to the othermachine as remote_file.
 116
 117 .SH BUGS
 118 When a signal is received locally, the signal is passed to the remote
 119 command using
 120 blocking i/o.  Even though it is only one byte, this may result
 121 in delay in teminating the local command if communications are slow.
 122 Also, the signal remains raised in the local rexec procedure, so
 123 typically the remote command cannot ask for further user input
 124 after the signal is sent.
 125 .PP
 126 It is annoying to have to use the ``--'' flag to include options in
 127 the remote command without quoting them.  This is because the GNU
 128 getopt(3) routine is being called.  This behavior may be corrected
 129 by setting the POSIXLY_CORRECT environtmental variable.
 130 .PP
 131 Please send bug reports or system incompatibilities to the author.
 132 .SH "SEE ALSO"
 133 rexec(3), rexecd(8)
 134 .SH AUTHOR
 135 .PP
 136 Michael Sadd
 137 .br
 138 sadd@msc.cornell.edu
 139 .br
 140 http://www.msc.cornell.edu/~sadd/