RSH(1N)                 COMMAND REFERENCE                 RSH(1N)



NAME
     rsh - remote shell

SYNOPSIS
     rsh host [ -l username ] [ -n ] command
     host [ -l username ] [ -n ] command

DESCRIPTION
     Rsh connects to the specified host, and executes the
     specified command.  Rsh copies its standard input to the
     remote command, the standard output of the remote command to
     its standard output, and the standard error of the remote
     command to its standard error.  Interrupt, quit, and
     terminate signals are propagated to the remote command; rsh
     normally terminates when the remote command does.

     The remote username used is the same as your local username,
     unless you specify a different remote name with the -l
     option.  This remote name must be equivalent (in the sense
     of rlogin(1n)) to the originating account; no provision is
     made for specifying a password with a command.

     If you omit command, then instead of executing a single
     command, you will be logged in on the remote host using
     rlogin(1n).

     Shell metacharacters which are not quoted are interpreted on
     local machine, while quoted metacharacters are interpreted
     on the remote machine.

     Host names are given in the file /etc/hosts.  Each host has
     one standard name (the first name given in the file), which
     is rather long and unambiguous, and optionally one or more
     nicknames.  The host names for local machines are also
     commands in the directory /usr/hosts; if you put this
     directory in your search path then the rsh can be omitted.

OPTIONS
     -lusername
         Specify a different remote username.

     -n  Redirect the input of rsh to /dev/null so that rsh will
         not block on reads from the terminal. See CAVEATS below.

EXAMPLES
     The following command appends the remote file file0 on host
     ecs to file1 on the local machine:

          rsh ecs cat file0 >> file1

     However, this next command appends file0 on ecs to file1
     which is also on ecs:



Printed 10/17/86                                                1

RSH(1N)                 COMMAND REFERENCE                 RSH(1N)



          rsh ecs cat file0 ">>" file1

     Remember that characters that are special to the shell (like
     '>', '<', '?', '[', ']', '*', '|', etc.) must be quoted to
     be passed to the shell running on the remote system.

     Suppose the name of a host on which you wish to execute
     commands is ecs.  Then if you link a host name to rsh as in
     the following:

          ln -s /bin/rsh /usr/hosts/ecs

     and add /usr/hosts to your path search path, then you can
     execute a remote command without specifying 'rsh', for
     example:

          ecs cat file0 >> file1

FILES
     /etc/hosts               Contains hostnames: standard and
                              nicknames.

     /usr/hosts/*             Contains hostnames for local
                              machines.

RETURN VALUE
     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [P_WARN]       A system error occurred. Execution continues.
                    See intro(2) for more information on system
                    errors.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

CAVEATS
     If you are using csh(1csh) and put a rsh(1n) in the
     background without redirecting its input away from the
     terminal, it will block even if no reads are posted by the
     remote command.  If no input is desired you should redirect
     the input of rsh to /dev/null using the -n option.

     You cannot run an interactive command (like vi(1)); use
     rlogin(1n).

     Stop signals stop the local rsh process only.




Printed 10/17/86                                                2

RSH(1N)                 COMMAND REFERENCE                 RSH(1N)



SEE ALSO
     rlogin(1n), hosts.equiv(5n), .rhosts(5n).





















































Printed 10/17/86                                                3

%%index%%
na:72,54;
sy:126,286;
de:412,1674;
op:2086,345;
ex:2431,348;2923,647;
fi:3570,275;
rv:3845,628;
ca:4473,602;
se:5219,204;
%%index%%000000000155