Dbmail.conf

NAME

       dbmail.conf - configuration file for DBMail, the Database Mailer.

SYNOPSIS

      There are 8 sections: DBMAIL, SMTP, LMTP, POP, IMAP, SIEVE, LDAP,
      DELIVERY. The default config file already has documentation for all of
      the settings.

DESCRIPTION

         [DBMAIL]
         # Database settings
         driver=pgsql            # Supported drivers are mysql, pgsql, sqlite.
         authdriver=sql          # Supported drivers are sql, ldap.
         host=                   # Host for database, set to localhost if database is on
                                 #   the same host as dbmail and you want to use a local
                                 #   socket for connecting.
         sqlport=                # If you want to use TCP/IP for connecting to the database,
                                 #   and have the database running on a non-standard port.
         sqlsocket=              # When using a local socket connection to the database, fill
                                 #   in the path to the socket here (e.g. /var/run/mysql.sock).
         user=dbmail             # Database username.
         pass=                   # Database password.
         db=dbmail               # Database name.
         table_prefix=dbmail_    # Table prefix. Defaults to "dbmail_" if not specified.
         encoding=utf8           # Encoding to match database/table encoding, e.g., latin1, utf8
         default_msg_encoding=utf8     # Default for messages without a known encoding, e.g., 
iso8859-1, utf8

         postmaster=             # Postmaster’s email address for use in bounce messages.
         sendmail=<a title="///usr/lib/w3m/cgi-bin/w3mman2html.cgi?sendmail">/usr/sbin/sendmail</a>   
# Sendmail executable for forwards, replies, notifies, vacations.
                                       # You may use pipes (|) in this command, for example:
                                       # dos2unix|<a title="///usr/lib/w3m/cgi-bin/w3mman2html.cgi? 
sendmail">/usr/sbin/sendmail</a>  will work well with Qmail.
                                       # You may use quotes (") for executables with unusual names.

         # The following items can be overridden in the service-specific sections.
         TRACE_SYSLOG=5          # Trace level to send to syslog. Default is 2 (messages, errors, 
fatals).
         TRACE_STDERR=2          # Trace level to send to stderr. Default is 0 (fatals).
         EFFECTIVE_USER=nobody   # Root privs are used to open a port, then privs
         EFFECTIVE_GROUP=nogroup #   are dropped down to the user/group specified here.
         BINDIP=*                # The IP address the services will bind to.
                                 #   Use * for all local interfaces.
                                 #   Use 127.0.0.1 for localhost only.
                                 #   Multiple addresses may be separated by commas.
                                 #   IPv6 addresses are not yet supported.
         NCHILDREN=2             # Default number of child processes to start.
         MAXCHILDREN=10          # Maximum number of child processes allowed.
         MINSPARECHILDREN=2      # Unused children to always have availale.
         MAXSPARECHILDREN=4      # Maximum unused children allowed to be active.
         MAXCONNECTS=10000       # Child process is restarted after handling this many connections.
         MAX_ERRORS=500          # Child process will restart after this many connection errors.
         TIMEOUT=300             # Idle time allowed before a connection is shut off.
         RESOLVE_IP=yes          # If yes, resolves IP addresses to DNS names when logging.
         log=/var/log/dbmail.log       # logfile for stdout messages
         error_log=/var/log/dbmail.err # logfile for stderr messages
         pid_directory=/var/run        # directory for storing PID files
         state_directory=/var/run      # directory for storing the daemon statefiles
         library_directory=/usr/lib/dbmail # directory for locating libraries

         [SMTP]
                                 # In fact, there isn’t anything here by default.

         [LMTP]
         PORT=24                 # Port to listen on.
         BANNER=Hello I am LMTP  # Override the LMTP banner to hide your DBMail version.

         [POP]
         PORT=110                # Port to listen on.
         POP_BEFORE_SMTP=no      # If yes, allows SMTP access from the host IP connecting by POP3.
         BANNER=Hello I am POP3  # Override the POP3 banner to hide your DBMail version.

         [IMAP]
         PORT=143                # Port to listen on.
         TIMEOUT=4000            # IMAP prefers a longer timeout than other services.
         IMAP_BEFORE_SMTP=no     # If yes, allows SMTP access from the host IP connecting by IMAP.
         BANNER=Hello I am IMAP  # Override the IMAP banner to hide your DBMail version.

         [SIEVE]
         PORT=2000               # Port to listen on.
         BANNER=Hello I am SIEVE # Override the ManageSieve banner to hide your DBMail version.

         [LDAP]
         PORT=389
         VERSION=3
         HOSTNAME=ldap
         BASE_DN=ou=People,dc=mydomain,dc=com
         BIND_DN=cn=admin,dc=mydomain,dc=com
         BIND_PW=password
         SCOPE=SubTree
         USER_OBJECTCLASS=top,account,dbmailUser
         FORW_OBJECTCLASS=top,account,dbmailForwardingAddress
         CN_STRING=uid
         FIELD_PASSWD=userPassword
         FIELD_UID=uid
         FIELD_NID=uidNumber
         MIN_NID=10000
         MAX_NID=15000
         FIELD_CID=gidNumber
         MIN_CID=10000
         MAX_CID=15000
         FIELD_MAIL=mail
         FIELD_QUOTA=mailQuota
         FIELD_FWDTARGET=mailForwardingAddress

         [DELIVERY]
         SIEVE=yes               # Run Sieve scripts as messages are delivered.
         SUBADDRESS=yes          # Use ’user+mailbox@domain’ format to deliver to a mailbox.
         SIEVE_VACATION=yes      # Turn on/off the Sieve Vacation extension.
         SIEVE_NOTIFY=no         # Turn on/off the Sieve Notify extension (not supported).
         SIEVE_DEBUG=no          # Turn on/off additional Sieve debugging.
         AUTO_NOTIFY=no          # Use the auto_notify table to send email notifications.
         AUTO_REPLY=no           # Use the auto_reply table to send away messages.
         #AUTO_NOTIFY_SUBJECT    # Defaults to "NEW MAIL NOTIFICATION"
         #AUTO_NOTIFY_SENDER     # Defaults to POSTMASTER from the DBMAIL section.

BUGS

      If you experience inexplicable problems with DBMail, please report the
      issue to the [1]<u>DBMail</u> <u>Bug</u> <u>Tracker</u>.

LICENSE

      DBMail and its components are distributed under the terms of the GNU
      General Public License. Copyrights are held variously by the authors
      listed below.

AUTHOR(S)

      DBMail is a collaborative effort among the core developers listed below
      and the tremendous help of the testers, patchers and bug hunters listed
      in the AUTHORS and THANKS files found in the DBMail source
      distribution.

         Eelco van Beek      Aaron Stone            Paul J Stevens
         Roel Rozendaal      Open Source Engineer   NFG Net Facilities Group BV
         Ilja Booij          Palo Alto, CA USA      <a href="http://www.nfg.nl">http://www.nfg.nl</a>
         IC&S                <a href="http://hydricacid.com">http://hydricacid.com</a>
         Koningsweg 4
         3582 GE Utrecht
         <a href="http://www.ic-s.nl">http://www.ic-s.nl</a>

REFERENCES

      1. DBMail Bug Tracker
         <a href="http://dbmail.org/index.php">http://dbmail.org/index.php</a>?page=bugs

                                 10/16/2007