NAME
	  rsh -	Executes the specified command at the remote host or
	  logs in to a remote host

     SYNOPSIS
	  rsh [-dn] [-l	user] remote_host [command] [argument ...]


	  The remote shell command (rsh) executes command at the
	  remote_host, or, if no command is specified, logs in to
	  remote_host.

     FLAGS
	  -d  Turns on socket debugging	(using setsockopt()) on	the
	      TCP sockets used for communication with the remote host.

	  -l user
	      Specifies	that rsh is to log in to the remote host as
	      user instead of the local	username.  If this flag	is not
	      specified, the local and remote usernames	are the	same.

	  -n  Redirects	any input for rsh to the /dev/null device.
	      Use this flag if you are in C shell and run rsh in the
	      background.


     DESCRIPTION
	  The rsh command sends	standard input from the	local host to
	  the remote command and receives standard output and standard
	  error	from the remote	command.  If you do not	specify	a com-
	  mand,	rsh executes rlogin instead.

	  If you do not	specify	the -l flag, the local username	is
	  used at the remote host.  If -l user is entered, the speci-
	  fied username	is used	at the remote host.  In	either case,
	  the remote host allows access	only if	at least one of	the
	  following conditions is satisfied:


	    o  The local user ID is not	superuser, and the name	of the
	       local host is listed as an equivalent host in the
	       remote /etc/hosts.equiv file.

	    o  If either the local user	ID is superuser	or the check
	       of /etc/hosts.equiv fails, the remote user's home
	       directory must contain a	$HOME/.rhosts file that	lists
	       the local host and username.


	  For security reasons,	any $HOME/.rhosts file must be owned
	  by either the	remote user or the root	user, and only the
	  owner	should have Read and Write access.
	  In addition to the preceding conditions, rsh also allows
	  access to the	remote host if the remote user account does
	  not have a password defined.	However, for security reasons,
	  use of a password on all user	accounts is recommended.

	  While	the remote command is executing, pressing the Inter-
	  rupt,	Terminate, or Quit key sequences sends the correspond-
	  ing signal to	the remote process.  However, pressing the
	  Stop key sequence stops only the local process.  Normally,
	  when the remote command terminates, the local	rsh process
	  terminates.

	  To have shell	metacharacters interpreted on the remote host,
	  place	the metacharacters inside "" (double quotes).  Other-
	  wise,	the metacharacters are interpreted by the local	shell.

     EXAMPLES
	  In the following examples, the local host host1 is listed in
	  the /etc/hosts.equiv file at the remote host host2.


	   1.  To check	the amount of free disk	space on the remote
	       host host2, enter:

	       $ rsh host2 df



	   2.  To append a remote file to another file on the remote
	       host, place the >> metacharacters in "" (double
	       quotes):

	       $ rsh host2 cat test1 ">>" test2



	   3.  To append a remote file at the remote host to a local
	       file, omit the double quotes:

	       $ rsh host2 cat test2 >>	test3



	   4.  To append a remote file to a local file and use a
	       remote user's permissions at the	remote host, use the
	       -l flag:

	       $ rsh host2 -l jane cat test4 >>	test5



     FILES

	  /etc/hosts.equiv
		     Specifies remote hosts from which users can exe-
		     cute commands on the local	host (provided these
		     users have	an account on the local	host).

	  $HOME/.rhosts
		     Specifies remote users that can use a local user
		     account.


     RELATED INFORMATION
	  Commands:  rcp(1), rlogin(1),	rshd(8), telnet(1).

	  Functions:  rexec(3).

	  Files:  rhosts(4).