4.1 Configuration parameters

The patch you just applied adds support for three new configuration parameters you should add in the correct configuration file.

• IMAP_MAILDIR_CREATOR

  Specifies a script or a program to run when a maildir is not found by the imap daemon. The script is called with the missing maildir name as the first argument, and other parameters can be taken from the environment. This option should be put (in debian) in /etc/courier/imapd. In other distribution, the best place would be a configuration file, but if you can't find one, just put the variable in the environment before running courier (look the manual page for env and at the scripts in init.d). Example:

   
             IMAP_MAILDIR_CREATOR="/sbin/imapcreator" 
      
  

• POP3_MAILDIR_CREATOR

  Specifies a script or a program to run when a maildir is not found by the pop3 daemon. The script is called with the missing maildir name as the first argument, and other parameters can be taken from the environment. This option should be put (in debian) in /etc/courier/pop3d. In other distribution, the best place would be a configuration file, but if you can't find one, just put the variable in the environment before running courier (look the manual page for env and at the scripts in init.d). Example:

   
             POP3_MAILDIR_CREATOR="/sbin/pop3creator" 
      
  

  Watch out: Courier passes configuration parameters throught the environment. If you look at the scripts in /etc/init.d/ you'll see that while before loading the imap daemon all the parameters in the configuration file are loaded with export, sed and env, the pop3 initialization scripts export only a limited amount of parameters. You may find it usefull (It won't work otherwise) to put something like this in your /etc/init.d/courier-pop3 script, or in /usr/sbin/pop3d (it's a script):

              /usr/bin/env - POP3_MAILDIR_CREATOR="$POP3_MAILDIR_CREATOR" PATH="...
          
  

  and so on, instead of the usual (your is probably different):

             /usr/bin/env - PATH="$PATH" SHELL="$SHELL" POP3AUTH="$POP3AUTH" \
                  $TCPD -pid=$PIDFILE -stderrlogger=${sbindir}/courierlogger \
                                   -maxprocs=$MAXDAEMONS -maxperip=$MAXPERIP \
                                           $TCPDOPTS -address=$ADDRESS $PORT \
              ${prefix}/lib/courier/courier/courierpop3login $AUTHMODULELIST \
                            ${prefix}/lib/courier/courier/courierpop3d Maildir
          
  

• MOD_MAILDIR_CREATOR

  Specifies a script or a program to run when the home directory of the user is not found. For example, if you have an user called ``foo'', if ``/home/foo'' does not exist MOD_MAILDIR_CREATOR is called. POP3 or IMAP MAILDIR_CREATOR are called when ``/home/foo/Maildir'' does not exist. Example:

   
             MOD_MAILDIR_CREATOR="/sbin/modcreator" 
      
  

• MOD_MAILDIR_CREATOR
• either one of POP3_MAILDIR_CREATOR or IMAP_MAILDIR_CREATOR