*** empty log message ***
authorMatthew Mondor <mmondor@pulsar-zone.net>
Wed, 11 Aug 2004 14:57:24 +0000 (14:57 +0000)
committerMatthew Mondor <mmondor@pulsar-zone.net>
Wed, 11 Aug 2004 14:57:24 +0000 (14:57 +0000)
mmsoftware/mmmail/etc/mmsmtpd.conf
mmsoftware/mmmail/src/mmpop3d/mmpop3d.conf.5
mmsoftware/mmmail/src/mmsmtpd/mmsmtpd.conf.5

index 29b8339..e5f50ec 100644 (file)
@@ -1,4 +1,4 @@
-; $Id: mmsmtpd.conf,v 1.3 2003/06/04 06:00:16 mmondor Exp $
+; $Id: mmsmtpd.conf,v 1.4 2004/08/11 14:57:23 mmondor Exp $
 ;
 ; mmsmtpd configuration file (/etc/mmsmtpd.conf)
 ; and # are considered comments, and can happen at start or end of line.
@@ -20,6 +20,12 @@ ASYNC_PROCESSES      3
 ; Location of the path where to store our process ID
 PID_PATH       "/var/run/mmsmtpd.pid"
 ;
+; If using MMMAIL_FILE for file storage of message bodies rather than
+; MMMAIL_MYSQL, this specifies where mail box directories should be created
+; and messages stored in them. This should also work fine using NFS.
+;
+MAIL_DIR       "/var/mmmail-dir"
+;
 ; User mmsmtpd should run as
 USER           "mmmail"
 ; Groups process should be part of
index 0e2513e..5599f0d 100644 (file)
@@ -1,4 +1,4 @@
-.\" $Id: mmpop3d.conf.5,v 1.6 2004/05/05 23:59:57 mmondor Exp $
+.\" $Id: mmpop3d.conf.5,v 1.7 2004/08/11 14:57:23 mmondor Exp $
 .\"
 .\" Copyright (C) 2001-2004, Matthew Mondor
 .\" All rights reserved.
@@ -128,12 +128,17 @@ important to also include here the 'mmstat' group.
 On systems which are expected to operate under high load, serving a large
 number of connections simultaneously, it may be ideal to increase this
 variable.  This pre-allocates buffers using the
-.Xr mmlist 3
+.Xr mmpool 3
 library. For a system serving 64 connections, a suitable value may be 4. This
 feature will mostly cause noticeable speed increase on systems which do not
 provide very efficient memory allocators, such as glibc on Linux. The best
 is to perform various tests and evaluate the required number to use here.
 .Pp
+Note that this currently has little significance with the current
+implementation since scaling was enhanced. However, if it is known that a high
+number of connections are immediately expected at system launch time, it may
+be useful to immediately scale up the server using this parameter.
+.Pp
 .It Nm LOG_FACILITY Ar "facility"
 Syslog facility which should be used for error logging. Should normally be
 one of
index d484fa7..5844b85 100644 (file)
@@ -1,4 +1,4 @@
-.\" $Id: mmsmtpd.conf.5,v 1.8 2004/05/05 23:59:57 mmondor Exp $
+.\" $Id: mmsmtpd.conf.5,v 1.9 2004/08/11 14:57:24 mmondor Exp $
 .\"
 .\" Copyright (C) 2001-2004, Matthew Mondor
 .\" All rights reserved.
@@ -117,6 +117,30 @@ is called, if
 .Fa CHROOT_DIR
 was enabled.
 .Pp
+.It Nm MAIL_DIR Ar "file"
+If
+.Xr mmmail 8
+was compiled using
+.Nm -DMMMAIL_FILE
+instead of
+.Nm -DMMMAIL_MYSQL ,
+this specifies the directory under which all mail should be stored. The
+directories for the mail boxes will automatically be created as necessary,
+and messages will be stored, one per message, into the corresponding ones.
+Note that the user under which the
+.Xr mmsmtpd 8
+and
+.Xr mmpop3d 8
+processes run must have write access to this directory. In a typical install,
+the directory will be owned by the user running those, and will have the group
+set to the main group for that user, with a permissions mode of 0750.
+.Pp
+Note that using file storage for messages usually yields better performance
+than using SQL storage alone. Although SQL is still used to store
+corresponding mail entries, the file text/glob row of the mail table is what
+consists of a considerable performance bottleneck when many large messages
+exist in the database.
+.Pp
 .It Nm USER Ar "user"
 Unprivileged user server process should run as.
 .Pp
@@ -128,12 +152,20 @@ It is important to also include here the 'mmstat' group.
 On systems which are expected to operate under high load, serving a large
 number of connections simultaneously, it may be ideal to increase this
 variable.  This pre-allocates buffers using the
-.Xr mmlist 3
+.Xr mmpool 3
 library. For a system serving 64 connections, a suitable value may be 4. This
 feature will mostly cause noticeable speed increase on systems which do not
 provide very efficient memory allocators, such as glibc on Linux. The best
 is to perform various tests and evaluate the required number to use here.
 .Pp
+Note that with the new (current)
+.Xr mmpool 3
+implementation, this value now has little to no significance, because the
+system is especially made to automatically scale properly. This value will
+however still be useful to immediately scale up the system, in cases where a
+large number of connections are immediately expected when launching the
+system.
+.Pp
 .It Nm LOG_FACILITY Ar "facility"
 Syslog facility which should be used for error logging. Should normally be
 one of
@@ -395,6 +427,7 @@ The following defaults are used:
 ASYNC_PROCESSES         3
 CHROOT_DIR              ""
 PID_PATH                "/var/run/mmsmtpd.pid"
+MAIL_DIR                "/var/mmmail-dir"
 USER                    mmmail
 GROUPS                  mmmail,mmstat
 LOG_FACILITY            LOG_AUTHPRIV