The DPOP configuration settings:

Most configuration options for DPOP are held in a configuration file:
dmail.conf

to specify a different configuration file on startup use:

          dpop -i another/path/fred.conf

The initial settings in the configuration file are normally placed there by
the dmsetup wizard later you may modify them to fine tune your system or to
allow for changes to your system. The configuration file contains extensive
comments and can be edited using a standard text editor. Alternatively the
various setup wizards within DPOP Manager can be used to modify the
configuration file for you.

As some of the information stored in the configuration file may be
sensitive it should normally not have world read access. (The password for
limiting Tellpop manager commands may be stored there J )



The location for the configuration file is system dependent but typical
values are:

     for most Unix variations

        * /etc/dmail.conf

     for Windows 95 and NT

        * C:\winnt\system32\dmail.conf

Common Settings

authent_method          Authentication method. One of Netwin, Kerberos, APOP, Unix_User, NT_User
bin_path                Directory for per user work files (ie username.bin directories)
bulletin_path           Directory to contain bulletin messages of form nnn.txt
bulletin_from           Text to be sent as from line in all bulletins. Defualt is "Email System Administratordpop_host          The TCPIP address of the host dpop is running on
dpop_path               Installation directory for dpop
drop_path               Directory for the maildrop files
log_level               Logging level for errors. One of error, info, debug
lookup_names            Do we lookup ip names for checking valid connections - CAN BE SLOW
manager_ip_address      IP addresses manager commands can come from
manager_password        Password for valid manager commands (OBSOLETE after DPOP version 2.0)
pop_port                The port number pop3 clients will access
stats_path              Path for log of per connection usage statistics
user_ip_address         IP addresses user connections can come from
user_ip_name            Valid ip names user connections can come from
valid_users             Valid usernames to get their mail here
work_path               Directory for work files and log files

Obscure Settings

authent_cache           Number of authentication requests to cache, External authentication only.
authent_domain          Set true if you want user@domain passed to external authentication process
authent_number          Number of concurrent authentication processes to run
authent_process         Authentication process to run when using external authentication
authent_process /mypath/authent.exe
authent_timeout         Timeout for external authentication requests
bin_path                Path for user directories containing Bin and msg index files
bin_pfull               Criteria for compacting. bins with less than bin_pfull get compacted
check_gid               Set if gid for drop files should be checked. Default is no check
crlf_stored             Is cr and lf stored at end of lines on this system
drop_ext                Drop file extension. Default is none.
drop_kill               File related to drop file to remove after drop file has been burst
drop_type               Drop file/directory type (only mailbox is available at present)
drop_old                Process temporary files left by previous popper
drop_prefix             If true then the virtual domain prefix is used as part of path for drop files
drop_users              A wild card list of users who access there mail from pop3 AND unix command line
dwatch_path             DPOP writes a dpop.pid to this directory so that dwatch can monitor the server
hash_spool              Are the maildrop files hashed into directory in some way
log_path                Path for log file
log_status              Time between logging DPOP status to log file in mins
lowercase_username      If true DPOP will always set usernames to lowercase so that case is ignored.
lowercase_password      If true DPOP will always set passwords to lowercase so that case is ignored.
max_log_size            Max size, in bytes, for log file before renameing and starting new one
max_sessions            Limit on number of concurrent sessions connected at one time
msg_seperator           Message separator character if not defined then we don't use one
pop_timeout             How long we wait (in seconds) before assuming connection has gone
retr_chunk              Max bytes to send in one chunk for retrv command. Default is 10000
slave_number            DSlave processes for handling burst of large drop files
slave_burst_size        Burst drop files of this size or larger with a slave process
slave_timeout           Timeout for slave commands. Default 100 seconds
vdomain                 A list of virtual domain prefixes, ip numbers, virtual domains and drop paths
vdomain_seperator       Virtual Domain seperator

---------------------------------------------------------------------------

DPOP configuration settings

drop_prefix

     This setting determines how the drop file name is constructed
     when virtual domains are being used. Drop_prefix can be set to
     true or false. The default is true. When this setting is true the
     drop file name will include the virtual domain prefix. For
     example consider the case when the following vdomain line is
     being used and a user fred is connecting to abc.com which maps to
     ip number 1.2.3.4

        * vdomain abc 1.2.3.4 abc.com /mail/abc_com

     If drop_prefix is true the drop file used will be
     /mail/abc_com/abc_fred

     While if drop_prefix is false the drop file used will be
     /mail/abc_com/fred

     -----------------------------------------------------------------

pop_port

     The port number DPOP will accept POP3 client connections on. The
     default is 110. This can be set to something other than 110 for
     testing DPOP while leaving another pop server running on the
     normal POP3 port.

     Examples:
     pop_port 1100

     -----------------------------------------------------------------

