NAME

       prayer-session — Prayer user session backend daemon

SYNOPSIS

       prayer-session [--config-file file] [[--config-option name=value] ...] [--foreground]

DESCRIPTION

       prayer-session  is  the  backend  process in the Prayer Webmail system. A fresh prayer-session backend is
       forked off whenever a user logs in.

       This process contains all of the permanent state associated with that login session including one or more
       connections to a IMAP server and possibly connections to accountd  servers.  prayer-session  communicates
       with  the user using HTML over HTTP connections via the prayer(8) proxy. Each login has a session ID that
       the front end processes use to find the correct backend.

       Backend server processes move into a dormant state after a certain period of  inactivity,  shutting  down
       IMAP  and  accountd  connections which can be easily resuscitated when the session wakes up. After a long
       period of inactivity, typically several hours the session process shuts down.

       prayer-session accepts the following command-line options:

       --config-file file
               Reads configuration from file instead of the default /etc/prayer/prayer.cf.

       --config-option name=value
               Sets (overrides) the configuration option name to value.  Any number of options can be  specified
               in this manner.

       --foreground
               Debug mode. Run a single process in the foreground.

ENVIRONMENT

       PRAYER_CONFIG_FILE
               Can  be  set  to specify the configuration file to use. The --config-file option takes precedence
               over this variable.

       PRAYER_HOSTNAME
               Local hostname. Overrides the hostname setting in the  configuration  file  as  well  as  on  the
               command line.

FILES

       /usr/local/prayer/etc/prayer.cf
               Default configuration file.

       /usr/local/prayer/templates/
               Location  of  standard  templates. The templates are compiled into prayer-session for performance
               reasons, so the template files are actually not used, but they are available for customization.

SEE ALSO

       prayer(8), prayer.cf(5)

AUTHORS

       This manual page was put together by Magnus Holmgren <holmgren@debian.org> using documentation written by
       David Carter <dpc22@cam.ac.uk>.

The Prayer Webmail Interface                     17 August 2008                                PRAYER-SESSION(8)