<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 99.2beta8 (1.42)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>4. sympa.conf parameters</TITLE>
<META NAME="description" CONTENT="4. sympa.conf parameters">
<META NAME="keywords" CONTENT="sympa">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="Generator" CONTENT="LaTeX2HTML v99.2beta8">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="sympa.css">
<LINK REL="next" HREF="node6.html">
<LINK REL="previous" HREF="node4.html">
<LINK REL="up" HREF="sympa.html">
<LINK REL="next" HREF="node6.html">
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#ffffff">
<!--Navigation Panel-->
<A NAME="tex2html452"
HREF="node6.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html446"
HREF="sympa.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html440"
HREF="node4.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html448"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html450"
HREF="node17.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html453"
HREF="node6.html">5. WWSympa</A>
<B> Up:</B> <A NAME="tex2html447"
HREF="sympa.html">Sympa Mailing Lists Management Software</A>
<B> Previous:</B> <A NAME="tex2html441"
HREF="node4.html">3. Installing Sympa</A>
  <B> <A NAME="tex2html449"
HREF="node1.html">Contents</A></B>
  <B> <A NAME="tex2html451"
HREF="node17.html">Index</A></B>
<BR>
<BR>
<!--End of Navigation Panel-->
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
<LI><A NAME="tex2html454"
HREF="node5.html#SECTION00510000000000000000">4.1 Site customization</A>
<UL>
<LI><A NAME="tex2html455"
HREF="node5.html#SECTION00511000000000000000">4.1.1 <TT>host</TT></A>
<LI><A NAME="tex2html456"
HREF="node5.html#SECTION00512000000000000000">4.1.2 <TT>email</TT></A>
<LI><A NAME="tex2html457"
HREF="node5.html#SECTION00513000000000000000">4.1.3 <TT>listmaster</TT></A>
<LI><A NAME="tex2html458"
HREF="node5.html#SECTION00514000000000000000">4.1.4 <TT>WWSympa_url</TT></A>
<LI><A NAME="tex2html459"
HREF="node5.html#SECTION00515000000000000000">4.1.5 <TT>cookie</TT></A>
<LI><A NAME="tex2html460"
HREF="node5.html#SECTION00516000000000000000">4.1.6 <TT>create_list</TT></A>
</UL>
<LI><A NAME="tex2html461"
HREF="node5.html#SECTION00520000000000000000">4.2 Directories</A>
<UL>
<LI><A NAME="tex2html462"
HREF="node5.html#SECTION00521000000000000000">4.2.1 <TT>home</TT></A>
<LI><A NAME="tex2html463"
HREF="node5.html#SECTION00522000000000000000">4.2.2 <TT>etc</TT></A>
</UL>
<LI><A NAME="tex2html464"
HREF="node5.html#SECTION00530000000000000000">4.3 System related</A>
<UL>
<LI><A NAME="tex2html465"
HREF="node5.html#SECTION00531000000000000000">4.3.1 <TT>syslog</TT></A>
<LI><A NAME="tex2html466"
HREF="node5.html#SECTION00532000000000000000">4.3.2 <TT>log_socket_type</TT></A>
<LI><A NAME="tex2html467"
HREF="node5.html#SECTION00533000000000000000">4.3.3 <TT>pidfile</TT></A>
<LI><A NAME="tex2html468"
HREF="node5.html#SECTION00534000000000000000">4.3.4 <TT>umask</TT></A>
</UL>
<LI><A NAME="tex2html469"
HREF="node5.html#SECTION00540000000000000000">4.4 Sending related</A>
<UL>
<LI><A NAME="tex2html470"
HREF="node5.html#SECTION00541000000000000000">4.4.1 <TT>maxsmtp</TT></A>
<LI><A NAME="tex2html471"
HREF="node5.html#SECTION00542000000000000000">4.4.2 <TT>max_size</TT></A>
<LI><A NAME="tex2html472"
HREF="node5.html#SECTION00543000000000000000">4.4.3 <TT>nrcpt</TT></A>
<LI><A NAME="tex2html473"
HREF="node5.html#SECTION00544000000000000000">4.4.4 <TT>avg</TT></A>
<LI><A NAME="tex2html474"
HREF="node5.html#SECTION00545000000000000000">4.4.5 <TT>sendmail</TT></A>
<LI><A NAME="tex2html475"
HREF="node5.html#SECTION00546000000000000000">4.4.6 <TT>rfc2369_header_fields</TT></A>
<LI><A NAME="tex2html476"
HREF="node5.html#SECTION00547000000000000000">4.4.7 <TT>remove_headers</TT></A>
</UL>
<LI><A NAME="tex2html477"
HREF="node5.html#SECTION00550000000000000000">4.5 Spool related</A>
<UL>
<LI><A NAME="tex2html478"
HREF="node5.html#SECTION00551000000000000000">4.5.1 <TT>spool</TT></A>
<LI><A NAME="tex2html479"
HREF="node5.html#SECTION00552000000000000000">4.5.2 <TT>queue</TT></A>
<LI><A NAME="tex2html480"
HREF="node5.html#SECTION00553000000000000000">4.5.3 <TT>queuemod</TT></A>
<LI><A NAME="tex2html481"
HREF="node5.html#SECTION00554000000000000000">4.5.4 <TT>queuedigest</TT></A>
<LI><A NAME="tex2html482"
HREF="node5.html#SECTION00555000000000000000">4.5.5 <TT>queueexpire</TT></A>
<LI><A NAME="tex2html483"
HREF="node5.html#SECTION00556000000000000000">4.5.6 <TT>queueauth</TT></A>
<LI><A NAME="tex2html484"
HREF="node5.html#SECTION00557000000000000000">4.5.7 <TT>queueoutgoing</TT></A>
<LI><A NAME="tex2html485"
HREF="node5.html#SECTION00558000000000000000">4.5.8 <TT>queuebounce</TT></A>
<LI><A NAME="tex2html486"
HREF="node5.html#SECTION00559000000000000000">4.5.9 <TT>tmpdir</TT></A>
<LI><A NAME="tex2html487"
HREF="node5.html#SECTION005510000000000000000">4.5.10 <TT>sleep</TT></A>
<LI><A NAME="tex2html488"
HREF="node5.html#SECTION005511000000000000000">4.5.11 <TT>clean_delay_queue</TT></A>
<LI><A NAME="tex2html489"
HREF="node5.html#SECTION005512000000000000000">4.5.12 <TT>clean_delay_queuemod</TT></A>
<LI><A NAME="tex2html490"
HREF="node5.html#SECTION005513000000000000000">4.5.13 <TT>clean_delay_queueauth</TT></A>
</UL>
<LI><A NAME="tex2html491"
HREF="node5.html#SECTION00560000000000000000">4.6 Internationalization related</A>
<UL>
<LI><A NAME="tex2html492"
HREF="node5.html#SECTION00561000000000000000">4.6.1 <TT>msgcat</TT></A>
<LI><A NAME="tex2html493"
HREF="node5.html#SECTION00562000000000000000">4.6.2 <TT>lang</TT></A>
</UL>
<LI><A NAME="tex2html494"
HREF="node5.html#SECTION00570000000000000000">4.7 Bounce related</A>
<UL>
<LI><A NAME="tex2html495"
HREF="node5.html#SECTION00571000000000000000">4.7.1 <TT>bounce_warn_rate</TT></A>
<LI><A NAME="tex2html496"
HREF="node5.html#SECTION00572000000000000000">4.7.2 <TT>bounce_halt_rate</TT></A>
<LI><A NAME="tex2html497"
HREF="node5.html#SECTION00573000000000000000">4.7.3 <TT>welcome_return_path</TT></A>
<LI><A NAME="tex2html498"
HREF="node5.html#SECTION00574000000000000000">4.7.4 <TT>remind_return_path</TT></A>
</UL>
<LI><A NAME="tex2html499"
HREF="node5.html#SECTION00580000000000000000">4.8 Priority related</A>
<UL>
<LI><A NAME="tex2html500"
HREF="node5.html#SECTION00581000000000000000">4.8.1 <TT>sympa_priority</TT></A>
<LI><A NAME="tex2html501"
HREF="node5.html#SECTION00582000000000000000">4.8.2 <TT>request_priority</TT></A>
<LI><A NAME="tex2html502"
HREF="node5.html#SECTION00583000000000000000">4.8.3 <TT>owner_priority</TT></A>
<LI><A NAME="tex2html503"
HREF="node5.html#SECTION00584000000000000000">4.8.4 <TT>default_list_priority</TT></A>
</UL>
<LI><A NAME="tex2html504"
HREF="node5.html#SECTION00590000000000000000">4.9 Database related</A>
<UL>
<LI><A NAME="tex2html505"
HREF="node5.html#SECTION00591000000000000000">4.9.1 <TT>db_type</TT></A>
<LI><A NAME="tex2html506"
HREF="node5.html#SECTION00592000000000000000">4.9.2 <TT>db_name</TT></A>
<LI><A NAME="tex2html507"
HREF="node5.html#SECTION00593000000000000000">4.9.3 <TT>db_host</TT></A>
<LI><A NAME="tex2html508"
HREF="node5.html#SECTION00594000000000000000">4.9.4 <TT>db_user</TT></A>
<LI><A NAME="tex2html509"
HREF="node5.html#SECTION00595000000000000000">4.9.5 <TT>db_passwd</TT></A>
</UL>
<LI><A NAME="tex2html510"
HREF="node5.html#SECTION005100000000000000000">4.10 Loop prevention</A>
<UL>
<LI><A NAME="tex2html511"
HREF="node5.html#SECTION005101000000000000000">4.10.1 <TT>loop_command_max</TT></A>
<LI><A NAME="tex2html512"
HREF="node5.html#SECTION005102000000000000000">4.10.2 <TT>loop_command_sampling_delay</TT></A>
<LI><A NAME="tex2html513"
HREF="node5.html#SECTION005103000000000000000">4.10.3 <TT>loop_command_decrease_factor</TT></A>
</UL>
<LI><A NAME="tex2html514"
HREF="node5.html#SECTION005110000000000000000">4.11 S/MIME configuration</A>
<UL>
<LI><A NAME="tex2html515"
HREF="node5.html#SECTION005111000000000000000">4.11.1 <TT>openSSL</TT></A>
<LI><A NAME="tex2html516"
HREF="node5.html#SECTION005112000000000000000">4.11.2 <TT>trusted_ca_options</TT></A>
<LI><A NAME="tex2html517"
HREF="node5.html#SECTION005113000000000000000">4.11.3 <TT>key_passwd</TT></A>
</UL>
<LI><A NAME="tex2html518"
HREF="node5.html#SECTION005120000000000000000">4.12 Antivirus plug-in</A>
<UL>
<LI><A NAME="tex2html519"
HREF="node5.html#SECTION005121000000000000000">4.12.1 <TT>antivirus_path</TT></A>
<LI><A NAME="tex2html520"
HREF="node5.html#SECTION005122000000000000000">4.12.2 <TT>antivirus_args</TT></A>
</UL></UL>
<!--End of Table of Child-Links-->
<HR>
<H1><A NAME="SECTION00500000000000000000"></A>
<A NAME="exp-admin"></A> <A NAME="432"></A>
<A NAME="433"></A>
<BR>
4. sympa.conf parameters
</H1>
<P>
The <A NAME="3094"></A><TT>/etc/sympa.conf</TT> configuration file contains numerous
parameters which are read on start-up of <I>Sympa</I>. If you change this file, do not forget
that you will need to restart <I>Sympa</I> afterwards.
<P>
The <A NAME="3099"></A><TT>/etc/sympa.conf</TT> file contains directives in the following
format:
<P>
<BLOCKQUOTE>
<I>keyword value</I>
</BLOCKQUOTE>
<P>
Comments start with the <TT>#</TT> character at the beginning of
a line. Empty lines are also considered as comments and are ignored.
There should only be one directive per line, but their order in
the file is of no importance.
<P>
<H1><A NAME="SECTION00510000000000000000">
4.1 Site customization</A>
</H1>
<P>
<H2><A NAME="SECTION00511000000000000000"></A><A NAME="3102"></A>
<BR>
4.1.1 <TT>host</TT>
</H2>
<P>
This keyword is <B>mandatory</B>. It is the domain name
used in the <A NAME="3105"></A><TT>From:</TT> header in replies to administrative requests.
<P>
Example: <TT>host listhost.cru.fr</TT>
<P>
<H2><A NAME="SECTION00512000000000000000"></A><A NAME="3109"></A>
<BR>
4.1.2 <TT>email</TT>
</H2>
<P>
(Default value: <TT>sympa</TT>)
<P>
Username (the part of the address preceding the <TT>@</TT> sign) used
in the <A NAME="3113"></A><TT>From:</TT> header in replies to administrative requests.
<P>
Example: <TT>email listserv</TT>
<P>
<H2><A NAME="SECTION00513000000000000000"></A><A NAME="3117"></A>
<BR>
4.1.3 <TT>listmaster</TT>
</H2>
<P>
The list of e-mail addresses of listmasters (users authorized to perform
global server commands).
<P>
Example: <TT>listmaster postmaster@cru.fr,root@home.cru.fr</TT>
<P>
<H2><A NAME="SECTION00514000000000000000"></A><A NAME="3121"></A>
<BR>
4.1.4 <TT>WWSympa_url</TT>
</H2>
<P>
(Default value: <TT>http://<host>/wws</TT>)
<P>
This is the root URL of <A NAME="3125"></A><I>WWSympa</I>.
<P>
Example: <TT>WWSympa_url https://my.server/wws</TT>
<P>
<H2><A NAME="SECTION00515000000000000000"></A><A NAME="3129"></A>
<BR>
4.1.5 <TT>cookie</TT>
</H2>
<P>
This string is used to generate MD5 authentication keys.
It allows generated authentication keys to differ from one
site to another. It is also used for reversible encryption of
user passwords stored in the database. The presence of this string
is one reason why access to <A NAME="3132"></A><TT>sympa.conf</TT> needs to be restricted
to the Sympa user.
<P>
Note that changing this parameter will break all
http cookies stored in users' browsers, as well as all user passwords.
<P>
Example: <TT>cookie gh869jku5</TT>
<P>
<H2><A NAME="SECTION00516000000000000000"></A><A NAME="3136"></A>
<BR>
4.1.6 <TT>create_list</TT>
</H2>
<P>
(Default value: <TT>listmaster</TT>)
<P>
Defines who can create lists (or request list creations).
Sympa will use the corresponding scenario.
<P>
Example: <TT>create_list intranet</TT>
<P>
<H1><A NAME="SECTION00520000000000000000">
4.2 Directories</A>
</H1>
<P>
<H2><A NAME="SECTION00521000000000000000"></A><A NAME="3141"></A>
<BR>
4.2.1 <TT>home</TT>
</H2>
<P>
(Default value: <TT><A NAME="3146"></A><TT>~sympa/expl</TT></TT>)
<P>
The directory whose subdirectories correspond to the different lists.
<P>
Example: <TT>home /home/sympa/expl</TT>
<P>
<H2><A NAME="SECTION00522000000000000000"></A><A NAME="3152"></A>
<BR>
4.2.2 <TT>etc</TT>
</H2>
<P>
(Default value: <TT><A NAME="3157"></A><TT>~sympa/etc</TT></TT>)
<P>
This is the local directory for configuration files (such as
<A NAME="3162"></A><TT>edit_list.conf</TT>. It contains 3 subdirectories:
<A NAME="3165"></A><TT>scenari</TT> for local scenarii; <A NAME="3168"></A><TT>templates</TT>
for the site's local templates and default list templates; and <A NAME="3171"></A><TT>wws_templates</TT>
for the site's local html templates.
<P>
Example: <TT>home /home/sympa/etc</TT>
<P>
<H1><A NAME="SECTION00530000000000000000">
4.3 System related</A>
</H1>
<P>
<H2><A NAME="SECTION00531000000000000000"></A><A NAME="3175"></A>
<BR>
4.3.1 <TT>syslog</TT>
</H2>
<P>
(Default value: <TT>LOCAL1</TT>)
<P>
Name of the sub-system (facility) for logging messages.
<P>
Example: <TT>syslog LOCAL2</TT>
<P>
<H2><A NAME="SECTION00532000000000000000"></A><A NAME="3180"></A>
<A NAME="par-log-socket-type"></A>
<BR>
4.3.2 <TT>log_socket_type</TT>
</H2>
<P>
(Default value: <TT>inet</TT>)
<P>
<I>Sympa</I> communicates with <A NAME="3185"></A><TT>syslogd</TT>
using either UDP or UNIX sockets. Set <A NAME="3188"></A><TT>log_socket_type</TT> to <TT>inet</TT> to use UDP, or <TT>unix</TT> for UNIX sockets.
<P>
<H2><A NAME="SECTION00533000000000000000"></A><A NAME="3191"></A>
<BR>
4.3.3 <TT>pidfile</TT>
</H2>
<P>
(Default value: <TT><A NAME="3196"></A><TT>~sympa/sympa.pid</TT></TT>)
<P>
The file where the <A NAME="3201"></A><TT>sympa.pl</TT> daemon stores its
process number. Warning: the <TT>sympa</TT> user must be
able to write to this file, and to create it if it doesn't
exist.
<P>
Example: <TT>pidfile /var/run/sympa.pid</TT>
<P>
<H2><A NAME="SECTION00534000000000000000"></A><A NAME="3205"></A>
<BR>
4.3.4 <TT>umask</TT>
</H2>
<P>
(Default value: <TT>027</TT>)
<P>
Default mask for file creation (see <A NAME="3209"></A><TT>umask</TT>(2)).
<P>
Example: <TT>umask 007</TT>
<P>
<H1><A NAME="SECTION00540000000000000000">
4.4 Sending related</A>
</H1>
<P>
<H2><A NAME="SECTION00541000000000000000"></A><A NAME="3213"></A>
<BR>
4.4.1 <TT>maxsmtp</TT>
</H2>
<P>
(Default value: <TT>20</TT>)
<P>
Maximum number of SMTP delivery child processes spawned
by <I>Sympa</I>. This is the main load control parameter.
<P>
Example: <TT>maxsmtp 500</TT>
<P>
<H2><A NAME="SECTION00542000000000000000"></A><A NAME="3219"></A>
<BR>
4.4.2 <TT>max_size</TT>
</H2>
<P>
(Default value: <TT>5 Mb</TT>)
<P>
Maximum size allowed for messages distributed by <I>Sympa</I>.
This may be customized per list by setting the <A NAME="3224"></A><TT>max_size</TT>
list parameter.
<P>
Example: <TT>max_size 2097152</TT>
<P>
<H2><A NAME="SECTION00543000000000000000"></A><A NAME="3228"></A>
<BR>
4.4.3 <TT>nrcpt</TT>
</H2>
<P>
(Default value: <TT>25</TT>)
<P>
Maximum number of recipients per <A NAME="3232"></A><TT>sendmail</TT> call.
This grouping factor makes it possible for the (<A NAME="3235"></A><TT>sendmail</TT>) MTA to optimize the number of SMTP sessions for
message distribution.
<P>
<H2><A NAME="SECTION00544000000000000000"></A><A NAME="3238"></A>
<BR>
4.4.4 <TT>avg</TT>
</H2>
<P>
(Default value: <TT>10</TT>)
<P>
Maximum number of different internet domains within addresses per
<A NAME="3242"></A><TT>sendmail</TT> call.
<P>
<H2><A NAME="SECTION00545000000000000000"></A><A NAME="3245"></A>
<BR>
4.4.5 <TT>sendmail</TT>
</H2>
<P>
(Default value: <TT>/usr/sbin/sendmail</TT>)
<P>
Absolute call path to SMTP message transfer agent (<A NAME="3249"></A><TT>sendmail</TT> for example).
<P>
Example: <TT>sendmail /usr/sbin/sendmail</TT>
<P>
<H2><A NAME="SECTION00546000000000000000"></A><A NAME="3253"></A>
<BR>
4.4.6 <TT>rfc2369_header_fields</TT>
</H2>
<P>
(Default value: <TT>help,subscribe,unsubscribe,post,owner,archive</TT>)
<P>
RFC2369 compliant header fields (List-xxx) to be added to
distributed messages. These header-fields should be implemented
by MUA's, adding menus.
<P>
<H2><A NAME="SECTION00547000000000000000"></A><A NAME="3257"></A>
<BR>
4.4.7 <TT>remove_headers</TT>
</H2>
<P>
(Default value: <TT>Return-Receipt-To,Precedence,X-Sequence,Disposition-Notification-To</TT>)
<P>
This is the list of headers that <I>Sympa</I> should remove from
outgoing messages. Use it, for example, to ensure some privacy
for your users by discarding anonymous options.
It is (for the moment) site-wide. It is applied before the
<I>Sympa</I>, rfc2369_header_fields, and custom_header fields are
added.
<P>
Example: <TT>remove_headers Resent-Date,Resent-From,Resent-To,Resent-Message-Id,Sender,Delivered-To,Return-Receipt-To,Precedence,X-Sequence,Disposition-Notification-To</TT>
<P>
<H1><A NAME="SECTION00550000000000000000"></A>
<A NAME="spool-related"></A>
<BR>
4.5 Spool related
</H1>
<P>
<H2><A NAME="SECTION00551000000000000000"></A><A NAME="3264"></A>
<BR>
4.5.1 <TT>spool</TT>
</H2>
<P>
(Default value: <TT><A NAME="3269"></A><TT>~sympa/spool</TT></TT>)
<P>
The parent directory which contains all the other spools.
<P>
<H2><A NAME="SECTION00552000000000000000"></A><A NAME="3274"></A>
<BR>
4.5.2 <TT>queue</TT>
</H2>
<P>
The absolute path of the directory which contains the queue, used both by the
<A NAME="3277"></A><TT>queue</TT> program and the <A NAME="3280"></A><TT>sympa.pl</TT> daemon. This
parameter is mandatory.
<P>
Example: <TT>queue /home/sympa/queue</TT>
<P>
<H2><A NAME="SECTION00553000000000000000"></A><A NAME="3284"></A>
<A NAME="cf:queuemod"></A> <A NAME="528"></A>
<BR>
4.5.3 <TT>queuemod</TT>
</H2>
<P>
(Default value: <TT><A NAME="3289"></A><TT>~sympa/spool/moderation</TT></TT>)
<P>
This parameter is optional and retained solely for backward compatibility.
<P>
<H2><A NAME="SECTION00554000000000000000"></A><A NAME="3294"></A>
<A NAME="531"></A>
<A NAME="532"></A>
<BR>
4.5.4 <TT>queuedigest</TT>
</H2>
<P>
(Default value: <TT><A NAME="3299"></A><TT>~digest</TT></TT>)
<P>
This parameter is optional and retained solely for backward compatibility.
<P>
<H2><A NAME="SECTION00555000000000000000"></A><A NAME="3304"></A>
<BR>
4.5.5 <TT>queueexpire</TT>
</H2>
<P>
(Default value: <TT><A NAME="3309"></A><TT>~sympa/spool/expire</TT></TT>)
<P>
This parameter is optional and retained solely for backward compatibility.
<P>
<H2><A NAME="SECTION00556000000000000000"></A><A NAME="3314"></A>
<BR>
4.5.6 <TT>queueauth</TT>
</H2>
<P>
(Default value: <TT><A NAME="3319"></A><TT>~sympa/spool/auth</TT></TT>)
<P>
This parameter is optional and retained solely for backward compatibility.
<P>
<H2><A NAME="SECTION00557000000000000000"></A><A NAME="3324"></A>
<BR>
4.5.7 <TT>queueoutgoing</TT>
</H2>
<P>
(Default value: <TT><A NAME="3329"></A><TT>~sympa/spool/outgoing</TT></TT>)
<P>
This parameter is optional and retained solely for backward compatibility.
<P>
<H2><A NAME="SECTION00558000000000000000"></A><A NAME="3334"></A>
<A NAME="541"></A>
<BR>
4.5.8 <TT>queuebounce</TT>
</H2>
<P>
(Default value: <TT><A NAME="3339"></A><TT>~sympa/spool/bounce</TT></TT>)
<P>
Spool to store bounces (non-delivery reports) received by the <A NAME="3344"></A><TT>bouncequeue</TT>
program via the mylist-owner or bounce+* addresses . This parameter is mandatory
and must be an absolute path.
<P>
<H2><A NAME="SECTION00559000000000000000"></A><A NAME="3347"></A>
<BR>
4.5.9 <TT>tmpdir</TT>
</H2>
<P>
(Default value: <TT><A NAME="3352"></A><TT>~sympa/spool/tmpdir</TT></TT>)
<P>
Temporary directory used by OpenSSL and antiviruses.
<P>
<H2><A NAME="SECTION005510000000000000000"></A><A NAME="3357"></A>
<A NAME="kw-sleep"></A>
<BR>
4.5.10 <TT>sleep</TT>
</H2>
<P>
(Default value: <TT>5</TT>)
<P>
Waiting period (in seconds) between each scan of the main queue.
Never set this value to 0!
<P>
<H2><A NAME="SECTION005511000000000000000"></A><A NAME="3361"></A>
<BR>
4.5.11 <TT>clean_delay_queue</TT>
</H2>
<P>
(Default value: <TT>1</TT>)
<P>
Retention period (in days) for ``bad'' messages in
<A NAME="3365"></A>spool (as specified by <A NAME="3366"></A><TT>queue</TT>).
<I>Sympa</I> keeps messages rejected for various reasons (badly
formatted, looping, etc.) in
this directory, with a name prefixed by <TT>BAD</TT>.
This configuration variable controls the number of days
these messages are kept.
<P>
Example: <TT>clean_delay_queue 3</TT>
<P>
<H2><A NAME="SECTION005512000000000000000"></A><A NAME="3371"></A>
<BR>
4.5.12 <TT>clean_delay_queuemod</TT>
</H2>
<P>
(Default value: <TT>10</TT>)
<P>
Expiration delay (in days) in the <A NAME="3375"></A>moderation
<A NAME="3376"></A>spool (as specified by <A NAME="3377"></A><TT>queuemod</TT>).
Beyond this deadline, messages that have not been processed
are deleted. For moderated lists, the contents of this spool
can be consulted using a key along with the <A NAME="3380"></A><TT>MODINDEX</TT> command.
<P>
<H2><A NAME="SECTION005513000000000000000"></A><A NAME="3383"></A>
<BR>
4.5.13 <TT>clean_delay_queueauth</TT>
</H2>
<P>
(Default value: <TT>3</TT>)
<P>
Expiration delay (in days) in the <A NAME="3387"></A>authentication
queue. Beyond this deadline, messages not enabled are
deleted.
<P>
<H1><A NAME="SECTION00560000000000000000">
4.6 Internationalization related</A>
</H1>
<P>
<H2><A NAME="SECTION00561000000000000000"></A><A NAME="3388"></A>
<BR>
4.6.1 <TT>msgcat</TT>
</H2>
<P>
(Default value: <TT><A NAME="3393"></A><TT>~sympa/nls</TT></TT>)
<P>
The location of multilingual (nls) catalog files. Must correspond to
<A NAME="3398"></A><TT>~src/nls/Makefile</TT>.
<P>
<H2><A NAME="SECTION00562000000000000000"></A><A NAME="3403"></A>
<BR>
4.6.2 <TT>lang</TT>
</H2>
<P>
(Default value: <TT>us</TT>)
<P>
This is the default language for <I>Sympa</I>. The message
catalog (.cat) located in the corresponding <A NAME="3408"></A><TT>msgcat</TT> directory
will be used.
<P>
<H1><A NAME="SECTION00570000000000000000">
4.7 Bounce related</A>
</H1>
<P>
<H2><A NAME="SECTION00571000000000000000"></A><A NAME="3411"></A>
<A NAME="kw-bounce-warn-rate"></A>
<BR>
4.7.1 <TT>bounce_warn_rate</TT>
</H2>
<P>
(Default value: <TT>30</TT>)
<P>
Site default value for <A NAME="3415"></A><TT>bounce</TT>.
The list owner receives a warning whenever a message is distributed and
the number of bounces exceeds this value.
<P>
<H2><A NAME="SECTION00572000000000000000"></A><A NAME="3418"></A>
<A NAME="kw-bounce-halt-rate"></A>
<BR>
4.7.2 <TT>bounce_halt_rate</TT>
</H2>
<P>
(Default value: <TT>50</TT>)
<P>
<TT>FOR FUTURE USE</TT>
<P>
Site default value for <A NAME="3422"></A><TT>bounce</TT>.
Messages will cease to be distributed if the number of bounces exceeds this value.
<P>
<H2><A NAME="SECTION00573000000000000000"></A><A NAME="3425"></A>
<A NAME="kw-welcome-return-path"></A>
<BR>
4.7.3 <TT>welcome_return_path</TT>
</H2>
<P>
(Default value: <TT>owner</TT>)
<P>
If set to string <TT>unique</TT>, sympa will use a unique e-mail address in the
return path, prefixed by <TT>bounce+</TT>, in order to remove the corresponding
subscriber. Requires the <TT>bounced</TT> daemon, and plussed aliases (as in
sendmail 8.7 and later).
<P>
<H2><A NAME="SECTION00574000000000000000"></A><A NAME="3429"></A>
<A NAME="kw-remind-return-path"></A>
<BR>
4.7.4 <TT>remind_return_path</TT>
</H2>
<P>
(Default value: <TT>owner</TT>)
<P>
Like <A NAME="3433"></A><TT>welcome_return_path</TT>, but relates to the remind message.
<P>
<H1><A NAME="SECTION00580000000000000000">
4.8 Priority related</A>
</H1>
<P>
<H2><A NAME="SECTION00581000000000000000"></A><A NAME="3436"></A>
<A NAME="kw-sympa-priority"></A>
<BR>
4.8.1 <TT>sympa_priority</TT>
</H2>
<P>
(Default value: <TT>1</TT>)
<P>
Priority applied to <I>Sympa</I> commands while running the spool.
<P>
Available since release 2.3.1.
<P>
<H2><A NAME="SECTION00582000000000000000"></A><A NAME="3441"></A>
<A NAME="kw-request-priority"></A>
<BR>
4.8.2 <TT>request_priority</TT>
</H2>
<P>
(Default value: <TT>0</TT>)
<P>
Priority for processing of messages for mylist-request,
i.e. for owners of the list.
<P>
Available since release 2.3.3
<P>
<H2><A NAME="SECTION00583000000000000000"></A><A NAME="3445"></A>
<A NAME="kw-owner-priority"></A>
<BR>
4.8.3 <TT>owner_priority</TT>
</H2>
<P>
(Default value: <TT>9</TT>)
<P>
Priority for processing messages for mylist-owner in
the spool. This address will receive non-delivery reports
(bounces) and should have a low priority.
<P>
Available since release 2.3.3
<P>
<H2><A NAME="SECTION00584000000000000000"></A><A NAME="3449"></A>
<A NAME="kw-default-list-priority"></A>
<BR>
4.8.4 <TT>default_list_priority</TT>
</H2>
<P>
(Default value: <TT>5</TT>)
<P>
Default priority for messages if not defined in the list
configuration file.
<P>
Available since release 2.3.1.
<P>
<H1><A NAME="SECTION00590000000000000000">
4.9 Database related</A>
</H1>
<P>
The following parameters are needed when using an RDBMS, but otherwise are not
required:
<P>
<H2><A NAME="SECTION00591000000000000000"></A><A NAME="3453"></A>
<BR>
4.9.1 <TT>db_type</TT>
</H2>
<P>
Database management system used (e.g. MySQL, Pg, Oracle)
<P>
This corresponds to the PERL DataBase Driver (DBD) name and
is therefore case-sensitive.
<P>
<H2><A NAME="SECTION00592000000000000000"></A><A NAME="3456"></A>
<BR>
4.9.2 <TT>db_name</TT>
</H2>
<P>
(Default value: <TT>sympa</TT>)
<P>
Name of the database containing user information. See
detailed notes on database structure, <A HREF="#rdbms-struct"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>,
page <A HREF="#rdbms-struct"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>.
<P>
<H2><A NAME="SECTION00593000000000000000"></A><A NAME="3460"></A>
<BR>
4.9.3 <TT>db_host</TT>
</H2>
<P>
Database host name.
<P>
<H2><A NAME="SECTION00594000000000000000"></A><A NAME="3463"></A>
<BR>
4.9.4 <TT>db_user</TT>
</H2>
<P>
User with read access to the database.
<P>
<H2><A NAME="SECTION00595000000000000000"></A><A NAME="3466"></A>
<BR>
4.9.5 <TT>db_passwd</TT>
</H2>
<P>
Password for <A NAME="3469"></A><TT>db_user</TT>.
<P>
<H1><A NAME="SECTION005100000000000000000">
4.10 Loop prevention</A>
</H1>
<P>
The following define your loop prevention policy for commands.
(see <A HREF="node9.html#loop-detection">8.7</A>, page <A HREF="node9.html#loop-detection"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)
<P>
<H2><A NAME="SECTION005101000000000000000"></A><A NAME="3472"></A>
<BR>
4.10.1 <TT>loop_command_max</TT>
</H2>
<P>
(Default value: <TT>200</TT>)
<P>
The maximum number of command reports sent to an e-mail
address. When it is reached, messages are stored with the BAD
prefix, and reports are no longer sent.
<P>
<H2><A NAME="SECTION005102000000000000000"></A><A NAME="3476"></A>
<BR>
4.10.2 <TT>loop_command_sampling_delay</TT>
</H2>
<P>
(Default value: <TT>3600</TT>)
<P>
This parameter defines the delay in seconds before decrementing
the counter of reports sent to an e-mail address.
<P>
<H2><A NAME="SECTION005103000000000000000"></A><A NAME="3480"></A>
<BR>
4.10.3 <TT>loop_command_decrease_factor</TT>
</H2>
<P>
(Default value: <TT>0.5</TT>)
<P>
The decrementation factor (<TT>from 0 to 1</TT>), used to
determine the new report counter after expiration of the delay.
<P>
<H1><A NAME="SECTION005110000000000000000">
4.11 S/MIME configuration</A>
</H1>
<P>
<I>Sympa</I> can optionally verify and use S/MIME signatures for security purposes.
In this case, three optional parameters must be assigned by the listmaster
(see <A HREF="node8.html#smimeconf">7.4.2</A>, page <A HREF="node8.html#smimeconf"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>).
<P>
<H2><A NAME="SECTION005111000000000000000"></A><A NAME="3485"></A>
<BR>
4.11.1 <TT>openSSL</TT>
</H2>
<P>
The path for the openSSL binary file.
<P>
<H2><A NAME="SECTION005112000000000000000"></A><A NAME="3488"></A>
<BR>
4.11.2 <TT>trusted_ca_options</TT>
</H2>
The option used by OpenSSL
for trusted CA certificates. Required if cfkeyword openSSL is defined.
<P>
<H2><A NAME="SECTION005113000000000000000"></A><A NAME="3491"></A>
<BR>
4.11.3 <TT>key_passwd</TT>
</H2>
<P>
The password for list private key encryption. If not
defined, <I>Sympa</I> assumes that list private keys are not encrypted.
<P>
<H1><A NAME="SECTION005120000000000000000"></A>
<A NAME="Antivirus_plug-in"></A>
<BR>
4.12 Antivirus plug-in
</H1>
<P>
<I>Sympa</I> can optionally check incoming messages before delivering them, using an external antivirus solution.
You must then set two parameters.
<P>
<H2><A NAME="SECTION005121000000000000000"></A><A NAME="3496"></A>
<BR>
4.12.1 <TT>antivirus_path</TT>
</H2>
<P>
The path to your favorite antivirus binary file (including the binary file).
<P>
Example :<PRE>
antivirus_path /usr/local/bin/uvscan
</PRE>
<P>
<H2><A NAME="SECTION005122000000000000000"></A><A NAME="3499"></A>
<BR>
4.12.2 <TT>antivirus_args</TT>
</H2>
<P>
The arguments used by the antivirus software to look for viruses.
You must set them so as to get the virus name.
You should use, if available, the 'unzip' option and check all extensions.
<P>
Example with uvscan :<PRE>
antivirus_args --summary --secure
</PRE>
<P>
Example with fsav :<PRE>
antivirus_args --dumb --archive
</PRE>
<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html452"
HREF="node6.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html446"
HREF="sympa.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html440"
HREF="node4.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html448"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html450"
HREF="node17.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html453"
HREF="node6.html">5. WWSympa</A>
<B> Up:</B> <A NAME="tex2html447"
HREF="sympa.html">Sympa Mailing Lists Management Software</A>
<B> Previous:</B> <A NAME="tex2html441"
HREF="node4.html">3. Installing Sympa</A>
  <B> <A NAME="tex2html449"
HREF="node1.html">Contents</A></B>
  <B> <A NAME="tex2html451"
HREF="node17.html">Index</A></B>
<!--End of Navigation Panel-->
<ADDRESS>
root
2001-06-05
</ADDRESS>
</BODY>
</HTML>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
968fb36a1d13190d5ed9d2ee3bf64b87
>
files
>
90