dpop_host

     The TCPIP address of the host dpop is running on

     Examples:
     dpop_host me.my.ip.addrs

     -----------------------------------------------------------------

lookup_names

     Set true if DPOP should lookup ip names for checking valid
     connections - (CAN BE SLOW) The default is false.

     Examples:
     lookup_names    false

     -----------------------------------------------------------------

authentication_method

     The authentication method is one of the following

     Netwin    Netwins own style only used for testing
     NT_User   Windows NT Usernames and Passwords

     Unix_User Standard Unix usernames and password. With or without
               shadow password file
               An external user supplied program is used for
               authentication. May be used for adding special connection
     External  restrictions. For example email from laboratory computers
               only outside working hours. A sampe authent program is
               supplied with distribution set.

     Examples:
     authent_method   Netwin
     authent_method   External

     -----------------------------------------------------------------

dpop_path

     Specifies the installation directory for dpop. The manual and
     utility applications are stored here. The default for unix is
     /usr/local/dpop The default for NT is C:\dpop

     Examples:
     dpop_path   /path/for/dpop
     dpop_path   d:\network_apps\dpop

     -----------------------------------------------------------------

drop_path

     Specifies the directory for the maildrop files. These are the
     files that contain newly arrived mail messages for each user.
     Normally the drop file for a user Fred will be drop_path/Fred
     This file will be appended to each time a new message arrives.
     There is no default for the drop_path so a setting for it must be
     included in the dmail.conf file. A leading ~ can be used to
     signify the home directory and is replaced by the users home
     directory so ~/inmail might become /usr/local/ralph/inmail

     Examples:
     drop_path       ~/Mailbox                        might use /home/fred/Mailbox as fred's drop file
     drop_path       /var/spool/netmail               will use /var/spool/netwmail/fred as fred's drop file
     drop_path        c:\pop3\mail                     will use c:\pop3\mail\fred as fred's drop file

     -----------------------------------------------------------------

work_path

     This setting specifies the directory to be used for DPOP and
     DSMTP work files. By default log and useage statistics files are
     also stored here. The default for the work_path is the dpop_path

     Examples:
     work_path       drop_path                       will set it to same as drop_path
     work_path       /var/dmail                      is the normal setting on unix
     work_path        c:\mail\work                   might be used on an NT machine

     -----------------------------------------------------------------

bin_path

     This setting specifies the directory for per user work files.
     That is the username.bin sub directories. These contain bin files
     for processed messages and message index files. The bin_path
     defaults to the same as the work_path. It is often set to be the
     same as the drop_path. In this case a user with a drop file
     /var/mail/fred would have a bin directory /var/mail/fred.bin

     Examples:
     bin_path       drop_path
     bin_path       /usr/local/bins

     -----------------------------------------------------------------

log_level

     This setting determines what event information DPOP will record
     in its log files. Three settings are available; error, info and
     debug. The default log level is info.

      error  Only records errors in the log file

      info   Records informational messages and errors in the log file

             Records debugging messages in the log file. This can often
             help in determining the cause of unusual behaviour or the
      debug  reason a particular setting is not working as expected.
             However, it may slow down operation slightly and can produce
             large log files, so use sparingly.

     Example:
     log_level     debug

     -----------------------------------------------------------------

manager_ip_address

     A wildcard list of IP addresses manager commands can come from.
     Specified in Netwin wildcard format: (*-wild, !-NOT, separated by
     commas. NO SPACES ALLOWED). Often set to * as manager commands
     must also contain the manager password. When tellpop or the dmail
     manager package are used remotely a challenge-encrypted-password
     response sequence is used.

     Examples
     manager_ip_name      *
     manager_ip_name      *.fred
     manager_ip_address   161.29.2.*
     manager_ip_address   161.29.2.37

     -----------------------------------------------------------------

user_ip_address

     IP addresses user connections can come from. Specified using
     Netwin wildcard format: (*-wild, !-NOT, separated by commas. NO
     SPACES ALLOWED). The default setting allows connection from any
     ip address. Note this is only one of several ways of limiting
     access.

     Examples
     user_ip_address 130.123.*.*
     user_ip_address 130.123.24.*,!130.123.24.25
     user_ip_address 130.123.*.*
     user_ip_address *

     -----------------------------------------------------------------

user_ip_name

     Valid ip names user connections can come from. Specified in
     Netwin wildcard format: (*-wild, !-NOT, separated by commas. NO
     SPACES ALLOWED). The default setting allows connections from
     anyone. Note this is only one of several ways of limiting access.

     Examples
     user_ip_name     massey.ac.nz
     user_ip_name     massey.ac.nz,otago.ac.nz,fred.john.bill
     user_ip_name     *.ac.nz,bill.*.nz
     user_ip_name     *

     -----------------------------------------------------------------

