.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "SYMPA_CONFIG 5"
.TH SYMPA_CONFIG 5 "2022-11-25" "6.2.70" "sympa 6.2.70"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
sympa_config \- Configuration files for Sympa mailing list manager
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
There are three levels in Sympa's main configuration:
site global, mail domain and list.
.SS "\fIsympa.conf\fP: Configuration file for global settings"
.IX Subsection "sympa.conf: Configuration file for global settings"
\&\fI/etc/sympa/sympa/sympa.conf\fR is main configuration file of Sympa.
Several parameters defined in this file may be overridden by \fIrobot.conf\fR
configuration file for each virtual domain, or by \fIconfig\fR configuration file
for each mailing list.
.PP
Format of \fIsympa.conf\fR and \fIrobot.conf\fR is as following:
.IP "\(bu" 4
Lines beginning with \f(CW\*(C`#\*(C'\fR and containing only spaces are ignored.
.IP "\(bu" 4
Each line has the form "\fIparameter\fR \fIvalue\fR".
\&\fIvalue\fR may contain spaces but may not contain newlines.
.Sp
There are simple parameters and compound parameters.
.Sp
The name of compound parameter consist of a paragraph name and
a sub-parameter name separated by period (\f(CW\*(C`.\*(C'\fR).
However some compound parameters have simple synonym names to keep
compatibility to earlier versions (See \*(L"Obsoleted sympa.conf parameters\*(R").
.Sp
Example:
.Sp
.Vb 3
\&  process_archive on
\&  archive.web_access open
\&  archive.mail_access closed
.Ve
.SS "\fIrobot.conf\fP: Optional configuration file for the mail domain"
.IX Subsection "robot.conf: Optional configuration file for the mail domain"
\&\fIrobot.conf\fR is the optional configuration file for each mail domain.
.PP
Format of \fIrobot.conf\fR is the same as \fIsympa.conf\fR above.
.SS "\fIconfig\fP: Configuration file for the mailing list"
.IX Subsection "config: Configuration file for the mailing list"
\&\fIconfig\fR is main configuration file of each mailing list.
.PP
Format of \fIconfig\fR is as following:
.IP "\(bu" 4
Lines beginning with \f(CW\*(C`#\*(C'\fR and containing only spaces are ignored.
.IP "\(bu" 4
There are simple parameters and compound parameters:
.RS 4
.IP "\(bu" 4
A simple parameter is expressed by single line by each.
The line has the form "\fIparameter\fR \fIvalue\fR".
\&\fIvalue\fR may contain spaces but may not contain newlines.
.Sp
Several parameters may have multiple values.
If it's the case, values may be separated by comma (\f(CW\*(C`,\*(C'\fR)
or parameter lines may be repeated.
Some of parameters must have one or more of limited values.
.Sp
Example:
.Sp
.Vb 1
\&  subject This is subject of my list
\&  
\&  remove_headers User\-Agent,Importance
\&  
\&  custom_headers X\-List: mylist
\&  custom_headers X\-Face: %\`\-W7!?^]Sg\*(AqI\-K>P<cdn&k:~A^{x>(]Gc{V...
\&  
\&  rfc2369_header_fields post,owner
.Ve
.IP "\(bu" 4
A compound parameter is expressed by multiple lines, so-called \*(L"paragraph\*(R",
that consists of
the first line specifying paragraph name and subsequent one or more
sub-parameter lines.  Paragraph must be separated by one or more empty lines
from the other parameters.
.Sp
Several multiple line parameters may occur multiple times.
.Sp
Example:
.Sp
.Vb 3
\&  archive
\&  web_access open
\&  mail_access closed
.Ve
.RE
.RS 4
.RE
.SH "PARAMETERS"
.IX Header "PARAMETERS"
Below is entire list of configuration parameters.
.IP "\(bu" 4
Sub-parameters in paragraph are listed as \fIparagraph\fR\f(CW\*(C`.\*(C'\fR\fIsub-parameter\fR
by each.
.IP "\(bu" 4
\&\*(L"Default\*(R" is built-in default value if any.
About symbols for paths, such as \f(CW$SENDMAIL_ALIASES\fR,
see "Directory layout <https://www.sympa.community/manual/layout.html>".
.SS "Service description"
.IX Subsection "Service description"
\fI\f(CI\*(C`domain\*(C'\fI\fR
.IX Subsection "domain"
.PP
Primary mail domain name
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[\-\ew]+(?:[.][\-\ew]+)+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Example:
.PP
.Vb 1
\&  domain mail.example.org
.Ve
.PP
\fI\f(CI\*(C`listmaster\*(C'\fI\fR
.IX Subsection "listmaster"
.PP
Email addresses of listmasters
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.Sp
/\f(CW$email\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Email addresses of the listmasters (users authorized to perform global server commands). Some error reports may also be sent to these addresses. Listmasters can be defined for each virtual host, however, the default listmasters will have privileges to manage all virtual hosts.
.PP
Example:
.PP
.Vb 1
\&  listmaster your_email_address@domain.tld
.Ve
.PP
\fI\f(CI\*(C`supported_lang\*(C'\fI\fR
.IX Subsection "supported_lang"
.PP
Supported languages
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+(\e\-\ew+)*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`ca,cs,de,el,en\-US,es,et,eu,fi,fr,gl,hu,it,ja,ko,nb,nl,oc,pl,pt\-BR,ru,sv,tr,vi,zh\-CN,zh\-TW\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
All supported languages for the user interface. Languages proper locale information not installed are ignored.
.PP
\fI\f(CI\*(C`title\*(C'\fI\fR
.IX Subsection "title"
.PP
Title of service
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`Mailing lists service\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The name of your mailing list service. It will appear in the header of web interface and subjects of several service messages.
.PP
\fI\f(CI\*(C`gecos\*(C'\fI\fR
.IX Subsection "gecos"
.PP
Display name of Sympa
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`SYMPA\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.34 and later.
.PP
This parameter is used for display name in the \*(L"From:\*(R" header field for the messages sent by Sympa itself.
.PP
\fI\f(CI\*(C`legacy_character_support_feature\*(C'\fI\fR
.IX Subsection "legacy_character_support_feature"
.PP
Support of legacy character set
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
If set to \*(L"on\*(R", enables support of legacy character set according to \fBcharset.conf\fR\|(5) configuration file.
.PP
In some language environments, legacy encoding (character set) can be preferred for e\-mail messages: for example iso\-2022\-jp in Japanese language.
.SS "Database related"
.IX Subsection "Database related"
\fI\f(CI\*(C`update_db_field_types\*(C'\fI\fR
.IX Subsection "update_db_field_types"
.PP
Update database structure
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """auto"" \- automatic" 4
.el .IP "\f(CWauto\fR \- automatic" 4
.IX Item "auto - automatic"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`auto\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
auto: Updates database table structures automatically.
.PP
However, since version 5.3b.5, Sympa will not shorten field size if it already have been longer than the size defined in database definition.
.PP
\fI\f(CI\*(C`db_type\*(C'\fI\fR
.IX Subsection "db_type"
.PP
Type of the database
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`mysql\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Possible types are \*(L"MySQL\*(R", \*(L"PostgreSQL\*(R", \*(L"Oracle\*(R" and \*(L"SQLite\*(R".
.PP
\fI\f(CI\*(C`db_host\*(C'\fI\fR
.IX Subsection "db_host"
.PP
Hostname of the database server
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$host\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
With PostgreSQL, you can also use the path to Unix Socket Directory, e.g. \*(L"/var/run/postgresql\*(R" for connection with Unix domain socket.
.PP
Example:
.PP
.Vb 1
\&  db_host localhost
.Ve
.PP
\fI\f(CI\*(C`db_port\*(C'\fI\fR
.IX Subsection "db_port"
.PP
Port of the database server
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[\-/\ew]+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`db_name\*(C'\fI\fR
.IX Subsection "db_name"
.PP
Name of the database
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`sympa\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
With SQLite, this must be the full path to database file.
.PP
With Oracle Database, this must be \s-1SID,\s0 net service name or easy connection identifier (to use net service name, db_host should be set to \*(L"none\*(R" and \s-1HOST, PORT\s0 and \s-1SERVICE_NAME\s0 should be defined in tnsnames.ora file).
.PP
\fI\f(CI\*(C`db_user\*(C'\fI\fR
.IX Subsection "db_user"
.PP
User for the database connection
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Example:
.PP
.Vb 1
\&  db_user sympa
.Ve
.PP
\fI\f(CI\*(C`db_passwd\*(C'\fI\fR
.IX Subsection "db_passwd"
.PP
Password for the database connection
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
What ever you use a password or not, you must protect the \s-1SQL\s0 server (is it not a public internet service ?)
.PP
Example:
.PP
.Vb 1
\&  db_passwd your_passwd
.Ve
.PP
\fI\f(CI\*(C`db_options\*(C'\fI\fR
.IX Subsection "db_options"
.PP
Database options
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
If these options are defined, they will be appended to data source name (\s-1DSN\s0) fed to database driver. Check the related \s-1DBD\s0 documentation to learn about the available options.
.PP
Example:
.PP
.Vb 1
\&  db_options mysql_read_default_file=/home/joe/my.cnf;mysql_socket=tmp/mysql.sock\-test
.Ve
.PP
\fI\f(CI\*(C`db_env\*(C'\fI\fR
.IX Subsection "db_env"
.PP
Environment variables setting for database
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
With Oracle Database, this is useful for defining \s-1ORACLE_HOME\s0 and \s-1NLS_LANG.\s0
.PP
Example:
.PP
.Vb 1
\&  db_env NLS_LANG=American_America.AL32UTF8;ORACLE_HOME=/u01/app/oracle/product/11.2.0/server
.Ve
.PP
\fI\f(CI\*(C`db_timeout\*(C'\fI\fR
.IX Subsection "db_timeout"
.PP
Database processing timeout
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Currently, this parameter may be used for SQLite only.
.PP
\fI\f(CI\*(C`db_additional_subscriber_fields\*(C'\fI\fR
.IX Subsection "db_additional_subscriber_fields"
.PP
Database private extension to subscriber table
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.Sp
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Adds more fields to \*(L"subscriber_table\*(R" table. Sympa recognizes fields defined with this parameter. You will then be able to use them from within templates and scenarios:
.PP
* for scenarios: [subscriber\->field]
.PP
* for templates: [% subscriber.field %]
.PP
These fields will also appear in the list members review page and will be editable by the list owner. This parameter is a comma-separated list.
.PP
You need to extend the database format with these fields
.PP
Example:
.PP
.Vb 1
\&  db_additional_subscriber_fields billing_delay,subscription_expiration
.Ve
.PP
\fI\f(CI\*(C`db_additional_user_fields\*(C'\fI\fR
.IX Subsection "db_additional_user_fields"
.PP
Database private extension to user table
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.Sp
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Adds more fields to \*(L"user_table\*(R" table. Sympa recognizes fields defined with this parameter. You will then be able to use them from within templates: [% subscriber.field %]
.PP
This parameter is a comma-separated list.
.PP
You need to extend the database format with these fields
.PP
Example:
.PP
.Vb 1
\&  db_additional_user_fields age,address
.Ve
.SS "System log"
.IX Subsection "System log"
\fI\f(CI\*(C`syslog\*(C'\fI\fR
.IX Subsection "syslog"
.PP
System log facility for Sympa
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`LOCAL1\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Do not forget to configure syslog server.
.PP
\fI\f(CI\*(C`log_socket_type\*(C'\fI\fR
.IX Subsection "log_socket_type"
.PP
Communication mode with syslog server
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`unix\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`log_level\*(C'\fI\fR
.IX Subsection "log_level"
.PP
Log verbosity
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW0\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Sets the verbosity of logs.
.PP
0: Only main operations are logged
.PP
3: Almost everything is logged.
.PP
Example:
.PP
.Vb 1
\&  log_level 2
.Ve
.SS "Mail server"
.IX Subsection "Mail server"
\fI\f(CI\*(C`sendmail\*(C'\fI\fR
.IX Subsection "sendmail"
.PP
Path to sendmail
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`/usr/sbin/sendmail\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Absolute path to sendmail command line utility (e.g.: a binary named \*(L"sendmail\*(R" is distributed with Postfix).
.PP
Sympa expects this binary to be sendmail compatible (exim, Postfix, qmail and so on provide it).
.PP
\fI\f(CI\*(C`sendmail_args\*(C'\fI\fR
.IX Subsection "sendmail_args"
.PP
Command line parameters passed to sendmail
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`\-oi \-odi \-oem\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Note that \*(L"\-f\*(R", \*(L"\-N\*(R" and \*(L"\-V\*(R" options and recipient addresses should not be included, because they will be included by Sympa.
.PP
\fI\f(CI\*(C`sendmail_aliases\*(C'\fI\fR
.IX Subsection "sendmail_aliases"
.PP
Path of the file that contains all list related aliases
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW$SENDMAIL_ALIASES\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
It is recommended to create a specific alias file so that Sympa never overwrites the standard alias file, but only a dedicated file.
.PP
Set this parameter to \*(L"none\*(R" if you want to disable alias management in Sympa.
.PP
\fI\f(CI\*(C`aliases_program\*(C'\fI\fR
.IX Subsection "aliases_program"
.PP
Program used to update alias database
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`makemap|newaliases|postalias|postmap|/.+|none\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`newaliases\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This may be \*(L"makemap\*(R", \*(L"newaliases\*(R", \*(L"postalias\*(R", \*(L"postmap\*(R" or full path to custom program.
.PP
\fI\f(CI\*(C`aliases_wrapper\*(C'\fI\fR
.IX Subsection "aliases_wrapper"
.PP
Whether to use the alias wrapper
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`on\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.59b.1 and later.
.PP
If the program to update alias database does not require root privileges, set this parameter to \*(L"off\*(R" and remove the wrapper file sympa_newaliases\-wrapper.
.PP
\fI\f(CI\*(C`aliases_db_type\*(C'\fI\fR
.IX Subsection "aliases_db_type"
.PP
Type of alias database
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew[\-\ew]*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`hash\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\&\*(L"btree\*(R", \*(L"dbm\*(R", \*(L"hash\*(R" and so on.  Available when aliases_program is \*(L"makemap\*(R", \*(L"postalias\*(R" or \*(L"postmap\*(R"
.PP
\fI\f(CI\*(C`alias_manager\*(C'\fI\fR
.IX Subsection "alias_manager"
.PP
Path to alias manager
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SBINDIR/alias_manager.pl\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The absolute path to the script that will add/remove mail aliases
.PP
Example:
.PP
.Vb 1
\&  alias_manager /usr/local/libexec/ldap_alias_manager.pl
.Ve
.SS "List definition"
.IX Subsection "List definition"
\fI\f(CI\*(C`subject\*(C'\fI\fR
.IX Subsection "subject"
.PP
Subject of the list
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
This parameter indicates the subject of the list, which is sent in response to the \s-1LISTS\s0 mail command. The subject is a free form text limited to one line.
.PP
\fI\f(CI\*(C`visibility\*(C'\fI\fR
.IX Subsection "visibility"
.PP
Visibility of the list
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`visibility\*(C'\fR scenario:
.RS 4
.ie n .IP """conceal"" \- conceal except for subscribers" 4
.el .IP "\f(CWconceal\fR \- conceal except for subscribers" 4
.IX Item "conceal - conceal except for subscribers"
.PD 0
.ie n .IP """identified"" \- conceal from anonymous users" 4
.el .IP "\f(CWidentified\fR \- conceal from anonymous users" 4
.IX Item "identified - conceal from anonymous users"
.ie n .IP """noconceal"" \- no conceal" 4
.el .IP "\f(CWnoconceal\fR \- no conceal" 4
.IX Item "noconceal - no conceal"
.ie n .IP """secret"" \- conceal even for subscribers" 4
.el .IP "\f(CWsecret\fR \- conceal even for subscribers" 4
.IX Item "secret - conceal even for subscribers"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`conceal\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This parameter indicates whether the list should feature in the output generated in response to a \s-1LISTS\s0 command or should be shown in the list overview of the web-interface.
.PP
\fI\f(CI\*(C`topics\*(C'\fI\fR
.IX Subsection "topics"
.PP
Topics for the list
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.Sp
List topic.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
This parameter allows the classification of lists. You may define multiple topics as well as hierarchical ones. WWSympa's list of public lists uses this parameter.
.PP
\fI\f(CI\*(C`lang\*(C'\fI\fR
.IX Subsection "lang"
.PP
Language of the list
.IP "Format:" 4
.IX Item "Format:"
Language tag.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`en\-US\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This parameter defines the language used for the list. It is used to initialize a user's language preference; Sympa command reports are extracted from the associated message catalog.
.PP
\fI\f(CI\*(C`family_name\*(C'\fI\fR
.IX Subsection "family_name"
.PP
Family name
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$family_name\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`max_list_members\*(C'\fI\fR
.IX Subsection "max_list_members"
.PP
Maximum number of list members
.IP "Format:" 4
.IX Item "Format:"
Number of list members.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW0\fR (list members)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.5 and later.
.PP
limit for the number of subscribers. 0 means no limit.
.PP
\fI\f(CI\*(C`priority\*(C'\fI\fR
.IX Subsection "priority"
.PP
Priority
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP "0 \- 0 \- highest priority" 4
.el .IP "\f(CW0\fR \- 0 \- highest priority" 4
.IX Item "0 - 0 - highest priority"
.ie n .IP "1 \- 1" 4
.el .IP "\f(CW1\fR \- 1" 4
.IX Item "1 - 1"
.ie n .IP "2 \- 2" 4
.el .IP "\f(CW2\fR \- 2" 4
.IX Item "2 - 2"
.ie n .IP "3 \- 3" 4
.el .IP "\f(CW3\fR \- 3" 4
.IX Item "3 - 3"
.ie n .IP "4 \- 4" 4
.el .IP "\f(CW4\fR \- 4" 4
.IX Item "4 - 4"
.ie n .IP "5 \- 5" 4
.el .IP "\f(CW5\fR \- 5" 4
.IX Item "5 - 5"
.ie n .IP "6 \- 6" 4
.el .IP "\f(CW6\fR \- 6" 4
.IX Item "6 - 6"
.ie n .IP "7 \- 7" 4
.el .IP "\f(CW7\fR \- 7" 4
.IX Item "7 - 7"
.ie n .IP "8 \- 8" 4
.el .IP "\f(CW8\fR \- 8" 4
.IX Item "8 - 8"
.ie n .IP "9 \- 9 \- lowest priority" 4
.el .IP "\f(CW9\fR \- 9 \- lowest priority" 4
.IX Item "9 - 9 - lowest priority"
.ie n .IP """z"" \- queue messages only" 4
.el .IP "\f(CWz\fR \- queue messages only" 4
.IX Item "z - queue messages only"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW5\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The priority with which Sympa will process messages for this list. This level of priority is applied while the message is going through the spool. The z priority will freeze the message in the spool.
.SS "Receiving"
.IX Subsection "Receiving"
\fI\f(CI\*(C`sender_headers\*(C'\fI\fR
.IX Subsection "sender_headers"
.PP
Header field name(s) used to determine sender of the messages
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`From\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\&\*(L"Return-Path\*(R" means envelope sender (a.k.a. \*(L"\s-1UNIX\s0 From\*(R") which will be alternative to sender of messages without \*(L"From\*(R" field.  \*(L"Resent-From\*(R" may also be inserted before \*(L"From\*(R", because some mailers add it into redirected messages and keep original \*(L"From\*(R" field intact.  In particular cases, \*(L"Return-Path\*(R" can not give right sender: Several mail gateway products rewrite envelope sender and add original one as non-standard field such as \*(L"X\-Envelope-From\*(R".  If that is the case, you might want to insert it in place of \*(L"Return-Path\*(R".
.PP
Example:
.PP
.Vb 1
\&  sender_headers Resent\-From,From,Return\-Path
.Ve
.PP
\fI\f(CI\*(C`misaddressed_commands\*(C'\fI\fR
.IX Subsection "misaddressed_commands"
.PP
Reject misaddressed commands
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`reject\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
When a mail command is sent to a list, by default Sympa rejects this message. This feature can be turned off by setting this parameter to \*(L"ignore\*(R".
.PP
\fI\f(CI\*(C`misaddressed_commands_regexp\*(C'\fI\fR
.IX Subsection "misaddressed_commands_regexp"
.PP
Regular expression matching with misaddressed commands
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`((subscribe\es+(\eS+)|unsubscribe\es+(\eS+)|signoff\es+(\eS+)|set\es+(\eS+)\es+(mail|nomail|digest))\es*)\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Perl regular expression applied on messages subject and body to detect misaddressed commands.
.PP
\fI\f(CI\*(C`sympa_priority\*(C'\fI\fR
.IX Subsection "sympa_priority"
.PP
Priority for command messages
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP "0 \- 0 \- highest priority" 4
.el .IP "\f(CW0\fR \- 0 \- highest priority" 4
.IX Item "0 - 0 - highest priority"
.ie n .IP "1 \- 1" 4
.el .IP "\f(CW1\fR \- 1" 4
.IX Item "1 - 1"
.ie n .IP "2 \- 2" 4
.el .IP "\f(CW2\fR \- 2" 4
.IX Item "2 - 2"
.ie n .IP "3 \- 3" 4
.el .IP "\f(CW3\fR \- 3" 4
.IX Item "3 - 3"
.ie n .IP "4 \- 4" 4
.el .IP "\f(CW4\fR \- 4" 4
.IX Item "4 - 4"
.ie n .IP "5 \- 5" 4
.el .IP "\f(CW5\fR \- 5" 4
.IX Item "5 - 5"
.ie n .IP "6 \- 6" 4
.el .IP "\f(CW6\fR \- 6" 4
.IX Item "6 - 6"
.ie n .IP "7 \- 7" 4
.el .IP "\f(CW7\fR \- 7" 4
.IX Item "7 - 7"
.ie n .IP "8 \- 8" 4
.el .IP "\f(CW8\fR \- 8" 4
.IX Item "8 - 8"
.ie n .IP "9 \- 9 \- lowest priority" 4
.el .IP "\f(CW9\fR \- 9 \- lowest priority" 4
.IX Item "9 - 9 - lowest priority"
.ie n .IP """z"" \- queue messages only" 4
.el .IP "\f(CWz\fR \- queue messages only" 4
.IX Item "z - queue messages only"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW1\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Priority applied to messages sent to Sympa command address.
.PP
\fI\f(CI\*(C`request_priority\*(C'\fI\fR
.IX Subsection "request_priority"
.PP
Priority for messages bound for list owners
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP "0 \- 0 \- highest priority" 4
.el .IP "\f(CW0\fR \- 0 \- highest priority" 4
.IX Item "0 - 0 - highest priority"
.ie n .IP "1 \- 1" 4
.el .IP "\f(CW1\fR \- 1" 4
.IX Item "1 - 1"
.ie n .IP "2 \- 2" 4
.el .IP "\f(CW2\fR \- 2" 4
.IX Item "2 - 2"
.ie n .IP "3 \- 3" 4
.el .IP "\f(CW3\fR \- 3" 4
.IX Item "3 - 3"
.ie n .IP "4 \- 4" 4
.el .IP "\f(CW4\fR \- 4" 4
.IX Item "4 - 4"
.ie n .IP "5 \- 5" 4
.el .IP "\f(CW5\fR \- 5" 4
.IX Item "5 - 5"
.ie n .IP "6 \- 6" 4
.el .IP "\f(CW6\fR \- 6" 4
.IX Item "6 - 6"
.ie n .IP "7 \- 7" 4
.el .IP "\f(CW7\fR \- 7" 4
.IX Item "7 - 7"
.ie n .IP "8 \- 8" 4
.el .IP "\f(CW8\fR \- 8" 4
.IX Item "8 - 8"
.ie n .IP "9 \- 9 \- lowest priority" 4
.el .IP "\f(CW9\fR \- 9 \- lowest priority" 4
.IX Item "9 - 9 - lowest priority"
.ie n .IP """z"" \- queue messages only" 4
.el .IP "\f(CWz\fR \- queue messages only" 4
.IX Item "z - queue messages only"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW0\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Priority for processing of messages bound for \*(L"LIST-request\*(R" address, i.e. owners of the list
.PP
\fI\f(CI\*(C`owner_priority\*(C'\fI\fR
.IX Subsection "owner_priority"
.PP
Priority for non-VERP bounces
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP "0 \- 0 \- highest priority" 4
.el .IP "\f(CW0\fR \- 0 \- highest priority" 4
.IX Item "0 - 0 - highest priority"
.ie n .IP "1 \- 1" 4
.el .IP "\f(CW1\fR \- 1" 4
.IX Item "1 - 1"
.ie n .IP "2 \- 2" 4
.el .IP "\f(CW2\fR \- 2" 4
.IX Item "2 - 2"
.ie n .IP "3 \- 3" 4
.el .IP "\f(CW3\fR \- 3" 4
.IX Item "3 - 3"
.ie n .IP "4 \- 4" 4
.el .IP "\f(CW4\fR \- 4" 4
.IX Item "4 - 4"
.ie n .IP "5 \- 5" 4
.el .IP "\f(CW5\fR \- 5" 4
.IX Item "5 - 5"
.ie n .IP "6 \- 6" 4
.el .IP "\f(CW6\fR \- 6" 4
.IX Item "6 - 6"
.ie n .IP "7 \- 7" 4
.el .IP "\f(CW7\fR \- 7" 4
.IX Item "7 - 7"
.ie n .IP "8 \- 8" 4
.el .IP "\f(CW8\fR \- 8" 4
.IX Item "8 - 8"
.ie n .IP "9 \- 9 \- lowest priority" 4
.el .IP "\f(CW9\fR \- 9 \- lowest priority" 4
.IX Item "9 - 9 - lowest priority"
.ie n .IP """z"" \- queue messages only" 4
.el .IP "\f(CWz\fR \- queue messages only" 4
.IX Item "z - queue messages only"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW9\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Priority for processing of messages bound for \*(L"LIST-owner\*(R" address, i.e. non-delivery reports (bounces).
.PP
\fI\f(CI\*(C`incoming_max_count\*(C'\fI\fR
.IX Subsection "incoming_max_count"
.PP
Max number of sympa_msg.pl workers
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW1\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2b.5 and later.
.PP
Max number of workers of sympa_msg.pl daemon processing incoming spool.
.PP
\fI\f(CI\*(C`sleep\*(C'\fI\fR
.IX Subsection "sleep"
.PP
Interval between scanning incoming message spool
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW5\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Must not be 0.
.SS "Sending/receiving setup"
.IX Subsection "Sending/receiving setup"
\fI\f(CI\*(C`send\*(C'\fI\fR
.IX Subsection "send"
.PP
Who can send messages
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`send\*(C'\fR scenario:
.RS 4
.ie n .IP """closed"" \- closed" 4
.el .IP "\f(CWclosed\fR \- closed" 4
.IX Item "closed - closed"
.PD 0
.ie n .IP """confidential"" \- restricted to subscribers, messages from others are discarded" 4
.el .IP "\f(CWconfidential\fR \- restricted to subscribers, messages from others are discarded" 4
.IX Item "confidential - restricted to subscribers, messages from others are discarded"
.ie n .IP """editordkim"" \- Moderated, no authentication needed if \s-1DKIM\s0 signature from moderator is \s-1OK\s0" 4
.el .IP "\f(CWeditordkim\fR \- Moderated, no authentication needed if \s-1DKIM\s0 signature from moderator is \s-1OK\s0" 4
.IX Item "editordkim - Moderated, no authentication needed if DKIM signature from moderator is OK"
.ie n .IP """editorkey"" \- Moderated" 4
.el .IP "\f(CWeditorkey\fR \- Moderated" 4
.IX Item "editorkey - Moderated"
.ie n .IP """editorkeyonly"" \- Moderated, even for moderators" 4
.el .IP "\f(CWeditorkeyonly\fR \- Moderated, even for moderators" 4
.IX Item "editorkeyonly - Moderated, even for moderators"
.ie n .IP """editorkeyonlyauth"" \- Moderated, need authentication from moderator" 4
.el .IP "\f(CWeditorkeyonlyauth\fR \- Moderated, need authentication from moderator" 4
.IX Item "editorkeyonlyauth - Moderated, need authentication from moderator"
.ie n .IP """newsletter"" \- Newsletter, restricted to moderators" 4
.el .IP "\f(CWnewsletter\fR \- Newsletter, restricted to moderators" 4
.IX Item "newsletter - Newsletter, restricted to moderators"
.ie n .IP """newsletterkeyonly"" \- Newsletter, restricted to moderators after confirmation" 4
.el .IP "\f(CWnewsletterkeyonly\fR \- Newsletter, restricted to moderators after confirmation" 4
.IX Item "newsletterkeyonly - Newsletter, restricted to moderators after confirmation"
.ie n .IP """owner"" \- Restricted to list owners only" 4
.el .IP "\f(CWowner\fR \- Restricted to list owners only" 4
.IX Item "owner - Restricted to list owners only"
.ie n .IP """ownerauth"" \- Restricted to list owners with previous \s-1MD5\s0 authentication" 4
.el .IP "\f(CWownerauth\fR \- Restricted to list owners with previous \s-1MD5\s0 authentication" 4
.IX Item "ownerauth - Restricted to list owners with previous MD5 authentication"
.ie n .IP """private"" \- restricted to subscribers" 4
.el .IP "\f(CWprivate\fR \- restricted to subscribers" 4
.IX Item "private - restricted to subscribers"
.ie n .IP """private_smime"" \- restricted to subscribers and checked smime signature" 4
.el .IP "\f(CWprivate_smime\fR \- restricted to subscribers and checked smime signature" 4
.IX Item "private_smime - restricted to subscribers and checked smime signature"
.ie n .IP """privateandeditorkey"" \- Moderated, restricted to subscribers" 4
.el .IP "\f(CWprivateandeditorkey\fR \- Moderated, restricted to subscribers" 4
.IX Item "privateandeditorkey - Moderated, restricted to subscribers"
.ie n .IP """privateandnomultipartoreditorkey"" \- Moderated, for non subscribers sending multipart messages" 4
.el .IP "\f(CWprivateandnomultipartoreditorkey\fR \- Moderated, for non subscribers sending multipart messages" 4
.IX Item "privateandnomultipartoreditorkey - Moderated, for non subscribers sending multipart messages"
.ie n .IP """privatekey"" \- restricted to subscribers with previous md5 authentication" 4
.el .IP "\f(CWprivatekey\fR \- restricted to subscribers with previous md5 authentication" 4
.IX Item "privatekey - restricted to subscribers with previous md5 authentication"
.ie n .IP """privatekeyandeditorkeyonly"" \- Moderated, for subscribers and even moderators themself" 4
.el .IP "\f(CWprivatekeyandeditorkeyonly\fR \- Moderated, for subscribers and even moderators themself" 4
.IX Item "privatekeyandeditorkeyonly - Moderated, for subscribers and even moderators themself"
.ie n .IP """privateoreditorkey"" \- Private, moderated for non subscribers" 4
.el .IP "\f(CWprivateoreditorkey\fR \- Private, moderated for non subscribers" 4
.IX Item "privateoreditorkey - Private, moderated for non subscribers"
.ie n .IP """privateorpublickey"" \- Private, confirmation for non subscribers" 4
.el .IP "\f(CWprivateorpublickey\fR \- Private, confirmation for non subscribers" 4
.IX Item "privateorpublickey - Private, confirmation for non subscribers"
.ie n .IP """public"" \- public list" 4
.el .IP "\f(CWpublic\fR \- public list" 4
.IX Item "public - public list"
.ie n .IP """public_nobcc"" \- public list, Bcc rejected (anti-spam)" 4
.el .IP "\f(CWpublic_nobcc\fR \- public list, Bcc rejected (anti-spam)" 4
.IX Item "public_nobcc - public list, Bcc rejected (anti-spam)"
.ie n .IP """publickey"" \- anyone no authentication if \s-1DKIM\s0 signature is \s-1OK\s0" 4
.el .IP "\f(CWpublickey\fR \- anyone no authentication if \s-1DKIM\s0 signature is \s-1OK\s0" 4
.IX Item "publickey - anyone no authentication if DKIM signature is OK"
.ie n .IP """publicnoattachment"" \- public list multipart/mixed messages are forwarded to moderator" 4
.el .IP "\f(CWpublicnoattachment\fR \- public list multipart/mixed messages are forwarded to moderator" 4
.IX Item "publicnoattachment - public list multipart/mixed messages are forwarded to moderator"
.ie n .IP """publicnomultipart"" \- public list multipart messages are rejected" 4
.el .IP "\f(CWpublicnomultipart\fR \- public list multipart messages are rejected" 4
.IX Item "publicnomultipart - public list multipart messages are rejected"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`private\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This parameter specifies who can send messages to the list.
.PP
\fI\f(CI\*(C`delivery_time\*(C'\fI\fR
.IX Subsection "delivery_time"
.PP
Delivery time (hh:mm)
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[0\-2]?\ed\e:[0\-6]\ed\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
If this parameter is present, non-digest messages will be delivered to subscribers at this time: When this time has been past, delivery is postponed to the same time in next day.
.PP
\fI\f(CI\*(C`digest\*(C'\fI\fR
.IX Subsection "digest"
.PP
(Paragraph)
Digest frequency
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
Definition of digest mode. If this parameter is present, subscribers can select the option of receiving messages in multipart/digest \s-1MIME\s0 format, or as a plain text digest. Messages are then grouped together, and compiled messages are sent to subscribers according to the frequency selected with this parameter.
.PP
\f(CW\*(C`digest.days\*(C'\fR
.IX Subsection "digest.days"
.PP
days
.IP "Format:" 4
.IX Item "Format:"
Multiple occurrences allowed.
.Sp
Day of week, \f(CW0\fR \- \f(CW6\fR.
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`digest.hour\*(C'\fR
.IX Subsection "digest.hour"
.PP
hour
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`digest.minute\*(C'\fR
.IX Subsection "digest.minute"
.PP
minute
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`digest_max_size\*(C'\fI\fR
.IX Subsection "digest_max_size"
.PP
Digest maximum number of messages
.IP "Format:" 4
.IX Item "Format:"
Number of messages.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW25\fR (messages)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`available_user_options\*(C'\fI\fR
.IX Subsection "available_user_options"
.PP
(Paragraph)
Available subscription options
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
\f(CW\*(C`available_user_options.reception\*(C'\fR
.IX Subsection "available_user_options.reception"
.PP
reception mode
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.Sp
Reception mode of list member.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`mail,notice,digest,digestplain,summary,nomail,txt,urlize,not_me\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
Only these modes will be allowed for the subscribers of this list. If a subscriber has a reception mode not in the list, Sympa uses the mode specified in the default_user_options paragraph.
.PP
\fI\f(CI\*(C`default_user_options\*(C'\fI\fR
.IX Subsection "default_user_options"
.PP
(Paragraph)
Subscription profile
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
Default profile for the subscribers of the list.
.PP
\f(CW\*(C`default_user_options.reception\*(C'\fR
.IX Subsection "default_user_options.reception"
.PP
reception mode
.IP "Format:" 4
.IX Item "Format:"
Reception mode of list member.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`mail\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
Mail reception mode.
.PP
\f(CW\*(C`default_user_options.visibility\*(C'\fR
.IX Subsection "default_user_options.visibility"
.PP
visibility
.IP "Format:" 4
.IX Item "Format:"
Visibility mode of list member.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`noconceal\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
Visibility of the subscriber.
.PP
\fI\f(CI\*(C`msg_topic\*(C'\fI\fR
.IX Subsection "msg_topic"
.PP
(Paragraph)
Topics for message categorization
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
This paragraph defines a topic used to tag a message of a list, named by msg_topic.name (\*(L"other\*(R" is a reserved word), its title is msg_topic.title. The msg_topic.keywords entry is optional and allows automatic tagging. This should be a list of keywords, separated by ','.
.PP
\f(CW\*(C`msg_topic.name\*(C'\fR
.IX Subsection "msg_topic.name"
.PP
Message topic name
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[\e\-\ew]+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`msg_topic.keywords\*(C'\fR
.IX Subsection "msg_topic.keywords"
.PP
Message topic keywords
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[^,\en]+(,[^,\en]+)*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`msg_topic.title\*(C'\fR
.IX Subsection "msg_topic.title"
.PP
Message topic title
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`msg_topic_keywords_apply_on\*(C'\fI\fR
.IX Subsection "msg_topic_keywords_apply_on"
.PP
Defines to which part of messages topic keywords are applied
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """subject"" \- subject field" 4
.el .IP "\f(CWsubject\fR \- subject field" 4
.IX Item "subject - subject field"
.ie n .IP """body"" \- message body" 4
.el .IP "\f(CWbody\fR \- message body" 4
.IX Item "body - message body"
.ie n .IP """subject_and_body"" \- subject and body" 4
.el .IP "\f(CWsubject_and_body\fR \- subject and body" 4
.IX Item "subject_and_body - subject and body"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`subject\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
This parameter indicates which part of the message is used to perform automatic tagging.
.PP
\fI\f(CI\*(C`msg_topic_tagging\*(C'\fI\fR
.IX Subsection "msg_topic_tagging"
.PP
Message tagging
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """required_sender"" \- required to post message" 4
.el .IP "\f(CWrequired_sender\fR \- required to post message" 4
.IX Item "required_sender - required to post message"
.ie n .IP """required_moderator"" \- required to distribute message" 4
.el .IP "\f(CWrequired_moderator\fR \- required to distribute message" 4
.IX Item "required_moderator - required to distribute message"
.ie n .IP """optional"" \- optional" 4
.el .IP "\f(CWoptional\fR \- optional" 4
.IX Item "optional - optional"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`optional\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
This parameter indicates if the tagging is optional or required for a list.
.PP
\fI\f(CI\*(C`reply_to_header\*(C'\fI\fR
.IX Subsection "reply_to_header"
.PP
(Paragraph)
Reply address
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
This defines what Sympa will place in the Reply-To: \s-1SMTP\s0 header field of the messages it distributes.
.PP
\f(CW\*(C`reply_to_header.value\*(C'\fR
.IX Subsection "reply_to_header.value"
.PP
value
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """sender"" \- sender" 4
.el .IP "\f(CWsender\fR \- sender" 4
.IX Item "sender - sender"
.ie n .IP """list"" \- list" 4
.el .IP "\f(CWlist\fR \- list" 4
.IX Item "list - list"
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.ie n .IP """other_email"" \- other email address" 4
.el .IP "\f(CWother_email\fR \- other email address" 4
.IX Item "other_email - other email address"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`sender\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
This parameter indicates whether the Reply-To: field should indicate the sender of the message (sender), the list itself (list), both list and sender (all) or an arbitrary e\-mail address (defined by the other_email parameter).
.PP
Note: it is inadvisable to change this parameter, and particularly inadvisable to set it to list. Experience has shown it to be almost inevitable that users, mistakenly believing that they are replying only to the sender, will send private messages to a list. This can lead, at the very least, to embarrassment, and sometimes to more serious consequences.
.PP
\f(CW\*(C`reply_to_header.other_email\*(C'\fR
.IX Subsection "reply_to_header.other_email"
.PP
other email address
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$email\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
If value was set to other_email, this parameter defines the e\-mail address used.
.PP
\f(CW\*(C`reply_to_header.apply\*(C'\fR
.IX Subsection "reply_to_header.apply"
.PP
respect of existing header field
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """forced"" \- overwrite Reply-To: header field" 4
.el .IP "\f(CWforced\fR \- overwrite Reply-To: header field" 4
.IX Item "forced - overwrite Reply-To: header field"
.ie n .IP """respect"" \- preserve existing header field" 4
.el .IP "\f(CWrespect\fR \- preserve existing header field" 4
.IX Item "respect - preserve existing header field"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`respect\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
The default is to respect (preserve) the existing Reply-To: \s-1SMTP\s0 header field in incoming messages. If set to forced, Reply-To: \s-1SMTP\s0 header field will be overwritten.
.PP
\fI\f(CI\*(C`anonymous_sender\*(C'\fI\fR
.IX Subsection "anonymous_sender"
.PP
Anonymous sender
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
To hide the sender's email address before distributing the message. It is replaced by the provided email address.
.PP
\fI\f(CI\*(C`anonymous_header_fields\*(C'\fI\fR
.IX Subsection "anonymous_header_fields"
.PP
Header fields removed when a mailing list is setup in anonymous mode
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`Authentication\-Results,Disposition\-Notification\-To,DKIM\-Signature,Fax,Injection\-Info,Mailer,Organisation,Organization,Original\-Recipient,Originating\-Client,Originator,Path,Phone,Received,Received\-SPF,Reply\-To,Resent\-Reply\-To,Return\-Receipt\-To,Telefax,User\-Agent,X\-Envelope\-From,X\-Envelope\-To,X\-Face,X\-Mailer,X\-MimeOLE,X\-Newsreader,X\-Sender,X\-X\-Sender\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
See \*(L"anonymous_sender\*(R" list parameter.
.PP
Default value prior to Sympa 6.1.19 is:
.PP
.Vb 1
\&  Sender,X\-Sender,Received,Message\-id,From,X\-Envelope\-To,Resent\-From,Reply\-To,Organization,Disposition\-Notification\-To,X\-Envelope\-From,X\-X\-Sender
.Ve
.PP
\fI\f(CI\*(C`custom_header\*(C'\fI\fR
.IX Subsection "custom_header"
.PP
Custom header field
.IP "Format:" 4
.IX Item "Format:"
Multiple occurrences allowed.
.Sp
/\f(CW\*(C`\eS+:\es+.*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
This parameter is optional. The headers specified will be added to the headers of messages distributed via the list. As of release 1.2.2 of Sympa, it is possible to put several custom header lines in the configuration file at the same time.
.PP
\fI\f(CI\*(C`custom_subject\*(C'\fI\fR
.IX Subsection "custom_subject"
.PP
Subject tagging
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
This parameter is optional. It specifies a string which is added to the subject of distributed messages (intended to help users who do not use automatic tools to sort incoming messages). This string will be surrounded by [] characters.
.PP
\fI\f(CI\*(C`footer_type\*(C'\fI\fR
.IX Subsection "footer_type"
.PP
Attachment type
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """mime"" \- add a new \s-1MIME\s0 part" 4
.el .IP "\f(CWmime\fR \- add a new \s-1MIME\s0 part" 4
.IX Item "mime - add a new MIME part"
.ie n .IP """append"" \- append to message body" 4
.el .IP "\f(CWappend\fR \- append to message body" 4
.IX Item "append - append to message body"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`mime\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
List owners may decide to add message headers or footers to messages sent via the list. This parameter defines the way a footer/header is added to a message.
.PP
mime:
.PP
The default value. Sympa will add the footer/header as a new \s-1MIME\s0 part.
.PP
append:
.PP
Sympa will not create new \s-1MIME\s0 parts, but will try to append the header/footer to the body of the message. Predefined message-footers will be ignored.
.PP
\fI\f(CI\*(C`max_size\*(C'\fI\fR
.IX Subsection "max_size"
.PP
Maximum message size
.IP "Format:" 4
.IX Item "Format:"
Number of bytes.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW5242880\fR (bytes)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), host
.PP
Maximum size of a message in 8\-bit bytes.
.PP
Example:
.PP
.Vb 1
\&  max_size 2097152
.Ve
.PP
\fI\f(CI\*(C`personalization_feature\*(C'\fI\fR
.IX Subsection "personalization_feature"
.PP
Allow message personalization
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.59b.2 and later.
.PP
\fI\f(CI\*(C`personalization\*(C'\fI\fR
.IX Subsection "personalization"
.PP
(Paragraph)
Message personalization
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
\f(CW\*(C`personalization.web_apply_on\*(C'\fR
.IX Subsection "personalization.web_apply_on"
.PP
Scope for messages from the web interface
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """footer"" \- header and footer" 4
.el .IP "\f(CWfooter\fR \- header and footer" 4
.IX Item "footer - header and footer"
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`footer\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\f(CW\*(C`personalization.mail_apply_on\*(C'\fR
.IX Subsection "personalization.mail_apply_on"
.PP
Scope for messages from incoming email
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """footer"" \- header and footer" 4
.el .IP "\f(CWfooter\fR \- header and footer" 4
.IX Item "footer - header and footer"
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`none\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`message_hook\*(C'\fI\fR
.IX Subsection "message_hook"
.PP
(Paragraph)
Hook modules for message processing
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
\f(CW\*(C`message_hook.pre_distribute\*(C'\fR
.IX Subsection "message_hook.pre_distribute"
.PP
A hook on the messages before distribution
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`(::|\ew)+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`message_hook.post_archive\*(C'\fR
.IX Subsection "message_hook.post_archive"
.PP
A hook on the messages just after archiving
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`(::|\ew)+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`reject_mail_from_automates_feature\*(C'\fI\fR
.IX Subsection "reject_mail_from_automates_feature"
.PP
Reject mail from automatic processes (crontab, etc)?
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`on\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 and later.
.PP
Rejects messages that seem to be from automated services, based on a few header fields (\*(L"Content-Identifier:\*(R", \*(L"Auto-Submitted:\*(R").
.PP
Sympa also can be configured to reject messages based on the \*(L"From:\*(R" header field value (see \*(L"loop_prevention_regex\*(R").
.PP
\fI\f(CI\*(C`remove_headers\*(C'\fI\fR
.IX Subsection "remove_headers"
.PP
Header fields to be removed from incoming messages
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.Sp
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`X\-Sympa\-To,X\-Family\-To,Return\-Receipt\-To,Precedence,X\-Sequence,Disposition\-Notification\-To,Sender\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
Use it, for example, to ensure some privacy for your users in case that \*(L"anonymous_sender\*(R" mode is inappropriate.
.PP
The removal of these header fields is applied before Sympa adds its own header fields (\*(L"rfc2369_header_fields\*(R" and \*(L"custom_header\*(R").
.PP
Example:
.PP
.Vb 1
\&  remove_headers Resent\-Date,Resent\-From,Resent\-To,Resent\-Message\-Id,Sender,Delivered\-To
.Ve
.PP
\fI\f(CI\*(C`remove_outgoing_headers\*(C'\fI\fR
.IX Subsection "remove_outgoing_headers"
.PP
Header fields to be removed before message distribution
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.Sp
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`none\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
The removal happens after Sympa's own header fields are added; therefore, it is a convenient way to remove Sympa's own header fields (like \*(L"X\-Loop:\*(R" or \*(L"X\-no-archive:\*(R") if you wish.
.PP
Example:
.PP
.Vb 1
\&  remove_outgoing_headers X\-no\-archive
.Ve
.PP
\fI\f(CI\*(C`rfc2369_header_fields\*(C'\fI\fR
.IX Subsection "rfc2369_header_fields"
.PP
\&\s-1RFC 2369\s0 header fields
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.RS 4
.ie n .IP """help"" \- help" 4
.el .IP "\f(CWhelp\fR \- help" 4
.IX Item "help - help"
.PD 0
.ie n .IP """subscribe"" \- subscription" 4
.el .IP "\f(CWsubscribe\fR \- subscription" 4
.IX Item "subscribe - subscription"
.ie n .IP """unsubscribe"" \- unsubscription" 4
.el .IP "\f(CWunsubscribe\fR \- unsubscription" 4
.IX Item "unsubscribe - unsubscription"
.ie n .IP """post"" \- posting address" 4
.el .IP "\f(CWpost\fR \- posting address" 4
.IX Item "post - posting address"
.ie n .IP """owner"" \- owner" 4
.el .IP "\f(CWowner\fR \- owner" 4
.IX Item "owner - owner"
.ie n .IP """archive"" \- list archive" 4
.el .IP "\f(CWarchive\fR \- list archive" 4
.IX Item "archive - list archive"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`help,subscribe,unsubscribe,post,owner,archive\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
Specify which \s-1RFC 2369\s0 mailing list header fields to be added.
.PP
\&\*(L"List-Id:\*(R" header field defined in \s-1RFC 2919\s0 is always added. Sympa also adds \*(L"Archived-At:\*(R" header field defined in \s-1RFC 5064.\s0
.SS "Distribution"
.IX Subsection "Distribution"
\fI\f(CI\*(C`urlize_min_size\*(C'\fI\fR
.IX Subsection "urlize_min_size"
.PP
Minimum size to be urlized
.IP "Format:" 4
.IX Item "Format:"
Number of bytes.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW10240\fR (bytes)
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
When a subscriber chose \*(L"urlize\*(R" reception mode, attachments not smaller than this size will be urlized.
.PP
\fI\f(CI\*(C`allowed_external_origin\*(C'\fI\fR
.IX Subsection "allowed_external_origin"
.PP
Allowed external links in sanitized \s-1HTML\s0
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[\-\ew*]+(?:[.][\-\ew*]+)+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.19b.2 and later.
.PP
When the \s-1HTML\s0 content of a message must be sanitized, links (\*(L"href\*(R" or \*(L"src\*(R" attributes) with the hosts listed in this parameter will not be scrubbed. If \*(L"*\*(R" character is included, it matches any subdomains. Single \*(L"*\*(R" allows any hosts.
.PP
Example:
.PP
.Vb 1
\&  allowed_external_origin *.example.org,www.example.com
.Ve
.PP
\fI\f(CI\*(C`sympa_packet_priority\*(C'\fI\fR
.IX Subsection "sympa_packet_priority"
.PP
Default priority for a packet
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP "0 \- 0 \- highest priority" 4
.el .IP "\f(CW0\fR \- 0 \- highest priority" 4
.IX Item "0 - 0 - highest priority"
.ie n .IP "1 \- 1" 4
.el .IP "\f(CW1\fR \- 1" 4
.IX Item "1 - 1"
.ie n .IP "2 \- 2" 4
.el .IP "\f(CW2\fR \- 2" 4
.IX Item "2 - 2"
.ie n .IP "3 \- 3" 4
.el .IP "\f(CW3\fR \- 3" 4
.IX Item "3 - 3"
.ie n .IP "4 \- 4" 4
.el .IP "\f(CW4\fR \- 4" 4
.IX Item "4 - 4"
.ie n .IP "5 \- 5" 4
.el .IP "\f(CW5\fR \- 5" 4
.IX Item "5 - 5"
.ie n .IP "6 \- 6" 4
.el .IP "\f(CW6\fR \- 6" 4
.IX Item "6 - 6"
.ie n .IP "7 \- 7" 4
.el .IP "\f(CW7\fR \- 7" 4
.IX Item "7 - 7"
.ie n .IP "8 \- 8" 4
.el .IP "\f(CW8\fR \- 8" 4
.IX Item "8 - 8"
.ie n .IP "9 \- 9 \- lowest priority" 4
.el .IP "\f(CW9\fR \- 9 \- lowest priority" 4
.IX Item "9 - 9 - lowest priority"
.ie n .IP """z"" \- queue messages only" 4
.el .IP "\f(CWz\fR \- queue messages only" 4
.IX Item "z - queue messages only"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW5\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The default priority set to a packet to be sent by the bulk.
.PP
\fI\f(CI\*(C`bulk_fork_threshold\*(C'\fI\fR
.IX Subsection "bulk_fork_threshold"
.PP
Fork threshold of bulk daemon
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW1\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The minimum number of packets before bulk daemon forks a new worker to increase sending rate.
.PP
\fI\f(CI\*(C`bulk_max_count\*(C'\fI\fR
.IX Subsection "bulk_max_count"
.PP
Maximum number of bulk workers
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW3\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`bulk_lazytime\*(C'\fI\fR
.IX Subsection "bulk_lazytime"
.PP
Idle timeout of bulk workers
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW600\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The number of seconds a bulk worker will remain running without processing a message before it spontaneously exits.
.PP
\fI\f(CI\*(C`bulk_sleep\*(C'\fI\fR
.IX Subsection "bulk_sleep"
.PP
Sleep time of bulk workers
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW1\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The number of seconds a bulk worker sleeps between starting a new loop if it didn't find a message to send.
.PP
Keep it small if you want your server to be reactive.
.PP
\fI\f(CI\*(C`bulk_wait_to_fork\*(C'\fI\fR
.IX Subsection "bulk_wait_to_fork"
.PP
Interval between checks of packet numbers
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW10\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of seconds a master bulk daemon waits between two packets number checks.
.PP
Keep it small if you expect brutal increases in the message sending load.
.PP
\fI\f(CI\*(C`log_smtp\*(C'\fI\fR
.IX Subsection "log_smtp"
.PP
Log invocation of sendmail
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This can be overwritten by \*(L"\-m\*(R" option for sympa.pl.
.PP
\fI\f(CI\*(C`maxsmtp\*(C'\fI\fR
.IX Subsection "maxsmtp"
.PP
Maximum number of sendmail processes
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW40\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Maximum number of simultaneous child processes spawned by Sympa. This is the main load control parameter.
.PP
Proposed value is quite low, but you can rise it up to 100, 200 or even 300 with powerful systems.
.PP
Example:
.PP
.Vb 1
\&  maxsmtp 500
.Ve
.PP
\fI\f(CI\*(C`nrcpt\*(C'\fI\fR
.IX Subsection "nrcpt"
.PP
Maximum number of recipients per call to sendmail
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW25\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This grouping factor makes it possible for the sendmail processes to optimize the number of \s-1SMTP\s0 sessions for message distribution. If needed, you can limit the number of recipients for a particular domain. Check the \*(L"nrcpt_by_domain.conf\*(R" configuration file.
.PP
\fI\f(CI\*(C`avg\*(C'\fI\fR
.IX Subsection "avg"
.PP
Maximum number of different mail domains per call to sendmail
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW10\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.SS "Privileges"
.IX Subsection "Privileges"
\fI\f(CI\*(C`create_list\*(C'\fI\fR
.IX Subsection "create_list"
.PP
Who is able to create lists
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`create_list\*(C'\fR scenario:
.RS 4
.ie n .IP """closed"" \- closed" 4
.el .IP "\f(CWclosed\fR \- closed" 4
.IX Item "closed - closed"
.PD 0
.ie n .IP """listmaster"" \- restricted to listmaster" 4
.el .IP "\f(CWlistmaster\fR \- restricted to listmaster" 4
.IX Item "listmaster - restricted to listmaster"
.ie n .IP """public_listmaster"" \- anybody by validation by listmaster required" 4
.el .IP "\f(CWpublic_listmaster\fR \- anybody by validation by listmaster required" 4
.IX Item "public_listmaster - anybody by validation by listmaster required"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`public_listmaster\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Defines who can create lists (or request list creation) by creating new lists or by renaming or copying existing lists.
.PP
Example:
.PP
.Vb 1
\&  create_list listmaster
.Ve
.PP
\fI\f(CI\*(C`allow_subscribe_if_pending\*(C'\fI\fR
.IX Subsection "allow_subscribe_if_pending"
.PP
Allow adding subscribers to a list not open
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`on\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
If set to \*(L"off\*(R", adding subscribers to, or removing subscribers from a list with status other than \*(L"open\*(R" is forbidden.
.PP
\fI\f(CI\*(C`global_remind\*(C'\fI\fR
.IX Subsection "global_remind"
.PP
Who is able to send remind messages over all lists
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`global_remind\*(C'\fR scenario:
.RS 4
.ie n .IP """listmaster"" \- only for listmaster" 4
.el .IP "\f(CWlistmaster\fR \- only for listmaster" 4
.IX Item "listmaster - only for listmaster"
.RE
.RS 4
.RE
.PD 0
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`listmaster\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`move_user\*(C'\fI\fR
.IX Subsection "move_user"
.PP
Who is able to change user's email
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`move_user\*(C'\fR scenario:
.RS 4
.ie n .IP """auth"" \- need authentication" 4
.el .IP "\f(CWauth\fR \- need authentication" 4
.IX Item "auth - need authentication"
.PD 0
.ie n .IP """closed"" \- impossible" 4
.el .IP "\f(CWclosed\fR \- impossible" 4
.IX Item "closed - impossible"
.ie n .IP """listmaster"" \- listmaster only" 4
.el .IP "\f(CWlistmaster\fR \- listmaster only" 4
.IX Item "listmaster - listmaster only"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`auth\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.19b.1 and later.
.PP
\fI\f(CI\*(C`use_blocklist\*(C'\fI\fR
.IX Subsection "use_blocklist"
.PP
Use blocklist
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[\-.\ew]+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`send,create_list\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.61b.1 and later.
.PP
List of operations separated by comma for which blocklist filter is applied.  Setting this parameter to \*(L"none\*(R" will hide the blocklist feature.
.PP
\fI\f(CI\*(C`info\*(C'\fI\fR
.IX Subsection "info"
.PP
Who can view list information
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`info\*(C'\fR scenario:
.RS 4
.ie n .IP """conceal"" \- restricted to subscribers \- Silent rejection otherwise." 4
.el .IP "\f(CWconceal\fR \- restricted to subscribers \- Silent rejection otherwise." 4
.IX Item "conceal - restricted to subscribers - Silent rejection otherwise."
.PD 0
.ie n .IP """open"" \- for anyone" 4
.el .IP "\f(CWopen\fR \- for anyone" 4
.IX Item "open - for anyone"
.ie n .IP """private"" \- restricted to subscribers" 4
.el .IP "\f(CWprivate\fR \- restricted to subscribers" 4
.IX Item "private - restricted to subscribers"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`open\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`subscribe\*(C'\fI\fR
.IX Subsection "subscribe"
.PP
Who can subscribe to the list
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`subscribe\*(C'\fR scenario:
.RS 4
.ie n .IP """auth"" \- subscription request confirmed" 4
.el .IP "\f(CWauth\fR \- subscription request confirmed" 4
.IX Item "auth - subscription request confirmed"
.PD 0
.ie n .IP """auth_notify"" \- need authentication (notification is sent to owners)" 4
.el .IP "\f(CWauth_notify\fR \- need authentication (notification is sent to owners)" 4
.IX Item "auth_notify - need authentication (notification is sent to owners)"
.ie n .IP """auth_notifydkim"" \- need authentication unless \s-1DKIM\s0 signature is \s-1OK\s0 (notification is sent to owners)" 4
.el .IP "\f(CWauth_notifydkim\fR \- need authentication unless \s-1DKIM\s0 signature is \s-1OK\s0 (notification is sent to owners)" 4
.IX Item "auth_notifydkim - need authentication unless DKIM signature is OK (notification is sent to owners)"
.ie n .IP """auth_owner"" \- requires authentication then owner approval" 4
.el .IP "\f(CWauth_owner\fR \- requires authentication then owner approval" 4
.IX Item "auth_owner - requires authentication then owner approval"
.ie n .IP """auth_ownerdkim"" \- requires authentication unless \s-1DKIM\s0 signature is \s-1OK,\s0 then owner approval" 4
.el .IP "\f(CWauth_ownerdkim\fR \- requires authentication unless \s-1DKIM\s0 signature is \s-1OK,\s0 then owner approval" 4
.IX Item "auth_ownerdkim - requires authentication unless DKIM signature is OK, then owner approval"
.ie n .IP """authdkim"" \- subscription request confirmed" 4
.el .IP "\f(CWauthdkim\fR \- subscription request confirmed" 4
.IX Item "authdkim - subscription request confirmed"
.ie n .IP """closed"" \- subscription is impossible" 4
.el .IP "\f(CWclosed\fR \- subscription is impossible" 4
.IX Item "closed - subscription is impossible"
.ie n .IP """open"" \- for anyone without authentication" 4
.el .IP "\f(CWopen\fR \- for anyone without authentication" 4
.IX Item "open - for anyone without authentication"
.ie n .IP """open_notify"" \- anyone, notification is sent to list owner" 4
.el .IP "\f(CWopen_notify\fR \- anyone, notification is sent to list owner" 4
.IX Item "open_notify - anyone, notification is sent to list owner"
.ie n .IP """open_quiet"" \- anyone, no welcome message" 4
.el .IP "\f(CWopen_quiet\fR \- anyone, no welcome message" 4
.IX Item "open_quiet - anyone, no welcome message"
.ie n .IP """owner"" \- owners approval" 4
.el .IP "\f(CWowner\fR \- owners approval" 4
.IX Item "owner - owners approval"
.ie n .IP """smime"" \- requires S/MIME signed" 4
.el .IP "\f(CWsmime\fR \- requires S/MIME signed" 4
.IX Item "smime - requires S/MIME signed"
.ie n .IP """smimeorowner"" \- requires S/MIME signed or owner approval" 4
.el .IP "\f(CWsmimeorowner\fR \- requires S/MIME signed or owner approval" 4
.IX Item "smimeorowner - requires S/MIME signed or owner approval"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`open\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The subscribe parameter defines the rules for subscribing to the list.
.PP
\fI\f(CI\*(C`add\*(C'\fI\fR
.IX Subsection "add"
.PP
Who can add subscribers
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`add\*(C'\fR scenario:
.RS 4
.ie n .IP """auth"" \- restricted to owner with authentication" 4
.el .IP "\f(CWauth\fR \- restricted to owner with authentication" 4
.IX Item "auth - restricted to owner with authentication"
.PD 0
.ie n .IP """authdkim"" \- restricted to owner without authentication if \s-1DKIM\s0 signature is \s-1OK.\s0" 4
.el .IP "\f(CWauthdkim\fR \- restricted to owner without authentication if \s-1DKIM\s0 signature is \s-1OK.\s0" 4
.IX Item "authdkim - restricted to owner without authentication if DKIM signature is OK."
.ie n .IP """closed"" \- add impossible" 4
.el .IP "\f(CWclosed\fR \- add impossible" 4
.IX Item "closed - add impossible"
.ie n .IP """owner"" \- add performed by list owner does not need authentication" 4
.el .IP "\f(CWowner\fR \- add performed by list owner does not need authentication" 4
.IX Item "owner - add performed by list owner does not need authentication"
.ie n .IP """owner_notify"" \- add performed by owner does not need authentication (notification)" 4
.el .IP "\f(CWowner_notify\fR \- add performed by owner does not need authentication (notification)" 4
.IX Item "owner_notify - add performed by owner does not need authentication (notification)"
.ie n .IP """ownerdkim"" \- add performed by list owner does not need authentication if \s-1DKIM\s0 signature \s-1OK\s0" 4
.el .IP "\f(CWownerdkim\fR \- add performed by list owner does not need authentication if \s-1DKIM\s0 signature \s-1OK\s0" 4
.IX Item "ownerdkim - add performed by list owner does not need authentication if DKIM signature OK"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Privilege for adding (\s-1ADD\s0 command) a subscriber to the list
.PP
\fI\f(CI\*(C`unsubscribe\*(C'\fI\fR
.IX Subsection "unsubscribe"
.PP
Who can unsubscribe
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`unsubscribe\*(C'\fR scenario:
.RS 4
.ie n .IP """auth"" \- need authentication" 4
.el .IP "\f(CWauth\fR \- need authentication" 4
.IX Item "auth - need authentication"
.PD 0
.ie n .IP """auth_notify"" \- authentication requested, notification sent to owner" 4
.el .IP "\f(CWauth_notify\fR \- authentication requested, notification sent to owner" 4
.IX Item "auth_notify - authentication requested, notification sent to owner"
.ie n .IP """auth_notifydkim"" \- authentication requested unless \s-1DKIM\s0 signature is \s-1OK,\s0 notification sent to owner" 4
.el .IP "\f(CWauth_notifydkim\fR \- authentication requested unless \s-1DKIM\s0 signature is \s-1OK,\s0 notification sent to owner" 4
.IX Item "auth_notifydkim - authentication requested unless DKIM signature is OK, notification sent to owner"
.ie n .IP """authdkim"" \- need authentication unless \s-1DKIM\s0 signature is \s-1OK\s0" 4
.el .IP "\f(CWauthdkim\fR \- need authentication unless \s-1DKIM\s0 signature is \s-1OK\s0" 4
.IX Item "authdkim - need authentication unless DKIM signature is OK"
.ie n .IP """closed"" \- impossible" 4
.el .IP "\f(CWclosed\fR \- impossible" 4
.IX Item "closed - impossible"
.ie n .IP """open"" \- open" 4
.el .IP "\f(CWopen\fR \- open" 4
.IX Item "open - open"
.ie n .IP """open_notify"" \- open with mail confirmation, owner is notified" 4
.el .IP "\f(CWopen_notify\fR \- open with mail confirmation, owner is notified" 4
.IX Item "open_notify - open with mail confirmation, owner is notified"
.ie n .IP """owner"" \- owners approval" 4
.el .IP "\f(CWowner\fR \- owners approval" 4
.IX Item "owner - owners approval"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`open\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This parameter specifies the unsubscription method for the list. Use open_notify or auth_notify to allow owner notification of each unsubscribe command.
.PP
\fI\f(CI\*(C`del\*(C'\fI\fR
.IX Subsection "del"
.PP
Who can delete subscribers
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`del\*(C'\fR scenario:
.RS 4
.ie n .IP """auth"" \- deletion performed only by list owners, need authentication" 4
.el .IP "\f(CWauth\fR \- deletion performed only by list owners, need authentication" 4
.IX Item "auth - deletion performed only by list owners, need authentication"
.PD 0
.ie n .IP """authdkim"" \- deletion performed only by list owners, need authentication unless \s-1DKIM\s0 signature is \s-1OK\s0" 4
.el .IP "\f(CWauthdkim\fR \- deletion performed only by list owners, need authentication unless \s-1DKIM\s0 signature is \s-1OK\s0" 4
.IX Item "authdkim - deletion performed only by list owners, need authentication unless DKIM signature is OK"
.ie n .IP """closed"" \- remove subscriber impossible" 4
.el .IP "\f(CWclosed\fR \- remove subscriber impossible" 4
.IX Item "closed - remove subscriber impossible"
.ie n .IP """owner"" \- by owner without authentication" 4
.el .IP "\f(CWowner\fR \- by owner without authentication" 4
.IX Item "owner - by owner without authentication"
.ie n .IP """owner_notify"" \- list owners, authentication not needed (notification)" 4
.el .IP "\f(CWowner_notify\fR \- list owners, authentication not needed (notification)" 4
.IX Item "owner_notify - list owners, authentication not needed (notification)"
.ie n .IP """ownerdkim"" \- by owner without authentication if \s-1DKIM\s0 signature \s-1OK\s0" 4
.el .IP "\f(CWownerdkim\fR \- by owner without authentication if \s-1DKIM\s0 signature \s-1OK\s0" 4
.IX Item "ownerdkim - by owner without authentication if DKIM signature OK"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`invite\*(C'\fI\fR
.IX Subsection "invite"
.PP
Who can invite people
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`invite\*(C'\fR scenario:
.RS 4
.ie n .IP """closed"" \- closed" 4
.el .IP "\f(CWclosed\fR \- closed" 4
.IX Item "closed - closed"
.PD 0
.ie n .IP """owner"" \- invite perform by list owner do not need authentication" 4
.el .IP "\f(CWowner\fR \- invite perform by list owner do not need authentication" 4
.IX Item "owner - invite perform by list owner do not need authentication"
.ie n .IP """private"" \- restricted to subscribers" 4
.el .IP "\f(CWprivate\fR \- restricted to subscribers" 4
.IX Item "private - restricted to subscribers"
.ie n .IP """public"" \- public" 4
.el .IP "\f(CWpublic\fR \- public" 4
.IX Item "public - public"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`private\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`remind\*(C'\fI\fR
.IX Subsection "remind"
.PP
Who can start a remind process
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`remind\*(C'\fR scenario:
.RS 4
.ie n .IP """listmaster"" \- listmaster only" 4
.el .IP "\f(CWlistmaster\fR \- listmaster only" 4
.IX Item "listmaster - listmaster only"
.PD 0
.ie n .IP """listmasterdkim"" \- listmaster only (do not require authentication if \s-1DKIM\s0 siganture is \s-1OK\s0)" 4
.el .IP "\f(CWlistmasterdkim\fR \- listmaster only (do not require authentication if \s-1DKIM\s0 siganture is \s-1OK\s0)" 4
.IX Item "listmasterdkim - listmaster only (do not require authentication if DKIM siganture is OK)"
.ie n .IP """owner"" \- restricted to list owners" 4
.el .IP "\f(CWowner\fR \- restricted to list owners" 4
.IX Item "owner - restricted to list owners"
.ie n .IP """ownerdkim"" \- restricted to list owners (authentication is not required if a \s-1DKIM\s0 signature is \s-1OK\s0)" 4
.el .IP "\f(CWownerdkim\fR \- restricted to list owners (authentication is not required if a \s-1DKIM\s0 signature is \s-1OK\s0)" 4
.IX Item "ownerdkim - restricted to list owners (authentication is not required if a DKIM signature is OK)"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This parameter specifies who is authorized to use the remind command.
.PP
\fI\f(CI\*(C`review\*(C'\fI\fR
.IX Subsection "review"
.PP
Who can review subscribers
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`review\*(C'\fR scenario:
.RS 4
.ie n .IP """closed"" \- no one can review" 4
.el .IP "\f(CWclosed\fR \- no one can review" 4
.IX Item "closed - no one can review"
.PD 0
.ie n .IP """listmaster"" \- listmaster only" 4
.el .IP "\f(CWlistmaster\fR \- listmaster only" 4
.IX Item "listmaster - listmaster only"
.ie n .IP """owner"" \- only owner (and listmaster)" 4
.el .IP "\f(CWowner\fR \- only owner (and listmaster)" 4
.IX Item "owner - only owner (and listmaster)"
.ie n .IP """private"" \- restricted to subscribers" 4
.el .IP "\f(CWprivate\fR \- restricted to subscribers" 4
.IX Item "private - restricted to subscribers"
.ie n .IP """public"" \- anyone can do it!" 4
.el .IP "\f(CWpublic\fR \- anyone can do it!" 4
.IX Item "public - anyone can do it!"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This parameter specifies who can access the list of members. Since subscriber addresses can be abused by spammers, it is strongly recommended that you only authorize owners or subscribers to access the subscriber list.
.PP
\fI\f(CI\*(C`owner_domain\*(C'\fI\fR
.IX Subsection "owner_domain"
.PP
Required domains for list owners
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`$host( +$host)*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.23b.3 and later.
.PP
Restrict list ownership to addresses in the specified domains. This can be used to reserve list ownership to a group of trusted users from a set of domains associated with an organization, while allowing moderators and subscribers from the Internet at large.
.PP
\fI\f(CI\*(C`owner_domain_min\*(C'\fI\fR
.IX Subsection "owner_domain_min"
.PP
Minimum owners in required domains
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW0\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.23b.3 and later.
.PP
Minimum number of owners for each list must satisfy the owner_domain restriction. The default of zero (0) means *all* list owners must match. Setting to 1 requires only one list owner to match owner_domain; all other owners can be from any domain. This setting can be used to ensure that there is always at least one known contact point for any mailing list.
.PP
\fI\f(CI\*(C`default_owner_options\*(C'\fI\fR
.IX Subsection "default_owner_options"
.PP
(Paragraph)
Owner profile
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
Default profile for the owners of the list.
.PP
\f(CW\*(C`default_owner_options.profile\*(C'\fR
.IX Subsection "default_owner_options.profile"
.PP
profile
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """privileged"" \- privileged owner" 4
.el .IP "\f(CWprivileged\fR \- privileged owner" 4
.IX Item "privileged - privileged owner"
.ie n .IP """normal"" \- normal owner" 4
.el .IP "\f(CWnormal\fR \- normal owner" 4
.IX Item "normal - normal owner"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`normal\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\f(CW\*(C`default_owner_options.reception\*(C'\fR
.IX Subsection "default_owner_options.reception"
.PP
reception mode
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """mail"" \- receive notification email" 4
.el .IP "\f(CWmail\fR \- receive notification email" 4
.IX Item "mail - receive notification email"
.ie n .IP """nomail"" \- no notifications" 4
.el .IP "\f(CWnomail\fR \- no notifications" 4
.IX Item "nomail - no notifications"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`mail\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Mail reception mode.
.PP
\f(CW\*(C`default_owner_options.visibility\*(C'\fR
.IX Subsection "default_owner_options.visibility"
.PP
visibility
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """conceal"" \- concealed from list menu" 4
.el .IP "\f(CWconceal\fR \- concealed from list menu" 4
.IX Item "conceal - concealed from list menu"
.ie n .IP """noconceal"" \- listed on the list menu" 4
.el .IP "\f(CWnoconceal\fR \- listed on the list menu" 4
.IX Item "noconceal - listed on the list menu"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`noconceal\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Visibility of the owner.
.PP
\fI\f(CI\*(C`default_editor_options\*(C'\fI\fR
.IX Subsection "default_editor_options"
.PP
(Paragraph)
Moderator profile
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
Default profile for the moderators of the list.
.PP
\f(CW\*(C`default_editor_options.reception\*(C'\fR
.IX Subsection "default_editor_options.reception"
.PP
reception mode
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """mail"" \- receive notification email" 4
.el .IP "\f(CWmail\fR \- receive notification email" 4
.IX Item "mail - receive notification email"
.ie n .IP """nomail"" \- no notifications" 4
.el .IP "\f(CWnomail\fR \- no notifications" 4
.IX Item "nomail - no notifications"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`mail\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Mail reception mode.
.PP
\f(CW\*(C`default_editor_options.visibility\*(C'\fR
.IX Subsection "default_editor_options.visibility"
.PP
visibility
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """conceal"" \- concealed from list menu" 4
.el .IP "\f(CWconceal\fR \- concealed from list menu" 4
.IX Item "conceal - concealed from list menu"
.ie n .IP """noconceal"" \- listed on the list menu" 4
.el .IP "\f(CWnoconceal\fR \- listed on the list menu" 4
.IX Item "noconceal - listed on the list menu"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`noconceal\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Visibility of the moderator.
.PP
\fI\f(CI\*(C`shared_doc\*(C'\fI\fR
.IX Subsection "shared_doc"
.PP
(Paragraph)
Shared documents
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
This paragraph defines read and edit access to the shared document repository.
.PP
\f(CW\*(C`shared_doc.d_read\*(C'\fR
.IX Subsection "shared_doc.d_read"
.PP
Who can view
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`d_read\*(C'\fR scenario:
.RS 4
.ie n .IP """owner"" \- restricted to list owners" 4
.el .IP "\f(CWowner\fR \- restricted to list owners" 4
.IX Item "owner - restricted to list owners"
.PD 0
.ie n .IP """private"" \- restricted to subscribers" 4
.el .IP "\f(CWprivate\fR \- restricted to subscribers" 4
.IX Item "private - restricted to subscribers"
.ie n .IP """private\-https"" \- restricted to subscribers authenticated with user cert" 4
.el .IP "\f(CWprivate\-https\fR \- restricted to subscribers authenticated with user cert" 4
.IX Item "private-https - restricted to subscribers authenticated with user cert"
.ie n .IP """public"" \- public documents" 4
.el .IP "\f(CWpublic\fR \- public documents" 4
.IX Item "public - public documents"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`private\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\f(CW\*(C`shared_doc.d_edit\*(C'\fR
.IX Subsection "shared_doc.d_edit"
.PP
Who can edit
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`d_edit\*(C'\fR scenario:
.RS 4
.ie n .IP """editor"" \- moderated for subscribers" 4
.el .IP "\f(CWeditor\fR \- moderated for subscribers" 4
.IX Item "editor - moderated for subscribers"
.PD 0
.ie n .IP """owner"" \- restricted to list owners" 4
.el .IP "\f(CWowner\fR \- restricted to list owners" 4
.IX Item "owner - restricted to list owners"
.ie n .IP """private"" \- restricted to subscribers" 4
.el .IP "\f(CWprivate\fR \- restricted to subscribers" 4
.IX Item "private - restricted to subscribers"
.ie n .IP """private\-https"" \- restricted to subscribers authenticated with user cert" 4
.el .IP "\f(CWprivate\-https\fR \- restricted to subscribers authenticated with user cert" 4
.IX Item "private-https - restricted to subscribers authenticated with user cert"
.ie n .IP """public"" \- public documents" 4
.el .IP "\f(CWpublic\fR \- public documents" 4
.IX Item "public - public documents"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\f(CW\*(C`shared_doc.quota\*(C'\fR
.IX Subsection "shared_doc.quota"
.PP
quota
.IP "Format:" 4
.IX Item "Format:"
Number of Kbytes.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.SS "Archives"
.IX Subsection "Archives"
\fI\f(CI\*(C`ignore_x_no_archive_header_feature\*(C'\fI\fR
.IX Subsection "ignore_x_no_archive_header_feature"
.PP
Ignore \*(L"X\-no-archive:\*(R" header field
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Sympa's default behavior is to skip archiving of incoming messages that have an \*(L"X\-no-archive:\*(R" header field set. This parameter allows one to change this behavior.
.PP
Example:
.PP
.Vb 1
\&  ignore_x_no_archive_header_feature on
.Ve
.PP
\fI\f(CI\*(C`custom_archiver\*(C'\fI\fR
.IX Subsection "custom_archiver"
.PP
Custom archiver
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Activates a custom archiver to use instead of MHonArc. The value of this parameter is the absolute path to the executable file.
.PP
Sympa invokes this file with these two arguments:
.PP
\&\-\-list
.PP
The address of the list including domain part.
.PP
\&\-\-file
.PP
Absolute path to the message to be archived.
.PP
\fI\f(CI\*(C`process_archive\*(C'\fI\fR
.IX Subsection "process_archive"
.PP
Store distributed messages into archive
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2b.1 and later.
.PP
If enabled, distributed messages via lists will be archived. Otherwise archiving is disabled.
.PP
Note that even if setting this parameter disabled, past archives will not be removed and will be accessible according to access settings by each list.
.PP
\fI\f(CI\*(C`archive\*(C'\fI\fR
.IX Subsection "archive"
.PP
(Paragraph)
Archives
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
Privilege for reading mail archives and frequency of archiving.
.PP
Defines who can access the list's web archive.
.PP
\f(CW\*(C`archive.period\*(C'\fR
.IX Subsection "archive.period"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`archive.access\*(C'\fR
.IX Subsection "archive.access"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2a.43.
.PP
\f(CW\*(C`archive.web_access\*(C'\fR
.IX Subsection "archive.web_access"
.PP
access right
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`archive_web_access\*(C'\fR scenario:
.RS 4
.ie n .IP """closed"" \- closed" 4
.el .IP "\f(CWclosed\fR \- closed" 4
.IX Item "closed - closed"
.PD 0
.ie n .IP """listmaster"" \- listmaster" 4
.el .IP "\f(CWlistmaster\fR \- listmaster" 4
.IX Item "listmaster - listmaster"
.ie n .IP """owner"" \- by owner" 4
.el .IP "\f(CWowner\fR \- by owner" 4
.IX Item "owner - by owner"
.ie n .IP """private"" \- subscribers only" 4
.el .IP "\f(CWprivate\fR \- subscribers only" 4
.IX Item "private - subscribers only"
.ie n .IP """public"" \- public" 4
.el .IP "\f(CWpublic\fR \- public" 4
.IX Item "public - public"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`closed\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2b.1 and later.
.PP
\f(CW\*(C`archive.mail_access\*(C'\fR
.IX Subsection "archive.mail_access"
.PP
access right by mail commands
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`archive_mail_access\*(C'\fR scenario:
.RS 4
.ie n .IP """closed"" \- closed" 4
.el .IP "\f(CWclosed\fR \- closed" 4
.IX Item "closed - closed"
.PD 0
.ie n .IP """owner"" \- by owner" 4
.el .IP "\f(CWowner\fR \- by owner" 4
.IX Item "owner - by owner"
.ie n .IP """private"" \- subscribers only" 4
.el .IP "\f(CWprivate\fR \- subscribers only" 4
.IX Item "private - subscribers only"
.ie n .IP """public"" \- public" 4
.el .IP "\f(CWpublic\fR \- public" 4
.IX Item "public - public"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`closed\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2b.1 and later.
.PP
\f(CW\*(C`archive.quota\*(C'\fR
.IX Subsection "archive.quota"
.PP
quota
.IP "Format:" 4
.IX Item "Format:"
Number of Kbytes.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2b.1 and later.
.PP
\f(CW\*(C`archive.max_month\*(C'\fR
.IX Subsection "archive.max_month"
.PP
Maximum number of month archived
.IP "Format:" 4
.IX Item "Format:"
Number of months.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2b.1 and later.
.PP
\fI\f(CI\*(C`archive_crypted_msg\*(C'\fI\fR
.IX Subsection "archive_crypted_msg"
.PP
Archive encrypted mails as cleartext
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """original"" \- original messages" 4
.el .IP "\f(CWoriginal\fR \- original messages" 4
.IX Item "original - original messages"
.ie n .IP """decrypted"" \- decrypted messages" 4
.el .IP "\f(CWdecrypted\fR \- decrypted messages" 4
.IX Item "decrypted - decrypted messages"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`original\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`web_archive_spam_protection\*(C'\fI\fR
.IX Subsection "web_archive_spam_protection"
.PP
Protect web archive against spam harvesters
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """cookie"" \- use \s-1HTTP\s0 cookie" 4
.el .IP "\f(CWcookie\fR \- use \s-1HTTP\s0 cookie" 4
.IX Item "cookie - use HTTP cookie"
.ie n .IP """javascript"" \- use JavaScript" 4
.el .IP "\f(CWjavascript\fR \- use JavaScript" 4
.IX Item "javascript - use JavaScript"
.ie n .IP """at"" \- replace @ characters" 4
.el .IP "\f(CWat\fR \- replace @ characters" 4
.IX Item "at - replace @ characters"
.ie n .IP """concealed"" \- never show address" 4
.el .IP "\f(CWconcealed\fR \- never show address" 4
.IX Item "concealed - never show address"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`cookie\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The same as \*(L"spam_protection\*(R", but restricted to the web archive.
.PP
In addition to it:
.PP
cookie: users must submit a small form in order to receive a cookie before browsing the web archive.
.PP
concealed: e\-mail addresses will never be displayed.
.SS "Bounces"
.IX Subsection "Bounces"
\fI\f(CI\*(C`bounce\*(C'\fI\fR
.IX Subsection "bounce"
.PP
(Paragraph)
Bounces management
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
\f(CW\*(C`bounce.warn_rate\*(C'\fR
.IX Subsection "bounce.warn_rate"
.PP
warn rate
.IP "Format:" 4
.IX Item "Format:"
Number of %.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (%)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
The list owner receives a warning whenever a message is distributed and the number (percentage) of bounces exceeds this value.
.PP
\f(CW\*(C`bounce.halt_rate\*(C'\fR
.IX Subsection "bounce.halt_rate"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`bouncers_level1\*(C'\fI\fR
.IX Subsection "bouncers_level1"
.PP
(Paragraph)
Management of bouncers, 1st level
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
Level 1 is the lower level of bouncing users
.PP
\f(CW\*(C`bouncers_level1.rate\*(C'\fR
.IX Subsection "bouncers_level1.rate"
.PP
threshold
.IP "Format:" 4
.IX Item "Format:"
Number of points.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW45\fR (points)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Each bouncing user have a score (from 0 to 100).
.PP
This parameter defines a lower limit for each category of bouncing users.For example, level 1 begins from 45 to level_2_treshold.
.PP
\f(CW\*(C`bouncers_level1.action\*(C'\fR
.IX Subsection "bouncers_level1.action"
.PP
action for this population
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """remove_bouncers"" \- remove bouncing users" 4
.el .IP "\f(CWremove_bouncers\fR \- remove bouncing users" 4
.IX Item "remove_bouncers - remove bouncing users"
.ie n .IP """notify_bouncers"" \- send notify to bouncing users" 4
.el .IP "\f(CWnotify_bouncers\fR \- send notify to bouncing users" 4
.IX Item "notify_bouncers - send notify to bouncing users"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`notify_bouncers\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
This parameter defines which task is automatically applied on level 1 bouncers.
.PP
\f(CW\*(C`bouncers_level1.notification\*(C'\fR
.IX Subsection "bouncers_level1.notification"
.PP
notification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """owner"" \- owner" 4
.el .IP "\f(CWowner\fR \- owner" 4
.IX Item "owner - owner"
.ie n .IP """listmaster"" \- listmaster" 4
.el .IP "\f(CWlistmaster\fR \- listmaster" 4
.IX Item "listmaster - listmaster"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
When automatic task is executed on level 1 bouncers, a notification email can be send to listowner or listmaster.
.PP
\fI\f(CI\*(C`bouncers_level2\*(C'\fI\fR
.IX Subsection "bouncers_level2"
.PP
(Paragraph)
Management of bouncers, 2nd level
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
Level 2 is the highest level of bouncing users
.PP
\f(CW\*(C`bouncers_level2.rate\*(C'\fR
.IX Subsection "bouncers_level2.rate"
.PP
threshold
.IP "Format:" 4
.IX Item "Format:"
Number of points.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW75\fR (points)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Each bouncing user have a score (from 0 to 100).
.PP
This parameter defines the score range defining each category of bouncing users.For example, level 2 is for users with a score between 80 and 100.
.PP
\f(CW\*(C`bouncers_level2.action\*(C'\fR
.IX Subsection "bouncers_level2.action"
.PP
action for this population
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """remove_bouncers"" \- remove bouncing users" 4
.el .IP "\f(CWremove_bouncers\fR \- remove bouncing users" 4
.IX Item "remove_bouncers - remove bouncing users"
.ie n .IP """notify_bouncers"" \- send notify to bouncing users" 4
.el .IP "\f(CWnotify_bouncers\fR \- send notify to bouncing users" 4
.IX Item "notify_bouncers - send notify to bouncing users"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`remove_bouncers\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
This parameter defines which task is automatically applied on level 2 bouncers.
.PP
\f(CW\*(C`bouncers_level2.notification\*(C'\fR
.IX Subsection "bouncers_level2.notification"
.PP
notification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """owner"" \- owner" 4
.el .IP "\f(CWowner\fR \- owner" 4
.IX Item "owner - owner"
.ie n .IP """listmaster"" \- listmaster" 4
.el .IP "\f(CWlistmaster\fR \- listmaster" 4
.IX Item "listmaster - listmaster"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
When automatic task is executed on level 2 bouncers, a notification email can be send to listowner or listmaster.
.PP
\fI\f(CI\*(C`verp_rate\*(C'\fI\fR
.IX Subsection "verp_rate"
.PP
percentage of list members in \s-1VERP\s0 mode
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """100%"" \- 100% \- always" 4
.el .IP "\f(CW100%\fR \- 100% \- always" 4
.IX Item "100% - 100% - always"
.ie n .IP """50%"" \- 50%" 4
.el .IP "\f(CW50%\fR \- 50%" 4
.IX Item "50% - 50%"
.ie n .IP """33%"" \- 33%" 4
.el .IP "\f(CW33%\fR \- 33%" 4
.IX Item "33% - 33%"
.ie n .IP """25%"" \- 25%" 4
.el .IP "\f(CW25%\fR \- 25%" 4
.IX Item "25% - 25%"
.ie n .IP """20%"" \- 20%" 4
.el .IP "\f(CW20%\fR \- 20%" 4
.IX Item "20% - 20%"
.ie n .IP """10%"" \- 10%" 4
.el .IP "\f(CW10%\fR \- 10%" 4
.IX Item "10% - 10%"
.ie n .IP """5%"" \- 5%" 4
.el .IP "\f(CW5%\fR \- 5%" 4
.IX Item "5% - 5%"
.ie n .IP """2%"" \- 2%" 4
.el .IP "\f(CW2%\fR \- 2%" 4
.IX Item "2% - 2%"
.ie n .IP """0%"" \- 0% \- never" 4
.el .IP "\f(CW0%\fR \- 0% \- never" 4
.IX Item "0% - 0% - never"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`0%\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Uses variable envelope return path (\s-1VERP\s0) to detect bouncing subscriber addresses.
.PP
0%: \s-1VERP\s0 is never used.
.PP
100%: \s-1VERP\s0 is always in use.
.PP
\&\s-1VERP\s0 requires address with extension to be supported by \s-1MTA.\s0 If tracking is enabled for a list or a message, \s-1VERP\s0 is applied for 100% of subscribers.
.PP
\fI\f(CI\*(C`tracking\*(C'\fI\fR
.IX Subsection "tracking"
.PP
(Paragraph)
Message tracking feature
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
\f(CW\*(C`tracking.delivery_status_notification\*(C'\fR
.IX Subsection "tracking.delivery_status_notification"
.PP
tracking message by delivery status notification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
\f(CW\*(C`tracking.message_disposition_notification\*(C'\fR
.IX Subsection "tracking.message_disposition_notification"
.PP
tracking message by message disposition notification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """on_demand"" \- on demand" 4
.el .IP "\f(CWon_demand\fR \- on demand" 4
.IX Item "on_demand - on demand"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.41 and later.
.PP
\f(CW\*(C`tracking.tracking\*(C'\fR
.IX Subsection "tracking.tracking"
.PP
who can view message tracking
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`tracking\*(C'\fR scenario:
.RS 4
.ie n .IP """owner"" \- only owner (and listmaster)" 4
.el .IP "\f(CWowner\fR \- only owner (and listmaster)" 4
.IX Item "owner - only owner (and listmaster)"
.PD 0
.ie n .IP """private"" \- restricted to subscribers" 4
.el .IP "\f(CWprivate\fR \- restricted to subscribers" 4
.IX Item "private - restricted to subscribers"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.3 and later.
.PP
\f(CW\*(C`tracking.retention_period\*(C'\fR
.IX Subsection "tracking.retention_period"
.PP
Tracking datas are removed after this number of days
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW90\fR (days)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.3 and later.
.PP
\f(CW\*(C`tracking.message_delivery_notification\*(C'\fR
.IX Subsection "tracking.message_delivery_notification"
.PP
See \f(CW\*(C`message_disposition_notification\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 to 6.2a.40.
.PP
\fI\f(CI\*(C`welcome_return_path\*(C'\fI\fR
.IX Subsection "welcome_return_path"
.PP
Welcome return-path
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """unique"" \- bounce management" 4
.el .IP "\f(CWunique\fR \- bounce management" 4
.IX Item "unique - bounce management"
.ie n .IP """owner"" \- owner" 4
.el .IP "\f(CWowner\fR \- owner" 4
.IX Item "owner - owner"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
If set to unique, the welcome message is sent using a unique return path in order to remove the subscriber immediately in the case of a bounce.
.PP
\fI\f(CI\*(C`remind_return_path\*(C'\fI\fR
.IX Subsection "remind_return_path"
.PP
Return-path of the \s-1REMIND\s0 command
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """unique"" \- bounce management" 4
.el .IP "\f(CWunique\fR \- bounce management" 4
.IX Item "unique - bounce management"
.ie n .IP """owner"" \- owner" 4
.el .IP "\f(CWowner\fR \- owner" 4
.IX Item "owner - owner"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
Same as welcome_return_path, but applied to remind messages.
.PP
\fI\f(CI\*(C`expire_bounce_task\*(C'\fI\fR
.IX Subsection "expire_bounce_task"
.PP
Task for expiration of old bounces
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`daily\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This task resets bouncing information for addresses not bouncing in the last 10 days after the latest message distribution.
.PP
\fI\f(CI\*(C`purge_orphan_bounces_task\*(C'\fI\fR
.IX Subsection "purge_orphan_bounces_task"
.PP
Task for cleaning invalidated bounces
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`monthly\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This task deletes bounce information for unsubscribed users.
.PP
\fI\f(CI\*(C`eval_bouncers_task\*(C'\fI\fR
.IX Subsection "eval_bouncers_task"
.PP
Task for updating bounce scores
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`daily\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This task scans all bouncing users for all lists, and updates \*(L"bounce_score_subscriber\*(R" field in \*(L"subscriber_table\*(R" table. The scores may be used for management of bouncers.
.PP
\fI\f(CI\*(C`process_bouncers_task\*(C'\fI\fR
.IX Subsection "process_bouncers_task"
.PP
Task for management of bouncers
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`weekly\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This task executes actions on bouncing users configured by each list, according to their scores.
.PP
\fI\f(CI\*(C`purge_tables_task\*(C'\fI\fR
.IX Subsection "purge_tables_task"
.PP
Task for cleaning tables
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`daily\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This task cleans old tracking information from \*(L"notification_table\*(R" table.
.PP
\fI\f(CI\*(C`minimum_bouncing_count\*(C'\fI\fR
.IX Subsection "minimum_bouncing_count"
.PP
Minimum number of bounces
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW10\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The minimum number of bounces received to update bounce score of a user.
.PP
\fI\f(CI\*(C`minimum_bouncing_period\*(C'\fI\fR
.IX Subsection "minimum_bouncing_period"
.PP
Minimum bouncing period
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW10\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The minimum period for which bouncing lasted to update bounce score of a user.
.PP
\fI\f(CI\*(C`bounce_delay\*(C'\fI\fR
.IX Subsection "bounce_delay"
.PP
Delay of bounces
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW0\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Average time for a bounce sent back to mailing list server after a post was sent to a list. Usually bounces are sent back on the same day as the original message.
.PP
\fI\f(CI\*(C`bounce_email_prefix\*(C'\fI\fR
.IX Subsection "bounce_email_prefix"
.PP
Prefix of \s-1VERP\s0 return address
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`bounce\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The prefix to consist the return-path of probe messages used for bounce management, when variable envelope return path (\s-1VERP\s0) is enabled. \s-1VERP\s0 requires address with extension to be supported by \s-1MTA.\s0
.PP
If you change the default value, you must modify the mail aliases too.
.PP
\fI\f(CI\*(C`return_path_suffix\*(C'\fI\fR
.IX Subsection "return_path_suffix"
.PP
Suffix of list return address
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`\-owner\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The suffix appended to the list name to form the return-path of messages distributed through the list. This address will receive all non-delivery reports (also called bounces).
.SS "Loop prevention"
.IX Subsection "Loop prevention"
\fI\f(CI\*(C`loop_command_max\*(C'\fI\fR
.IX Subsection "loop_command_max"
.PP
Maximum number of responses to command message
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW200\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The maximum number of command reports sent to an email address. Messages are stored in \*(L"bad\*(R" subdirectory of incoming message spool, and reports are not longer sent.
.PP
\fI\f(CI\*(C`loop_command_sampling_delay\*(C'\fI\fR
.IX Subsection "loop_command_sampling_delay"
.PP
Delay before counting responses to command message
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW3600\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This parameter defines the delay in seconds before decrementing the counter of reports sent to an email address.
.PP
\fI\f(CI\*(C`loop_command_decrease_factor\*(C'\fI\fR
.IX Subsection "loop_command_decrease_factor"
.PP
Decrementing factor of responses to command message
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[.\ed]+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW0.5\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The decrementation factor (from 0 to 1), used to determine the new report counter after expiration of the delay.
.PP
\fI\f(CI\*(C`msgid_table_cleanup_ttl\*(C'\fI\fR
.IX Subsection "msgid_table_cleanup_ttl"
.PP
Expiration period of message \s-1ID\s0 table
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW86400\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Expiration period of entries in the table maintained by sympa_msg.pl daemon to prevent delivery of duplicate messages caused by loop.
.PP
\fI\f(CI\*(C`msgid_table_cleanup_frequency\*(C'\fI\fR
.IX Subsection "msgid_table_cleanup_frequency"
.PP
Cleanup interval of message \s-1ID\s0 table
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW3600\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Interval between cleanups of the table maintained by sympa_msg.pl daemon to prevent delivery of duplicate messages caused by loop.
.SS "Automatic lists"
.IX Subsection "Automatic lists"
\fI\f(CI\*(C`automatic_list_feature\*(C'\fI\fR
.IX Subsection "automatic_list_feature"
.PP
Automatic list
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`automatic_list_removal\*(C'\fI\fR
.IX Subsection "automatic_list_removal"
.PP
Remove empty automatic list
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """if_empty"" \- if_empty" 4
.el .IP "\f(CWif_empty\fR \- if_empty" 4
.IX Item "if_empty - if_empty"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`none\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
If set to \*(L"if_empty\*(R", then Sympa will remove automatically created mailing lists just after their creation, if they contain no list member.
.PP
Example:
.PP
.Vb 1
\&  automatic_list_removal if_empty
.Ve
.PP
\fI\f(CI\*(C`automatic_list_creation\*(C'\fI\fR
.IX Subsection "automatic_list_creation"
.PP
Who is able to create automatic list
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`automatic_list_creation\*(C'\fR scenario:
.RS 4
.ie n .IP """family_owner"" \- Restricted to people subscribed to the list of family owners." 4
.el .IP "\f(CWfamily_owner\fR \- Restricted to people subscribed to the list of family owners." 4
.IX Item "family_owner - Restricted to people subscribed to the list of family owners."
.PD 0
.ie n .IP """listmaster"" \- restricted to listmaster" 4
.el .IP "\f(CWlistmaster\fR \- restricted to listmaster" 4
.IX Item "listmaster - restricted to listmaster"
.ie n .IP """public"" \- anybody. Be sure you know what you are doing" 4
.el .IP "\f(CWpublic\fR \- anybody. Be sure you know what you are doing" 4
.IX Item "public - anybody. Be sure you know what you are doing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`public\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`automatic_list_families\*(C'\fI\fR
.IX Subsection "automatic_list_families"
.PP
Definition of automatic list families
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Defines the families the automatic lists are based on. It is a character string structured as follows:
.PP
* each family is separated from the other by a semicolon (;)
.PP
* inside a family definition, each field is separated from the other by a colon (:)
.PP
* each field has the structure: \*(L"<field name>=<field value>\*(R"
.PP
Basically, each time Sympa uses the automatic lists families, the values defined in this parameter will be available in the family object.
.PP
* for scenarios: [family\->name]
.PP
* for templates: [% family.name %]
.PP
Example:
.PP
.Vb 1
\&  automatic_list_families name=family_one:prefix=f1:display=My automatic lists:prefix_separator=+:classes separator=\-:family_owners_list=alist@domain.tld;name=family_two:prefix=f2:display=My other automatic lists:prefix_separator=+:classes separator=\-:family_owners_list=anotherlist@domain.tld;
.Ve
.PP
\fI\f(CI\*(C`parsed_family_files\*(C'\fI\fR
.IX Subsection "parsed_family_files"
.PP
Parsed files for families
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[\-.\ew]+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`message_header,message_header.mime,message_footer,message_footer.mime,info\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
comma-separated list of files that will be parsed by Sympa when instantiating a family (no space allowed in file names)
.PP
\fI\f(CI\*(C`family_signoff\*(C'\fI\fR
.IX Subsection "family_signoff"
.PP
Global unsubscription
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`family_signoff\*(C'\fR scenario:
.RS 4
.ie n .IP """auth"" \- need authentication" 4
.el .IP "\f(CWauth\fR \- need authentication" 4
.IX Item "auth - need authentication"
.PD 0
.ie n .IP """closed"" \- impossible" 4
.el .IP "\f(CWclosed\fR \- impossible" 4
.IX Item "closed - impossible"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`auth\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.54 and later.
.SS "Tag based spam filtering"
.IX Subsection "Tag based spam filtering"
\fI\f(CI\*(C`antispam_feature\*(C'\fI\fR
.IX Subsection "antispam_feature"
.PP
Tag based spam filtering
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`antispam_tag_header_name\*(C'\fI\fR
.IX Subsection "antispam_tag_header_name"
.PP
Header field to tag spams
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`X\-Spam\-Status\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
If a spam filter (like spamassassin or j\-chkmail) add a header field to tag spams, name of this header field (example X\-Spam-Status)
.PP
\fI\f(CI\*(C`antispam_tag_header_spam_regexp\*(C'\fI\fR
.IX Subsection "antispam_tag_header_spam_regexp"
.PP
Regular expression to check header field to tag spams
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`^\es*Yes\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Regular expression applied on this header to verify message is a spam (example Yes)
.PP
\fI\f(CI\*(C`antispam_tag_header_ham_regexp\*(C'\fI\fR
.IX Subsection "antispam_tag_header_ham_regexp"
.PP
Regular expression to determine spam or ham.
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`^\es*No\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Regular expression applied on this header field to verify message is \s-1NOT\s0 a spam (example No)
.PP
\fI\f(CI\*(C`spam_status\*(C'\fI\fR
.IX Subsection "spam_status"
.PP
Name of header field to inform
.IP "Format:" 4
.IX Item "Format:"
Name of \f(CW\*(C`spam_status\*(C'\fR scenario:
.RS 4
.ie n .IP """x\-spam\-status"" \- test X\-Spam-Status header" 4
.el .IP "\f(CWx\-spam\-status\fR \- test X\-Spam-Status header" 4
.IX Item "x-spam-status - test X-Spam-Status header"
.RE
.RS 4
.RE
.PD 0
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`x\-spam\-status\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Messages are supposed to be filtered by an spam filter that adds them one or more headers. This parameter is used to select a special scenario in order to decide the message's spam status: ham, spam or unsure. This parameter replaces antispam_tag_header_name, antispam_tag_header_spam_regexp and antispam_tag_header_ham_regexp.
.SS "Directories"
.IX Subsection "Directories"
\fI\f(CI\*(C`home\*(C'\fI\fR
.IX Subsection "home"
.PP
List home
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW$EXPLDIR\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Base directory of list configurations.
.PP
\fI\f(CI\*(C`etc\*(C'\fI\fR
.IX Subsection "etc"
.PP
Directory for configuration files
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW$SYSCONFDIR\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Base directory of global configuration (except \*(L"sympa.conf\*(R").
.PP
\fI\f(CI\*(C`spool\*(C'\fI\fR
.IX Subsection "spool"
.PP
Base directory of spools
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW$SPOOLDIR\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Base directory of all spools which are created at runtime. This directory must be writable by Sympa user.
.PP
\fI\f(CI\*(C`queue\*(C'\fI\fR
.IX Subsection "queue"
.PP
Directory for message incoming spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/msg\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This spool is used both by \*(L"queue\*(R" program and \*(L"sympa_msg.pl\*(R" daemon.
.PP
\fI\f(CI\*(C`queuemod\*(C'\fI\fR
.IX Subsection "queuemod"
.PP
Directory for moderation spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/moderation\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`queuedigest\*(C'\fI\fR
.IX Subsection "queuedigest"
.PP
Directory for digest spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/digest\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`queueauth\*(C'\fI\fR
.IX Subsection "queueauth"
.PP
Directory for held message spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/auth\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This parameter is named such by historical reason.
.PP
\fI\f(CI\*(C`queueoutgoing\*(C'\fI\fR
.IX Subsection "queueoutgoing"
.PP
Directory for archive spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/outgoing\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This parameter is named such by historical reason.
.PP
\fI\f(CI\*(C`queuesubscribe\*(C'\fI\fR
.IX Subsection "queuesubscribe"
.PP
Directory for held request spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/subscribe\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This parameter is named such by historical reason.
.PP
\fI\f(CI\*(C`queuetopic\*(C'\fI\fR
.IX Subsection "queuetopic"
.PP
Directory for topic spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/topic\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`queuebounce\*(C'\fI\fR
.IX Subsection "queuebounce"
.PP
Directory for bounce incoming spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/bounce\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This spool is used both by \*(L"bouncequeue\*(R" program and \*(L"bounced.pl\*(R" daemon.
.PP
\fI\f(CI\*(C`queuetask\*(C'\fI\fR
.IX Subsection "queuetask"
.PP
Directory for task spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/task\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`queueautomatic\*(C'\fI\fR
.IX Subsection "queueautomatic"
.PP
Directory for automatic list creation spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/automatic\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This spool is used both by \*(L"familyqueue\*(R" program and \*(L"sympa_automatic.pl\*(R" daemon.
.PP
\fI\f(CI\*(C`queuebulk\*(C'\fI\fR
.IX Subsection "queuebulk"
.PP
Directory for message outgoing spool
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/bulk\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.41 and later.
.PP
This parameter is named such by historical reason.
.PP
\fI\f(CI\*(C`tmpdir\*(C'\fI\fR
.IX Subsection "tmpdir"
.PP
Temporary directory used by external programs such as virus scanner. Also, outputs to daemons' standard error are redirected to the files under this directory.
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/tmp\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`viewmail_dir\*(C'\fI\fR
.IX Subsection "viewmail_dir"
.PP
Directory to cache formatted messages
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$SPOOLDIR/viewmail\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Base directory path of directories where \s-1HTML\s0 view of messages are cached.
.PP
\fI\f(CI\*(C`bounce_path\*(C'\fI\fR
.IX Subsection "bounce_path"
.PP
Directory for storing bounces
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW$BOUNCEDIR\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
The directory where bounced.pl daemon will store the last bouncing message for each user. A message is stored in the file: <bounce_path>/<list name>@<mail domain name>/<email address>, or, if tracking is enabled: <bounce_path>/<list name>@<mail domain name>/<email address>_<envelope \s-1ID\s0>.
.PP
Users can access to these messages using web interface in the bounce management page.
.PP
Don't confuse with \*(L"queuebounce\*(R" parameter which defines the spool where incoming error reports are stored and picked by bounced.pl daemon.
.PP
\fI\f(CI\*(C`arc_path\*(C'\fI\fR
.IX Subsection "arc_path"
.PP
Directory for storing archives
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW$ARCDIR\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Where to store \s-1HTML\s0 archives. This parameter is used by the \*(L"archived.pl\*(R" daemon. It is a good idea to install the archive outside the web document hierarchy to prevent overcoming of WWSympa's access control.
.PP
\fI\f(CI\*(C`purge_spools_task\*(C'\fI\fR
.IX Subsection "purge_spools_task"
.PP
Task for cleaning spools
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`daily\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2b.4 and later.
.PP
This task cleans old content in spools.
.PP
\fI\f(CI\*(C`clean_delay_queue\*(C'\fI\fR
.IX Subsection "clean_delay_queue"
.PP
Max age of incoming bad messages
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW7\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of days \*(L"bad\*(R" messages are kept in message incoming spool (as specified by \*(L"queue\*(R" parameter). Sympa keeps messages rejected for various reasons (badly formatted, looping etc.).
.PP
\fI\f(CI\*(C`clean_delay_queueoutgoing\*(C'\fI\fR
.IX Subsection "clean_delay_queueoutgoing"
.PP
Max age of bad messages for archives
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW7\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of days \*(L"bad\*(R" messages are kept in message archive spool (as specified by \*(L"queueoutgoing\*(R" parameter). Sympa keeps messages rejected for various reasons (unable to create archive directory, to copy file etc.).
.PP
\fI\f(CI\*(C`clean_delay_queuebounce\*(C'\fI\fR
.IX Subsection "clean_delay_queuebounce"
.PP
Max age of bad bounce messages
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW7\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of days \*(L"bad\*(R" messages are kept in bounce spool (as specified by \*(L"queuebounce\*(R" parameter). Sympa keeps messages rejected for various reasons (unknown original sender, unknown report type).
.PP
\fI\f(CI\*(C`clean_delay_queueauth\*(C'\fI\fR
.IX Subsection "clean_delay_queueauth"
.PP
Max age of held messages
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of days messages are kept in held message spool (as specified by \*(L"queueauth\*(R" parameter). Beyond this deadline, messages that have not been confirmed are deleted.
.PP
\fI\f(CI\*(C`clean_delay_queuesubscribe\*(C'\fI\fR
.IX Subsection "clean_delay_queuesubscribe"
.PP
Max age of held requests
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of days requests are kept in held request spool (as specified by \*(L"queuesubscribe\*(R" parameter). Beyond this deadline, requests that have not been validated nor declined are deleted.
.PP
\fI\f(CI\*(C`clean_delay_queuetopic\*(C'\fI\fR
.IX Subsection "clean_delay_queuetopic"
.PP
Max age of tagged topics
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of days (automatically or manually) tagged topics are kept in topic spool (as specified by \*(L"queuetopic\*(R" parameter). Beyond this deadline, tagging is forgotten.
.PP
\fI\f(CI\*(C`clean_delay_queueautomatic\*(C'\fI\fR
.IX Subsection "clean_delay_queueautomatic"
.PP
Max age of incoming bad messages in automatic list creation spool
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW10\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of days \*(L"bad\*(R" messages are kept in automatic list creation spool (as specified by \*(L"queueautomatic\*(R" parameter). Sympa keeps messages rejected for various reasons (badly formatted, looping etc.).
.PP
\fI\f(CI\*(C`clean_delay_queuebulk\*(C'\fI\fR
.IX Subsection "clean_delay_queuebulk"
.PP
Max age of outgoing bad messages
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW7\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of days \*(L"bad\*(R" messages are kept in message outgoing spool (as specified by \*(L"queuebulk\*(R" parameter). Sympa keeps messages rejected for various reasons (failed personalization, bad configuration on \s-1MTA\s0 etc.).
.PP
\fI\f(CI\*(C`clean_delay_queuedigest\*(C'\fI\fR
.IX Subsection "clean_delay_queuedigest"
.PP
Max age of bad messages in digest spool
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW14\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.6 and later.
.PP
Number of days \*(L"bad\*(R" messages are kept in digest spool (as specified by \*(L"queuedigest\*(R" parameter). Sympa keeps messages rejected for various reasons (syntax errors in \*(L"digest.tt2\*(R" template etc.).
.PP
\fI\f(CI\*(C`clean_delay_tmpdir\*(C'\fI\fR
.IX Subsection "clean_delay_tmpdir"
.PP
Max age of temporary files
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW7\fR (days)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of days files in temporary directory (as specified by \*(L"tmpdir\*(R" parameter), including standard error logs, are kept.
.SS "S/MIME and \s-1TLS\s0"
.IX Subsection "S/MIME and TLS"
S/MIME authentication, decryption and re-encryption. It requires these external modules: Crypt\-OpenSSL\-X509 and Crypt-SMIME.
.PP
\&\s-1TLS\s0 client authentication. It requires an external module: IO-Socket-SSL.
.PP
\fI\f(CI\*(C`cafile\*(C'\fI\fR
.IX Subsection "cafile"
.PP
File containing trusted \s-1CA\s0 certificates
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
3.3.6b.1 and later.
.PP
This can be used alternatively and/or additionally to \*(L"capath\*(R".
.PP
\fI\f(CI\*(C`capath\*(C'\fI\fR
.IX Subsection "capath"
.PP
Directory containing trusted \s-1CA\s0 certificates
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
3.3.6b.1 and later.
.PP
\&\s-1CA\s0 certificates in this directory are used for client authentication.
.PP
The certificates need to have names including hash of subject, or symbolic links to them with such names. The links may be created by using \*(L"c_rehash\*(R" script bundled in OpenSSL.
.PP
\fI\f(CI\*(C`key_passwd\*(C'\fI\fR
.IX Subsection "key_passwd"
.PP
Password used to crypt lists private keys
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
If not defined, Sympa assumes that list private keys are not encrypted.
.PP
Example:
.PP
.Vb 1
\&  key_passwd your_password
.Ve
.PP
\fI\f(CI\*(C`ssl_cert_dir\*(C'\fI\fR
.IX Subsection "ssl_cert_dir"
.PP
Directory containing user certificates
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`$EXPLDIR/X509\-user\-certs\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.SS "Data sources setup"
.IX Subsection "Data sources setup"
Including subscribers, owners and moderators from data sources. Appropriate database driver (\s-1DBD\s0) modules are required: DBD-CSV, DBD-mysql, DBD-ODBC, DBD-Oracle, DBD-Pg, DBD-SQLite and/or Net-LDAP. And also, if secure connection (\s-1LDAPS\s0) to \s-1LDAP\s0 server is required: IO-Socket-SSL.
.PP
\fI\f(CI\*(C`inclusion_notification_feature\*(C'\fI\fR
.IX Subsection "inclusion_notification_feature"
.PP
Notify subscribers when they are included from a data source?
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`member_include\*(C'\fI\fR
.IX Subsection "member_include"
.PP
(Paragraph)
Subscribers defined in an external data source
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
\f(CW\*(C`member_include.source\*(C'\fR
.IX Subsection "member_include.source"
.PP
the data source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[\ew\-]+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`member_include.source_parameters\*(C'\fR
.IX Subsection "member_include.source_parameters"
.PP
data source parameters
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`member_include.reception\*(C'\fR
.IX Subsection "member_include.reception"
.PP
reception mode
.IP "Format:" 4
.IX Item "Format:"
Reception mode of list member.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.67b.2 and later.
.PP
Mail reception mode.
.PP
\f(CW\*(C`member_include.visibility\*(C'\fR
.IX Subsection "member_include.visibility"
.PP
visibility
.IP "Format:" 4
.IX Item "Format:"
Visibility mode of list member.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.67b.2 and later.
.PP
Visibility of the subscriber.
.PP
\fI\f(CI\*(C`owner_include\*(C'\fI\fR
.IX Subsection "owner_include"
.PP
(Paragraph)
Owners defined in an external data source
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
\f(CW\*(C`owner_include.source\*(C'\fR
.IX Subsection "owner_include.source"
.PP
the data source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[\ew\-]+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`owner_include.source_parameters\*(C'\fR
.IX Subsection "owner_include.source_parameters"
.PP
data source parameters
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.0a and later.
.PP
\f(CW\*(C`owner_include.profile\*(C'\fR
.IX Subsection "owner_include.profile"
.PP
profile
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """privileged"" \- privileged owner" 4
.el .IP "\f(CWprivileged\fR \- privileged owner" 4
.IX Item "privileged - privileged owner"
.ie n .IP """normal"" \- normal owner" 4
.el .IP "\f(CWnormal\fR \- normal owner" 4
.IX Item "normal - normal owner"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`owner_include.reception\*(C'\fR
.IX Subsection "owner_include.reception"
.PP
reception mode
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """mail"" \- receive notification email" 4
.el .IP "\f(CWmail\fR \- receive notification email" 4
.IX Item "mail - receive notification email"
.ie n .IP """nomail"" \- no notifications" 4
.el .IP "\f(CWnomail\fR \- no notifications" 4
.IX Item "nomail - no notifications"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`owner_include.visibility\*(C'\fR
.IX Subsection "owner_include.visibility"
.PP
visibility
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """conceal"" \- concealed from list menu" 4
.el .IP "\f(CWconceal\fR \- concealed from list menu" 4
.IX Item "conceal - concealed from list menu"
.ie n .IP """noconceal"" \- listed on the list menu" 4
.el .IP "\f(CWnoconceal\fR \- listed on the list menu" 4
.IX Item "noconceal - listed on the list menu"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.4a.6 and later.
.PP
\fI\f(CI\*(C`editor_include\*(C'\fI\fR
.IX Subsection "editor_include"
.PP
(Paragraph)
Moderators defined in an external data source
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
\f(CW\*(C`editor_include.source\*(C'\fR
.IX Subsection "editor_include.source"
.PP
the data source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[\ew\-]+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`editor_include.source_parameters\*(C'\fR
.IX Subsection "editor_include.source_parameters"
.PP
data source parameters
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.0a and later.
.PP
\f(CW\*(C`editor_include.reception\*(C'\fR
.IX Subsection "editor_include.reception"
.PP
reception mode
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """mail"" \- receive notification email" 4
.el .IP "\f(CWmail\fR \- receive notification email" 4
.IX Item "mail - receive notification email"
.ie n .IP """nomail"" \- no notifications" 4
.el .IP "\f(CWnomail\fR \- no notifications" 4
.IX Item "nomail - no notifications"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`editor_include.visibility\*(C'\fR
.IX Subsection "editor_include.visibility"
.PP
visibility
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """conceal"" \- concealed from list menu" 4
.el .IP "\f(CWconceal\fR \- concealed from list menu" 4
.IX Item "conceal - concealed from list menu"
.ie n .IP """noconceal"" \- listed on the list menu" 4
.el .IP "\f(CWnoconceal\fR \- listed on the list menu" 4
.IX Item "noconceal - listed on the list menu"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.4a.6 and later.
.PP
\fI\f(CI\*(C`sql_fetch_timeout\*(C'\fI\fR
.IX Subsection "sql_fetch_timeout"
.PP
Timeout for fetch of include_sql_query
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW300\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 and later.
.PP
\fI\f(CI\*(C`include_file\*(C'\fI\fR
.IX Subsection "include_file"
.PP
File inclusion
.IP "Format:" 4
.IX Item "Format:"
Multiple occurrences allowed.
.Sp
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
Include subscribers from this file.  The file should contain one e\-mail address per line (lines beginning with a \*(L"#\*(R" are ignored).
.PP
\fI\f(CI\*(C`include_remote_file\*(C'\fI\fR
.IX Subsection "include_remote_file"
.PP
(Paragraph)
Remote file inclusion
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
\f(CW\*(C`include_remote_file.name\*(C'\fR
.IX Subsection "include_remote_file.name"
.PP
short name for this source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_remote_file.url\*(C'\fR
.IX Subsection "include_remote_file.url"
.PP
data location \s-1URL\s0
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_remote_file.user\*(C'\fR
.IX Subsection "include_remote_file.user"
.PP
remote user
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_remote_file.passwd\*(C'\fR
.IX Subsection "include_remote_file.passwd"
.PP
remote password
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_remote_file.timeout\*(C'\fR
.IX Subsection "include_remote_file.timeout"
.PP
idle timeout
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW180\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_remote_file.ssl_version\*(C'\fR
.IX Subsection "include_remote_file.ssl_version"
.PP
\&\s-1SSL\s0 version
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """ssl_any"" \- any versions" 4
.el .IP "\f(CWssl_any\fR \- any versions" 4
.IX Item "ssl_any - any versions"
.ie n .IP """sslv2"" \- \s-1SSL\s0 version 2" 4
.el .IP "\f(CWsslv2\fR \- \s-1SSL\s0 version 2" 4
.IX Item "sslv2 - SSL version 2"
.ie n .IP """sslv3"" \- \s-1SSL\s0 version 3" 4
.el .IP "\f(CWsslv3\fR \- \s-1SSL\s0 version 3" 4
.IX Item "sslv3 - SSL version 3"
.ie n .IP """tlsv1"" \- \s-1TLS\s0 version 1" 4
.el .IP "\f(CWtlsv1\fR \- \s-1TLS\s0 version 1" 4
.IX Item "tlsv1 - TLS version 1"
.ie n .IP """tlsv1_1"" \- \s-1TLS\s0 version 1.1" 4
.el .IP "\f(CWtlsv1_1\fR \- \s-1TLS\s0 version 1.1" 4
.IX Item "tlsv1_1 - TLS version 1.1"
.ie n .IP """tlsv1_2"" \- \s-1TLS\s0 version 1.2" 4
.el .IP "\f(CWtlsv1_2\fR \- \s-1TLS\s0 version 1.2" 4
.IX Item "tlsv1_2 - TLS version 1.2"
.ie n .IP """tlsv1_3"" \- \s-1TLS\s0 version 1.3" 4
.el .IP "\f(CWtlsv1_3\fR \- \s-1TLS\s0 version 1.3" 4
.IX Item "tlsv1_3 - TLS version 1.3"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`ssl_any\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_remote_file.ssl_ciphers\*(C'\fR
.IX Subsection "include_remote_file.ssl_ciphers"
.PP
\&\s-1SSL\s0 ciphers used
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`ALL\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_remote_file.ca_verify\*(C'\fR
.IX Subsection "include_remote_file.ca_verify"
.PP
Certificate verification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """optional"" \- optional" 4
.el .IP "\f(CWoptional\fR \- optional" 4
.IX Item "optional - optional"
.ie n .IP """required"" \- required" 4
.el .IP "\f(CWrequired\fR \- required" 4
.IX Item "required - required"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`none\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_remote_file.nosync_time_ranges\*(C'\fR
.IX Subsection "include_remote_file.nosync_time_ranges"
.PP
Time ranges when inclusion is not allowed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$time_ranges\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`include_sympa_list\*(C'\fI\fR
.IX Subsection "include_sympa_list"
.PP
(Paragraph)
List inclusion
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
Include subscribers from other list. All subscribers of list listname become subscribers of the current list. You may include as many lists as required, using one include_sympa_list paragraph for each included list. Any list at all may be included; you may therefore include lists which are also defined by the inclusion of other lists. Be careful, however, not to include list A in list B and then list B in list A, since this will give rise to an infinite loop.
.PP
\f(CW\*(C`include_sympa_list.name\*(C'\fR
.IX Subsection "include_sympa_list.name"
.PP
short name for this source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sympa_list.listname\*(C'\fR
.IX Subsection "include_sympa_list.listname"
.PP
list name to include
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`$listname(\e@$host)?\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sympa_list.filter\*(C'\fR
.IX Subsection "include_sympa_list.filter"
.PP
filter definition
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sympa_list.nosync_time_ranges\*(C'\fR
.IX Subsection "include_sympa_list.nosync_time_ranges"
.PP
Time ranges when inclusion is not allowed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$time_ranges\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`include_remote_sympa_list\*(C'\fI\fR
.IX Subsection "include_remote_sympa_list"
.PP
(Paragraph)
remote list inclusion
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
Sympa can contact another Sympa service using \s-1HTTPS\s0 to fetch a remote list in order to include each member of a remote list as subscriber. You may include as many lists as required, using one include_remote_sympa_list paragraph for each included list. Be careful, however, not to give rise to an infinite loop resulting from cross includes.
.PP
For this operation, one Sympa site acts as a server while the other one acs as client. On the server side, the only setting needed is to give permission to the remote Sympa to review the list. This is controlled by the review scenario.
.PP
\f(CW\*(C`include_remote_sympa_list.name\*(C'\fR
.IX Subsection "include_remote_sympa_list.name"
.PP
short name for this source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_remote_sympa_list.url\*(C'\fR
.IX Subsection "include_remote_sympa_list.url"
.PP
data location \s-1URL\s0
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.45b.1 and later.
.PP
\f(CW\*(C`include_remote_sympa_list.user\*(C'\fR
.IX Subsection "include_remote_sympa_list.user"
.PP
remote user
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.45b.1 and later.
.PP
\f(CW\*(C`include_remote_sympa_list.passwd\*(C'\fR
.IX Subsection "include_remote_sympa_list.passwd"
.PP
remote password
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.45b.1 and later.
.PP
\f(CW\*(C`include_remote_sympa_list.host\*(C'\fR
.IX Subsection "include_remote_sympa_list.host"
.PP
remote host
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$host\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
obsoleted.  Use \*(L"data location \s-1URL\*(R".\s0
.PP
\f(CW\*(C`include_remote_sympa_list.port\*(C'\fR
.IX Subsection "include_remote_sympa_list.port"
.PP
remote port
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW443\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
obsoleted.  Use \*(L"data location \s-1URL\*(R".\s0
.PP
\f(CW\*(C`include_remote_sympa_list.path\*(C'\fR
.IX Subsection "include_remote_sympa_list.path"
.PP
remote path of sympa list dump
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
obsoleted.  Use \*(L"data location \s-1URL\*(R".\s0
.PP
\f(CW\*(C`include_remote_sympa_list.cert\*(C'\fR
.IX Subsection "include_remote_sympa_list.cert"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.44.
.PP
\f(CW\*(C`include_remote_sympa_list.timeout\*(C'\fR
.IX Subsection "include_remote_sympa_list.timeout"
.PP
idle timeout
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW180\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.45b.1 and later.
.PP
\f(CW\*(C`include_remote_sympa_list.ssl_version\*(C'\fR
.IX Subsection "include_remote_sympa_list.ssl_version"
.PP
\&\s-1SSL\s0 version
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """ssl_any"" \- any versions" 4
.el .IP "\f(CWssl_any\fR \- any versions" 4
.IX Item "ssl_any - any versions"
.ie n .IP """sslv2"" \- \s-1SSL\s0 version 2" 4
.el .IP "\f(CWsslv2\fR \- \s-1SSL\s0 version 2" 4
.IX Item "sslv2 - SSL version 2"
.ie n .IP """sslv3"" \- \s-1SSL\s0 version 3" 4
.el .IP "\f(CWsslv3\fR \- \s-1SSL\s0 version 3" 4
.IX Item "sslv3 - SSL version 3"
.ie n .IP """tlsv1"" \- \s-1TLS\s0 version 1" 4
.el .IP "\f(CWtlsv1\fR \- \s-1TLS\s0 version 1" 4
.IX Item "tlsv1 - TLS version 1"
.ie n .IP """tlsv1_1"" \- \s-1TLS\s0 version 1.1" 4
.el .IP "\f(CWtlsv1_1\fR \- \s-1TLS\s0 version 1.1" 4
.IX Item "tlsv1_1 - TLS version 1.1"
.ie n .IP """tlsv1_2"" \- \s-1TLS\s0 version 1.2" 4
.el .IP "\f(CWtlsv1_2\fR \- \s-1TLS\s0 version 1.2" 4
.IX Item "tlsv1_2 - TLS version 1.2"
.ie n .IP """tlsv1_3"" \- \s-1TLS\s0 version 1.3" 4
.el .IP "\f(CWtlsv1_3\fR \- \s-1TLS\s0 version 1.3" 4
.IX Item "tlsv1_3 - TLS version 1.3"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`ssl_any\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.45b.1 and later.
.PP
\f(CW\*(C`include_remote_sympa_list.ssl_ciphers\*(C'\fR
.IX Subsection "include_remote_sympa_list.ssl_ciphers"
.PP
\&\s-1SSL\s0 ciphers used
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`ALL\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.45b.1 and later.
.PP
\f(CW\*(C`include_remote_sympa_list.ca_verify\*(C'\fR
.IX Subsection "include_remote_sympa_list.ca_verify"
.PP
Certificate verification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """optional"" \- optional" 4
.el .IP "\f(CWoptional\fR \- optional" 4
.IX Item "optional - optional"
.ie n .IP """required"" \- required" 4
.el .IP "\f(CWrequired\fR \- required" 4
.IX Item "required - required"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`optional\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.45b.1 and later.
.PP
\f(CW\*(C`include_remote_sympa_list.nosync_time_ranges\*(C'\fR
.IX Subsection "include_remote_sympa_list.nosync_time_ranges"
.PP
Time ranges when inclusion is not allowed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$time_ranges\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`include_ldap_query\*(C'\fI\fR
.IX Subsection "include_ldap_query"
.PP
(Paragraph)
\&\s-1LDAP\s0 query inclusion
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
This paragraph defines parameters for a query returning a list of subscribers. This feature requires the Net::LDAP (perlldap) \s-1PERL\s0 module.
.PP
\f(CW\*(C`include_ldap_query.name\*(C'\fR
.IX Subsection "include_ldap_query.name"
.PP
short name for this source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.host\*(C'\fR
.IX Subsection "include_ldap_query.host"
.PP
remote host
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$multiple_host_or_url\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.port\*(C'\fR
.IX Subsection "include_ldap_query.port"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.use_tls\*(C'\fR
.IX Subsection "include_ldap_query.use_tls"
.PP
use \s-1TLS\s0 (formerly \s-1SSL\s0)
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """starttls"" \- use \s-1STARTTLS\s0" 4
.el .IP "\f(CWstarttls\fR \- use \s-1STARTTLS\s0" 4
.IX Item "starttls - use STARTTLS"
.ie n .IP """ldaps"" \- use \s-1LDAPS\s0 (\s-1LDAP\s0 over \s-1TLS\s0)" 4
.el .IP "\f(CWldaps\fR \- use \s-1LDAPS\s0 (\s-1LDAP\s0 over \s-1TLS\s0)" 4
.IX Item "ldaps - use LDAPS (LDAP over TLS)"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`none\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.15 and later.
.PP
\f(CW\*(C`include_ldap_query.ssl_version\*(C'\fR
.IX Subsection "include_ldap_query.ssl_version"
.PP
\&\s-1SSL\s0 version
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """sslv2"" \- \s-1SSL\s0 version 2" 4
.el .IP "\f(CWsslv2\fR \- \s-1SSL\s0 version 2" 4
.IX Item "sslv2 - SSL version 2"
.ie n .IP """sslv3"" \- \s-1SSL\s0 version 3" 4
.el .IP "\f(CWsslv3\fR \- \s-1SSL\s0 version 3" 4
.IX Item "sslv3 - SSL version 3"
.ie n .IP """tlsv1"" \- \s-1TLS\s0 version 1" 4
.el .IP "\f(CWtlsv1\fR \- \s-1TLS\s0 version 1" 4
.IX Item "tlsv1 - TLS version 1"
.ie n .IP """tlsv1_1"" \- \s-1TLS\s0 version 1.1" 4
.el .IP "\f(CWtlsv1_1\fR \- \s-1TLS\s0 version 1.1" 4
.IX Item "tlsv1_1 - TLS version 1.1"
.ie n .IP """tlsv1_2"" \- \s-1TLS\s0 version 1.2" 4
.el .IP "\f(CWtlsv1_2\fR \- \s-1TLS\s0 version 1.2" 4
.IX Item "tlsv1_2 - TLS version 1.2"
.ie n .IP """tlsv1_3"" \- \s-1TLS\s0 version 1.3" 4
.el .IP "\f(CWtlsv1_3\fR \- \s-1TLS\s0 version 1.3" 4
.IX Item "tlsv1_3 - TLS version 1.3"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`tlsv1\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.ssl_ciphers\*(C'\fR
.IX Subsection "include_ldap_query.ssl_ciphers"
.PP
\&\s-1SSL\s0 ciphers used
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`ALL\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.ca_verify\*(C'\fR
.IX Subsection "include_ldap_query.ca_verify"
.PP
Certificate verification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """optional"" \- optional" 4
.el .IP "\f(CWoptional\fR \- optional" 4
.IX Item "optional - optional"
.ie n .IP """required"" \- required" 4
.el .IP "\f(CWrequired\fR \- required" 4
.IX Item "required - required"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`required\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.13 and later.
.PP
\f(CW\*(C`include_ldap_query.bind_dn\*(C'\fR
.IX Subsection "include_ldap_query.bind_dn"
.PP
remote user
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_ldap_query.bind_password\*(C'\fR
.IX Subsection "include_ldap_query.bind_password"
.PP
remote password
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_ldap_query.suffix\*(C'\fR
.IX Subsection "include_ldap_query.suffix"
.PP
suffix
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.scope\*(C'\fR
.IX Subsection "include_ldap_query.scope"
.PP
search scope
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """base"" \- base" 4
.el .IP "\f(CWbase\fR \- base" 4
.IX Item "base - base"
.ie n .IP """one"" \- one level" 4
.el .IP "\f(CWone\fR \- one level" 4
.IX Item "one - one level"
.ie n .IP """sub"" \- subtree" 4
.el .IP "\f(CWsub\fR \- subtree" 4
.IX Item "sub - subtree"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`sub\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.timeout\*(C'\fR
.IX Subsection "include_ldap_query.timeout"
.PP
connection timeout
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.filter\*(C'\fR
.IX Subsection "include_ldap_query.filter"
.PP
filter
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.attrs\*(C'\fR
.IX Subsection "include_ldap_query.attrs"
.PP
extracted attribute
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`$ldap_attrdesc(\es*,\es*$ldap_attrdesc)?\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`mail\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.select\*(C'\fR
.IX Subsection "include_ldap_query.select"
.PP
selection (if multiple)
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.ie n .IP """first"" \- first entry" 4
.el .IP "\f(CWfirst\fR \- first entry" 4
.IX Item "first - first entry"
.ie n .IP """regex"" \- entries matching regular expression" 4
.el .IP "\f(CWregex\fR \- entries matching regular expression" 4
.IX Item "regex - entries matching regular expression"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`first\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.regex\*(C'\fR
.IX Subsection "include_ldap_query.regex"
.PP
regular expression
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_query.nosync_time_ranges\*(C'\fR
.IX Subsection "include_ldap_query.nosync_time_ranges"
.PP
Time ranges when inclusion is not allowed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$time_ranges\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.16 and later.
.PP
\f(CW\*(C`include_ldap_query.passwd\*(C'\fR
.IX Subsection "include_ldap_query.passwd"
.PP
See \f(CW\*(C`bind_password\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_ldap_query.use_ssl\*(C'\fR
.IX Subsection "include_ldap_query.use_ssl"
.PP
See \f(CW\*(C`use_tls\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.3a.2 to 6.2.14.
.PP
\f(CW\*(C`include_ldap_query.user\*(C'\fR
.IX Subsection "include_ldap_query.user"
.PP
See \f(CW\*(C`bind_dn\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`include_ldap_2level_query\*(C'\fI\fR
.IX Subsection "include_ldap_2level_query"
.PP
(Paragraph)
\&\s-1LDAP\s0 2\-level query inclusion
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
This paragraph defines parameters for a two-level query returning a list of subscribers. Usually the first-level query returns a list of DNs and the second-level queries convert the DNs into e\-mail addresses. This feature requires the Net::LDAP (perlldap) \s-1PERL\s0 module.
.PP
\f(CW\*(C`include_ldap_2level_query.name\*(C'\fR
.IX Subsection "include_ldap_2level_query.name"
.PP
short name for this source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.host\*(C'\fR
.IX Subsection "include_ldap_2level_query.host"
.PP
remote host
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$multiple_host_or_url\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.port\*(C'\fR
.IX Subsection "include_ldap_2level_query.port"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.use_tls\*(C'\fR
.IX Subsection "include_ldap_2level_query.use_tls"
.PP
use \s-1TLS\s0 (formerly \s-1SSL\s0)
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """starttls"" \- use \s-1STARTTLS\s0" 4
.el .IP "\f(CWstarttls\fR \- use \s-1STARTTLS\s0" 4
.IX Item "starttls - use STARTTLS"
.ie n .IP """ldaps"" \- use \s-1LDAPS\s0 (\s-1LDAP\s0 over \s-1TLS\s0)" 4
.el .IP "\f(CWldaps\fR \- use \s-1LDAPS\s0 (\s-1LDAP\s0 over \s-1TLS\s0)" 4
.IX Item "ldaps - use LDAPS (LDAP over TLS)"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`none\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.15 and later.
.PP
\f(CW\*(C`include_ldap_2level_query.ssl_version\*(C'\fR
.IX Subsection "include_ldap_2level_query.ssl_version"
.PP
\&\s-1SSL\s0 version
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """sslv2"" \- \s-1SSL\s0 version 2" 4
.el .IP "\f(CWsslv2\fR \- \s-1SSL\s0 version 2" 4
.IX Item "sslv2 - SSL version 2"
.ie n .IP """sslv3"" \- \s-1SSL\s0 version 3" 4
.el .IP "\f(CWsslv3\fR \- \s-1SSL\s0 version 3" 4
.IX Item "sslv3 - SSL version 3"
.ie n .IP """tlsv1"" \- \s-1TLS\s0 version 1" 4
.el .IP "\f(CWtlsv1\fR \- \s-1TLS\s0 version 1" 4
.IX Item "tlsv1 - TLS version 1"
.ie n .IP """tlsv1_1"" \- \s-1TLS\s0 version 1.1" 4
.el .IP "\f(CWtlsv1_1\fR \- \s-1TLS\s0 version 1.1" 4
.IX Item "tlsv1_1 - TLS version 1.1"
.ie n .IP """tlsv1_2"" \- \s-1TLS\s0 version 1.2" 4
.el .IP "\f(CWtlsv1_2\fR \- \s-1TLS\s0 version 1.2" 4
.IX Item "tlsv1_2 - TLS version 1.2"
.ie n .IP """tlsv1_3"" \- \s-1TLS\s0 version 1.3" 4
.el .IP "\f(CWtlsv1_3\fR \- \s-1TLS\s0 version 1.3" 4
.IX Item "tlsv1_3 - TLS version 1.3"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`tlsv1\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.ssl_ciphers\*(C'\fR
.IX Subsection "include_ldap_2level_query.ssl_ciphers"
.PP
\&\s-1SSL\s0 ciphers used
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`ALL\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.ca_verify\*(C'\fR
.IX Subsection "include_ldap_2level_query.ca_verify"
.PP
Certificate verification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """optional"" \- optional" 4
.el .IP "\f(CWoptional\fR \- optional" 4
.IX Item "optional - optional"
.ie n .IP """required"" \- required" 4
.el .IP "\f(CWrequired\fR \- required" 4
.IX Item "required - required"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`required\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.13 and later.
.PP
\f(CW\*(C`include_ldap_2level_query.bind_dn\*(C'\fR
.IX Subsection "include_ldap_2level_query.bind_dn"
.PP
remote user
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_ldap_2level_query.bind_password\*(C'\fR
.IX Subsection "include_ldap_2level_query.bind_password"
.PP
remote password
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_ldap_2level_query.suffix1\*(C'\fR
.IX Subsection "include_ldap_2level_query.suffix1"
.PP
first-level suffix
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.scope1\*(C'\fR
.IX Subsection "include_ldap_2level_query.scope1"
.PP
first-level search scope
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """base"" \- base" 4
.el .IP "\f(CWbase\fR \- base" 4
.IX Item "base - base"
.ie n .IP """one"" \- one level" 4
.el .IP "\f(CWone\fR \- one level" 4
.IX Item "one - one level"
.ie n .IP """sub"" \- subtree" 4
.el .IP "\f(CWsub\fR \- subtree" 4
.IX Item "sub - subtree"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`sub\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.timeout1\*(C'\fR
.IX Subsection "include_ldap_2level_query.timeout1"
.PP
first-level connection timeout
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.filter1\*(C'\fR
.IX Subsection "include_ldap_2level_query.filter1"
.PP
first-level filter
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.attrs1\*(C'\fR
.IX Subsection "include_ldap_2level_query.attrs1"
.PP
first-level extracted attribute
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$ldap_attrdesc\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.select1\*(C'\fR
.IX Subsection "include_ldap_2level_query.select1"
.PP
first-level selection
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.ie n .IP """first"" \- first entry" 4
.el .IP "\f(CWfirst\fR \- first entry" 4
.IX Item "first - first entry"
.ie n .IP """regex"" \- entries matching regular expression" 4
.el .IP "\f(CWregex\fR \- entries matching regular expression" 4
.IX Item "regex - entries matching regular expression"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`first\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.regex1\*(C'\fR
.IX Subsection "include_ldap_2level_query.regex1"
.PP
first-level regular expression
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.suffix2\*(C'\fR
.IX Subsection "include_ldap_2level_query.suffix2"
.PP
second-level suffix template
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.scope2\*(C'\fR
.IX Subsection "include_ldap_2level_query.scope2"
.PP
second-level search scope
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """base"" \- base" 4
.el .IP "\f(CWbase\fR \- base" 4
.IX Item "base - base"
.ie n .IP """one"" \- one level" 4
.el .IP "\f(CWone\fR \- one level" 4
.IX Item "one - one level"
.ie n .IP """sub"" \- subtree" 4
.el .IP "\f(CWsub\fR \- subtree" 4
.IX Item "sub - subtree"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`sub\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.timeout2\*(C'\fR
.IX Subsection "include_ldap_2level_query.timeout2"
.PP
second-level connection timeout
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.filter2\*(C'\fR
.IX Subsection "include_ldap_2level_query.filter2"
.PP
second-level filter template
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.attrs2\*(C'\fR
.IX Subsection "include_ldap_2level_query.attrs2"
.PP
second-level extracted attribute
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`$ldap_attrdesc(\es*,\es*$ldap_attrdesc)?\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`mail\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.select2\*(C'\fR
.IX Subsection "include_ldap_2level_query.select2"
.PP
second-level selection
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.ie n .IP """first"" \- first entry" 4
.el .IP "\f(CWfirst\fR \- first entry" 4
.IX Item "first - first entry"
.ie n .IP """regex"" \- entries matching regular expression" 4
.el .IP "\f(CWregex\fR \- entries matching regular expression" 4
.IX Item "regex - entries matching regular expression"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`first\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.regex2\*(C'\fR
.IX Subsection "include_ldap_2level_query.regex2"
.PP
second-level regular expression
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_query.nosync_time_ranges\*(C'\fR
.IX Subsection "include_ldap_2level_query.nosync_time_ranges"
.PP
Time ranges when inclusion is not allowed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$time_ranges\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.16 and later.
.PP
\f(CW\*(C`include_ldap_2level_query.passwd\*(C'\fR
.IX Subsection "include_ldap_2level_query.passwd"
.PP
See \f(CW\*(C`bind_password\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_ldap_2level_query.use_ssl\*(C'\fR
.IX Subsection "include_ldap_2level_query.use_ssl"
.PP
See \f(CW\*(C`use_tls\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.3a.2 to 6.2.14.
.PP
\f(CW\*(C`include_ldap_2level_query.user\*(C'\fR
.IX Subsection "include_ldap_2level_query.user"
.PP
See \f(CW\*(C`bind_dn\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`include_sql_query\*(C'\fI\fR
.IX Subsection "include_sql_query"
.PP
(Paragraph)
\&\s-1SQL\s0 query inclusion
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
This parameter is used to define the \s-1SQL\s0 query parameters.
.PP
\f(CW\*(C`include_sql_query.name\*(C'\fR
.IX Subsection "include_sql_query.name"
.PP
short name for this source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_query.db_type\*(C'\fR
.IX Subsection "include_sql_query.db_type"
.PP
database type
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_query.db_host\*(C'\fR
.IX Subsection "include_sql_query.db_host"
.PP
remote host
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$host\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_sql_query.db_port\*(C'\fR
.IX Subsection "include_sql_query.db_port"
.PP
database port
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_query.db_name\*(C'\fR
.IX Subsection "include_sql_query.db_name"
.PP
database name
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_query.db_options\*(C'\fR
.IX Subsection "include_sql_query.db_options"
.PP
connection options
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_sql_query.db_env\*(C'\fR
.IX Subsection "include_sql_query.db_env"
.PP
environment variables for database connection
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\e=\eS+(;\ew+\e=\eS+)*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_query.db_user\*(C'\fR
.IX Subsection "include_sql_query.db_user"
.PP
remote user
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_sql_query.db_passwd\*(C'\fR
.IX Subsection "include_sql_query.db_passwd"
.PP
remote password
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_sql_query.sql_query\*(C'\fR
.IX Subsection "include_sql_query.sql_query"
.PP
\&\s-1SQL\s0 query
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$sql_query\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_query.f_dir\*(C'\fR
.IX Subsection "include_sql_query.f_dir"
.PP
Directory where the database is stored (used for \s-1DBD::CSV\s0 only)
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_query.nosync_time_ranges\*(C'\fR
.IX Subsection "include_sql_query.nosync_time_ranges"
.PP
Time ranges when inclusion is not allowed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$time_ranges\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.16 and later.
.PP
\f(CW\*(C`include_sql_query.connect_options\*(C'\fR
.IX Subsection "include_sql_query.connect_options"
.PP
See \f(CW\*(C`db_options\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_sql_query.host\*(C'\fR
.IX Subsection "include_sql_query.host"
.PP
See \f(CW\*(C`db_host\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_sql_query.passwd\*(C'\fR
.IX Subsection "include_sql_query.passwd"
.PP
See \f(CW\*(C`db_passwd\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_sql_query.user\*(C'\fR
.IX Subsection "include_sql_query.user"
.PP
See \f(CW\*(C`db_user\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`ttl\*(C'\fI\fR
.IX Subsection "ttl"
.PP
Inclusions timeout
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW3600\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
Sympa caches user data extracted using the include parameter. Their \s-1TTL\s0 (time-to-live) within Sympa can be controlled using this parameter. The default value is 3600
.PP
\fI\f(CI\*(C`distribution_ttl\*(C'\fI\fR
.IX Subsection "distribution_ttl"
.PP
Inclusions timeout for message distribution
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
This parameter defines the delay since the last synchronization after which the user's list will be updated before performing either of following actions:
.PP
* Reviewing list members
.PP
* Message distribution
.PP
\fI\f(CI\*(C`include_ldap_ca\*(C'\fI\fR
.IX Subsection "include_ldap_ca"
.PP
(Paragraph)
\&\s-1LDAP\s0 query custom attribute
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
\f(CW\*(C`include_ldap_ca.name\*(C'\fR
.IX Subsection "include_ldap_ca.name"
.PP
short name for this source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.host\*(C'\fR
.IX Subsection "include_ldap_ca.host"
.PP
remote host
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$multiple_host_or_url\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.port\*(C'\fR
.IX Subsection "include_ldap_ca.port"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.use_tls\*(C'\fR
.IX Subsection "include_ldap_ca.use_tls"
.PP
use \s-1TLS\s0 (formerly \s-1SSL\s0)
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """starttls"" \- use \s-1STARTTLS\s0" 4
.el .IP "\f(CWstarttls\fR \- use \s-1STARTTLS\s0" 4
.IX Item "starttls - use STARTTLS"
.ie n .IP """ldaps"" \- use \s-1LDAPS\s0 (\s-1LDAP\s0 over \s-1TLS\s0)" 4
.el .IP "\f(CWldaps\fR \- use \s-1LDAPS\s0 (\s-1LDAP\s0 over \s-1TLS\s0)" 4
.IX Item "ldaps - use LDAPS (LDAP over TLS)"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`none\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.15 and later.
.PP
\f(CW\*(C`include_ldap_ca.ssl_version\*(C'\fR
.IX Subsection "include_ldap_ca.ssl_version"
.PP
\&\s-1SSL\s0 version
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """sslv2"" \- \s-1SSL\s0 version 2" 4
.el .IP "\f(CWsslv2\fR \- \s-1SSL\s0 version 2" 4
.IX Item "sslv2 - SSL version 2"
.ie n .IP """sslv3"" \- \s-1SSL\s0 version 3" 4
.el .IP "\f(CWsslv3\fR \- \s-1SSL\s0 version 3" 4
.IX Item "sslv3 - SSL version 3"
.ie n .IP """tlsv1"" \- \s-1TLS\s0 version 1" 4
.el .IP "\f(CWtlsv1\fR \- \s-1TLS\s0 version 1" 4
.IX Item "tlsv1 - TLS version 1"
.ie n .IP """tlsv1_1"" \- \s-1TLS\s0 version 1.1" 4
.el .IP "\f(CWtlsv1_1\fR \- \s-1TLS\s0 version 1.1" 4
.IX Item "tlsv1_1 - TLS version 1.1"
.ie n .IP """tlsv1_2"" \- \s-1TLS\s0 version 1.2" 4
.el .IP "\f(CWtlsv1_2\fR \- \s-1TLS\s0 version 1.2" 4
.IX Item "tlsv1_2 - TLS version 1.2"
.ie n .IP """tlsv1_3"" \- \s-1TLS\s0 version 1.3" 4
.el .IP "\f(CWtlsv1_3\fR \- \s-1TLS\s0 version 1.3" 4
.IX Item "tlsv1_3 - TLS version 1.3"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`tlsv1\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.ssl_ciphers\*(C'\fR
.IX Subsection "include_ldap_ca.ssl_ciphers"
.PP
\&\s-1SSL\s0 ciphers used
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`ALL\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.ca_verify\*(C'\fR
.IX Subsection "include_ldap_ca.ca_verify"
.PP
Certificate verification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """optional"" \- optional" 4
.el .IP "\f(CWoptional\fR \- optional" 4
.IX Item "optional - optional"
.ie n .IP """required"" \- required" 4
.el .IP "\f(CWrequired\fR \- required" 4
.IX Item "required - required"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`required\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.13 and later.
.PP
\f(CW\*(C`include_ldap_ca.bind_dn\*(C'\fR
.IX Subsection "include_ldap_ca.bind_dn"
.PP
remote user
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_ldap_ca.bind_password\*(C'\fR
.IX Subsection "include_ldap_ca.bind_password"
.PP
remote password
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_ldap_ca.suffix\*(C'\fR
.IX Subsection "include_ldap_ca.suffix"
.PP
suffix
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.scope\*(C'\fR
.IX Subsection "include_ldap_ca.scope"
.PP
search scope
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """base"" \- base" 4
.el .IP "\f(CWbase\fR \- base" 4
.IX Item "base - base"
.ie n .IP """one"" \- one level" 4
.el .IP "\f(CWone\fR \- one level" 4
.IX Item "one - one level"
.ie n .IP """sub"" \- subtree" 4
.el .IP "\f(CWsub\fR \- subtree" 4
.IX Item "sub - subtree"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`sub\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.timeout\*(C'\fR
.IX Subsection "include_ldap_ca.timeout"
.PP
connection timeout
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.filter\*(C'\fR
.IX Subsection "include_ldap_ca.filter"
.PP
filter
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.attrs\*(C'\fR
.IX Subsection "include_ldap_ca.attrs"
.PP
extracted attribute
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`$ldap_attrdesc(\es*,\es*$ldap_attrdesc)?\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`mail\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.email_entry\*(C'\fR
.IX Subsection "include_ldap_ca.email_entry"
.PP
Name of email entry
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.select\*(C'\fR
.IX Subsection "include_ldap_ca.select"
.PP
selection (if multiple)
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.ie n .IP """first"" \- first entry" 4
.el .IP "\f(CWfirst\fR \- first entry" 4
.IX Item "first - first entry"
.ie n .IP """regex"" \- entries matching regular expression" 4
.el .IP "\f(CWregex\fR \- entries matching regular expression" 4
.IX Item "regex - entries matching regular expression"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`first\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.regex\*(C'\fR
.IX Subsection "include_ldap_ca.regex"
.PP
regular expression
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.nosync_time_ranges\*(C'\fR
.IX Subsection "include_ldap_ca.nosync_time_ranges"
.PP
Time ranges when inclusion is not allowed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$time_ranges\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_ca.passwd\*(C'\fR
.IX Subsection "include_ldap_ca.passwd"
.PP
See \f(CW\*(C`bind_password\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_ldap_ca.use_ssl\*(C'\fR
.IX Subsection "include_ldap_ca.use_ssl"
.PP
See \f(CW\*(C`use_tls\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a? to 6.2.14.
.PP
\f(CW\*(C`include_ldap_ca.user\*(C'\fR
.IX Subsection "include_ldap_ca.user"
.PP
See \f(CW\*(C`bind_dn\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`include_ldap_2level_ca\*(C'\fI\fR
.IX Subsection "include_ldap_2level_ca"
.PP
(Paragraph)
\&\s-1LDAP\s0 2\-level query custom attribute
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
\f(CW\*(C`include_ldap_2level_ca.name\*(C'\fR
.IX Subsection "include_ldap_2level_ca.name"
.PP
short name for this source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.host\*(C'\fR
.IX Subsection "include_ldap_2level_ca.host"
.PP
remote host
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$multiple_host_or_url\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.port\*(C'\fR
.IX Subsection "include_ldap_2level_ca.port"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.use_tls\*(C'\fR
.IX Subsection "include_ldap_2level_ca.use_tls"
.PP
use \s-1TLS\s0 (formerly \s-1SSL\s0)
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """starttls"" \- use \s-1STARTTLS\s0" 4
.el .IP "\f(CWstarttls\fR \- use \s-1STARTTLS\s0" 4
.IX Item "starttls - use STARTTLS"
.ie n .IP """ldaps"" \- use \s-1LDAPS\s0 (\s-1LDAP\s0 over \s-1TLS\s0)" 4
.el .IP "\f(CWldaps\fR \- use \s-1LDAPS\s0 (\s-1LDAP\s0 over \s-1TLS\s0)" 4
.IX Item "ldaps - use LDAPS (LDAP over TLS)"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`none\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.15 and later.
.PP
\f(CW\*(C`include_ldap_2level_ca.ssl_version\*(C'\fR
.IX Subsection "include_ldap_2level_ca.ssl_version"
.PP
\&\s-1SSL\s0 version
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """sslv2"" \- \s-1SSL\s0 version 2" 4
.el .IP "\f(CWsslv2\fR \- \s-1SSL\s0 version 2" 4
.IX Item "sslv2 - SSL version 2"
.ie n .IP """sslv3"" \- \s-1SSL\s0 version 3" 4
.el .IP "\f(CWsslv3\fR \- \s-1SSL\s0 version 3" 4
.IX Item "sslv3 - SSL version 3"
.ie n .IP """tlsv1"" \- \s-1TLS\s0 version 1" 4
.el .IP "\f(CWtlsv1\fR \- \s-1TLS\s0 version 1" 4
.IX Item "tlsv1 - TLS version 1"
.ie n .IP """tlsv1_1"" \- \s-1TLS\s0 version 1.1" 4
.el .IP "\f(CWtlsv1_1\fR \- \s-1TLS\s0 version 1.1" 4
.IX Item "tlsv1_1 - TLS version 1.1"
.ie n .IP """tlsv1_2"" \- \s-1TLS\s0 version 1.2" 4
.el .IP "\f(CWtlsv1_2\fR \- \s-1TLS\s0 version 1.2" 4
.IX Item "tlsv1_2 - TLS version 1.2"
.ie n .IP """tlsv1_3"" \- \s-1TLS\s0 version 1.3" 4
.el .IP "\f(CWtlsv1_3\fR \- \s-1TLS\s0 version 1.3" 4
.IX Item "tlsv1_3 - TLS version 1.3"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`tlsv1\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.ssl_ciphers\*(C'\fR
.IX Subsection "include_ldap_2level_ca.ssl_ciphers"
.PP
\&\s-1SSL\s0 ciphers used
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`ALL\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.ca_verify\*(C'\fR
.IX Subsection "include_ldap_2level_ca.ca_verify"
.PP
Certificate verification
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """optional"" \- optional" 4
.el .IP "\f(CWoptional\fR \- optional" 4
.IX Item "optional - optional"
.ie n .IP """required"" \- required" 4
.el .IP "\f(CWrequired\fR \- required" 4
.IX Item "required - required"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`required\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.13 and later.
.PP
\f(CW\*(C`include_ldap_2level_ca.bind_dn\*(C'\fR
.IX Subsection "include_ldap_2level_ca.bind_dn"
.PP
remote user
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_ldap_2level_ca.bind_password\*(C'\fR
.IX Subsection "include_ldap_2level_ca.bind_password"
.PP
remote password
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_ldap_2level_ca.suffix1\*(C'\fR
.IX Subsection "include_ldap_2level_ca.suffix1"
.PP
first-level suffix
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.scope1\*(C'\fR
.IX Subsection "include_ldap_2level_ca.scope1"
.PP
first-level search scope
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """base"" \- base" 4
.el .IP "\f(CWbase\fR \- base" 4
.IX Item "base - base"
.ie n .IP """one"" \- one level" 4
.el .IP "\f(CWone\fR \- one level" 4
.IX Item "one - one level"
.ie n .IP """sub"" \- subtree" 4
.el .IP "\f(CWsub\fR \- subtree" 4
.IX Item "sub - subtree"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`sub\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.timeout1\*(C'\fR
.IX Subsection "include_ldap_2level_ca.timeout1"
.PP
first-level connection timeout
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.filter1\*(C'\fR
.IX Subsection "include_ldap_2level_ca.filter1"
.PP
first-level filter
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.attrs1\*(C'\fR
.IX Subsection "include_ldap_2level_ca.attrs1"
.PP
first-level extracted attribute
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$ldap_attrdesc\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.select1\*(C'\fR
.IX Subsection "include_ldap_2level_ca.select1"
.PP
first-level selection
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.ie n .IP """first"" \- first entry" 4
.el .IP "\f(CWfirst\fR \- first entry" 4
.IX Item "first - first entry"
.ie n .IP """regex"" \- entries matching regular expression" 4
.el .IP "\f(CWregex\fR \- entries matching regular expression" 4
.IX Item "regex - entries matching regular expression"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`first\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.regex1\*(C'\fR
.IX Subsection "include_ldap_2level_ca.regex1"
.PP
first-level regular expression
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.suffix2\*(C'\fR
.IX Subsection "include_ldap_2level_ca.suffix2"
.PP
second-level suffix template
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.scope2\*(C'\fR
.IX Subsection "include_ldap_2level_ca.scope2"
.PP
second-level search scope
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """base"" \- base" 4
.el .IP "\f(CWbase\fR \- base" 4
.IX Item "base - base"
.ie n .IP """one"" \- one level" 4
.el .IP "\f(CWone\fR \- one level" 4
.IX Item "one - one level"
.ie n .IP """sub"" \- subtree" 4
.el .IP "\f(CWsub\fR \- subtree" 4
.IX Item "sub - subtree"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`sub\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.timeout2\*(C'\fR
.IX Subsection "include_ldap_2level_ca.timeout2"
.PP
second-level connection timeout
.IP "Format:" 4
.IX Item "Format:"
Number of seconds.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (seconds)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.filter2\*(C'\fR
.IX Subsection "include_ldap_2level_ca.filter2"
.PP
second-level filter template
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.attrs2\*(C'\fR
.IX Subsection "include_ldap_2level_ca.attrs2"
.PP
second-level extracted attribute
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$ldap_attrdesc\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`mail\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.select2\*(C'\fR
.IX Subsection "include_ldap_2level_ca.select2"
.PP
second-level selection
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.ie n .IP """first"" \- first entry" 4
.el .IP "\f(CWfirst\fR \- first entry" 4
.IX Item "first - first entry"
.ie n .IP """regex"" \- entries matching regular expression" 4
.el .IP "\f(CWregex\fR \- entries matching regular expression" 4
.IX Item "regex - entries matching regular expression"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`first\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.regex2\*(C'\fR
.IX Subsection "include_ldap_2level_ca.regex2"
.PP
second-level regular expression
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.email_entry\*(C'\fR
.IX Subsection "include_ldap_2level_ca.email_entry"
.PP
Name of email entry
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.nosync_time_ranges\*(C'\fR
.IX Subsection "include_ldap_2level_ca.nosync_time_ranges"
.PP
Time ranges when inclusion is not allowed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$time_ranges\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_ldap_2level_ca.passwd\*(C'\fR
.IX Subsection "include_ldap_2level_ca.passwd"
.PP
See \f(CW\*(C`bind_password\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_ldap_2level_ca.use_ssl\*(C'\fR
.IX Subsection "include_ldap_2level_ca.use_ssl"
.PP
See \f(CW\*(C`use_tls\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a? to 6.2.14.
.PP
\f(CW\*(C`include_ldap_2level_ca.user\*(C'\fR
.IX Subsection "include_ldap_2level_ca.user"
.PP
See \f(CW\*(C`bind_dn\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`include_sql_ca\*(C'\fI\fR
.IX Subsection "include_sql_ca"
.PP
(Paragraph)
\&\s-1SQL\s0 query custom attribute
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
\f(CW\*(C`include_sql_ca.name\*(C'\fR
.IX Subsection "include_sql_ca.name"
.PP
short name for this source
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_ca.db_type\*(C'\fR
.IX Subsection "include_sql_ca.db_type"
.PP
database type
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_ca.db_host\*(C'\fR
.IX Subsection "include_sql_ca.db_host"
.PP
remote host
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$host\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_sql_ca.db_port\*(C'\fR
.IX Subsection "include_sql_ca.db_port"
.PP
database port
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_ca.db_name\*(C'\fR
.IX Subsection "include_sql_ca.db_name"
.PP
database name
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_ca.db_options\*(C'\fR
.IX Subsection "include_sql_ca.db_options"
.PP
connection options
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_sql_ca.db_env\*(C'\fR
.IX Subsection "include_sql_ca.db_env"
.PP
environment variables for database connection
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\e=\eS+(;\ew+\e=\eS+)*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_ca.db_user\*(C'\fR
.IX Subsection "include_sql_ca.db_user"
.PP
remote user
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_sql_ca.db_passwd\*(C'\fR
.IX Subsection "include_sql_ca.db_passwd"
.PP
remote password
.IP "Format:" 4
.IX Item "Format:"
The value to be concealed.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.57b.1 and later.
.PP
\f(CW\*(C`include_sql_ca.sql_query\*(C'\fR
.IX Subsection "include_sql_ca.sql_query"
.PP
\&\s-1SQL\s0 query
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$sql_query\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_ca.f_dir\*(C'\fR
.IX Subsection "include_sql_ca.f_dir"
.PP
Directory where the database is stored (used for \s-1DBD::CSV\s0 only)
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_ca.email_entry\*(C'\fR
.IX Subsection "include_sql_ca.email_entry"
.PP
Name of email entry
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_ca.nosync_time_ranges\*(C'\fR
.IX Subsection "include_sql_ca.nosync_time_ranges"
.PP
Time ranges when inclusion is not allowed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$time_ranges\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`include_sql_ca.connect_options\*(C'\fR
.IX Subsection "include_sql_ca.connect_options"
.PP
See \f(CW\*(C`db_options\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_sql_ca.host\*(C'\fR
.IX Subsection "include_sql_ca.host"
.PP
See \f(CW\*(C`db_host\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_sql_ca.passwd\*(C'\fR
.IX Subsection "include_sql_ca.passwd"
.PP
See \f(CW\*(C`db_passwd\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\f(CW\*(C`include_sql_ca.user\*(C'\fR
.IX Subsection "include_sql_ca.user"
.PP
See \f(CW\*(C`db_user\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.SS "\s-1DKIM/DMARC/ARC\s0"
.IX Subsection "DKIM/DMARC/ARC"
\&\s-1DKIM\s0 signature verification and re-signing. It requires an external module: Mail-DKIM.
.PP
\&\s-1ARC\s0 seals on forwarded messages. It requires an external module: Mail-DKIM.
.PP
\fI\f(CI\*(C`dkim_add_signature_to\*(C'\fI\fR
.IX Subsection "dkim_add_signature_to"
.PP
Which service messages to be signed
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`(?:list|robot)(?:,(?:list|robot))*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`robot,list\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Inserts a \s-1DKIM\s0 signature to service messages in context of robot, list or both
.PP
\fI\f(CI\*(C`dkim_signer_identity\*(C'\fI\fR
.IX Subsection "dkim_signer_identity"
.PP
The \*(L"i=\*(R" tag as defined in rfc 4871
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Default is null.
.PP
\fI\f(CI\*(C`dkim_feature\*(C'\fI\fR
.IX Subsection "dkim_feature"
.PP
Insert \s-1DKIM\s0 signature to messages sent to the list
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
If set to \*(L"on\*(R", Sympa may verify \s-1DKIM\s0 signatures of incoming messages and/or insert \s-1DKIM\s0 signature to outgoing messages.
.PP
\fI\f(CI\*(C`dkim_parameters\*(C'\fI\fR
.IX Subsection "dkim_parameters"
.PP
(Paragraph)
\&\s-1DKIM\s0 configuration
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
A set of parameters in order to define outgoing \s-1DKIM\s0 signature
.PP
\f(CW\*(C`dkim_parameters.private_key_path\*(C'\fR
.IX Subsection "dkim_parameters.private_key_path"
.PP
File path for \s-1DKIM\s0 private key
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The file must contain a \s-1PEM\s0 encoded private key
.PP
\f(CW\*(C`dkim_parameters.selector\*(C'\fR
.IX Subsection "dkim_parameters.selector"
.PP
Selector for \s-1DNS\s0 lookup of \s-1DKIM\s0 public key
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The selector is used in order to build the \s-1DNS\s0 query for public key. It is up to you to choose the value you want but verify that you can query the public \s-1DKIM\s0 key for \*(L"<selector>._domainkey.your_domain\*(R"
.PP
\f(CW\*(C`dkim_parameters.header_list\*(C'\fR
.IX Subsection "dkim_parameters.header_list"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\f(CW\*(C`dkim_parameters.signer_domain\*(C'\fR
.IX Subsection "dkim_parameters.signer_domain"
.PP
\&\s-1DKIM\s0 \*(L"d=\*(R" tag, you should probably use the default value
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The \s-1DKIM\s0 \*(L"d=\*(R" tag, is the domain of the signing entity. The list domain \s-1MUST\s0 be included in the \*(L"d=\*(R" domain
.PP
\f(CW\*(C`dkim_parameters.signer_identity\*(C'\fR
.IX Subsection "dkim_parameters.signer_identity"
.PP
\&\s-1DKIM\s0 \*(L"i=\*(R" tag, you should probably leave this parameter empty
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\&\s-1DKIM\s0 \*(L"i=\*(R" tag, you should probably not use this parameter, as recommended by \s-1RFC 4871,\s0 default for list broadcasted messages is i=<listname>\-request@<domain>
.PP
\fI\f(CI\*(C`dkim_signature_apply_on\*(C'\fI\fR
.IX Subsection "dkim_signature_apply_on"
.PP
The categories of messages sent to the list that will be signed using \s-1DKIM.\s0
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.RS 4
.ie n .IP """md5_authenticated_messages"" \- authenticated by password" 4
.el .IP "\f(CWmd5_authenticated_messages\fR \- authenticated by password" 4
.IX Item "md5_authenticated_messages - authenticated by password"
.PD 0
.ie n .IP """smime_authenticated_messages"" \- authenticated by S/MIME signature" 4
.el .IP "\f(CWsmime_authenticated_messages\fR \- authenticated by S/MIME signature" 4
.IX Item "smime_authenticated_messages - authenticated by S/MIME signature"
.ie n .IP """dkim_authenticated_messages"" \- authenticated by \s-1DKIM\s0 signature" 4
.el .IP "\f(CWdkim_authenticated_messages\fR \- authenticated by \s-1DKIM\s0 signature" 4
.IX Item "dkim_authenticated_messages - authenticated by DKIM signature"
.ie n .IP """editor_validated_messages"" \- approved by moderator" 4
.el .IP "\f(CWeditor_validated_messages\fR \- approved by moderator" 4
.IX Item "editor_validated_messages - approved by moderator"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.ie n .IP """any"" \- any messages" 4
.el .IP "\f(CWany\fR \- any messages" 4
.IX Item "any - any messages"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`md5_authenticated_messages,smime_authenticated_messages,dkim_authenticated_messages,editor_validated_messages\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This parameter controls in which case messages must be signed using \s-1DKIM,\s0 you may sign every message choosing 'any' or a subset. The parameter value is a comma separated list of keywords
.PP
\fI\f(CI\*(C`arc_feature\*(C'\fI\fR
.IX Subsection "arc_feature"
.PP
Add \s-1ARC\s0 seals to messages sent to the list
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.37b.1 and later.
.PP
Enable/Disable \s-1ARC.\s0 This feature requires Mail::DKIM::ARC to be installed, and maybe some custom scenario to be updated
.PP
\fI\f(CI\*(C`arc_srvid\*(C'\fI\fR
.IX Subsection "arc_srvid"
.PP
\&\s-1SRV ID\s0 for Authentication-Results used in \s-1ARC\s0 seal
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.37b.1 and later.
.PP
Typically the domain of the mail server
.PP
\fI\f(CI\*(C`arc_parameters\*(C'\fI\fR
.IX Subsection "arc_parameters"
.PP
(Paragraph)
\&\s-1ARC\s0 configuration
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
A set of parameters in order to define outgoing \s-1ARC\s0 seal
.PP
\f(CW\*(C`arc_parameters.arc_private_key_path\*(C'\fR
.IX Subsection "arc_parameters.arc_private_key_path"
.PP
File path for \s-1ARC\s0 private key
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The file must contain a \s-1PEM\s0 encoded private key. Defaults to same file as \s-1DKIM\s0 private key
.PP
\f(CW\*(C`arc_parameters.arc_selector\*(C'\fR
.IX Subsection "arc_parameters.arc_selector"
.PP
Selector for \s-1DNS\s0 lookup of \s-1ARC\s0 public key
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The selector is used in order to build the \s-1DNS\s0 query for public key. It is up to you to choose the value you want but verify that you can query the public \s-1DKIM\s0 key for \*(L"<selector>._domainkey.your_domain\*(R". Default is the same selector as for \s-1DKIM\s0 signatures
.PP
\f(CW\*(C`arc_parameters.arc_signer_domain\*(C'\fR
.IX Subsection "arc_parameters.arc_signer_domain"
.PP
\&\s-1ARC\s0 \*(L"d=\*(R" tag, you should probably use the default value
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
The \s-1ARC\s0 \*(L"d=\*(R" tag is the domain of the signing entity. The \s-1DKIM\s0 d= domain name is used as its default value
.PP
\fI\f(CI\*(C`dmarc_protection\*(C'\fI\fR
.IX Subsection "dmarc_protection"
.PP
(Paragraph)
\&\s-1DMARC\s0 Protection
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
Parameters to define how to manage From address processing to avoid some domains' excessive \s-1DMARC\s0 protection
.PP
\f(CW\*(C`dmarc_protection.mode\*(C'\fR
.IX Subsection "dmarc_protection.mode"
.PP
Protection modes
.IP "Format:" 4
.IX Item "Format:"
Multiple values allowed, separated by "\f(CW\*(C`,\*(C'\fR".
.RS 4
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.PD 0
.ie n .IP """all"" \- all" 4
.el .IP "\f(CWall\fR \- all" 4
.IX Item "all - all"
.ie n .IP """dkim_signature"" \- \s-1DKIM\s0 signature exists" 4
.el .IP "\f(CWdkim_signature\fR \- \s-1DKIM\s0 signature exists" 4
.IX Item "dkim_signature - DKIM signature exists"
.ie n .IP """dmarc_reject"" \- \s-1DMARC\s0 policy suggests rejection" 4
.el .IP "\f(CWdmarc_reject\fR \- \s-1DMARC\s0 policy suggests rejection" 4
.IX Item "dmarc_reject - DMARC policy suggests rejection"
.ie n .IP """dmarc_any"" \- \s-1DMARC\s0 policy exists" 4
.el .IP "\f(CWdmarc_any\fR \- \s-1DMARC\s0 policy exists" 4
.IX Item "dmarc_any - DMARC policy exists"
.ie n .IP """dmarc_quarantine"" \- \s-1DMARC\s0 policy suggests quarantine" 4
.el .IP "\f(CWdmarc_quarantine\fR \- \s-1DMARC\s0 policy suggests quarantine" 4
.IX Item "dmarc_quarantine - DMARC policy suggests quarantine"
.ie n .IP """domain_regex"" \- domain matching regular expression" 4
.el .IP "\f(CWdomain_regex\fR \- domain matching regular expression" 4
.IX Item "domain_regex - domain matching regular expression"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Select one or more operation modes.  \*(L"Domain matching regular expression\*(R" (domain_regex) matches the specified Domain regular expression; \*(L"\s-1DKIM\s0 signature exists\*(R" (dkim_signature) matches any message with a \s-1DKIM\s0 signature header; \*(L"\s-1DMARC\s0 policy ...\*(R" (dmarc_*) matches messages from sender domains with a \s-1DMARC\s0 policy as given; \*(L"all\*(R" (all) matches all messages.
.PP
Example:
.PP
.Vb 1
\&  dmarc_protection.mode dmarc_reject,dkim_signature
.Ve
.PP
\f(CW\*(C`dmarc_protection.domain_regex\*(C'\fR
.IX Subsection "dmarc_protection.domain_regex"
.PP
Regular expression for domain name match
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Regular expression match pattern for From domain
.PP
\f(CW\*(C`dmarc_protection.other_email\*(C'\fR
.IX Subsection "dmarc_protection.other_email"
.PP
New From address
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This is the email address to use when modifying the From header.  It defaults to the list address.  This is similar to Anonymisation but preserves the original sender details in the From address phrase.
.PP
\f(CW\*(C`dmarc_protection.phrase\*(C'\fR
.IX Subsection "dmarc_protection.phrase"
.PP
New From name format
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """display_name"" \- ""Name""" 4
.el .IP "\f(CWdisplay_name\fR \- ``Name''" 4
.IX Item "display_name - Name"
.ie n .IP """name_and_email"" \- ""Name"" (e\-mail)" 4
.el .IP "\f(CWname_and_email\fR \- ``Name'' (e\-mail)" 4
.IX Item "name_and_email - Name (e-mail)"
.ie n .IP """name_via_list"" \- ""Name"" (via List)" 4
.el .IP "\f(CWname_via_list\fR \- ``Name'' (via List)" 4
.IX Item "name_via_list - Name (via List)"
.ie n .IP """name_email_via_list"" \- ""Name"" (e\-mail via List)" 4
.el .IP "\f(CWname_email_via_list\fR \- ``Name'' (e\-mail via List)" 4
.IX Item "name_email_via_list - Name (e-mail via List)"
.ie n .IP """list_for_email"" \- ""List"" (on behalf of e\-mail)" 4
.el .IP "\f(CWlist_for_email\fR \- ``List'' (on behalf of e\-mail)" 4
.IX Item "list_for_email - List (on behalf of e-mail)"
.ie n .IP """list_for_name"" \- ""List"" (on behalf of Name)" 4
.el .IP "\f(CWlist_for_name\fR \- ``List'' (on behalf of Name)" 4
.IX Item "list_for_name - List (on behalf of Name)"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`name_via_list\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This is the format to be used for the sender name part of the new From header field.
.SS "List address verification"
.IX Subsection "List address verification"
Checks if an alias with the same name as the list to be created already exists on the \s-1SMTP\s0 server. This feature requires an external module: Net-SMTP.
.PP
\fI\f(CI\*(C`list_check_helo\*(C'\fI\fR
.IX Subsection "list_check_helo"
.PP
\&\s-1SMTP HELO\s0 (\s-1EHLO\s0) parameter used for address verification
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 and later.
.PP
Default value is the host part of \*(L"list_check_smtp\*(R" parameter.
.PP
\fI\f(CI\*(C`list_check_smtp\*(C'\fI\fR
.IX Subsection "list_check_smtp"
.PP
\&\s-1SMTP\s0 server to verify existence of the same addresses as the list to be created
.IP "Format:" 4
.IX Item "Format:"
/\f(CW$hostport\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This is needed if you are running Sympa on a host but you handle all your mail on a separate mail relay.
.PP
Default value is real \s-1FQDN\s0 of the host. Port number may be specified as \*(L"mail.example.org:25\*(R" or \*(L"203.0.113.1:25\*(R".  If port is not specified, standard port (25) will be used.
.PP
\fI\f(CI\*(C`list_check_suffixes\*(C'\fI\fR
.IX Subsection "list_check_suffixes"
.PP
Address suffixes to verify
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`request,owner,editor,unsubscribe,subscribe\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
List of suffixes you are using for list addresses, i.e. \*(L"mylist-request\*(R", \*(L"mylist-owner\*(R" and so on.
.PP
This parameter is used with the \*(L"list_check_smtp\*(R" parameter. It is also used to check list names at list creation time.
.SS "Antivirus plug-in"
.IX Subsection "Antivirus plug-in"
\fI\f(CI\*(C`antivirus_path\*(C'\fI\fR
.IX Subsection "antivirus_path"
.PP
Path to the antivirus scanner engine
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Supported antivirus: Clam AntiVirus/clamscan & clamdscan, McAfee/uvscan, Fsecure/fsav, Sophos, \s-1AVP\s0 and Trend Micro/VirusWall
.PP
Example:
.PP
.Vb 1
\&  antivirus_path /usr/local/bin/clamscan
.Ve
.PP
\fI\f(CI\*(C`antivirus_args\*(C'\fI\fR
.IX Subsection "antivirus_args"
.PP
Antivirus plugin command line arguments
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Example:
.PP
.Vb 1
\&  antivirus_args \-\-no\-summary \-\-database /usr/local/share/clamav
.Ve
.PP
\fI\f(CI\*(C`antivirus_notify\*(C'\fI\fR
.IX Subsection "antivirus_notify"
.PP
Notify sender if virus checker detects malicious content
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """sender"" \- sender" 4
.el .IP "\f(CWsender\fR \- sender" 4
.IX Item "sender - sender"
.ie n .IP """delivery_status"" \- send back \s-1DSN\s0" 4
.el .IP "\f(CWdelivery_status\fR \- send back \s-1DSN\s0" 4
.IX Item "delivery_status - send back DSN"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`sender\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\&\*(L"sender\*(R" to notify originator of the message, \*(L"delivery_status\*(R" to send delivery status, or \*(L"none\*(R"
.SS "Miscellaneous"
.IX Subsection "Miscellaneous"
\fI\f(CI\*(C`email\*(C'\fI\fR
.IX Subsection "email"
.PP
Local part of Sympa email address
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`sympa\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Local part (the part preceding the \*(L"@\*(R" sign) of the address by which mail interface of Sympa accepts mail commands.
.PP
If you change the default value, you must modify the mail aliases too.
.PP
\fI\f(CI\*(C`listmaster_email\*(C'\fI\fR
.IX Subsection "listmaster_email"
.PP
Local part of listmaster email address
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`listmaster\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Local part (the part preceding the \*(L"@\*(R" sign) of the address by which listmasters receive messages.
.PP
If you change the default value, you must modify the mail aliases too.
.PP
\fI\f(CI\*(C`custom_robot_parameter\*(C'\fI\fR
.IX Subsection "custom_robot_parameter"
.PP
Custom robot parameter
.IP "Format:" 4
.IX Item "Format:"
Multiple occurrences allowed.
.Sp
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Used to define a custom parameter for your server. Do not forget the semicolon between the parameter name and the parameter value.
.PP
You will be able to access the custom parameter value in web templates by variable \*(L"conf.custom_robot_parameter.<param_name>\*(R"
.PP
Example:
.PP
.Vb 1
\&  custom_robot_parameter param_name ; param_value
.Ve
.PP
\fI\f(CI\*(C`prohibited_listnames\*(C'\fI\fR
.IX Subsection "prohibited_listnames"
.PP
Prevent people to use some names for their lists names
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.63b.1 and later.
.PP
This parameter is a comma-separated list of names. You can use * as a wildcard character. To use a regex for this, please use prohibited_listnames_regex setting.
.PP
Example:
.PP
.Vb 1
\&  prohibited_listnames www,root,*master
.Ve
.PP
\fI\f(CI\*(C`prohibited_listnames_regex\*(C'\fI\fR
.IX Subsection "prohibited_listnames_regex"
.PP
Prevent people to use some names for their lists names, based on a regex
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.63b.1 and later.
.PP
This parameter is a regex. Please note that prohibited_listnames and prohibited_listnames_regex will both be applied if set, they are not exclusive.
.PP
Example:
.PP
.Vb 1
\&  prohibited_listnames_regex www|root|.*master
.Ve
.PP
\fI\f(CI\*(C`cache_list_config\*(C'\fI\fR
.IX Subsection "cache_list_config"
.PP
Use of binary cache of list configuration
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """binary_file"" \- use binary file" 4
.el .IP "\f(CWbinary_file\fR \- use binary file" 4
.IX Item "binary_file - use binary file"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`none\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
binary_file: Sympa processes will maintain a binary version of the list configuration, \*(L"config.bin\*(R" file on local disk. If you manage a big amount of lists (1000+), it should make the web interface startup faster.
.PP
You can recreate cache by running \*(L"sympa.pl \-\-reload_list_config\*(R".
.PP
\fI\f(CI\*(C`db_list_cache\*(C'\fI\fR
.IX Subsection "db_list_cache"
.PP
Use database cache to search lists
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Note that \*(L"list_table\*(R" database table should be filled at the first time by running:
.PP
.Vb 1
\&  # sympa.pl \-\-sync_list_db
.Ve
.PP
\fI\f(CI\*(C`purge_user_table_task\*(C'\fI\fR
.IX Subsection "purge_user_table_task"
.PP
Task for expiring inactive users
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`monthly\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This task removes rows in the \*(L"user_table\*(R" table which have not corresponding entries in the \*(L"subscriber_table\*(R" table.
.PP
\fI\f(CI\*(C`purge_logs_table_task\*(C'\fI\fR
.IX Subsection "purge_logs_table_task"
.PP
Task for cleaning tables
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`daily\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This task cleans old logs from \*(L"logs_table\*(R" table.
.PP
\fI\f(CI\*(C`logs_expiration_period\*(C'\fI\fR
.IX Subsection "logs_expiration_period"
.PP
Max age of logs in database
.IP "Format:" 4
.IX Item "Format:"
Number of months.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW3\fR (months)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Number of months that elapse before a log is expired
.PP
\fI\f(CI\*(C`stats_expiration_period\*(C'\fI\fR
.IX Subsection "stats_expiration_period"
.PP
Max age of statistics information in database
.IP "Format:" 4
.IX Item "Format:"
Number of months.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW3\fR (months)
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2b.7 and later.
.PP
Number of months that elapse before statistics information are expired
.PP
\fI\f(CI\*(C`umask\*(C'\fI\fR
.IX Subsection "umask"
.PP
Umask
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`[0\-7]+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW027\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Default mask for file creation (see \fBumask\fR\|(2)). Note that it will be interpreted as an octal value.
.PP
\fI\f(CI\*(C`clean_delay_queuemod\*(C'\fI\fR
.IX Subsection "clean_delay_queuemod"
.PP
Max age of moderated messages
.IP "Format:" 4
.IX Item "Format:"
Number of days.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW30\fR (days)
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
Number of days messages are kept in moderation spool (as specified by \*(L"queuemod\*(R" parameter). Beyond this deadline, messages that have not been processed are deleted.
.PP
\fI\f(CI\*(C`custom_attribute\*(C'\fI\fR
.IX Subsection "custom_attribute"
.PP
(Paragraph)
Custom user attributes
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
\f(CW\*(C`custom_attribute.id\*(C'\fR
.IX Subsection "custom_attribute.id"
.PP
internal identifier
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`custom_attribute.name\*(C'\fR
.IX Subsection "custom_attribute.name"
.PP
label
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`custom_attribute.comment\*(C'\fR
.IX Subsection "custom_attribute.comment"
.PP
additional comment
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`custom_attribute.type\*(C'\fR
.IX Subsection "custom_attribute.type"
.PP
type
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """string"" \- string" 4
.el .IP "\f(CWstring\fR \- string" 4
.IX Item "string - string"
.ie n .IP """text"" \- multi-line text" 4
.el .IP "\f(CWtext\fR \- multi-line text" 4
.IX Item "text - multi-line text"
.ie n .IP """integer"" \- number" 4
.el .IP "\f(CWinteger\fR \- number" 4
.IX Item "integer - number"
.ie n .IP """enum"" \- set of keywords" 4
.el .IP "\f(CWenum\fR \- set of keywords" 4
.IX Item "enum - set of keywords"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`string\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`custom_attribute.enum_values\*(C'\fR
.IX Subsection "custom_attribute.enum_values"
.PP
possible attribute values (if enum is used)
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`custom_attribute.optional\*(C'\fR
.IX Subsection "custom_attribute.optional"
.PP
is the attribute optional?
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """required"" \- required" 4
.el .IP "\f(CWrequired\fR \- required" 4
.IX Item "required - required"
.ie n .IP """optional"" \- optional" 4
.el .IP "\f(CWoptional\fR \- optional" 4
.IX Item "optional - optional"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`optional\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`custom_vars\*(C'\fI\fR
.IX Subsection "custom_vars"
.PP
(Paragraph)
custom parameters
.IP "Multiple occurrences allowed" 4
.IX Item "Multiple occurrences allowed"
.PP
\f(CW\*(C`custom_vars.name\*(C'\fR
.IX Subsection "custom_vars.name"
.PP
var name
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`custom_vars.value\*(C'\fR
.IX Subsection "custom_vars.value"
.PP
var value
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`.+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`loop_prevention_regex\*(C'\fI\fR
.IX Subsection "loop_prevention_regex"
.PP
Regular expression applied to prevent loops with robots
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\eS*\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`mailer\-daemon|sympa|listserv|majordomo|smartlist|mailman\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
If the sender address matches the regular expression, then the message is rejected.
.PP
\fI\f(CI\*(C`pictures_feature\*(C'\fI\fR
.IX Subsection "pictures_feature"
.PP
Pictures
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`on\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Enables or disables the pictures feature by default.  If enabled, subscribers can upload their picture (from the \*(L"Subscriber option\*(R" page) to use as an avatar.
.PP
Pictures are stored in a directory specified by the \*(L"static_content_path\*(R" parameter.
.PP
\fI\f(CI\*(C`remind_task\*(C'\fI\fR
.IX Subsection "remind_task"
.PP
Periodical subscription reminder task
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.PP
This parameter states which model is used to create a remind task. A remind task regularly sends  subscribers a message which reminds them of their list subscriptions.
.PP
\fI\f(CI\*(C`latest_instantiation\*(C'\fI\fR
.IX Subsection "latest_instantiation"
.PP
(Paragraph)
Latest family instantiation
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
\f(CW\*(C`latest_instantiation.email\*(C'\fR
.IX Subsection "latest_instantiation.email"
.PP
who ran the instantiation
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`listmaster|$email\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`latest_instantiation.date_epoch\*(C'\fR
.IX Subsection "latest_instantiation.date_epoch"
.PP
date
.IP "Format:" 4
.IX Item "Format:"
The time in second from Unix epoch.
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`latest_instantiation.date\*(C'\fR
.IX Subsection "latest_instantiation.date"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.16.
.PP
\fI\f(CI\*(C`creation\*(C'\fI\fR
.IX Subsection "creation"
.PP
(Paragraph)
Creation of the list
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
\f(CW\*(C`creation.email\*(C'\fR
.IX Subsection "creation.email"
.PP
who created the list
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`listmaster|$email\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`creation.date_epoch\*(C'\fR
.IX Subsection "creation.date_epoch"
.PP
date
.IP "Format:" 4
.IX Item "Format:"
The time in second from Unix epoch.
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`creation.date\*(C'\fR
.IX Subsection "creation.date"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.16.
.PP
\fI\f(CI\*(C`update\*(C'\fI\fR
.IX Subsection "update"
.PP
(Paragraph)
Last update of config
.IP "Single occurrence" 4
.IX Item "Single occurrence"
.PP
\f(CW\*(C`update.email\*(C'\fR
.IX Subsection "update.email"
.PP
who updated the config
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`(listmaster|automatic|$email)\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`update.date_epoch\*(C'\fR
.IX Subsection "update.date_epoch"
.PP
date
.IP "Format:" 4
.IX Item "Format:"
The time in second from Unix epoch.
.IP "Default:" 4
.IX Item "Default:"
None, \fImandatory\fR.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\f(CW\*(C`update.date\*(C'\fR
.IX Subsection "update.date"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.16.
.PP
\fI\f(CI\*(C`status\*(C'\fI\fR
.IX Subsection "status"
.PP
Status of the list
.IP "Format:" 4
.IX Item "Format:"
Status of list.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`open\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`serial\*(C'\fI\fR
.IX Subsection "serial"
.PP
Serial number of the config
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ed+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW0\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.SS "Web interface parameters"
.IX Subsection "Web interface parameters"
\fI\f(CI\*(C`wwsympa_url\*(C'\fI\fR
.IX Subsection "wwsympa_url"
.PP
\&\s-1URL\s0 prefix of web interface
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This is used to construct URLs of web interface. The protocol (either https:// or http://) is required.
.PP
Example:
.PP
.Vb 1
\&  wwsympa_url https://web.example.org/sympa
.Ve
.PP
\fI\f(CI\*(C`wwsympa_url_local\*(C'\fI\fR
.IX Subsection "wwsympa_url_local"
.PP
\&\s-1URL\s0 prefix of WWSympa behind proxy
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.56 and later.
.PP
\fI\f(CI\*(C`static_content_url\*(C'\fI\fR
.IX Subsection "static_content_url"
.PP
\&\s-1URL\s0 for static contents
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`/static\-sympa\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\&\s-1HTTP\s0 server have to map it with \*(L"static_content_path\*(R" directory.
.PP
\fI\f(CI\*(C`static_content_path\*(C'\fI\fR
.IX Subsection "static_content_path"
.PP
Directory for static contents
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW$STATICDIR\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`css_path\*(C'\fI\fR
.IX Subsection "css_path"
.PP
Directory for static style sheets (\s-1CSS\s0)
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW$CSSDIR\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
After an upgrade, static \s-1CSS\s0 files are upgraded with the newly installed \*(L"css.tt2\*(R" template. Therefore, this is not a good place to store customized \s-1CSS\s0 files.
.PP
\fI\f(CI\*(C`css_url\*(C'\fI\fR
.IX Subsection "css_url"
.PP
\&\s-1URL\s0 for style sheets (\s-1CSS\s0)
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`/static\-sympa/css\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
To use auto-generated static \s-1CSS, HTTP\s0 server have to map it with \*(L"css_path\*(R".
.PP
\fI\f(CI\*(C`pictures_path\*(C'\fI\fR
.IX Subsection "pictures_path"
.PP
Directory for subscribers pictures
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW$PICTURESDIR\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.25b.2 and later.
.PP
\fI\f(CI\*(C`pictures_url\*(C'\fI\fR
.IX Subsection "pictures_url"
.PP
\&\s-1URL\s0 for subscribers pictures
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`/static\-sympa/pictures\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.25b.2 and later.
.PP
\&\s-1HTTP\s0 server have to map it with \*(L"pictures_path\*(R" directory.
.PP
\fI\f(CI\*(C`mhonarc\*(C'\fI\fR
.IX Subsection "mhonarc"
.PP
Path to MHonArc mail-to-HTML converter
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`/usr/bin/mhonarc\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
This is required for \s-1HTML\s0 mail archiving.
.PP
\fI\f(CI\*(C`log_facility\*(C'\fI\fR
.IX Subsection "log_facility"
.PP
System log facility for web interface
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`LOCAL1\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
System log facility for WWSympa, archived.pl and bounced.pl. Default is to use value of \*(L"syslog\*(R" parameter.
.SS "Web interface parameters: Appearances"
.IX Subsection "Web interface parameters: Appearances"
\fI\f(CI\*(C`logo_html_definition\*(C'\fI\fR
.IX Subsection "logo_html_definition"
.PP
Custom logo
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\&\s-1HTML\s0 fragment to insert a logo in the page of web interface.
.PP
Example:
.PP
.Vb 1
\&  logo_html_definition <a href="http://www.example.com"><img style="float: left; margin\-top: 7px; margin\-left: 37px;" src="http://www.example.com/logos/mylogo.jpg" alt="My Company" /></a>
.Ve
.PP
\fI\f(CI\*(C`favicon_url\*(C'\fI\fR
.IX Subsection "favicon_url"
.PP
Custom favicon
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.5 and later.
.PP
\&\s-1URL\s0 of favicon image
.PP
\fI\f(CI\*(C`color_0\*(C'\fI, ..., \f(CI\*(C`color_15\*(C'\fI\fR
.IX Subsection "color_0, ..., color_15"
.PP
Colors for web interface
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
See description on web interface.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Colors are used in style sheet (\s-1CSS\s0). They may be changed using web interface by listmasters.
.PP
\fI\f(CI\*(C`dark_color\*(C'\fI, \f(CI\*(C`light_color\*(C'\fI, \f(CI\*(C`text_color\*(C'\fI, \f(CI\*(C`bg_color\*(C'\fI, \f(CI\*(C`error_color\*(C'\fI, \f(CI\*(C`selected_color\*(C'\fI, \f(CI\*(C`shaded_color\*(C'\fI\fR
.IX Subsection "dark_color, light_color, text_color, bg_color, error_color, selected_color, shaded_color"
.PP
Colors for web interface, obsoleted
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
See description on web interface.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`default_home\*(C'\fI\fR
.IX Subsection "default_home"
.PP
Type of main web page
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`home\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\&\*(L"lists\*(R" for the page of list of lists. \*(L"home\*(R" for home page.
.PP
\fI\f(CI\*(C`archive_default_index\*(C'\fI\fR
.IX Subsection "archive_default_index"
.PP
Default index organization of web archive
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`thrd\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
thrd: Threaded index.
.PP
mail: Chronological index.
.PP
\fI\f(CI\*(C`review_page_size\*(C'\fI\fR
.IX Subsection "review_page_size"
.PP
Size of review page
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW25\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Default number of lines of the array displaying users in the review page
.PP
\fI\f(CI\*(C`viewlogs_page_size\*(C'\fI\fR
.IX Subsection "viewlogs_page_size"
.PP
Size of viewlogs page
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW25\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Default number of lines of the array displaying the log entries in the logs page.
.PP
\fI\f(CI\*(C`main_menu_custom_button_1_title\*(C'\fI, ... \f(CI\*(C`main_menu_custom_button_3_title\*(C'\fI, \f(CI\*(C`main_menu_custom_button_1_url\*(C'\fI, ... \f(CI\*(C`main_menu_custom_button_3_url\*(C'\fI, \f(CI\*(C`main_menu_custom_button_1_target\*(C'\fI, ... \f(CI\*(C`main_menu_custom_button_3_target\*(C'\fI\fR
.IX Subsection "main_menu_custom_button_1_title, ... main_menu_custom_button_3_title, main_menu_custom_button_1_url, ... main_menu_custom_button_3_url, main_menu_custom_button_1_target, ... main_menu_custom_button_3_target"
.PP
Custom menus
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
You may modify the main menu content by editing the menu.tt2 file, but you can also edit these parameters in order to add up to 3 buttons. Each button is defined by a title (the text in the button), an \s-1URL\s0 and, optionally, a target.
.PP
Example:
.PP
.Vb 3
\&  main_menu_custom_button_1_title FAQ
\&  main_menu_custom_button_1_url http://www.renater.fr/faq/universalistes/index
\&  main_menu_custom_button_1_target Help
.Ve
.SS "Password validation"
.IX Subsection "Password validation"
Checks if the password the user submitted has sufficient strength. This feature requires an external module: Data-Password.
.PP
\fI\f(CI\*(C`password_validation\*(C'\fI\fR
.IX Subsection "password_validation"
.PP
Password validation
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.1.23 and later.
.PP
The password validation techniques to be used against user passwords that are added to mailing lists. Options come from Data::Password https://metacpan.org/pod/Data::Password#VARIABLES
.PP
Example:
.PP
.Vb 1
\&  password_validation MINLEN=8,GROUPS=3,DICTIONARY=4,DICTIONARIES=/pentest/dictionaries
.Ve
.SS "Authentication with \s-1LDAP\s0"
.IX Subsection "Authentication with LDAP"
Authenticates users based on the directory on \s-1LDAP\s0 server. This feature requires an external module: Net-LDAP. And also, if secure connection (\s-1LDAPS\s0) is required: IO-Socket-SSL.
.PP
\fI\f(CI\*(C`ldap_force_canonical_email\*(C'\fI\fR
.IX Subsection "ldap_force_canonical_email"
.PP
Use canonical email address for \s-1LDAP\s0 authentication
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW1\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
When using \s-1LDAP\s0 authentication, if the identifier provided by the user was a valid email, if this parameter is set to false, then the provided email will be used to authenticate the user. Otherwise, use of the first email returned by the \s-1LDAP\s0 server will be used.
.SS "\s-1SOAP HTTP\s0 interface"
.IX Subsection "SOAP HTTP interface"
Provides some functions of Sympa through the \s-1SOAP HTTP\s0 interface. This feature requires an external module: SOAP-Lite.
.PP
\fI\f(CI\*(C`soap_url\*(C'\fI\fR
.IX Subsection "soap_url"
.PP
\&\s-1URL\s0 of SympaSOAP
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\&\s-1WSDL\s0 document of SympaSOAP refers to this \s-1URL\s0 in its service section.
.PP
Example:
.PP
.Vb 1
\&  soap_url http://web.example.org/sympasoap
.Ve
.PP
\fI\f(CI\*(C`soap_url_local\*(C'\fI\fR
.IX Subsection "soap_url_local"
.PP
\&\s-1URL\s0 of SympaSOAP behind proxy
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.19b.1 and later.
.SS "Web interface parameters: Miscellaneous"
.IX Subsection "Web interface parameters: Miscellaneous"
\fI\f(CI\*(C`cookie_domain\*(C'\fI\fR
.IX Subsection "cookie_domain"
.PP
\&\s-1HTTP\s0 cookies validity domain
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`localhost\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
If beginning with a dot (\*(L".\*(R"), the cookie is available within the specified Internet domain. Otherwise, for the specified host. The only reason for replacing the default value would be where WWSympa's authentication process is shared with an application running on another host.
.PP
Example:
.PP
.Vb 1
\&  cookie_domain .renater.fr
.Ve
.PP
\fI\f(CI\*(C`cookie_expire\*(C'\fI\fR
.IX Subsection "cookie_expire"
.PP
\&\s-1HTTP\s0 cookies lifetime
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW0\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This is the default value when not set explicitly by users. \*(L"0\*(R" means the cookie may be retained during browser sessions.
.PP
\fI\f(CI\*(C`cookie_refresh\*(C'\fI\fR
.IX Subsection "cookie_refresh"
.PP
Average interval to refresh \s-1HTTP\s0 session \s-1ID.\s0
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW60\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`purge_session_table_task\*(C'\fI\fR
.IX Subsection "purge_session_table_task"
.PP
Task for cleaning old sessions
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`daily\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
This task removes old entries in the \*(L"session_table\*(R" table.
.PP
\fI\f(CI\*(C`session_table_ttl\*(C'\fI\fR
.IX Subsection "session_table_ttl"
.PP
Max age of sessions
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`2d\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Session duration is controlled by \*(L"sympa_session\*(R" cookie validity attribute. However, by security reason, this delay also need to be controlled by server side. This task removes old entries in the \*(L"session_table\*(R" table.
.PP
Format of values is a string without spaces including \*(L"y\*(R" for years, \*(L"m\*(R" for months, \*(L"d\*(R" for days, \*(L"h\*(R" for hours, \*(L"min\*(R" for minutes and \*(L"sec\*(R" for seconds.
.PP
\fI\f(CI\*(C`anonymous_session_table_ttl\*(C'\fI\fR
.IX Subsection "anonymous_session_table_ttl"
.PP
Max age of sessions for anonymous users
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`1h\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`shared_feature\*(C'\fI\fR
.IX Subsection "shared_feature"
.PP
Enable shared repository
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.41b.2 and later.
.PP
If set to \*(L"on\*(R", list owners can open shared repository.
.PP
\fI\f(CI\*(C`use_html_editor\*(C'\fI\fR
.IX Subsection "use_html_editor"
.PP
Use \s-1HTML\s0 editor
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 and later.
.PP
If set to \*(L"on\*(R", users will be able to post messages in \s-1HTML\s0 using a javascript \s-1WYSIWYG\s0 editor.
.PP
Example:
.PP
.Vb 1
\&  use_html_editor on
.Ve
.PP
\fI\f(CI\*(C`html_editor_url\*(C'\fI\fR
.IX Subsection "html_editor_url"
.PP
\&\s-1URL\s0 of \s-1HTML\s0 editor
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.34 and later.
.PP
\&\s-1URL\s0 path to the javascript file making the \s-1WYSIWYG HTML\s0 editor available.  Relative path under <static_content_url> or absolute path.
.PP
Example is for TinyMCE 4 installed under <static_content_path>/js/tinymce/.
.PP
Example:
.PP
.Vb 1
\&  html_editor_url js/tinymce/tinymce.min.js
.Ve
.PP
\fI\f(CI\*(C`html_editor_init\*(C'\fI\fR
.IX Subsection "html_editor_init"
.PP
\&\s-1HTML\s0 editor initialization
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 and later.
.PP
Javascript excerpt that enables and configures the \s-1WYSIWYG HTML\s0 editor.
.PP
Example:
.PP
.Vb 1
\&  html_editor_init tinymce.init({selector:"#body",language:lang.split(/[^a\-zA\-Z]+/).join("_")});
.Ve
.PP
\fI\f(CI\*(C`max_wrong_password\*(C'\fI\fR
.IX Subsection "max_wrong_password"
.PP
Count limit of wrong password submission
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW19\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
If this limit is reached, the account is locked until the user renews their password. The default value is chosen in order to block bots trying to log in using brute force strategy. This value should never be reached by real users that will probably uses the renew password service before they performs so many tries.
.PP
\fI\f(CI\*(C`password_case\*(C'\fI\fR
.IX Subsection "password_case"
.PP
Password case
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`insensitive\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\&\*(L"insensitive\*(R" or \*(L"sensitive\*(R".
.PP
If set to \*(L"insensitive\*(R", WWSympa's password check will be insensitive. This only concerns passwords stored in the Sympa database, not the ones in \s-1LDAP.\s0
.PP
Should not be changed! May invalid all user password.
.PP
\fI\f(CI\*(C`password_hash\*(C'\fI\fR
.IX Subsection "password_hash"
.PP
Password hashing algorithm
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`md5\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.25b.3 and later.
.PP
\&\*(L"md5\*(R" or \*(L"bcrypt\*(R".
.PP
If set to \*(L"md5\*(R", Sympa will use \s-1MD5\s0 password hashes. If set to \*(L"bcrypt\*(R", bcrypt hashes will be used instead. This only concerns passwords stored in the Sympa database, not the ones in \s-1LDAP.\s0
.PP
\fI\f(CI\*(C`password_hash_update\*(C'\fI\fR
.IX Subsection "password_hash_update"
.PP
Update password hashing algorithm when users log in
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW1\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.25b.3 and later.
.PP
On successful login, update the encrypted user password to use the algorithm specified by \*(L"password_hash\*(R". This allows for a graceful transition to a new password hash algorithm. A value of 0 disables updating of existing password hashes.  New and reset passwords will use the \*(L"password_hash\*(R" setting in all cases.
.PP
\fI\f(CI\*(C`bcrypt_cost\*(C'\fI\fR
.IX Subsection "bcrypt_cost"
.PP
Bcrypt hash cost
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW12\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.25b.3 and later.
.PP
When \*(L"password_hash\*(R" is set to \*(L"bcrypt\*(R", this sets the \*(L"cost\*(R" parameter of the bcrypt hash function. The default of 12 is expected to require approximately 250ms to calculate the password hash on a 3.2GHz \s-1CPU.\s0 This only concerns passwords stored in the Sympa database, not the ones in \s-1LDAP.\s0
.PP
Can be changed but any new cost setting will only apply to new passwords.
.PP
\fI\f(CI\*(C`one_time_ticket_lifetime\*(C'\fI\fR
.IX Subsection "one_time_ticket_lifetime"
.PP
Age of one time ticket
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`2d\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
Duration before the one time tickets are expired
.PP
\fI\f(CI\*(C`one_time_ticket_lockout\*(C'\fI\fR
.IX Subsection "one_time_ticket_lockout"
.PP
Restrict access to one time ticket
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`one_time\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
Is access to the one time ticket restricted, if any users previously accessed? (one_time | remote_addr | open)
.PP
\fI\f(CI\*(C`purge_one_time_ticket_table_task\*(C'\fI\fR
.IX Subsection "purge_one_time_ticket_table_task"
.PP
Task for expiring old one time tickets
.IP "Format:" 4
.IX Item "Format:"
/\f(CW\*(C`\ew+\*(C'\fR/
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`daily\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`one_time_ticket_table_ttl\*(C'\fI\fR
.IX Subsection "one_time_ticket_table_ttl"
.PP
Expiration period of one time ticket
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW\*(C`10d\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`pictures_max_size\*(C'\fI\fR
.IX Subsection "pictures_max_size"
.PP
The maximum size of uploaded picture
.IP "Format:" 4
.IX Item "Format:"
Number of bytes.
.IP "Default:" 4
.IX Item "Default:"
\&\f(CW102400\fR (bytes)
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`spam_protection\*(C'\fI\fR
.IX Subsection "spam_protection"
.PP
Protect web interface against spam harvesters
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """at"" \- replace @ characters" 4
.el .IP "\f(CWat\fR \- replace @ characters" 4
.IX Item "at - replace @ characters"
.ie n .IP """javascript"" \- use JavaScript" 4
.el .IP "\f(CWjavascript\fR \- use JavaScript" 4
.IX Item "javascript - use JavaScript"
.ie n .IP """none"" \- do nothing" 4
.el .IP "\f(CWnone\fR \- do nothing" 4
.IX Item "none - do nothing"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`javascript\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
There is a need to protect Sympa web sites against spambots which collect email addresses from public web sites. Various methods are available in Sympa and you can choose to use them with the spam_protection and web_archive_spam_protection parameters. Possible value are:
.PP
javascript:
.PP
the address is hidden using a javascript. A user who enables javascript can see a nice mailto address where others have nothing.
.PP
at:
.PP
the @ char is replaced by the string \*(L" \s-1AT \*(R".\s0
.PP
none:
.PP
no protection against spammer.
.PP
\fI\f(CI\*(C`reporting_spam_script_path\*(C'\fI\fR
.IX Subsection "reporting_spam_script_path"
.PP
Script to report spam
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 and later.
.PP
If set, when a list moderator report undetected spams for list moderation, this external script is invoked and the message is injected into standard input of the script.
.PP
\fI\f(CI\*(C`domains_blocklist\*(C'\fI\fR
.IX Subsection "domains_blocklist"
.PP
Prevent people to subscribe to a list with addresses using these domains
.IP "Format:" 4
.IX Item "Format:"
Any.
.IP "Default:" 4
.IX Item "Default:"
None.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.61b.1 and later.
.PP
This parameter is a comma-separated list.
.PP
Example:
.PP
.Vb 1
\&  domains_blocklist example.org,spammer.com
.Ve
.PP
\fI\f(CI\*(C`quiet_subscription\*(C'\fI\fR
.IX Subsection "quiet_subscription"
.PP
Quiet subscriptions policy
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """optional"" \- optional" 4
.el .IP "\f(CWoptional\fR \- optional" 4
.IX Item "optional - optional"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`optional\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.41b.1 and later.
.PP
Global policy for quiet subscriptions: \*(L"on\*(R" means that subscriptions will never send a notice to the subscriber, \*(L"off\*(R" will enforce a notice sending, and \*(L"optional\*(R" (default) allows the use of the list policy.
.PP
\fI\f(CI\*(C`show_report_abuse\*(C'\fI\fR
.IX Subsection "show_report_abuse"
.PP
Add a \*(L"Report abuse\*(R" link in the side menu of the lists
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.37b.3 and later.
.PP
The link is a mailto link, you can change that by overriding web_tt2/report_abuse.tt2
.PP
\fI\f(CI\*(C`allow_account_deletion\*(C'\fI\fR
.IX Subsection "allow_account_deletion"
.PP
\&\s-1EXPERIMENTAL\s0! Allow users to delete their account. If enabled, shows a \*(L"delete my account\*(R" form in user's preferences page.
.IP "Format:" 4
.IX Item "Format:"
.RS 4
.PD 0
.ie n .IP """on"" \- enabled" 4
.el .IP "\f(CWon\fR \- enabled" 4
.IX Item "on - enabled"
.ie n .IP """off"" \- disabled" 4
.el .IP "\f(CWoff\fR \- disabled" 4
.IX Item "off - disabled"
.RE
.RS 4
.RE
.IP "Default:" 4
.IX Item "Default:"
.PD
\&\f(CW\*(C`off\*(C'\fR
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.41b.1 and later.
.PP
Account deletion unsubscribes the users from his/her lists and removes him/her from lists ownership. It is only available to users using internal authentication (i.e. no \s-1LDAP,\s0 no \s-1SSO...\s0). See https://github.com/sympa\-community/sympa/issues/300 for details
.SS "Renamed parameters"
.IX Subsection "Renamed parameters"
These parameters were renamed.  Though older names are still available, their use is no longer recommended.
.PP
\fI\f(CI\*(C`arc_private_key_path\*(C'\fI\fR
.IX Subsection "arc_private_key_path"
.PP
See \f(CW\*(C`arc_parameters.arc_private_key_path\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.37b.1 to 6.2.56.
.PP
\fI\f(CI\*(C`arc_selector\*(C'\fI\fR
.IX Subsection "arc_selector"
.PP
See \f(CW\*(C`arc_parameters.arc_selector\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.37b.1 to 6.2.56.
.PP
\fI\f(CI\*(C`arc_signer_domain\*(C'\fI\fR
.IX Subsection "arc_signer_domain"
.PP
See \f(CW\*(C`arc_parameters.arc_signer_domain\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.37b.1 to 6.2.56.
.PP
\fI\f(CI\*(C`archive_mail_access\*(C'\fI\fR
.IX Subsection "archive_mail_access"
.PP
See \f(CW\*(C`archive.mail_access\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`archive_web_access\*(C'\fI\fR
.IX Subsection "archive_web_access"
.PP
See \f(CW\*(C`archive.web_access\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`bounce_halt_rate\*(C'\fI\fR
.IX Subsection "bounce_halt_rate"
.PP
See \f(CW\*(C`bounce.halt_rate\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`bounce_warn_rate\*(C'\fI\fR
.IX Subsection "bounce_warn_rate"
.PP
See \f(CW\*(C`bounce.warn_rate\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`custom\-header\*(C'\fI\fR
.IX Subsection "custom-header"
.PP
See \f(CW\*(C`custom_header\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.PP
\fI\f(CI\*(C`custom\-subject\*(C'\fI\fR
.IX Subsection "custom-subject"
.PP
See \f(CW\*(C`custom_subject\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.PP
\fI\f(CI\*(C`d_edit\*(C'\fI\fR
.IX Subsection "d_edit"
.PP
See \f(CW\*(C`shared_doc.d_edit\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`d_read\*(C'\fI\fR
.IX Subsection "d_read"
.PP
See \f(CW\*(C`shared_doc.d_read\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`default_archive_quota\*(C'\fI\fR
.IX Subsection "default_archive_quota"
.PP
See \f(CW\*(C`archive.quota\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`default_bounce_level1_rate\*(C'\fI\fR
.IX Subsection "default_bounce_level1_rate"
.PP
See \f(CW\*(C`bouncers_level1.rate\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`default_bounce_level2_rate\*(C'\fI\fR
.IX Subsection "default_bounce_level2_rate"
.PP
See \f(CW\*(C`bouncers_level2.rate\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`default_list_priority\*(C'\fI\fR
.IX Subsection "default_list_priority"
.PP
See \f(CW\*(C`priority\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`default_max_list_members\*(C'\fI\fR
.IX Subsection "default_max_list_members"
.PP
See \f(CW\*(C`max_list_members\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`default_remind_task\*(C'\fI\fR
.IX Subsection "default_remind_task"
.PP
See \f(CW\*(C`remind_task\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`default_shared_quota\*(C'\fI\fR
.IX Subsection "default_shared_quota"
.PP
See \f(CW\*(C`shared_doc.quota\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`default_sql_fetch_timeout\*(C'\fI\fR
.IX Subsection "default_sql_fetch_timeout"
.PP
See \f(CW\*(C`sql_fetch_timeout\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 to 6.2.56.
.PP
\fI\f(CI\*(C`default_ttl\*(C'\fI\fR
.IX Subsection "default_ttl"
.PP
See \f(CW\*(C`ttl\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`dkim_private_key_path\*(C'\fI\fR
.IX Subsection "dkim_private_key_path"
.PP
See \f(CW\*(C`dkim_parameters.private_key_path\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`dkim_selector\*(C'\fI\fR
.IX Subsection "dkim_selector"
.PP
See \f(CW\*(C`dkim_parameters.selector\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`dkim_signer_domain\*(C'\fI\fR
.IX Subsection "dkim_signer_domain"
.PP
See \f(CW\*(C`dkim_parameters.signer_domain\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`dmarc_protection_domain_regex\*(C'\fI\fR
.IX Subsection "dmarc_protection_domain_regex"
.PP
See \f(CW\*(C`dmarc_protection.domain_regex\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`dmarc_protection_mode\*(C'\fI\fR
.IX Subsection "dmarc_protection_mode"
.PP
See \f(CW\*(C`dmarc_protection.mode\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`dmarc_protection_other_email\*(C'\fI\fR
.IX Subsection "dmarc_protection_other_email"
.PP
See \f(CW\*(C`dmarc_protection.other_email\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`dmarc_protection_phrase\*(C'\fI\fR
.IX Subsection "dmarc_protection_phrase"
.PP
See \f(CW\*(C`dmarc_protection.phrase\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`domains_blacklist\*(C'\fI\fR
.IX Subsection "domains_blacklist"
.PP
See \f(CW\*(C`domains_blocklist\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2.41b.1 to 6.2.60.
.PP
\fI\f(CI\*(C`email_gecos\*(C'\fI\fR
.IX Subsection "email_gecos"
.PP
See \f(CW\*(C`gecos\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.5 to 6.2a.33.
.PP
\fI\f(CI\*(C`forced_reply\-to\*(C'\fI\fR
.IX Subsection "forced_reply-to"
.PP
See \f(CW\*(C`forced_reply_to\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.PP
\fI\f(CI\*(C`forced_replyto\*(C'\fI\fR
.IX Subsection "forced_replyto"
.PP
See \f(CW\*(C`forced_reply_to\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.PP
\fI\f(CI\*(C`key_password\*(C'\fI\fR
.IX Subsection "key_password"
.PP
See \f(CW\*(C`key_passwd\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`max\-size\*(C'\fI\fR
.IX Subsection "max-size"
.PP
See \f(CW\*(C`max_size\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.PP
\fI\f(CI\*(C`merge_feature\*(C'\fI\fR
.IX Subsection "merge_feature"
.PP
See \f(CW\*(C`personalization_feature\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.IP "Available versions:" 4
.IX Item "Available versions:"
6.0b.2 to 6.2.59b.1.
.PP
\fI\f(CI\*(C`reply\-to\*(C'\fI\fR
.IX Subsection "reply-to"
.PP
See \f(CW\*(C`reply_to\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.PP
\fI\f(CI\*(C`replyto\*(C'\fI\fR
.IX Subsection "replyto"
.PP
See \f(CW\*(C`reply_to\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.PP
\fI\f(CI\*(C`subscription\*(C'\fI\fR
.IX Subsection "subscription"
.PP
See \f(CW\*(C`subscribe\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.PP
\fI\f(CI\*(C`tracking_default_retention_period\*(C'\fI\fR
.IX Subsection "tracking_default_retention_period"
.PP
See \f(CW\*(C`tracking.retention_period\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.3 to 6.2.56.
.PP
\fI\f(CI\*(C`tracking_delivery_status_notification\*(C'\fI\fR
.IX Subsection "tracking_delivery_status_notification"
.PP
See \f(CW\*(C`tracking.delivery_status_notification\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 to 6.2.56.
.PP
\fI\f(CI\*(C`tracking_message_delivery_notification\*(C'\fI\fR
.IX Subsection "tracking_message_delivery_notification"
.PP
See \f(CW\*(C`tracking_message_disposition_notification\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.0 to 6.2a.40.
.PP
\fI\f(CI\*(C`tracking_message_disposition_notification\*(C'\fI\fR
.IX Subsection "tracking_message_disposition_notification"
.PP
See \f(CW\*(C`tracking.message_disposition_notification\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.41 to 6.2.56.
.PP
\fI\f(CI\*(C`unsubscription\*(C'\fI\fR
.IX Subsection "unsubscription"
.PP
See \f(CW\*(C`unsubscribe\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
Unknown.
.PP
\fI\f(CI\*(C`use_blacklist\*(C'\fI\fR
.IX Subsection "use_blacklist"
.PP
See \f(CW\*(C`use_blocklist\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.3a.4 to 6.2.60.
.SS "Deprecated parameters"
.IX Subsection "Deprecated parameters"
These parameters were deprecated. They may not be used anymore.
.PP
\fI\f(CI\*(C`account\*(C'\fI\fR
.IX Subsection "account"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`archived_pidfile\*(C'\fI\fR
.IX Subsection "archived_pidfile"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.1.17.
.PP
\fI\f(CI\*(C`automatic_list_prefix\*(C'\fI\fR
.IX Subsection "automatic_list_prefix"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`bounced_pidfile\*(C'\fI\fR
.IX Subsection "bounced_pidfile"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.1.17.
.PP
\fI\f(CI\*(C`clean_delay_queueother\*(C'\fI\fR
.IX Subsection "clean_delay_queueother"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.4a.9 to 5.4.7.
.PP
\fI\f(CI\*(C`cookie\*(C'\fI\fR
.IX Subsection "cookie"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.60.
.PP
\fI\f(CI\*(C`default_distribution_ttl\*(C'\fI\fR
.IX Subsection "default_distribution_ttl"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`distribution_mode\*(C'\fI\fR
.IX Subsection "distribution_mode"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.0a.1 to 6.2a.40.
.PP
\fI\f(CI\*(C`edit_list\*(C'\fI\fR
.IX Subsection "edit_list"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`editor\*(C'\fI\fR
.IX Subsection "editor"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.32.
.PP
\fI\f(CI\*(C`expire_task\*(C'\fI\fR
.IX Subsection "expire_task"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`filesystem_encoding\*(C'\fI\fR
.IX Subsection "filesystem_encoding"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.3a.7 to 6.2.52.
.PP
\fI\f(CI\*(C`forced_reply_to\*(C'\fI\fR
.IX Subsection "forced_reply_to"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`host\*(C'\fI\fR
.IX Subsection "host"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.PP
\fI\f(CI\*(C`html_editor_file\*(C'\fI\fR
.IX Subsection "html_editor_file"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.0a.0 to 6.2a.33.
.PP
\fI\f(CI\*(C`htmlarea_url\*(C'\fI\fR
.IX Subsection "htmlarea_url"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.35b.1.
.PP
\fI\f(CI\*(C`http_host\*(C'\fI\fR
.IX Subsection "http_host"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.54.
.PP
\fI\f(CI\*(C`include_list\*(C'\fI\fR
.IX Subsection "include_list"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
2.2.6 to 6.2.15.
.PP
\fI\f(CI\*(C`ldap_export_connection_timeout\*(C'\fI\fR
.IX Subsection "ldap_export_connection_timeout"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
3.3b.3 to 4.1?.
.PP
\fI\f(CI\*(C`ldap_export_dnmanager\*(C'\fI\fR
.IX Subsection "ldap_export_dnmanager"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
3.3b.3 to 4.1?.
.PP
\fI\f(CI\*(C`ldap_export_host\*(C'\fI\fR
.IX Subsection "ldap_export_host"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
3.3b.3 to 4.1?.
.PP
\fI\f(CI\*(C`ldap_export_name\*(C'\fI\fR
.IX Subsection "ldap_export_name"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
3.3b.3 to 4.1?.
.PP
\fI\f(CI\*(C`ldap_export_password\*(C'\fI\fR
.IX Subsection "ldap_export_password"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
3.3b.3 to 4.1?.
.PP
\fI\f(CI\*(C`ldap_export_suffix\*(C'\fI\fR
.IX Subsection "ldap_export_suffix"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
3.3b.3 to 4.1?.
.PP
\fI\f(CI\*(C`localedir\*(C'\fI\fR
.IX Subsection "localedir"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
4.2b.2 to 6.2a.32.
.PP
\fI\f(CI\*(C`lock_method\*(C'\fI\fR
.IX Subsection "lock_method"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.3b.3 to 6.2a.33.
.PP
\fI\f(CI\*(C`log_condition\*(C'\fI\fR
.IX Subsection "log_condition"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.29 to 6.2.41b.1.
.PP
\fI\f(CI\*(C`log_module\*(C'\fI\fR
.IX Subsection "log_module"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
6.2a.29 to 6.2.41b.1.
.PP
\fI\f(CI\*(C`msgcat\*(C'\fI\fR
.IX Subsection "msgcat"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 4.2b.1.
.PP
\fI\f(CI\*(C`openssl\*(C'\fI\fR
.IX Subsection "openssl"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2a.40.
.PP
\fI\f(CI\*(C`owner\*(C'\fI\fR
.IX Subsection "owner"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.32.
.PP
\fI\f(CI\*(C`pidfile\*(C'\fI\fR
.IX Subsection "pidfile"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.1.17.
.PP
\fI\f(CI\*(C`pidfile_bulk\*(C'\fI\fR
.IX Subsection "pidfile_bulk"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.1.17.
.PP
\fI\f(CI\*(C`pidfile_creation\*(C'\fI\fR
.IX Subsection "pidfile_creation"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.1.17.
.PP
\fI\f(CI\*(C`pidfile_distribute\*(C'\fI\fR
.IX Subsection "pidfile_distribute"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.1.17.
.PP
\fI\f(CI\*(C`queuedistribute\*(C'\fI\fR
.IX Subsection "queuedistribute"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
5.0a.1 to 6.2a.40.
.PP
\fI\f(CI\*(C`queueexpire\*(C'\fI\fR
.IX Subsection "queueexpire"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 5.1.2.
.PP
\fI\f(CI\*(C`reply_to\*(C'\fI\fR
.IX Subsection "reply_to"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`sort\*(C'\fI\fR
.IX Subsection "sort"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
1.4.0 and later.
.PP
\fI\f(CI\*(C`task_manager_pidfile\*(C'\fI\fR
.IX Subsection "task_manager_pidfile"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.1.17.
.PP
\fI\f(CI\*(C`tracking\*(C'\fI (domain and site)\fR
.IX Subsection "tracking (domain and site)"
.PP
See \f(CW\*(C`tracking.tracking\*(C'\fR.
.IP "Context:" 4
.IX Item "Context:"
domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.56.
.PP
\fI\f(CI\*(C`tri\*(C'\fI\fR
.IX Subsection "tri"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 1.3.4\-1.
.PP
\fI\f(CI\*(C`trusted_ca_options\*(C'\fI\fR
.IX Subsection "trusted_ca_options"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 3.3.5.
.PP
\fI\f(CI\*(C`use_fast_cgi\*(C'\fI\fR
.IX Subsection "use_fast_cgi"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2.22.
.PP
\fI\f(CI\*(C`user_data_source\*(C'\fI\fR
.IX Subsection "user_data_source"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR)
.PP
\fI\f(CI\*(C`web_archive\*(C'\fI\fR
.IX Subsection "web_archive"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
list (\fIconfig\fR), domain (\fIrobot.conf\fR), site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 6.2a.43.
.PP
\fI\f(CI\*(C`web_recode_to\*(C'\fI\fR
.IX Subsection "web_recode_to"
.PP
Deprecated.
.IP "Context:" 4
.IX Item "Context:"
site (\fIsympa.conf\fR)
.IP "Available versions:" 4
.IX Item "Available versions:"
up to 5.2.
.SH "FILES"
.IX Header "FILES"
.IP "\fI/etc/sympa/sympa/sympa.conf\fR" 4
.IX Item "/etc/sympa/sympa/sympa.conf"
Sympa main configuration file.
.IP "\fI\f(CI$SYSCONFDIR\fI/<mail domain name>/robot.conf\fR" 4
.IX Item "$SYSCONFDIR/<mail domain name>/robot.conf"
Configuration specific to each mail domain.
.IP "\fI\f(CI$EXPLDIR\fI/<list name>/config\fR or \fI\f(CI$EXPLDIR\fI/<mail domain name>/<list name>/config\fR" 4
.IX Item "$EXPLDIR/<list name>/config or $EXPLDIR/<mail domain name>/<list name>/config"
List main configuration file.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fISympa Administration Manual\fR.
<https://www.sympa.community/manual/>.
.PP
\&\fBauth.conf\fR\|(5),
\&\fBcharset.conf\fR\|(5),
\&\fBcrawlers_detection.conf\fR\|(5),
\&\fBedit_list.conf\fR\|(5),
\&\fBldap_alias_manager.conf\fR\|(5),
\&\fBnrcpt_by_domain.conf\fR\|(5),
\&\fBsympa_scenario\fR\|(5),
\&\fBtopics.conf\fR\|(5).