# mbout - The Outbound Manager

###

SYNOPSIS

    Usage:  mbout [command] <params> <options>

            Commands are:
            node <node>                             Show nodelist information
            poll <node> [node..node]                Poll node(s) (always crash)
            req  <node> <file> [file..file]         Request file(s) from node
            stat                                    Show outbound status
            stop <node> [node..node]                Stop polling node(s)

            <node>   Should be in domain form, e.g. f16.n2801.z2.domain
            <flavor> Flavor's are: crash | normal | hold
            Options are:

            -quiet                                  Quiet mode

###

DESCRIPTION

mbout is the outbound manager for MBSE BBS. It can ask information from the nodelists, create and remove polls, request files and display the outbound status. Most of the tasks such as create and remove polls should be done from the crontab.

###

ENVIRONMENT

In order to run mbout 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.

###

COMMANDS

mbout poll [node..node] creates poll requests in the outbound for one or more nodes. The semafore scanout is created so that the mailer script will start calling. The mailer will handle the poll request as if it should deliver crashmail, so the node will be called as long as the poll request exists. If the error counter is set for the node to poll the counter is reset to zero. If a call to a node is successfull, the poll file will be removed by mbcico

mbout stop [node..node] removes poll requests that are leftover when polling nodes didn't succeed.

mbout req <node> <file> [file..file] creates filerequests to a node. One or more filenames may be given including wildcards. It is not possible to do update or password protected uploads yet. If there is already a requestlist for that node, the new requests will be added. This command does not call a node, you need to create a poll request to make the actual call. This is also practical if you want some files from your uplink, just make the requests and the actual request is send when your normal scheduled poll to your uplink is processed.

mbout stat shows the status of the mailer outbound. This status is also written to the logfile.

###

OPTIONS

mbout [commands] -quiet will suppress screen output. This is usefull if you run mbout from the crontab or from background scripts.

###

BUGS

If you find any bugs, mispelled documentation etc, please contact the author: Michiel Broek at 2:2801/16@Fidonet or Michiel_Broek@f16.n2801.z2.fidonet.org

###

EXAMPLES

This is an example of crontab entries that writes the outbound status to the logfile and creates and stops polling of 2 nodes.

    00 00 * * * export MBSE_ROOT=/opt/mbse; $MBSE_ROOT/bin/mbout stat -quiet
    00 01 * * * export MBSE_ROOT=/opt/mbse; $MBSE_ROOT/bin/mbout poll f98.n100.z92 f0.n100.z92 -quiet
    00 02 * * * export MBSE_ROOT=/opt/mbse; $MBSE_ROOT/bin/mbout stop f99.n100.z92 f0.n100.z92 -quiet

Back to index Back to Main index