mbot.conf(5)							File Formats Manual						      mbot.conf(5)

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  han-
       dler.

       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 thumb-
			   nail 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  data-
			   base.

		 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)