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. 

If you omit command, instead of executing a single command, rsh logs you in on the remote host using rlogin(1C).

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

tutorial% rsh lizard cat lizard.file >> tutorial.file

appends the remote file lizard.file from the machine called lizard to the file called tutorial.file on the machine called tutorial, while the command:

tutorial% rsh lizard cat lizard.file ">>" another.lizard.file

appends the file lizard.file on the machine called lizard to the file another.lizard.file.  which also resides on the machine called lizard.

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

−l username
use username as the remote username instead of your local username.  In the absence of this option, the remote username is the same as your local username, 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.

−n redirect the input of rsh to /dev/null. You need this option if you are using csh(1) and put a rsh(1C) in the background without redirecting its input away from the terminal because it will block even if no reads are posted by the remote command.

The type of remote shell (sh or csh) is determined by the user’s entry in the file /etc/passwd on the remote system. 

FILES

/etc/hosts
/usr/hosts/∗

SEE ALSO

rlogin(1C)

BUGS

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

Stop signals stop the local rsh process only; this is arguably wrong, but currently hard to fix for reasons too complicated to explain here. 

The current local environment is not passed to the remote shell. 

Sun Release 2.0  —  Last change: 1 February 1985