RSH(1)              RISC/os Reference Manual               RSH(1)



NAME
     rsh, remsh - remote shell

SYNOPSIS
     /usr/net/rsh host [ -l username ] [ -n ] command
     /usr/net/remsh host [ rsh options ]
     /usr/hosts/hostname [ rsh options ]

DESCRIPTION
     rsh connects to the specified host, and executes the speci-
     fied 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 com-
     mand 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(1C)) to the originating account; no provision is
     made for specifying a password with a command.

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

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

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

          rsh otherhost cat remotefile >> localfile

     appends the remote file remotefile to the localfile local-
     file, while

          rsh otherhost cat remotefile ">>" otherremotefile

     appends remotefile to otherremotefile.

     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 com-
     mands in the directory /usr/hosts; if you put this directory
     in your search path then the rsh can be omitted.



                        Printed 11/19/92                   Page 1

RSH(1)              RISC/os Reference Manual               RSH(1)



FILES
     /etc/hosts
     /usr/hosts/*

SEE ALSO
     rlogin(1C)

ERRORS
     rsh does not return the exit status of the remote command.

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

     Stop signals stop the local rsh process only; this is argu-
     ably wrong, but currently hard to fix for reasons too com-
     plicated to explain here.







































 Page 2                 Printed 11/19/92