valid_users

     Wildcard list of valid usernames. Only users whose usernames
     match will be able to connect to DPOP. The list is specified in
     Netwin wildcard format: (*-wild, !-NOT, separated by commas. NO
     SPACES ALLOWED)
     # default is anyone. Note this is only one of several ways of
     limiting access.

     Examples
     valid_users     *, !*smith*,fred,john,bill
     valid_users     *

     -----------------------------------------------------------------

stats_path

     Specifies the path for files containing a log of per connection
     usage statistics. One file is produced each day and they can be
     analysed and sumarised with the tellpop stats command. The
     default is to place these stats files in the dpop_path. If no
     stats records are required then a blank path can be specified.

     Examples:
     stats_path                                      implies don't log usage statistics
     #stats_path     c:\pop_stats                    place stats files in c:\pop_stats

     -----------------------------------------------------------------

manager_password

     Specifies the password to be used for manager commands. This
     setting is now obsolete (from DPOP 2.0) Use command tellpop
     password xyz instead. The password is no longer sent as clear
     text and is stored encrypted in a seperate file tellpass.dat

     Example:
     #manager_password xyz

     -----------------------------------------------------------------

msg_seperator

     Message separator character if not defined then we don't use one
     and depend on a blank line followed by a valid From line as a
     message separator. The format x\n for this setting implies that
     email message lines in the drop file which start with the
     character x will be stored as xxtext and that a line contain just
     the character x is used as a message seperator. For example the
     setting msg_seperator .\n would mean lines starting with a dot
     would be stored as ..line and a line containing just . woulc
     signify the end of a message.

     Examples:
     msg_seperator    .\n
     msg_seperator    |

     -----------------------------------------------------------------

pop_timeout

     How long we wait (in seconds) before assuming connection has
     gone. If this setting is too long then a session left running
     will prevent the user from connecting from elsewhere. If it is
     set too short then the connection could be terminated while the
     user is just thinking what to do next. The default setting is 600
     seconds or 10 minutes.

     Example:
     pop_timeout    1200

     -----------------------------------------------------------------

hash_spool

     Specifies how the maildrop file names are hashed into drop
     directories. Hashing is used to make up for unix slow linear
     directory search. This setting must match what is being used by
     the mail delivery system, in the case of DSMTP it will also read
     this setting and automatically match. The default setting is 0
     which implies no hashing. The available settings are:

     0 no hashing

     1 sum of first four characters of username    a/username to z/username
       modulo 26

     2 first two characters of username as         f/r/fred for user fred
       subdirectories
     -----------------------------------------------------------------

max_sessions

     This setting can be used to limit the number of concurrent POP
     users. The default setting is 200. The number of concurrent
     connections is sometimes limited by other factors such as the
     number of available file handles. DPOP needs several file_handles
     per connection and on some versions of unix file_handles per
     process are limited to 256. On NT and other versions of unix this
     limit may be many thousands.

     Examples:
     max_sessions    99

     -----------------------------------------------------------------

bin_pfull

     This setting controls the criteria for compacting message storage
     bin files. Files with less than bin_pfull bytes used / total size
     are compacted when a user connection is closed. The default
     setting is 0.5

     Examples:
     bin_pfull     0.9                         This would make compacting happen more often
     bin_pfull     0.1                         This would make compacting happen less often
     bin_pfull     0                           This would stop bins ever being compressed

     -----------------------------------------------------------------

