Rshell Component

The Rshell control is used to execute commands on a remote Unix machine using the rshell mechanism. (NOTE: The following is a very short description. For more information, please consult the help files that come with the respective package.)

The Rshell control allows remote execution of commands on UNIX hosts, or any other system with the rshell interface. Using the control is very simple. The destination is specified by the RemoteHost property, the login information is given by the LocalUser and RemoteUser properties, and the command to execute by the Command property. Further input can be supplied to the command by assigning data to the Stdin property.

The output of the command is returned through the Stdout event. If an error happens on the protocol level, the error message can be found in the ErrorMessage property. Errors during command execution (the stderr stream) are given by the Stderr event.

To be able to successfully use the control, the remote host must be set up to allow execution of commands via rshell from the machine the control runs on.

This control requires a Winsock 1.1 compliant TCP/IP stack. This means that the Winsock stack installed in the system must have a version of at least 1.1. In particular, Windows 95, 98, and NT machines with Winsock 2.0 are fully supported.

PROPERTIES

BytesSent. The number of bytes actually sent after an assignment to Stdin.

Command. The command to be sent to the remote host.

EOL. Used to break the stdout data stream into chunks separated by its value.

ErrEOL. Used to break the stderr data stream into chunks separated by its value.

ErrorMessage. The error message returned when any of the steps prior to command execution fail.

LocalHost. The name of the local host. When connected, the IP address of the interface through which the connection was made.

LocalUser. The id of the user on the local machine.

RemoteHost. The address of the RemoteHost. Domain names are resolved to IP addresses.

RemotePort. The remote shell service port (default is 514).

RemoteUser. The id of the user on the remote host.

SocketHandle. The handle of the main socket used by the control.

Stdin. A string of data to be sent to the remote host while connected.

WinsockInfo. Identifying information about the loaded Winsock stack.

WinsockLoaded. Loads and unloads Winsock on demand.

WinsockMaxDatagramSize. Size in bytes of the largest UDP datagram that can be sent or received.

WinsockMaxSockets. Maximum number of sockets available to a single process.

WinsockPath. The path to the Winsock DLL used.

WinsockStatus. The status of the Winsock stack.

EVENTS

Connected. Fired immediately after a connection completes (or fails).

Disconnected. Fired when a connection is closed.

Error. Information about errors during data delivery.

Stderr. Fired when data (complete lines) come in through stderr.

Stdout. Fired when data (complete lines) come in through stdout.