


RSH(1C)             UNIX Programmer's Manual		  RSH(1C)



NAME
     rsh - remote shell

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

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

     If you omit _c_o_m_m_a_n_d, then instead of executing a single com-
     mand, you will be logged in on the remote host using
     _r_l_o_g_i_n(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 _r_e_m_o_t_e_f_i_l_e to the localfile _l_o_c_a_l_-
     _f_i_l_e, while

	rsh otherhost cat remotefile ">>" otherremotefile

     appends _r_e_m_o_t_e_f_i_l_e to _o_t_h_e_r_r_e_m_o_t_e_f_i_l_e.

     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.

FILES
     /etc/hosts
     /usr/hosts/*

SEE ALSO
     rlogin(1C)



Printed 11/26/99	 April 29, 1985                         1






RSH(1C)             UNIX Programmer's Manual		  RSH(1C)



BUGS
     If you are using _c_s_h(1) and put a _r_s_h(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 _r_s_h to /dev/null using the -n option.

     You cannot run an interactive command (like _r_o_g_u_e(6) or
     _v_i(1)); use _r_l_o_g_i_n(1C).

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










































Printed 11/26/99	 April 29, 1985                         2