crlf_stored

     This should be set true if cr and lf are normally stored at end
     of each line in a text file. DPOP will normally choose the
     correct default for the system it is running on. Thus the
     defaults is true for Windows NT and no for Unix. In some rare
     cases it may be necessary to use this setting explicitly

     Examples:
     crlf_stored    true
     crlf_stored    false

     -----------------------------------------------------------------

     Path for user directories containing Bin and msg index files
     each users bins and msg files are stored in a subdirectory
     /username.bin below this
     should normally be set to same place as work_path
     default is same as work_path
     bin_path work_path will set it to same as work_path
     bin_path drop_path will set it to same as drop_path
     bin_path path/for/binfiles

     -----------------------------------------------------------------

     Path for log file
     default is same as work_path
     log_path mypath/for/log/files/

     -----------------------------------------------------------------

     Number of concurrent authentication processes to run
     default is 1
     authent_number 5

     -----------------------------------------------------------------

     Authentication process to run
     authent_process /mypath/authent.exe

     -----------------------------------------------------------------

     Number of authentication requests to cache
     default min of max_users and 1000
     authent_cache 0 => no cacheing
     authent_cache 5000

     -----------------------------------------------------------------

     Drop file extension
     default is none
     drop_ext .mbx

     -----------------------------------------------------------------

     File related to drop file to kill
     On some systems some form of index has to be killed after a drop
     file has been processed
     For example for user Fred there may be a Fred.idx
     default is none
     drop_kill .idx will delete Fred.idx after processing drop file
     Fred

     -----------------------------------------------------------------

     Timeout for external authentication requests
     default 10 seconds
     authent_timeout 10

     -----------------------------------------------------------------

     Set if gid for drop files should be checked
     default is no check and set gid of drop files to gid for user (or
     gid for uid returned from authenticator)
     Note if check_gid is not entered protection is set to no group
     access
     check_gid mail would check group was mail and set group to mail
     check_gid netmail would check group was netmail and set group to
     netmail

     -----------------------------------------------------------------

     Drop file/directory type (NOT YET AVAILABLE)
     default is normal mailbox file
     drop_type maildir QMail style directory with messages in /new



     -----------------------------------------------------------------

     Process temporary files left by previous popper
     This normally only needs to be set for a short time after
     changeover to DPOP from some other popper
     default is no old temporary files to process
     Examples:
     drop_old .oldone
     Before processing drop file for user fred process fred.oldone
     drop_old .~.pop
     Before processing drop file for user fred process file .fred.pop

     -----------------------------------------------------------------

     Drop users
     A wild card list of users who access there mail from pop3 AND
     unix command line
     For these users we have to convet any undeleted mail back to a
     drop file
     after each connection
     This degrades POP3 performance for those users so use sparingly
     Note: This is not needed if they ONLY read mail from unix and
     never from POP
     default is noone
     Examples:
     drop_users unixman
     drop_users fred,john,bill
     drop_users uni*,JSmith
     drop_users billsmith

     -----------------------------------------------------------------

     Virtual Domain support
     A list of virtual domain prefixes, ip numbers, virtual domains
     and drop paths
     Allows different drop paths and username prefix strings to be
     specified for
     users connecting to different virtual domains based on IP number
     of username sufix
     See manual for details of setting up virtual domains for use with
     DSMTP and DPOP
     default is no virtual domains
     Multiple lines (one for each virtual domain) are required
     ~ can be used as first character of drop file path in the same
     way as it is used in a drop_path setting
     vdomain Astring 161.33.2.44 ast.netg.co.nz
     /var/spool/mail/domain1
     vdomain xyz 161.33.2.30 lnt.netg.co.nz /var/spool/domain2
     For virtual domains based on username sufix rather than ip number
     use format below
     vdomain Bstring /su lnt.netg.co.nz /var/spool/domain2

     -----------------------------------------------------------------

     Virtual Domain seperator
     the seperator for username/file domain prefix letter
     default is _
     so ralph from domain one becomes Astring_ralph
     and ralph from domain two becomes Bstring_ralph
     examples
     vdomain_seperator _
     vdomain_seperator /

     -----------------------------------------------------------------

     Want user@domain passed to external authentication process
     default is false
     authent_domain true

     -----------------------------------------------------------------

     Max size, in bytes, for log file before renameing and starting
     new one
     default is 3,000 kbytes
     max_log_size 3000000

     -----------------------------------------------------------------

     Max bytes to send in one chunk for retrv command
     default is 10000
     retr_chunk 5000

     -----------------------------------------------------------------

     Time between logging DPOP status to log file in mins
     default is 10 hourly (ie 600)
     log_status 120

     -----------------------------------------------------------------

     DSlave processes for handling burst of large drop files
     Number of slave processes to run
     default is 0
     slave_number 2

     -----------------------------------------------------------------

     Burst drop files of this size or larger with a slave process
     default 1000000
     slave_burst_size 10000000

     -----------------------------------------------------------------

     Timeout for slave commands
     default 100 seconds
     slave_timeout 123

     -----------------------------------------------------------------

     Lowercase username - ie always set usernames to lowercase so that
     case is ignored.
     default is false - ie username is case sensitive
     lowercase_username true

     -----------------------------------------------------------------

     Lowercase password - ie always set passwords to lowercase so that
     case is ignored.
     default is false - ie password is case sensitive
     lowercase_password true

     -----------------------------------------------------------------

     dwatch_path - dpop writes a dpop.pid to this directory so that
     dwatch can monitor
     dpop and restart it if necessary. dpop.wat in the same directory
     contains the relevant
     information on how to restart and how often etc. See dwatch
     documentation for more details
     default is dpop_path

     -----------------------------------------------------------------

     If authent_domain is true DPOP will send lookup user@domain to
     the external authentication process
     rather than just sending lookup user
     default is false
     for use of virtual domains with external authentication this
     needs to be set to true
     authent_domain true




