rshsvc

NAME

rshsvc - Windows command-line utility to manage Remote Shell service

SYNOPSIS

rshsvc -install [-m mappingserver]
rshsvc -remove
rshsvc -start [-m mappingserver] [-p]
rshsvc -stop

DESCRIPTION

The rshsvc Windows command-line utility manages Remote Shell service, the server side for the TCP/IP utility rsh(1). It works the same way as the UNIX Remote Shell service. Rsh clients can access this service from both Windows and UNIX computers.

The action performed by the rshsvc command depends on the command option you supply. The rshsvc command accepts the following options and arguments:

-install [-m mappingserver]

Installs the service. You can use the following option with -install:

-m mappingserver: Specifies the name of the server running User Name Mapping that will map Windows and UNIX user accounts. If this option is not specified, no user mapping is performed.

-remove

Removes the service.

-start [-m mappingserver] [-p]

Starts the service. You can use the following options with -start:

-m mappingserver: Specifies the name of the server running User Name Mapping that will map Windows and UNIX user accounts. If this option is not specified, no user mapping is performed.
-p: Specifies that the service is not to use passwords stored locally for users using the rshpswd(1w) Windows command-line utility.

-stop

Stops the service.

SECURITY

You must have an .rhosts(5) file in the path specified in the registry key \HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\RshSvc\RhostsPath. The default path is %SystemRoot%\system32\drivers\etc directory.

The .rhosts file should include one or more of the following entries, each on a separate line:

M1 U1 [U2 U3 ....]

where M1 is the name of the computer from which Rsh client can be run and U1, U2, and so on are names of the users who are permitted to access the Remote Shell service.

The Remote Shell service returns an "Access denied" message under the following conditions:

The Rsh client computer name is not specified in the .rhosts file.
The name of the logged-on user on the Rsh client computer is not present in the .rhosts files.
A user is trying to access the Remote Shell service from a computer specified in the .rhosts file for which the service failed to resolve the Internet Protocol (IP) address.

LIMITATIONS

When the client tries to start a command, the Remote Shell service waits for a defined length of time for the command to be completed. This time-out period can be changed by modifying the following registry key: \HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\RshSvc\DefaultTimeOut. The default value is 10 minutes.