RSH(1) BSD Reference Manual RSH(1)NAME
rsh - remote shell
SYNOPSIS
rsh [-KNSdnx] [-k realm] [-l username] host [command]
rsh [-KNSdnx] [-k realm] username@host [command]
DESCRIPTION
Rsh executes command on host.
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 options are as follows:
-d The -d option turns on socket debugging (using setsockopt(2)) on
the TCP sockets used for communication with the remote host.
-K The -K option turns off all Kerberos authentication.
-k The -k option causes rsh to obtain tickets for the remote host in
realm instead of the remote host's realm as determined by
krb_realmofhost(3).
-l By default, the remote username is the same as the local username.
The -l option or the username@host format allow the remote name to
be specified. Kerberos authentication is used, and authorization
is determined as in rlogin(1).
-N The -N option causes rsh to fail if Kerberos authentication is not
successful. Normally, rsh will try ``normal'' authentication if
Kerberos authentication fails.
-n The -n option redirects input from the special device /dev/null
(see the BUGS section of this manual page).
-S The rsh protocol requires the remote host to establish a TCP con-
nection back to the local host. This connection provides the stan-
dard error from the remote command and propagation of signals to
the remote command. In some cases, IP firewalls prevent this con-
nection from being formed.
When the -S flag is specified this second connection will not be
established. The standard error output from the remote command
will be merged with its standard output and appear on rdist's stan-
dard output. The interrupt, quit and terminate signals will cause
rsh to terminate and close the TCP connection. The remote command
will terminate when it attempts to write to the network connection.
-x The -x option is reserved for DES encryption, which is currently
not functional.
If no command is specified, you will be logged in on the remote host us-
ing rlogin(1).
Shell metacharacters which are not quoted are interpreted on local ma-
chine, while quoted metacharacters are interpreted on the remote machine.
For example, the command
rsh otherhost cat remotefile >> localfile
appends the remote file remotefile to the local file localfile, while
rsh otherhost cat remotefile ">>" other_remotefile
appends remotefile to other_remotefile.
FILES
/etc/hosts
SEE ALSOrlogin(1), kerberos(3), krb_sendauth(3), krb_realmofhost(3)HISTORY
The rsh command appeared in 4.2BSD.
BUGS
If you are using csh(1) and put a rsh in the background without redirect-
ing 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 rogue(6) or vi(1)) using
rsh; use rlogin(1) instead.
Stop signals stop the local rsh process only; this is arguably wrong, but
currently hard to fix for reasons too complicated to explain here.
4.2 Berkeley Distribution November 11, 1996 2