> ##### Last update 03-Sep-2005

> # mbsebbs - The main BBS program

> ### Synopsis.

> `mbsebbs`

> ### Description.

> mbsebbs is the main bbs program for the users. To be able to use the bbs, the bbs mustbe set open with mbstat open or users may not login. This is normally done at system boot. Also Zone Mail Hour is honored if the user logs in on a tty that has the honor ZMH flag set to true. If it is ZMH and the ZMH flag is true, the user will be kicked out of the bbs. You should only set this flag on the modem lines where you need to be available for ZMH if your "Fidonet" network requires that.

> The first visible action is to show the logo.ans file. Because it is not known who is trying to login, you only need to place this file in the default language directory.

> The next check is to see if the user is allowed to login on the tty he currently is on. If this tty is not available or is not in your setup, the user is kicked out. If he is allowed to login, a message is shown at which port he is on, unless you have turned this feature off in the setup.

> If the user login is successfull, his favourite language will be loaded. Then it is checked if the user is the Sysop, if so, the Sysop flag is set. If the users Date of Birth is invalid, he is forced to enter the right Date of Birth. The next check is to see if the user has passed the expiry date, this is a usefull feature for systems with donating users. Finally the access limits are set for the user and time remaining for today and download limits are set.

> After successfull login the user can be presented with a bunch of advertising screens. I will only name the screens without filename extension, as these screens are searched for in the following order;

> 1. filename.ans in the users favourite language directory.
> 2. filename.ans in the default language directory.
> 3. filename.asc in the users favourite language directory.
> 4. filename.asc in the default language directory.
> 5. If nothing is found, nothing is displayed.
> Here is the list of displayed screens:
> 1. mainlogo. Here you can put a logo or something.
> 2. welcome. This screen can contain information about the session the user has, his download limits, time left etc.
> 3. welcome1 is shown if the user has show bulletins set to true.
> 4. welcome2 is shown if the user has show bulletins set to true.
> 5. welcome3 is shown if the user has show bulletins set to true.
> 6. welcome4 is shown if the user has show bulletins set to true.
> 7. welcome5 is shown if the user has show bulletins set to true.
> 8. welcome6 is shown if the user has show bulletins set to true.
> 9. welcome7 is shown if the user has show bulletins set to true.
> 10. welcome8 is shown if the user has show bulletins set to true.
> 11. welcome9 is shown if the user has show bulletins set to true.
> 12. birthday is shown if the user logs in at his birthday and if he has show bullentins set to true.
> 13. dd-mm is shown if dd is the date of today and mm is the current month and if the user has show bulletins set to true.
> 14. sec20 is shown if the user has the security level in the filename, level 20 in this example. Als the display bulletins must be set to true.
> 15. news is shown if the user has the display bulletins set to true.
> 16. onceonly is shown only if the user has never seen this screen, the test is to compare the users last login date against the date of this file.

> After all these screens the users Offline Reader areas are checked to see if you as sysop didn't change the message areas. If you made changes, the users setup is adjusted and he will be notified. This means he sees a list with deleted areas and new areas.

> Next if the user has newmail scan set to true all message bases are checked to see if the user has new mail. This includes a check to see if he has Unix mail. If there is Unix mail, those mails are retrieved from the POP3 server and stored in his private mailbox. If there is new mail for the user, the user sees a list of areas with the messages in it and he is offered to read and reply these messages.

> Then if the user has show newfiles set to true and he is not a new bbs user he will see a list of new files you have on your bbs. During this display he can tag files for later download.

> The final setup is to set the users "do not disturb" flag and then the menu system is started. The menu system will run forever, until the user chooses to logoff, the connection is lost or his daily timelimit is reached. For the possibilities and setup of the menus see MBSE BBS Menu System

> ### Environment.

> In order to run mbsebbs you must set the global variable $MBSE_ROOT. This variable must point to the root directory of the bbs structure. The main configuration file config.data must be present in the ~/etc directory.

> If the environment variable CONNECT is present, a log entry will be made with the connect speed.

> If the environment variable CALLER_ID is present, a log entry will be made with the caller id.

> The environment variable LOGNAME must contain the unix username. This is set by the mblogin program.

> If the environment variable REMOTEHOST is present, a log entry will be made with the name or IP address of the remote host.

> If the environment variable TERM is present, a log entry will be made with the terminal type of the remote user.

> Back to index Back to Main index