> WebRSH: Help: Command Line Syntax:
Commands can be entered in the command field of WebRSH's main form. They can also be entered through appropriate links.

WARNING: WebRSH is CASE SENSITIVE!

WebRSH supports 19 specialized commands, all of which are lower-cased and start with 'rsh'. Also, the command 'cd' is recognized and handled by WebRSH: It can be used to safely change WebRSH's working directory. Any other command will be forwarded to the shell for execution. WebRSH will wait for it to finish running and return its text output (if any) to the client. If you want to spawn a command as an independent (namely, background) process, without waiting for it to finish, and without returning any output to the client, you should use the 'rshstart' command (see below) which is precisely intended for this purpose.

WARNING: When executing commands, one should know in advance that the command will complete its task without prompting for further input. Otherwise, the execution attempt might result in a hang process. On decent operating systems (namely, UNIX variants and to a lesser extent NT) most commands would recognize that they are called in a noninteractive mode and would die by themselves if they need to work interactively. Also, in the event that a hang process is created, it can usually be killed safely using WebRSH's killable links (or the "rshkill" command). On Windows 95, however, the situation is much more problematic: any attempt to execute a command that needs to work ineractively is likely to result in a hang process. Moreover, such hang processes may be impossible to terminate without shutting the system down. They may have various bad effects on the system, such as reducing system stability and consuming a significant amount of system resources. An attempt to kill such processes might only make things worse, and it might even crash the system. Furthermore, a hang process might prevent Windows 95 from shutting down, such that it may become necessary to use the power switch (or a reset button) in order to reboot it. These problems lead to the following recommendations WHEN USING THE COMMAND LINE INTERFACE UNDER WINDOWS 95:
1) Avoid using the command line interface as much as possible.
2) If you must use it, do so with extreme caution. Only use familiar commands that have been previously tested to work well with WebRSH.
3) If you have created a hang process: Do not attempt to kill it. Reboot the system as soon as possible, but only do so when you are physically located near the system (so that you can use the power switch if needed).

WebRSH supports the following specialized commands: rshhome, rshfm, rshedit, rshps, rshkill, rshkilllist, rshlaunchlist, rshexeclist, rshgetlist, rshget, rshgettxt, rshgetbin, rshtextmode, rshuploadform, rshupload, rshstart, rshperl, rshgethtm, and rshoptions. They are mainly intended to be used from WebRSH's generated hyperlinks. Nevertheless, they may also be used from the command line. The syntax for these commands is described below.

NOTE: The WebRSH working directory is a property of the form (or link) that sends the command. The program changes to this directory upon startup.

Most commands are responded with an HTML page containing their output. This output may contain text output, as well as hyperlinks and forms which provide an easy to use interface for execution of further commands.

SPECIALIZED COMMAND SYNTAX:

rshhome
Changes the working directory to the default home directory.

rshfm [DIR]
Invokes WebRSH's file manager in the directory DIR, or in the current working directory if DIR is not specified.

rshedit [FILE]
Opens FILE in WebRSH's text editor, or starts the text editor with a blank file if FILE is not specified.

rshps
Returns a list of currently running processes. The precise output depends on the PS Library in use.

rshkill PID
Terminates (kills) the process whose pid is PID. The precise utility used to perform the killing depends on the PS Library in use.

rshkilllist
Returns a list of "killable links" for currently running processes. The precise output depends on the PS Library in use.

rshlaunchlist [DIR]
Returns a list of "launchable links" for files in the directory DIR, or in the current working directory if DIR is not specified. A "launchable link" to the file FILENAME executes the command 'rshstart FILENAME'.

rshexeclist [DIR]
Returns a list of "executable links" to executable files in the directory DIR, or in the current working directory if DIR is not specified. An "executable link" to the file FILENAME executes it, waits for it to finish, and returns the resulting output.

rshgetlist [DIR]
Returns a list of "downloadable links" for all files in the directory DIR, or in the current working directory if DIR is not specified. A "downloadable link" to the file FILENAME sends the file to the client.

rshget FILENAME
Sends FILENAME to the client, reporting its MIME type according to its extension and to WebRSH's MIME table. The file is sent in its precise binary form.

rshgettxt FILENAME
Implements the "GET as TEXT" option from the command line. Sends FILENAME to the client, reporting its MIME type as text/plain. The file is sent either in its precise binary format or converted to a non-native text format, depending on the appropriate setting in the "General Preferences" options setting form.

rshgetbin FILENAME
Implements the "GET as BIN" option from the command line. Sends FILENAME to the client, reporting its MIME type as application/octet-stream. The file is sent in its precise binary form.

rshtextmode COMMAND
Executes COMMAND and returns only its output to the client (as text/plain). Can be used to store the output of COMMAND to a file.

rshuploadform [DIR]
Returns an upload form for the directory DIR, or for the current working directory if DIR is not specified.

rshupload
Used only by upload forms as part of uploading a file. This command should not be used from the command line.

rshstart [/min | /max] FILENAME
Launches the file FILENAME, namely executes it as a background process, without waiting for it to finish, and without returning any output to the client. FILENAME should be the name of an executable file along with any desired parameters to it. On Win32 platforms (where this command implements the native 'start' command) FILENAME can also be a link to an executable file, or any file that has a registered association with an executable, or a link to such a file. The optional /min | /max switches can only be used on Win32 platforms, where /min starts the program minimized and /max starts it maximized (the default is a regular window).

rshperl PERLSUB
Executes PERLSUB (where PERLSUB is a string of text) as a Perl subroutine (through an eval(PERLSUB) command), and returns its output.

rshgethtm HTMFILE
Retrieves HTMFILE (which must reside in WebRSH's htm directory), dynamically parses it to replace certain special strings with current WebRSH settings, appends WebRSH's main form, and sends it to the client.

rshoptions
Invokes WebRSH option settings.