> ##### Last update 26-Aug-2005

> # mbfido, the fidonet mail and files processor.

> ### Synopsis.

> `mbfido [command(s)] <options>`

> ### Description.

> mbfido is the program to process fidonet mail and files. In order to run mbfido you must first start mbtask, this is the deamon which controls all bbs activities. To prevent that mbfido will run more than once at the same time a lock is placed in the protected inbound with the pid of the running mbfido program. The gateway to and from internet is also handled by mbfido.

> ### Specifications.

> The recognized mail packets are type 2+ following the FSC-0039 standard with a fallback to the old stone age packets. Can handle messages of maximum 429467295 bytes, or less if you have less memory available, the practical limit is about 1 Meg. Note that most mailprocessors are only guaranteed to work to maximum 16 KBytes. Recent experiments in the LINUX echo show that this is still true, although most tossers seem to process mail up to 32 KBytes.

> ### Tossing Mail.

> First make sure you have the necessary message areas in your setup. At least you need the badmail and dupemail areas and a netmail area for each network you participate in. If you don't create badmail and dupemail areas then bad (unknown area etc) and dupes are lost and you cannot check the reason why. If you don't create the netmail areas for each network, then netmail to your system will dissapear. It is not possible to "retoss" the badmail yet after you have created any missing echomail areas.

> To prevent .pkt name collision the toss of incoming mail is done in parts. The first run is to process all uncompressed mailpackets and add mail to the outbound. Then each compressed ARCmail archive will be uncompressed and processed and mail will be imported and forwarded as necessary. During all these passes all filenames are sorted by date and time, the oldest files are processed first.

> The recognized mail packets are type 2+ following the FSC-0039 standard with a fallback to the old stone age packets. The packets are checked for being addressed to one of your own aka's and for a correct password. The password check may be switched off in the nodes setup. After all the packet header checks the messages will be extracted from the packet file.

> When messages are extracted from the packets, the date format is checked for Year2000 bugs from other tossers. Several checks are done by ideas of Tobias Ernst of 2:2476/418. It is also possible to run the pktdate utility before each packet will be processed. Whatever date format us used in the original message, mbfido will always rewrite the date field in the right FTS-0001 format.

> If the message is a netmail the message is checked for DOMAIN, INTL, FMPT and TOPT kludges so that full 4d or 5d addressing will be possible. Then a check is done if this netmail is addressed to one of our aka's. If it's addressed to "sysop" or "postmaster" the name is replaced with the sysop's name. If the message is addressed to one of the names defined in the service setup, that mail will be handled by the service manager, ie. given to areamgr, filemgr or send further as email to your local system.
> Then the message is checked if it is addressed to an existing bbs user, and if so it will be imported into the netmail area of the main zone of the bbs. If it's not addressed to a bbs user, the message will be readdressed to the sysop. If the message is not for one of our aka's the message will be put in the mailqueue for further routing.

> If the message is a echomail message it will be checked for being a duplicate by storing the CRC32 value of the AREA: line, message subject, origin line, message date and msgid kludge and testing if that CRC32 value exists in the echomail duplicate database. If there is no msgid in the message, the whole message body will be include to complete the CRC32 dupe check. Also the existance of the echomail area is checked and the node must be linked to that area. If the message is not in a passthru area and is not a duplicate it is finally imported in the message base. After that is the message will be forwarded to downlinks by adding the message to the mailqueue.

> ### Adding mail and files to the outbound.

> Adding mail and file to the outbound is done in two passes. The first pass is to put all outgoing mail into the ~/var/queue/z.n.n.p directory, the last letters are replaced by the digits of the nodenumber. The extension can be qqq for packed mail, nnn for normal unpacked mail, hhh for hold unpacked mail and ccc for crash unpacked mail. Adding mail and files to this directory can allways be done, even if one of the nodes you are adding mail for is having a mail session with your system. This is a safe operation.
> In the second pass, these temp files are really added to the outbound, but only if the destination node is not locked, ie. there is no current mailsession with that node. If there is a mail session going, these temp files will stay in the temp directory and are added to the outbound in a later run of mbfido. If adding the mail to the outbound succeeds the temporary files and directory is removed.

> ### Alias file.

> If the file /opt/mbse/etc/aliases exists, mbfido will try to fetch ftn-style aliases from there. If "from" address of a message from FidoNet matches right side of some entry in alias file, then the Reply-To: header is created in the RFC message with the name part taken from the left side of the sysalis entry and domain part taken from myfqdn (below). E.g., if a fidonet message comes from "John Smith of 1:234/567.89@fidonet" and there is an entry in the sysalias file:

>     "jsmith:      John.Smith@p89.f567.n234.z1.fidonet.org"

