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.

Handler's 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)