

Installing Remote Shell Service
===============================

1. Copy rshsetup.exe, rshsvc.exe, rshsvc.dll to %SystemRoot%\System32 directory

2. Run the following commands

     rshsetup %SystemRoot%\system32\rshsvc.exe %SystemRoot%\system32\rshsvc.dll

     net start rshsvc

3. To Stop the Service just do 

     net stop rshsvc


What is RSHSVC
==============

It is the server side for the TCP/IP utility rsh.exe. It works the same way 
as the UNIX Remote Shell Service. RSH clients can access this service from 
both NT and UNIX machines.

SECURITY
========

1. You need to have .rhosts files in %SystemRoot%\system32\drivers\etc 
   directory

2. The .rhosts file should have one or more of the following type of entries.
   Each Entry should be on one line.

   <M1>   <U1> [<U2> <U3> ....] 

   where M1 is the name of the machine from which RSH client can be run
   and U1, U2 etc. are names of the Users that are permiited to access 
       the Remote Shell Servive


  RSHSVC returns "Access denied" message under the following conditions.
  
  1. RSH client machine name is not specified in the .rhosts file.

  2. The name of the Logged on User on the RSH client machine is not present 
     in the .rhosts files.

  3. RHSVC (using GetHostByName) failed to reolve the Ip Address of a machine, 
     say Mx, specifed in the .rhosts files and a user is trying to access this 
     service from that machine Mx.

LIMITATIONS
===========

1. Both the RSH client and RSH service are not meant to be used for
   running interactive commands, such as, editing.

2. This service can be used to start batch files of the following 
   type.

            dir
            ls
            tlist

   It may not work well, if you try to start command windows in batch files.
   plz see the example below.

            start cmd
            start cmd vi

3. If you try to start interactive editors, such as vi, using this service,
   the rsh client may wait for a timeout period. The timeout is currently set
   to 10 minutes. In a future version, the timeout will be made a registry
   key, so that users can change it depending on their needs.

4. When the client tries to start a command, the rsh server waits for the
   completion of the execution of the command for a timeout period. The
   timeout is currently hard coded to 10 minutes. In a future version,
   the timeout will be made a registry key. This limitation means that 
   the client can not execute a command that takes more than 10 minutes 
   to complete.
      
FEEDBACK
========

If the user of this service has any feedback or suggestions, plz send 
mail to SudheerD@microsoft.com.