> and Domain name value is "mbse.nl", then the resulting message will contain a line: "Reply-To: jsmith@mbse.nl".

> ### Commands.

> `mbfido areas` This command will check all file and mail groups if areas files are defined and if the setting Auto change is set to Yes. Then the areafile is read and the areas in that file are compared with the defined areas. Missing areas are created and areas not in the areafile are removed or blocked depending if there are files or messages present in these areas. This is also a good command to create large bulks of new areas on your system.

> `mbfido mail <recipient>` This command is used by your MTA to deliver email addressed to for example Michiel_Broek@f2802.n280.z2.fidonet.org

> `mbmail <recipient>` This is the same as above.

> `mbfido notify <nodes>` This command will send notify messages to all nodes in your setup which have the notify option set to on. If you enter nodes as option you may use wilcards, ie 2:*/* to send messages to all nodes in zone 2. If you specify exactly one node, messages will be generated even if that node has the notify function off. From cron you should not specify any nodes, this will just send to all your links the information about their setup. Each node will receive a status report for files and mail, and area list for all file areas and mail areas to each aka a node has, and a flow report for mail for each aka.

> `mbfido roll` This command will only do something if a new week or month has begun. If this is true the statistic records in several databases are updated. You should run this command each midnight from cron to be sure that this when it is time to do so. This command is always executed before one of the scan, toss or tic commands so if you don't do this in cron, it will still happen.

> `mbfido scan` Scan for new messages entered at the bbs or by other utilities. If the file ~/tmp/echomail.jam or ~/tmp/netmail.jam exists, mbfido will only scan the messages in areas which are pointed at in this file. This is a lot faster then a full mailscan. If it is not present, all messagebases are scanned to see if there is a new message. If you specify -full on the commandline a full messagebase scan is forced. It is wise to do this sometimes, on my bbs I run this once a day.

> `mbfido tag` The command will create tag- and areas files in the doc directory for each group of mail and files.

> `mbfido test <node>` This is for testing of the mail routing. The node on the commandline must be in the format f28.n280.z2 etc. The results are printed on the tty. If you have debug logging on in menu 1.5.16 items 17 and 18, then all needed debug information is written to the logfile. You can use this to debug your routing.

> `mbfido tic` Process incoming files accompanied with .tic control files. Several actions can take place on the incoming file before they are imported in the BBS areas. Options are rearchiving, replacing banners (with your add), check for DOS viruses, running scripts for certain filename patterns, send these files to other nodes etc. All options can be defined for each area. If as a result from one of the actions there are new files hatched, for example after processing a nodelist difference file which created a new nodelist, the .tic processing will start again, until there is really nothing more to do.

> `mbfido toss` Toss incoming fidonet netmail and or echomail. By default mail in the protected inbound directory will be processed, uncompressed .pkt files and compressed arcmail bundles are recognized, filename case doesn't matter.

> `mbfido news` Scan all defined newsgroups for new newsarticles. New articles are fetched from the newsserver and stored in your messagebase and send to your up- and downlinks. This is for use with an NNTP gateway.

> `mbfido uucp` This will read a standard a newsbatch from stdin and gate the articles to Fidonet and the local message base. This is for use with an UUCP gateway, this mode should be called by uuxqt. The newsbatch may be compressed or uncompressed or a single news article.

> `mbnews` This is an alternative to mbfido uucp -quiet.

> ### Options.

> `mbfido [command] -nocrc` Disable CRC checking of incoming TIC files. Only use this if you know what you are doing.

> `mbfido scan -full` Force scanning of all message bases for new entered mail. You need this if mail in entered with other editors then from mbse. Also, running it once a day is adviced to catch any missed messages.

> `mbfido news -learn` Scan the newsserver for news articles, and update the news dupes database only. Use this switch if you start using mbfido to gate news articles for the first time. Articles will not be gated with this switch, mbfido will just learn which articles already exist. Normally you only need to use this switch once.

> `mbfido [command] -nodupe` Disable checking for duplicate's. Normally you should not use this switch. This switch doesn't work with the news command, only for echomail and tic files.

> `mbfido [command] -quiet` Quiet mode, all output to the current tty is supressed. Use this flag if you toss mail from a script (started by cron) after mail is received.

> `mbfido toss -unsecure` Toss mail without checking if the echomail is for your own system en without checking if the sending node is connected to your system. Nodes who are excluded from a certain echo, can stil not enter messages in that echo.

> `mbfido [command] -unprotect` Toss from the unprotected inbound directory. The default is to toss from the protected inbound directory.

> ### Environment.

> In order to run the bbs you need to set one global environment variable $MBSE_ROOT This variable must point to the root of the bbs directoy structure.

> ### Bugs.

> There are still bugs, this program is under development.

> Back to index Back to Main index