Host Manager 2.0 README
-----------------------

WARNING: This plugin was meant for Host Administrators ONLY!

Host Manager was designed for 'Host Administrators' who often assist
there customers. It allows them to logon to a server and instantly be
permitted God/Admin powers, without the hassle of gateKeeper, hostkeeper,
or even the server passwords. A fast, hands free solution to assisting
your customers faster from your everyday questions to an emergency.

Bug fixes
---------

* I caught a potential bug in the Reg/PUID loading section where if you 
had
an extra { in the {} part (ex. {ABC{DEF} ), it could've caused some 
problems.

New Features
------------

* PUID Validating now instead of just Reg/IP, it's Reg/PUID/IP, all three!
* Line Commenting! (ex. # This line of the file is a comment... )

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

It's best if a Host Admin were using a 'shared' plugins directory.

  for instance:
    /usr/local/palace/shared/plugins/

  making this plugin:
    /usr/local/palace/shared/plugins/hostmgr.so

Now you'd want to stick the BLESS file into a main directory too.

  for instance:
    /usr/local/palace/shared/conf/

  making the BLESS file:
    /usr/local/palace/shared/conf/<bless-file>
  or:
    /usr/local/palace/shared/conf/hostmgr.bless

Now that you have both your 'shared' plugins directory and BLESS file,
insert the following into your plugin.conf file.

   /usr/local/palace/shared/plugins/hostmgr.so 
/usr/local/palace/shared/conf/hostmgr.bless

Plugin Limitations
------------------

FYI (For your information): By default this plugin will only hold 32 
Reg/IP entries.
More RAM can be used to store more entries if you were to download the 
source code,
and build a version to store more entries.

  To do this simply edit the line near the top:
    #define RL 32

I seriously doubt a Host will have more than 32 server Admin/Techs 
assigned to 1 server.
Final comment, any incorrectly formatted line will not be registered as a 
valid entry,
thus it will be skipped by the plugin's read-only engine.

The Parameter File
------------------

  The BLESS file is what contains one or more lines of:
    {REG} {PUID} "#.#.#.#" or "*.*.*.*" - for IP Addresses

  example: - Standard format!
    {ABCDE} {ZFGHI} "123.*.456.*"
  or: - The 'Z' part of the PUID is NOT mandatory!
    {ABCDE} {FGHI} "123.*.456.*"
  incorrect: - However, the 'Z' cannot just be tossed anywhere!
    {ABCDE} {FGZHI} "123.*.456.*"

If my Registration code were to print {ABCDE}, and my PUID were to print 
{ZFGHI},
into the server log upon connection, and my IP were 123.1.456.2,
I would be granted instant God/Admin mode.

If you wish not to use the {PUID} verfication system, simply leave the 
field blank,

  example:
    {ABCDE} {} "123.*.456.*"

The Plugin itself reloads the BLESS file every 150 seconds, or 2.5 minutes 
(1 Swatch/Swiss Time Beat)

Conclusion
----------

There are no commands to memorize, no passwords to enter, subnets are 
ranged by an asterisk,
this plugin is fast, simple, reliable!

Notes
-----

Brought to you by Paul Taylor (Janus) <janus@thepalacehost.com>
