>
WebRSH: Help: Options: General Preferences:
- Background Color (value of $BGColor)
- The background color used for WebRSH pages.
- Additional <BODY> Parameters (value of $BodyParam)
- Additional parameters (other than the background color) for the BODY tag of WebRSH pages.
- Framing Table Color (value of $TableColor)
- The background color used for the outer (framing) tables of WebRSH forms.
- Additional Framing Table Parameters (value of $FTableParam)
- Additional parameters (other than the background color) for the outer (framing) tables
of WebRSH forms.
- Primary Table Parameters (value of $TableParam)
- Parameters for the inner (primary) tables of WebRSH forms.
- Host Name (value of $HostName)
- The name of the computer running WebRSH. This is only used in generating text for some of
WebRSH's pages.
- Command Field Size (value of $ComFieldSize)
- Size of the command input field in WebRSH's main form.
- FileName Field Size (value of $FNFieldSize)
- Size of input fields containing filenames in many WebRSH forms.
- File Manager Window Size (values of $FMSize and $FMHSize)
- Sizes of the File Manager select field. The vertical size is the number
of visible items. The horizontal size is roughly the size in characters,
although the actual resulting physical width depends very much on the browser
(and can differ considerably for different browsers).
- Plugin Options (value of $AppendToPI)
- The 'Append Main Form to Plugins' box determines whether or not WebRSH will append
its main form to the output of plugins. The plugin itself can always modify $AppendToPI
to override the default behavior set here.
- Optional Downloadable Links (value of $GetOptions)
- These options determine the kinds of "downloadable links" that will be generated
(in addition to the usual 'GET' links) in response to clicking 'GET' on the Main Menu
(or, equivalently, issuing the 'rshgetlist' command).
- "GET as TEXT" Sending Mode (value of $BinText)
- If the 'Send Files in Binary Mode' box is checked, then files sent with the 'GET as TEXT'
option will be sent in their exact binary format (which is the same way they are sent with
the 'GET' or 'GET as BIN' options). Otherwise, such files will be converted to a non-native
text format (namely, LF characters will be converted to CR-LF pairs or vice versa). That is,
if WebRSH is running on UNIX, the files will be converted to WinDOS format, and if WebRSH
is running on Win32, they will be converted to UNIX format.
- Default MIME type (value of $DefMimeType)
- The default MIME type to be reported for downloaded files. This is only relevant for
files with extensions that do not appear in WebRSH's MIME table.
- Extra Path Information (value of $XPath)
- If the 'Provide Filename for Downloaded Files' box is checked, file names will be added
to the the download URL as extra path information whenever files are downloaded through one
of the 'GET' options. This enables the browser to know the correct filename for downloaded files.
In most cases this box should be checked.
- Content-length Header (value of $GCLH)
- If the 'Generate Header when Appropriate' box is checked, the WebRSH script will supply a
'Content-length' header when a file is dowloaded through one of the 'GET' options or when
responding to an 'rshtextmode' command. Otherwise, such a header will not be provided. This
box should be checked unless the web server is ignoring this header and attaches its own
Content-length header to WebRSH's output.
- PS Library (value of $PsLib)
- The name of the library file to supply process related subroutines.
- Configuration Backup (value of $MakeBack)
- If the 'Backup the Script whenever Options are Modified' box is checked, a backup copy
of the main WebRSH script will be saved whenever options are changed. This backup copy will
have the same name as the main script except for a '-' added just before the extension.
Otherwise, no backup will be done.
- Default Request Method (value of $ReqMeth)
- The request method used by most of WebRSH's forms.
- Win32 Console Mode (value of $UseWin32Console)
- This option is available only on Win32 platforms. If the
'Assume the Availability of a Full Console' box is checked, WebRSH assumes it can communicate
with programs executed by it using STDIN/STDOUT, which requires WebRSH itself to be executed
with a full console. Otherwise, this is not assumed, and WebRSH will obtain output of other
programs by redirecting it to a temporary file and reading it from there. This box should be
checked if and only if WebRSH is being executed with a full console (this is determined by the
executing web server).
- Initialization Options (value of $LoginShell)
- This option is available only on UNIX platforms. If the 'Emulate a Login Shell'
box is checked, WebRSH will do its best to emulate the user's login environment. It will try
to get the user's login shell and home directory from the system, and will try to get the proper
default umask (by extracting it from a shell) whenever files are created. Furthermore,
if the user's login shell supports being run as a non-interactive login shell (namely, if it
is either bash, ksh, or zsh), commands will be executed through a login shell. If this box
is unchecked, such initialization would not take place, and it may be needed to manually set
the proper umask and some environment variables in the body of the main WebRSH script.
- Command Output Filtering (value of $ColFilter)
- This option is available only on UNIX platforms. If the 'Use Col Filter' box is checked,
output from shell commands will be filtered through 'col' to remove control characters
(this is important to make things like 'man *' work properly). Otherwise, such filtering would
not take place and WebRSH will present the raw STDOUT output of commands. It is recommended to
have this box checked as long as you have 'col'. This setting does not effect the 'rshtextmode'
command which always provides raw STDOUT output.