Valcheck 1.3 README
-------------------

Valcheck is a Palace Server plugin that validity checks the format of
messages from the clients to the server before the server processes
them.  Valcheck can prevent certain server crashes caused by bad
message format.


Changes in Version 1.3
----------------------

Bug fixes
---------

* A bug where Valcheck help was displayed for any help inquiry made
by a wizards is fixed.


Installation
------------

The following installation instructions assume that the Palace server
has been installed in /usr/local/palace.

Valcheck is a standard Palace server plugin.  It is installed by
placing the plugin file, valcheck.so, in the palace binary folder,
/usr/local/palace/bin, and adding the following line to the plugin
configuration file, /usr/local/palace/<palace-name>/psdata/plugin.conf

../bin/valcheck.so <switch settings>

The control switches log and page; may be set using the
<switch settings> parameters.  For example:

../bin/valcheck.so page on log off

will  suppress the log file entries while still paging the wizards
when a badly formated message is detected.  (See below for the meaning
of these switches.)  The default values for the switches are:

  log on
  page off



Wizard and god Commands
-----------------------

Valcheck also adds the following commands for users with wizard or god
status.

`valcheck list            - Show the valcheck plugin settings
`valcheck log [on | off]  - Write a log entry when a badly formated
                            message is rejected
`valcheck page [on | off] - Page wizards when a badly formated
                            message is rejected

