This page will describe how to setup the InterBBS part of the BBS lister.
Step 1. Compile the tools
Compile the tools located in utils/mbbslist
cd utils/mbbslist make
Step 2. Create an INI file for your entry
The first INI file you need is the one used to create the message to send out to other BBSes.
[main] BBS Name = Some BBS Sysop Name = Sysop Location = Timbuktu Software = MagickaBBS Address = bbs.somewhere.com Telnet Port = 2023 SSH Port = 2024 Comment = Lots of files and doors!
All fields are required except Telnet Port and SSH Port (though it’s recommended to enter at least one of them!)
run bbslistentrygen on this to create a text file that you will post with the mgpost utility.
./bbslistentrygen bbslist.ini /path/to/output.asc
Step 3. Set up mgpost to send your entry
An example for an mgpost.ini would be:
[main] ; Echo mail: ; TRUE = Fido Echo ; MAGI = Mnet echo ; FALSE = Local Mail Echomail = TRUE BBS Path = /path/to/MagickaBBS Message File = /path/to/output.asc Message Base = /path/to/msgs/fsx/fsx_dat Base Type = JAM From = some-bbs Subject = MBBSLIST Local AKA = 21:1/999 Origin Line = Some BBS ; Magi Node = 2
Then at regular intervals, run mgpost with this ini file to post your entry to the data area.
Step 4. Set up Scanning / Importing
Create an ini file for bbslistentryscan called scan.ini (or whatever you want to call it)
[main] BBSList Database = /path/to/MagickaBBS/bbslist2.sq3 Message Base = /path/to/msgs/fsx/fsx_dat Message Base Type = JAM
Please note only JAM is currently supported.
Please note it’s important to run bbslistentryscan from the same working directory each time.
Step 5. Putting it all together
This is a script I personally use runing from crontab daily. Though, weekly may be better.
#!/bin/bash cd /home/andrew/MagickaBBS/advert /home/andrew/MagickaBBS/utils/mgpost/mgpost bbslist.ini touch /home/andrew/MagickaBBS/mail.out cd /home/andrew/MagickaBBS/utils/mbbslist ./bbslistentryscan scan.ini
Step 6. Modifying your entry
If your details change, you can modify your entry file and regenerate the message. Only BBSes of the same name are overwritten - so if you change your BBS name you must start over.