rconfig

configures the rshd and rexecd services 

Command


SYNOPSIS

rconfig service [start | stop] [[+-]f] [[+-]s] [[+-]v]

rconfig service status [-frsv]


DESCRIPTION

rconfig helps to configure the MKS and Windows-specific features of the PTC MKS Toolkit version of the rshd and rexecd services. These services are based on traditional UNIX daemons and many basic configuration settings are handled using traditional UNIX methods (for example, the ~/.rhosts and ROOTDIR/etc/hosts.equiv files).

The service argument to rconfig is either rshd or rexecd, indicating which service rconfig is to work with.

When the second argument is status, rconfig enters status mode. In status mode, rconfig does not modify the selected service, but instead returns information about that service.

When the second argument is start or stop, rconfig attempts to start or stop the specified service.

Options

When not in status mode, rconfig accepts the following options:

+f 

tells the service to fail when the local user does not exist (the default).

-f 

tells the service to attempt to connect as a domain user when the local user does not exist.

+s 

allows multiple connections to the service (the default).

-s 

allows allows only a single connection to the service.

+v 

writes only error messages to the event log (the default).

-v 

writes all connections to the event log.

When in status mode, rconfig accepts the following options:

-f 

displays how the service responds when the local user does not exist.

-r 

displays the current running status of the service.

When a service is STOPPED or UNINSTALLED, you can start it with the rconfig start argument.

When a service is RUNNING, you can stop it with the rconfig stop argument.

-s 

displays Single when the service accepts only a single connection and Multiple when the service accepts multiple connections.

-v 

displays the status of the event logging. If all connections are being logged, rconfig displays Logging; if they are not, rconfig displays NoLogging.

When no options are specified in status mode, rconfig behaves as if -rsv was specified.


DIAGNOSTICS

Possible exit status values are:

0 

Successful completion.

>0 

An error occurred.


NOTE

rconfig is provided as a KornShell executable script. MKS cannot be responsible for proper functionality of this code if you alter the rconfig.sh file in any way.


PORTABILITY

Windows 10. Windows Server 2016. Windows Server 2019. Windows 11. Windows Server 2022. Windows Server 2025.


AVAILABILITY

PTC MKS Toolkit for System Administrators
PTC MKS Toolkit for Developers
PTC MKS Toolkit for Interoperability
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Commands:
grconfig, rexecd, rsetup, rshd, service

File Formats:
hosts.equiv, rhosts

MKS Toolkit Connectivity Solutions Guide


PTC MKS Toolkit 10.5 Documentation Build 40.