Provided by: mbot_0.3-7_all bug

NAME

       mbot.conf —       mbot configuration file

SYNOPSIS

       mbot.conf

Description

       mbot.conf  is organized in sections where you can associate handlers to
       mails.

       When mbot receive a mail, it will search for a section  having  a  name
       which  match  the mail subject, then use the associated handler. So the
       name of the section  will  depend  on  the  subject  to  use,  and  the
       parameters  to  be  defined in this section will depend on the selected
       handler.

       Here is a list of available handlers:

       GoogleHandler
                 Used to perform some search with the well known search engine

       UrlHandler
                 This  one  allows to download some url and attach its content
                 to the return mail, with the mime type properly set.

       NewsHandler
                 You can also send some news (with images) to  mbot,  it  will
                 fill  your  database  with  it. Currently supported RDBMs are
                 PostgreSQL and MySQL, so you  will  have  to  choose  between
                 PgNewsHandler and MyNewsHandler.

       PipeHandler
                 This one will make mbot call an arbitrary given command!

Default and common options

       For each section we have a common option who’s:

       HANDLER   This option define for the current section which Handler will
                 be used.

       WHITE_LIST
                 Here we define which are the e-mail addresses allowed to  use
                 associated  Handler. Only e-mails are stored here, like this:
                 name@domain.tld. If no BLACKLIST is defined then  the  sender
                 MUST be in this list otherwise mail will be rejected

       BLACK_LIST
                 This list contains blocked emails. If sender is in this list,
                 mbot won’t be allowed to handle the request.   If  BLACK_LIST
                 exists but not WHITE_LIST then every sender who’s not in this
                 list will be allowed to use this Handler.  The format of  the
                 list  is: ["email@domain.tld", "email2@anotherdom.tld"]. It’s
                 the same as WHITE_LIST.

       Default options:

       MBOT_ADDRESS
                 Email address used in the response.

       LOG_LEVEL Here we tell the Logger which level we want to log to syslog.
                 Those  levels are, from lower to higher, emerg - alert - crit
                 - err - warning - notice - info - debug.

Handlers options
       GoogleHandler’s options:

                 HOST      This is the first for this Handler, it  define  the
                           host for the searching engine.

                 BASE_URL  Define  here the string that is usually used by the
                           searching engine.

       UrlHandler’s options:

                 MAILSIZE  This option define the maximum mail size while mbot
                           fetch  url,  sender  will  receive error message if
                           mail size exceed this value.

                 ATTSIZE   For each attachement we define a size behind  which
                           mbot will raise an error.

       NewsHandler’s options:

                 HOST      This is the FQDN for the database server.

                 DB        The name of the database.

                 DB_USER   Username to add entry into database.

                 NEWS_TBL  Name of the table used by the Handler.

                 NEWS_TBLSQ
                           Name  of  the  sequence  table used by the Handler.
                           Usually used with Postgres server’s.

                 ATTACH_PATH
                           Used if sender attach an image with  his  mail,  in
                           this  directory  mbot will resize image to store it
                           as normal and thumbnail size into database.

                 tnX and tnY
                           These are the options for thumbnail resizing.

                 SITE      This is a list in which mbot will select  the  site
                           according to the receiver email. It will be used to
                           feed the database.

                 PHOTO_TBL This option is optionnal, it will be used  only  if
                           you want to have pictures associated to news.

                 PHOTO_TBLSQ
                           Name  of the sequence table used by the Handler for
                           the  photo  table.   Usually  used  with   Postgres
                           server’s.

       Note that there is no option for PipeHandler.

Bugs

       Please report bugs to the authors.

See Also

       mbot(1)

Authors

       mbot  was  writen  by Dimitri Fontaine dim@tuxfamily.org and Christophe
       Truffier nah-ko@tuxfamily.org.

                                                                  mbot.conf(5)