
Steps for changing MAXUSERS on an active Eagles or Pirates BBS
--------------------------------------------------------------

To change the MAXUSERS configuration variable you must rewrite your .BOARDS
file and all the mail and board .DIR files.

Raising MAXUSERS is no problem; but be aware that for every 1 you add to 
MAXUSERS you'll add one byte for EVERY post and mail message. Be sure you
have space!

To lower MAXUSERS you must be sure that ~bbs/.PASSWDS is not bigger than
sizeof(struct fileheader) * new MAXUSERS. If it is then you'll have to
truncate it and you're on your own for that. I'm assuming this program will
only be used for raising MAXUSERS.

Before starting:

1. *** BACK UP YOUR BBS !!!! *** 
   This process will destroy all mail and boards if not run properly.
   At least, archive ~bbs/.BOARDS, ~bbs/mail, and ~bbs/boards.

2. Compile cnvtbrds.c with "make cnvtbrds". This source should need no 
   changes.

3. Edit cnvtbrds.sh, putting in the right values for OLDMAXUSERS and
   NEWMAXUSERS. Be SURE these correspond to the present (old) value of 
   MAXUSERS and desired (new) value of MAXUSERS in config.h (bbs.h for PBBS).

The process (it's real simple):

1. Stop the bbs. Kick everyone off and remove ~bbs/bin/bbs, or comment out 
   bbs' passwd file entry.

2. Edit config.h (bbs.h for PBBS) in your bbs source directory and change 
   MAXUSERS to the new value you want.

3. Now, making sure OLDMAXUSERS and NEWMAXUSERS are right, run cnvtbrds.sh,
   maybe piping stderr to a file so error messages get saved. NOTE: you MUST
   be root, or the same uid as the bbs. If you're bbs, you can ignore any
   "cannot chown" messages. 

4. In your bbs source directory do a "make clean" followed by
   "make installbbs". Then log in quickly and make sure everything looks ok.
   If not, hey, you DID back up so restore it and try again. 
