source: server/mail/courier/courier-exp.xml@ 2f473b2

<sect2>
<title>Command explanations</title>

<para><parameter>--sysconfdir=/etc/courier</parameter>: Specifies the
directory where <application>Courier</application>'s configuration
files are installed.</para>

<para><parameter>--with-piddir=/var/run</parameter>: Specifies the
directory where <application>Courier</application>'s
<filename>PID</filename> files are stored
when <application>Courier</application> is active.</para>

<para><parameter>--libexecdir=/usr/lib/courier</parameter>: libexecdir contains 
programs and libraries that cannot be directly executed from the command-line.
</para>

<para><parameter>--datadir=/usr/share/courier</parameter>: Specifies the 
directory where miscellaneous shell scripts, <application>Perl</application> 
scripts, and data files will be installed.</para>

<para><parameter>--localstatedir=/var/spool/courier</parameter>: Specifies the 
directory that will hold the mail queue, and other temporary data. This option 
defaults to the subdirectory <filename class="directory">var</filename> in the 
directory specified by the <option>--prefix</option> option.</para>

<para><option>--with-paranoid-smtpext</option>:be paranoid when negotiating Courier-specific
ESMTP extensions with remote servers. The <application>Courier</application> mail server
defines and implements certain experimental ESMTP extensions: XVERP and XEXDATA. Problems may
result in the event that someone else uses the same name to implement some other extension.
If this option is specified, <application>Courier's</application> ESMTP server will also
advertise a dummy ESMTP capability called XCOURIEREXTENSIONS, and will not recognize any
Courier-specific extensions unless the remote mail server also advertises this dummy ESMTP
capability.</para>

<para><option>--disable-autorenamesent</option>: do not rename the Sent folder every month.
This option can also be controlled by the SQWEBMAIL_AUTORENAMESENT environment variable.</para>

<para><option>--disable-root-check</option>: Allows
<application>Courier</application> to be built as the root user.</para>

<para><parameter>--with-db=gbbm</parameter>:
<application>Courier</application> requires either the
<application><acronym>GDBM</acronym></application> or the
<application>DB</application> database library.
<application><acronym>GDBM</acronym></application> is used if both are present. This option forces the selection of the database library.
</para>

<!-- # Note - Courier will build fine with <xref linkend="db"/>, but all the database files
will not be created correctly -->

<para><parameter>--with-mailuser=courier</parameter>: All except two
<application>Courier</application> daemons run as a non-privileged
user. This option specifies the userid that
<application>Courier</application> will install and run as.</para>

<para><parameter>--with-mailgroup=courier</parameter>: like
<option>--with-mailuser</option>, but specifies the group
<acronym>ID</acronym>.</para>

<para><option>--enable-workarounds-for-imap-client-bugs</option>: there are several confirmed bugs in some
<acronym>IMAP</acronym> clients that do not properly implement the
<acronym>IMAP</acronym>4rev1 protocol. This option enables some workarounds for
those buggy <acronym>IMAP</acronym> clients. NOTE: make check will fail if this option is used. You should first configure
without this option, and if all post-configuration tests succeed, rerun configure with this option and recompile.</para>

<para><parameter>--with-ispell=/usr/bin/aspell</parameter>:
<application>Courier</application>'s webmail server can use spell checking, if
the aspell program is available. If configure finds ispell, spell checking is enabled. If aspell is not in the
current search path, use
<parameter>--with-ispell=<replaceable>program</replaceable></parameter> to 
explicitly set the location of <application>aspell</application>.</para>

</sect2>