Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SYMPA_CONFIG(5) 		  sympa 6.2.76			 SYMPA_CONFIG(5)

NAME
     sympa_config - Configuration files for Sympa mailing list manager

DESCRIPTION
     There are three levels in Sympa's main configuration: site global, mail do-
     main and list.

   sympa.conf: Configuration file for global settings
     /usr/local/etc/sympa/sympa.conf is main configuration file of Sympa.  Sev-
     eral parameters defined in this file may be overridden by robot.conf con-
     figuration file for each virtual domain, or by config configuration file
     for each mailing list.

     Format of sympa.conf and robot.conf is as following:

     *	 Lines beginning with "#" and containing only spaces are ignored.

     *	 Each line has the form "parameter value".  value may contain spaces but
	 may not contain newlines.

	 There are simple parameters and compound parameters.

	 The name of compound parameter consist of a paragraph name and a
	 sub-parameter name separated by period (".").	However some compound
	 parameters have simple synonym names to keep compatibility to earlier
	 versions (See "Obsoleted sympa.conf parameters").

	 Example:

	   process_archive on
	   archive.web_access open
	   archive.mail_access closed

   robot.conf: Optional configuration file for the mail domain
     robot.conf is the optional configuration file for each mail domain.

     Format of robot.conf is the same as sympa.conf above.

   config: Configuration file for the mailing list
     config is main configuration file of each mailing list.

     Format of config is as following:

     *	 Lines beginning with "#" and containing only spaces are ignored.

     *	 There are simple parameters and compound parameters:

	 *   A simple parameter is expressed by single line by each.  The line
	     has the form "parameter value".  value may contain spaces but may
	     not contain newlines.

	     Several parameters may have multiple values.  If it's the case,
	     values may be separated by comma (",") or parameter lines may be
	     repeated.	Some of parameters must have one or more of limited val-
	     ues.

	     Example:

	       subject This is subject of my list

	       remove_headers User-Agent,Importance

	       custom_headers X-List: mylist
	       custom_headers X-Face: %`-W7!?^]Sg'I-K>P<cdn&k:~A^{x>(]Gc{V...

	       rfc2369_header_fields post,owner

	 *   A compound parameter is expressed by multiple lines, so-called
	     "paragraph", 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 parame-
	     ters.

	     Several multiple line parameters may occur multiple times.

	     Example:

	       archive
	       web_access open
	       mail_access closed

PARAMETERS
     Below is entire list of configuration parameters.

     *	 Sub-parameters in paragraph are listed as paragraph"."sub-parameter by
	 each.

     *	 "Default" is built-in default value if any.  About symbols for paths,
	 such as $SENDMAIL_ALIASES, see "Directory layout
	 <https://www.sympa.community/manual/layout.html>".

   Service description
     "domain"

     Primary mail domain name

     Format:
	 /$domain/

     Default:
	 None, mandatory.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Example:

       domain mail.example.org

     "listmaster"

     Email addresses of listmasters

     Format:
	 Multiple values allowed, separated by "","".

	 /$email/

     Default:
	 None, mandatory.

     Context:
	 domain (robot.conf), site (sympa.conf)

     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.

     Example:

       listmaster your_email_address@domain.tld

     "supported_lang"

     Supported languages

     Format:
	 /"\w+(\-\w+)*"/

     Default:
	 "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"

     Context:
	 domain (robot.conf), site (sympa.conf)

     All supported languages for the user interface. Languages proper locale in-
     formation not installed are ignored.

     "title"

     Title of service

     Format:
	 /".+"/

     Default:
	 "Mailing lists service"

     Context:
	 domain (robot.conf), site (sympa.conf)

     The name of your mailing list service. It will appear in the header of web
     interface and subjects of several service messages.

     "gecos"

     Display name of Sympa

     Format:
	 /".+"/

     Default:
	 "SYMPA"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.34 and later.

     This parameter is used for display name in the "From:" header field for the
     messages sent by Sympa itself.

     "legacy_character_support_feature"

     Support of legacy character set

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 site (sympa.conf)

     If set to "on", enables support of legacy character set according to
     charset.conf(5) configuration file.

     In some language environments, legacy encoding (character set) can be pre-
     ferred for e-mail messages: for example iso-2022-jp in Japanese language.

   Database related
     "update_db_field_types"

     Update database structure

     Format:
	 "auto" - automatic
	 "off" - disabled

     Default:
	 "auto"

     Context:
	 site (sympa.conf)

     auto: Updates database table structures automatically.

     However, since version 5.3b.5, Sympa will not shorten field size if it al-
     ready have been longer than the size defined in database definition.

     "db_type"

     Type of the database

     Format:
	 /"\w+"/

     Default:
	 "mysql"

     Context:
	 site (sympa.conf)

     Possible types are "MySQL", "PostgreSQL", "Oracle" and "SQLite".

     "db_name"

     Name of the database

     Format:
	 /".+"/

     Default:
	 "sympa"

     Context:
	 site (sympa.conf)

     With SQLite, this must be the full path to database file.

     With Oracle Database, this must be SID, net service name or easy connection
     identifier (to use net service name, db_host should be set to "none" and
     HOST, PORT and SERVICE_NAME should be defined in tnsnames.ora file).

     "db_host"

     Hostname of the database server

     Format:
	 /$host/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     With PostgreSQL, you can also use the path to Unix Socket Directory, e.g.
     "/var/run/postgresql" for connection with Unix domain socket.

     Example:

       db_host localhost

     "db_port"

     Port of the database server

     Format:
	 /"[-/\w]+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     "db_user"

     User for the database connection

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Example:

       db_user sympa

     "db_passwd"

     Password for the database connection

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 site (sympa.conf)

     What ever you use a password or not, you must protect the SQL server (is it
     not a public internet service ?)

     Example:

       db_passwd your_passwd

     "db_options"

     Database options

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     If these options are defined, they will be appended to data source name
     (DSN) fed to database driver. Check the related DBD documentation to learn
     about the available options.

     Example:

       db_options mysql_read_default_file=/home/joe/my.cnf;mysql_socket=tmp/mysql.sock-test

     "db_env"

     Environment variables setting for database

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     With Oracle Database, this is useful for defining ORACLE_HOME and NLS_LANG.

     Example:

       db_env NLS_LANG=American_America.AL32UTF8;ORACLE_HOME=/u01/app/oracle/product/11.2.0/server

     "db_timeout"

     Database processing timeout

     Format:
	 /"\d+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Currently, this parameter may be used for SQLite only.

     "db_additional_subscriber_fields"

     Database private extension to subscriber table

     Format:
	 Multiple values allowed, separated by "","".

	 /".+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Adds more fields to "subscriber_table" table. Sympa recognizes fields de-
     fined with this parameter. You will then be able to use them from within
     templates and scenarios:

     * for scenarios: [subscriber->field]

     * for templates: [% subscriber.field %]

     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.

     You need to extend the database format with these fields

     Example:

       db_additional_subscriber_fields billing_delay,subscription_expiration

     "db_additional_user_fields"

     Database private extension to user table

     Format:
	 Multiple values allowed, separated by "","".

	 /".+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Adds more fields to "user_table" table. Sympa recognizes fields defined
     with this parameter. You will then be able to use them from within tem-
     plates: [% subscriber.field %]

     This parameter is a comma-separated list.

     You need to extend the database format with these fields

     Example:

       db_additional_user_fields age,address

   System log
     "syslog"

     System log facility for Sympa

     Format:
	 /"\S+"/

     Default:
	 "LOCAL1"

     Context:
	 site (sympa.conf)

     Do not forget to configure syslog server.

     "syslog_socket"

     (Paragraph) System log socket options

     Single occurrence

     The options to be used for system log socket. Options come from Sys::Syslog
     https://metacpan.org/pod/Sys::Syslog#setlogsock%28%29

     "syslog_socket.type"

     Communication mode with syslog server

     Format:
	 Multiple values allowed, separated by "","".

	 "native" - native
	 "tcp" - tcp
	 "udp" - udp
	 "inet" - inet
	 "unix" - unix
	 "stream" - stream
	 "pipe" - pipe
	 "console" - console

     Default:
	 None.

     Context:
	 site (sympa.conf)

     In most cases, an appropriate default value should be automatically chosen.

     "syslog_socket.path"

     Stream location

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Defaults to the standard location on the system.

     "syslog_socket.timeout"

     Socket timeout

     Format:
	 Number of seconds.

     Default:
	 None.

     Context:
	 site (sympa.conf)

     "syslog_socket.host"

     Host name to send the messages to

     Format:
	 /$host/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Defaults to the local host.

     "syslog_socket.port"

     TCP or UDP port to connect to

     Format:
	 /"\d+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Defaults to the standard port on the system.

     "log_level"

     Log verbosity

     Format:
	 /"\d+"/

     Default:
	 0

     Context:
	 domain (robot.conf), site (sympa.conf)

     Sets the verbosity of logs.

     0: Only main operations are logged

     3: Almost everything is logged.

     Example:

       log_level 2

   Mail server
     "sendmail"

     Path to sendmail

     Format:
	 /".+"/

     Default:
	 "/usr/sbin/sendmail"

     Context:
	 site (sympa.conf)

     Absolute path to sendmail command line utility (e.g.: a binary named "send-
     mail" is distributed with Postfix).

     Sympa expects this binary to be sendmail compatible (exim, Postfix, qmail
     and so on provide it).

     "sendmail_args"

     Command line parameters passed to sendmail

     Format:
	 /".+"/

     Default:
	 "-oi -odi -oem"

     Context:
	 site (sympa.conf)

     Note that "-f", "-N" and "-V" options and recipient addresses should not be
     included, because they will be included by Sympa.

     "sendmail_aliases"

     Path of the file that contains all list related aliases

     Format:
	 /".+"/

     Default:
	 $SENDMAIL_ALIASES

     Context:
	 domain (robot.conf), site (sympa.conf)

     It is recommended to create a specific alias file so that Sympa never over-
     writes the standard alias file, but only a dedicated file.

     Set this parameter to "none" if you want to disable alias management in
     Sympa.

     "aliases_program"

     Program used to update alias database

     Format:
	 /"makemap|newaliases|postalias|postmap|/.+|none"/

     Default:
	 "newaliases"

     Context:
	 domain (robot.conf), site (sympa.conf)

     This may be "makemap", "newaliases", "postalias", "postmap" or full path to
     custom program.

     "aliases_wrapper"

     Whether to use the alias wrapper

     Format:
	 "off" - disabled
	 "on" - enabled

     Default:
	 "on"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.59b.1 and later.

     If the program to update alias database does not require root privileges,
     set this parameter to "off" and remove the wrapper file
     sympa_newaliases-wrapper.

     "aliases_db_type"

     Type of alias database

     Format:
	 /"\w[-\w]*"/

     Default:
	 "hash"

     Context:
	 domain (robot.conf), site (sympa.conf)

     "btree", "dbm", "hash" and so on.	Available when aliases_program is
     "makemap", "postalias" or "postmap"

     "alias_manager"

     Path to alias manager

     Format:
	 /".+"/

     Default:
	 "$SBINDIR/alias_manager.pl"

     Context:
	 site (sympa.conf)

     The absolute path to the script that will add/remove mail aliases

     Example:

       alias_manager /usr/local/libexec/ldap_alias_manager.pl

   List definition
     "subject"

     Subject of the list

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     This parameter indicates the subject of the list, which is sent in response
     to the LISTS mail command. The subject is a free form text limited to one
     line.

     "visibility"

     Visibility of the list

     Format:
	 Name of "visibility" scenario:

	 "conceal" - conceal except for subscribers
	 "identified" - conceal from anonymous users
	 "noconceal" - no conceal
	 "secret" - conceal even for subscribers

     Default:
	 "conceal"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     This parameter indicates whether the list should feature in the output gen-
     erated in response to a LISTS command or should be shown in the list
     overview of the web-interface.

     "topics"

     Topics for the list

     Format:
	 Multiple values allowed, separated by "","".

	 List topic.

     Default:
	 None.

     Context:
	 list (config)

     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.

     "lang"

     Language of the list

     Format:
	 Language tag.

     Default:
	 "en-US"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     This parameter defines the language used for the list. It is used to ini-
     tialize a user's language preference; Sympa command reports are extracted
     from the associated message catalog.

     "family_name"

     Family name

     Format:
	 /$family_name/

     Default:
	 None.

     Context:
	 list (config)

     "max_list_members"

     Maximum number of list members

     Format:
	 Number of list members.

     Default:
	 0 (list members)

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.5 and later.

     limit for the number of subscribers. 0 means no limit.

     "priority"

     Priority

     Format:
	 0 - 0 - highest priority
	 1 - 1
	 2 - 2
	 3 - 3
	 4 - 4
	 5 - 5
	 6 - 6
	 7 - 7
	 8 - 8
	 9 - 9 - lowest priority
	 "z" - queue messages only

     Default:
	 5

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     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.

   Receiving
     "sender_headers"

     Header field name(s) used to determine sender of the messages

     Format:
	 Any.

     Default:
	 "From"

     Context:
	 site (sympa.conf)

     "Return-Path" means envelope sender (a.k.a. "UNIX From") which will be al-
     ternative to sender of messages without "From" field.  "Resent-From" may
     also be inserted before "From", because some mailers add it into redirected
     messages and keep original "From" field intact.  In particular cases, "Re-
     turn-Path" can not give right sender: Several mail gateway products rewrite
     envelope sender and add original one as non-standard field such as "X-Enve-
     lope-From".  If that is the case, you might want to insert it in place of
     "Return-Path".

     Example:

       sender_headers Resent-From,From,Return-Path

     "misaddressed_commands"

     Reject misaddressed commands

     Format:
	 Any.

     Default:
	 "reject"

     Context:
	 site (sympa.conf)

     When a mail command is sent to a list, by default Sympa rejects this mes-
     sage. This feature can be turned off by setting this parameter to "ignore".

     "misaddressed_commands_regexp"

     Regular expression matching with misaddressed commands

     Format:
	 Any.

     Default:
	 "((subscribe\s+(\S+)|unsubscribe\s+(\S+)|sig-
	 noff\s+(\S+)|set\s+(\S+)\s+(mail|nomail|digest))\s*)"

     Context:
	 site (sympa.conf)

     Perl regular expression applied on messages subject and body to detect mis-
     addressed commands.

     "sympa_priority"

     Priority for command messages

     Format:
	 0 - 0 - highest priority
	 1 - 1
	 2 - 2
	 3 - 3
	 4 - 4
	 5 - 5
	 6 - 6
	 7 - 7
	 8 - 8
	 9 - 9 - lowest priority
	 "z" - queue messages only

     Default:
	 1

     Context:
	 domain (robot.conf), site (sympa.conf)

     Priority applied to messages sent to Sympa command address.

     "request_priority"

     Priority for messages bound for list owners

     Format:
	 0 - 0 - highest priority
	 1 - 1
	 2 - 2
	 3 - 3
	 4 - 4
	 5 - 5
	 6 - 6
	 7 - 7
	 8 - 8
	 9 - 9 - lowest priority
	 "z" - queue messages only

     Default:
	 0

     Context:
	 domain (robot.conf), site (sympa.conf)

     Priority for processing of messages bound for "LIST-request" address, i.e.
     owners of the list

     "owner_priority"

     Priority for non-VERP bounces

     Format:
	 0 - 0 - highest priority
	 1 - 1
	 2 - 2
	 3 - 3
	 4 - 4
	 5 - 5
	 6 - 6
	 7 - 7
	 8 - 8
	 9 - 9 - lowest priority
	 "z" - queue messages only

     Default:
	 9

     Context:
	 domain (robot.conf), site (sympa.conf)

     Priority for processing of messages bound for "LIST-owner" address, i.e.
     non-delivery reports (bounces).

     "incoming_max_count"

     Max number of sympa_msg.pl workers

     Format:
	 /"\d+"/

     Default:
	 1

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2b.5 and later.

     Max number of workers of sympa_msg.pl daemon processing incoming spool.

     "sleep"

     Interval between scanning incoming message spool

     Format:
	 Number of seconds.

     Default:
	 5 (seconds)

     Context:
	 site (sympa.conf)

     Must not be 0.

   Sending/receiving setup
     "send"

     Who can send messages

     Format:
	 Name of "send" scenario:

	 "closed" - closed
	 "confidential" - restricted to subscribers, messages from others are
	 discarded
	 "editorkey" - Moderated
	 "editorkeyonly" - Moderated, even for moderators
	 "editorkeyonlyauth" - Moderated, need authentication from moderator
	 "newsletter" - Newsletter, restricted to moderators
	 "newsletterkeyonly" - Newsletter, restricted to moderators after con-
	 firmation
	 "owner" - Restricted to list owners only
	 "ownerauth" - Restricted to list owners with previous MD5 authentica-
	 tion
	 "private" - restricted to subscribers
	 "private_smime" - restricted to subscribers and checked smime signature
	 "privateandeditorkey" - Moderated, restricted to subscribers
	 "privateandnomultipartoreditorkey" - Moderated, for non subscribers
	 sending multipart messages
	 "privatekey" - restricted to subscribers with previous md5 authentica-
	 tion
	 "privatekeyandeditorkeyonly" - Moderated, for subscribers and even mod-
	 erators themself
	 "privateoreditorkey" - Private, moderated for non subscribers
	 "privateorpublickey" - Private, confirmation for non subscribers
	 "public" - public list
	 "public_nobcc" - public list, Bcc rejected (anti-spam)
	 "publickey" - need authentication
	 "publicnoattachment" - public list multipart/mixed messages are for-
	 warded to moderator
	 "publicnomultipart" - public list multipart messages are rejected

     Default:
	 "private"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     This parameter specifies who can send messages to the list.

     "delivery_time"

     Delivery time (hh:mm)

     Format:
	 /"[0-2]?\d\:[0-6]\d"/

     Default:
	 None.

     Context:
	 list (config)

     If this parameter is present, non-digest messages will be delivered to sub-
     scribers at this time: When this time has been past, delivery is postponed
     to the same time in next day.

     "digest"

     (Paragraph) Digest frequency

     Single occurrence

     Definition of digest mode. If this parameter is present, subscribers can
     select the option of receiving messages in multipart/digest MIME 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.

     "digest.days"

     days

     Format:
	 Multiple occurrences allowed.

	 Day of week, 0 - 6.

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "digest.hour"

     hour

     Format:
	 /"[01]?[0-9]|2[0-3]"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "digest.minute"

     minute

     Format:
	 /"[0-5]?[0-9]"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "digest_max_size"

     Digest maximum number of messages

     Format:
	 Number of messages.

     Default:
	 25 (messages)

     Context:
	 list (config)

     "available_user_options"

     (Paragraph) Available subscription options

     Single occurrence

     "available_user_options.reception"

     reception mode

     Format:
	 Multiple values allowed, separated by "","".

	 Reception mode of list member.

     Default:
	 "mail,notice,digest,digestplain,summary,nomail,txt,urlize,not_me"

     Context:
	 list (config)

     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 speci-
     fied in the default_user_options paragraph.

     "default_user_options"

     (Paragraph) Subscription profile

     Single occurrence

     Default profile for the subscribers of the list.

     "default_user_options.reception"

     reception mode

     Format:
	 Reception mode of list member.

     Default:
	 "mail"

     Context:
	 list (config)

     Mail reception mode.

     "default_user_options.visibility"

     visibility

     Format:
	 Visibility mode of list member.

     Default:
	 "noconceal"

     Context:
	 list (config)

     Visibility of the subscriber.

     "msg_topic"

     (Paragraph) Topics for message categorization

     Multiple occurrences allowed

     This paragraph defines a topic used to tag a message of a list, named by
     msg_topic.name ("other" 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 ','.

     "msg_topic.name"

     Message topic name

     Format:
	 /"[\-\w]+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "msg_topic.keywords"

     Message topic keywords

     Format:
	 /"[^,\n]+(,[^,\n]+)*"/

     Default:
	 None.

     Context:
	 list (config)

     "msg_topic.title"

     Message topic title

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "msg_topic_keywords_apply_on"

     Defines to which part of messages topic keywords are applied

     Format:
	 "subject" - subject field
	 "body" - message body
	 "subject_and_body" - subject and body

     Default:
	 "subject"

     Context:
	 list (config)

     This parameter indicates which part of the message is used to perform auto-
     matic tagging.

     "msg_topic_tagging"

     Message tagging

     Format:
	 "required_sender" - required to post message
	 "required_moderator" - required to distribute message
	 "optional" - optional

     Default:
	 "optional"

     Context:
	 list (config)

     This parameter indicates if the tagging is optional or required for a list.

     "reply_to_header"

     (Paragraph) Reply address

     Single occurrence

     This defines what Sympa will place in the Reply-To: SMTP header field of
     the messages it distributes.

     "reply_to_header.value"

     value

     Format:
	 "sender" - sender
	 "list" - list
	 "all" - all
	 "other_email" - other email address

     Default:
	 "sender"

     Context:
	 list (config)

     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 pa-
     rameter).

     Note: it is inadvisable to change this parameter, and particularly inadvis-
     able 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.

     "reply_to_header.other_email"

     other email address

     Format:
	 /$email/

     Default:
	 None.

     Context:
	 list (config)

     If value was set to other_email, this parameter defines the e-mail address
     used.

     "reply_to_header.apply"

     respect of existing header field

     Format:
	 "forced" - overwrite Reply-To: header field
	 "respect" - preserve existing header field

     Default:
	 "respect"

     Context:
	 list (config)

     The default is to respect (preserve) the existing Reply-To: SMTP header
     field in incoming messages. If set to forced, Reply-To: SMTP header field
     will be overwritten.

     "anonymous_sender"

     Anonymous sender

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     To hide the sender's email address before distributing the message. It is
     replaced by the provided email address.

     "anonymous_header_fields"

     Header fields removed when a mailing list is setup in anonymous mode

     Format:
	 Any.

     Default:
	 "ARC-Authentication-Results,ARC-Message-Signature,ARC-Seal,Authentica-
	 tion-Results,Disposition-Notification-To,DKIM-Signature,Domainkey-Sig-
	 nature,Fax,Injection-Info,Mailer,Organisation,Organization,Original-Re-
	 cipient,Originating-Client,Originator,Path,Phone,Received,Re-
	 ceived-SPF,Reply-To,Resent-Reply-To,Return-Receipt-To,Tele-
	 fax,User-Agent,X-Envelope-From,X-Envelope-To,X-Face,X-Mailer,X-Mime-
	 OLE,X-Newsreader,X-Sender,X-X-Sender"

     Context:
	 site (sympa.conf)

     "custom_header"

     Custom header field

     Format:
	 Multiple occurrences allowed.

	 /"$header_field_name:.+"/

     Default:
	 None.

     Context:
	 list (config)

     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.

     "custom_subject"

     Subject tagging

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     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 au-
     tomatic tools to sort incoming messages). This string will be surrounded by
     [] characters.

     "footer_type"

     Attachment type

     Format:
	 "mime" - add a new MIME part
	 "append" - append to message body

     Default:
	 "mime"

     Context:
	 list (config)

     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.

     mime:

     The default value. Sympa will add the footer/header as a new MIME part.

     append:

     Sympa will not create new MIME parts, but will try to append the
     header/footer to the body of the message. Predefined message-footers will
     be ignored.

     "max_size"

     Maximum message size

     Format:
	 Number of bytes.

     Default:
	 5242880 (bytes)

     Context:
	 list (config), domain (robot.conf), host

     Maximum size of a message in 8-bit bytes.

     Example:

       max_size 2097152

     "personalization_feature"

     Allow message personalization

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.59b.2 and later.

     "personalization"

     (Paragraph) Message personalization

     Single occurrence

     "personalization.web_apply_on"

     Scope for messages from the web interface

     Format:
	 "none" - do nothing
	 "footer" - header and footer
	 "all" - all

     Default:
	 "footer"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "personalization.mail_apply_on"

     Scope for messages from incoming email

     Format:
	 "none" - do nothing
	 "footer" - header and footer
	 "all" - all

     Default:
	 "none"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "message_hook"

     (Paragraph) Hook modules for message processing

     Single occurrence

     "message_hook.pre_distribute"

     A hook on the messages before distribution

     Format:
	 /"(::|\w)+"/

     Default:
	 None.

     Context:
	 list (config)

     "message_hook.post_archive"

     A hook on the messages just after archiving

     Format:
	 /"(::|\w)+"/

     Default:
	 None.

     Context:
	 list (config)

     "reject_mail_from_automates_feature"

     Reject mail from automatic processes (crontab, etc)?

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "on"

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 6.2a.0 and later.

     Rejects messages that seem to be from automated services, based on a few
     header fields ("Content-Identifier:", "Auto-Submitted:").

     Sympa also can be configured to reject messages based on the "From:" header
     field value (see "loop_prevention_regex").

     "remove_headers"

     Header fields to be removed from incoming messages

     Format:
	 Multiple values allowed, separated by "","".

	 /"\S+"/

     Default:
	 "X-Sympa-To,X-Family-To,Return-Receipt-To,Precedence,X-Sequence,Dispo-
	 sition-Notification-To,Sender"

     Context:
	 list (config), site (sympa.conf)

     Use it, for example, to ensure some privacy for your users in case that
     "anonymous_sender" mode is inappropriate.

     The removal of these header fields is applied before Sympa adds its own
     header fields ("rfc2369_header_fields" and "custom_header").

     Example:

       remove_headers Resent-Date,Resent-From,Resent-To,Resent-Message-Id,Sender,Delivered-To

     "remove_outgoing_headers"

     Header fields to be removed before message distribution

     Format:
	 Multiple values allowed, separated by "","".

	 /"$header_field_name(:.+)?"/

     Default:
	 "none"

     Context:
	 list (config), site (sympa.conf)

     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 "X-Loop:"
     or "X-no-archive:") if you wish.

     Example:

       remove_outgoing_headers X-no-archive

     "rfc2369_header_fields"

     RFC 2369 header fields

     Format:
	 Multiple values allowed, separated by "","".

	 "help" - help
	 "subscribe" - subscription
	 "unsubscribe" - unsubscription
	 "post" - posting address
	 "owner" - owner
	 "archive" - list archive

     Default:
	 "help,subscribe,unsubscribe,post,owner,archive"

     Context:
	 list (config), site (sympa.conf)

     Specify which RFC 2369 mailing list header fields to be added.

     "List-Id:" header field defined in RFC 2919 is always added. Sympa also
     adds "Archived-At:" header field defined in RFC 5064.

   Distribution
     "urlize_min_size"

     Minimum size to be urlized

     Format:
	 Number of bytes.

     Default:
	 10240 (bytes)

     Context:
	 domain (robot.conf), site (sympa.conf)

     When a subscriber chose "urlize" reception mode, attachments not smaller
     than this size will be urlized.

     "allowed_external_origin"

     Allowed external links in sanitized HTML

     Format:
	 /"(?:[^\@]+\@)?[-\w*]+(?:[.][-\w*]+)*(?:[:][\d*]+)?"/

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.19b.2 and later.

     When the HTML content of a message must be sanitized, links ("href" or
     "src" attributes) with the hosts listed in this parameter will not be
     scrubbed. If "*" character is included, it matches any subdomains. Single
     "*" allows any hosts.

     Example:

       allowed_external_origin *.example.org,www.example.com

     "sympa_packet_priority"

     Default priority for a packet

     Format:
	 0 - 0 - highest priority
	 1 - 1
	 2 - 2
	 3 - 3
	 4 - 4
	 5 - 5
	 6 - 6
	 7 - 7
	 8 - 8
	 9 - 9 - lowest priority
	 "z" - queue messages only

     Default:
	 5

     Context:
	 domain (robot.conf), site (sympa.conf)

     The default priority set to a packet to be sent by the bulk.

     "bulk_fork_threshold"

     Fork threshold of bulk daemon

     Format:
	 /"\d+"/

     Default:
	 1

     Context:
	 site (sympa.conf)

     The minimum number of packets before bulk daemon forks a new worker to in-
     crease sending rate.

     "bulk_max_count"

     Maximum number of bulk workers

     Format:
	 /"\d+"/

     Default:
	 3

     Context:
	 site (sympa.conf)

     "bulk_lazytime"

     Idle timeout of bulk workers

     Format:
	 Number of seconds.

     Default:
	 600 (seconds)

     Context:
	 site (sympa.conf)

     The number of seconds a bulk worker will remain running without processing
     a message before it spontaneously exits.

     "bulk_sleep"

     Sleep time of bulk workers

     Format:
	 Number of seconds.

     Default:
	 1 (seconds)

     Context:
	 site (sympa.conf)

     The number of seconds a bulk worker sleeps between starting a new loop if
     it didn't find a message to send.

     Keep it small if you want your server to be reactive.

     "bulk_wait_to_fork"

     Interval between checks of packet numbers

     Format:
	 Number of seconds.

     Default:
	 10 (seconds)

     Context:
	 site (sympa.conf)

     Number of seconds a master bulk daemon waits between two packets number
     checks.

     Keep it small if you expect brutal increases in the message sending load.

     "log_smtp"

     Log invocation of sendmail

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 domain (robot.conf), site (sympa.conf)

     This can be overwritten by "-m" option for sympa.pl.

     "maxsmtp"

     Maximum number of sendmail processes

     Format:
	 /"\d+"/

     Default:
	 40

     Context:
	 site (sympa.conf)

     Maximum number of simultaneous child processes spawned by Sympa. This is
     the main load control parameter.

     Proposed value is quite low, but you can rise it up to 100, 200 or even 300
     with powerful systems.

     Example:

       maxsmtp 500

     "nrcpt"

     Maximum number of recipients per call to sendmail

     Format:
	 /"\d+"/

     Default:
	 25

     Context:
	 site (sympa.conf)

     This grouping factor makes it possible for the sendmail processes to opti-
     mize the number of SMTP sessions for message distribution. If needed, you
     can limit the number of recipients for a particular domain. Check the "nr-
     cpt_by_domain.conf" configuration file.

     "avg"

     Maximum number of different mail domains per call to sendmail

     Format:
	 /"\d+"/

     Default:
	 10

     Context:
	 site (sympa.conf)

   Privileges
     "create_list"

     Who is able to create lists

     Format:
	 Name of "create_list" scenario:

	 "closed" - closed
	 "listmaster" - restricted to listmaster
	 "public_listmaster" - anybody by validation by listmaster required

     Default:
	 "public_listmaster"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Defines who can create lists (or request list creation) by creating new
     lists or by renaming or copying existing lists.

     Example:

       create_list listmaster

     "allow_subscribe_if_pending"

     Allow adding subscribers to a list not open

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "on"

     Context:
	 domain (robot.conf), site (sympa.conf)

     If set to "off", adding subscribers to, or removing subscribers from a list
     with status other than "open" is forbidden.

     "global_remind"

     Who is able to send remind messages over all lists

     Format:
	 Name of "global_remind" scenario:

	 "listmaster" - only for listmaster

     Default:
	 "listmaster"

     Context:
	 site (sympa.conf)

     "move_user"

     Who is able to change user's email

     Format:
	 Name of "move_user" scenario:

	 "auth" - need authentication
	 "closed" - impossible
	 "listmaster" - listmaster only

     Default:
	 "auth"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.19b.1 and later.

     "use_blocklist"

     Use blocklist

     Format:
	 /"[-.\w]+"/

     Default:
	 "send,create_list"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.61b.1 and later.

     List of operations separated by comma for which blocklist filter is ap-
     plied.  Setting this parameter to "none" will hide the blocklist feature.

     "info"

     Who can view list information

     Format:
	 Name of "info" scenario:

	 "conceal" - restricted to subscribers - Silent rejection otherwise.
	 "open" - for anyone
	 "private" - restricted to subscribers

     Default:
	 "open"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "subscribe"

     Who can subscribe to the list

     Format:
	 Name of "subscribe" scenario:

	 "auth" - subscription request confirmed
	 "auth_notify" - need authentication (notification is sent to owners)
	 "auth_owner" - requires authentication then owner approval
	 "closed" - subscription is impossible
	 "open" - for anyone without authentication
	 "open_notify" - anyone, notification is sent to list owner
	 "open_quiet" - anyone, no welcome message
	 "owner" - owners approval
	 "smime" - requires S/MIME signed
	 "smimeorowner" - requires S/MIME signed or owner approval

     Default:
	 "open"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     The subscribe parameter defines the rules for subscribing to the list.

     "add"

     Who can add subscribers

     Format:
	 Name of "add" scenario:

	 "auth" - restricted to owner with authentication
	 "closed" - add impossible
	 "owner" - add performed by list owner does not need authentication
	 "owner_notify" - add performed by owner does not need authentication
	 (notification)

     Default:
	 "owner"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Privilege for adding (ADD command) a subscriber to the list

     "unsubscribe"

     Who can unsubscribe

     Format:
	 Name of "unsubscribe" scenario:

	 "auth" - need authentication
	 "auth_notify" - authentication requested, notification sent to owner
	 "closed" - impossible
	 "open" - open
	 "open_notify" - open with mail confirmation, owner is notified
	 "owner" - owners approval

     Default:
	 "open"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     This parameter specifies the unsubscription method for the list. Use
     open_notify or auth_notify to allow owner notification of each unsubscribe
     command.

     "del"

     Who can delete subscribers

     Format:
	 Name of "del" scenario:

	 "auth" - deletion performed only by list owners, need authentication
	 "closed" - remove subscriber impossible
	 "owner" - by owner without authentication
	 "owner_notify" - list owners, authentication not needed (notification)

     Default:
	 "owner"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "invite"

     Who can invite people

     Format:
	 Name of "invite" scenario:

	 "closed" - closed
	 "owner" - invite perform by list owner do not need authentication
	 "private" - restricted to subscribers
	 "public" - public

     Default:
	 "private"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "remind"

     Who can start a remind process

     Format:
	 Name of "remind" scenario:

	 "listmaster" - listmaster only
	 "owner" - restricted to list owners

     Default:
	 "owner"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     This parameter specifies who is authorized to use the remind command.

     "review"

     Who can review subscribers

     Format:
	 Name of "review" scenario:

	 "closed" - no one can review
	 "listmaster" - listmaster only
	 "owner" - only owner (and listmaster)
	 "private" - restricted to subscribers
	 "public" - anyone can do it!

     Default:
	 "owner"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     This parameter specifies who can access the list of members. Since sub-
     scriber addresses can be abused by spammers, it is strongly recommended
     that you only authorize owners or subscribers to access the subscriber
     list.

     "owner_domain"

     Required domains for list owners

     Format:
	 /"$host( +$host)*"/

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.23b.3 and later.

     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 sub-
     scribers from the Internet at large.

     "owner_domain_min"

     Minimum owners in required domains

     Format:
	 /"\d+"/

     Default:
	 0

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.23b.3 and later.

     Minimum number of owners for each list must satisfy the owner_domain re-
     striction. The default of zero (0) means *all* list owners must match. Set-
     ting 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.

     "default_owner_options"

     (Paragraph) Owner profile

     Single occurrence

     Default profile for the owners of the list.

     "default_owner_options.profile"

     profile

     Format:
	 "privileged" - privileged owner
	 "normal" - normal owner

     Default:
	 "normal"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "default_owner_options.reception"

     reception mode

     Format:
	 "mail" - receive notification email
	 "nomail" - no notifications

     Default:
	 "mail"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Mail reception mode.

     "default_owner_options.visibility"

     visibility

     Format:
	 "conceal" - concealed from list menu
	 "noconceal" - listed on the list menu

     Default:
	 "noconceal"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Visibility of the owner.

     "default_editor_options"

     (Paragraph) Moderator profile

     Single occurrence

     Default profile for the moderators of the list.

     "default_editor_options.reception"

     reception mode

     Format:
	 "mail" - receive notification email
	 "nomail" - no notifications

     Default:
	 "mail"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Mail reception mode.

     "default_editor_options.visibility"

     visibility

     Format:
	 "conceal" - concealed from list menu
	 "noconceal" - listed on the list menu

     Default:
	 "noconceal"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Visibility of the moderator.

   Archives
     "ignore_x_no_archive_header_feature"

     Ignore "X-no-archive:" header field

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 site (sympa.conf)

     Sympa's default behavior is to skip archiving of incoming messages that
     have an "X-no-archive:" header field set. This parameter allows one to
     change this behavior.

     Example:

       ignore_x_no_archive_header_feature on

     "custom_archiver"

     Custom archiver

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Activates a custom archiver to use instead of MHonArc. The value of this
     parameter is the absolute path to the executable file.

     Sympa invokes this file with these two arguments:

     --list

     The address of the list including domain part.

     --file

     Absolute path to the message to be archived.

     "process_archive"

     Store distributed messages into archive

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2b.1 and later.

     If enabled, distributed messages via lists will be archived. Otherwise
     archiving is disabled.

     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.

     "archive"

     (Paragraph) Archives

     Single occurrence

     Privilege for reading mail archives and frequency of archiving.

     Defines who can access the list's web archive.

     "archive.period"

     Deprecated.

     Context:
	 list (config)

     "archive.access"

     Deprecated.

     Context:
	 list (config)

     Available versions:
	 up to 6.2a.43.

     "archive.web_access"

     access right

     Format:
	 Name of "archive_web_access" scenario:

	 "closed" - closed
	 "listmaster" - listmaster
	 "owner" - by owner
	 "private" - subscribers only
	 "public" - public

     Default:
	 "closed"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2b.1 and later.

     "archive.mail_access"

     access right by mail commands

     Format:
	 Name of "archive_mail_access" scenario:

	 "closed" - closed
	 "owner" - by owner
	 "private" - subscribers only
	 "public" - public

     Default:
	 "closed"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2b.1 and later.

     "archive.quota"

     quota

     Format:
	 Number of Kbytes.

     Default:
	 None.

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 6.2b.1 and later.

     "archive.max_month"

     Maximum number of month archived

     Format:
	 Number of months.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2b.1 and later.

     "archive_crypted_msg"

     Archive encrypted mails as cleartext

     Format:
	 "original" - original messages
	 "decrypted" - decrypted messages

     Default:
	 "original"

     Context:
	 list (config)

     "web_archive_spam_protection"

     Protect web archive against spam harvesters

     Format:
	 "cookie" - use HTTP cookie
	 "javascript" - use JavaScript
	 "at" - replace @ characters
	 "concealed" - never show address
	 "none" - do nothing

     Default:
	 "cookie"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     The same as "spam_protection", but restricted to the web archive.

     In addition to it:

     cookie: users must submit a small form in order to receive a cookie before
     browsing the web archive.

     concealed: e-mail addresses will never be displayed.

   Bounces
     "bounce"

     (Paragraph) Bounces management

     Single occurrence

     "bounce.warn_rate"

     warn rate

     Format:
	 Number of %.

     Default:
	 30 (%)

     Context:
	 list (config), site (sympa.conf)

     The list owner receives a warning whenever a message is distributed and the
     number (percentage) of bounces exceeds this value.

     "bounce.halt_rate"

     Deprecated.

     Context:
	 list (config), site (sympa.conf)

     "bouncers_level1"

     (Paragraph) Management of bouncers, 1st level

     Single occurrence

     Level 1 is the lower level of bouncing users

     "bouncers_level1.rate"

     threshold

     Format:
	 Number of points.

     Default:
	 45 (points)

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Each bouncing user have a score (from 0 to 100).

     This parameter defines a lower limit for each category of bouncing
     users.For example, level 1 begins from 45 to level_2_treshold.

     "bouncers_level1.action"

     action for this population

     Format:
	 "remove_bouncers" - remove bouncing users
	 "notify_bouncers" - send notify to bouncing users
	 "none" - do nothing

     Default:
	 "notify_bouncers"

     Context:
	 list (config)

     This parameter defines which task is automatically applied on level 1
     bouncers.

     "bouncers_level1.notification"

     notification

     Format:
	 "none" - do nothing
	 "owner" - owner
	 "listmaster" - listmaster

     Default:
	 "owner"

     Context:
	 list (config)

     When automatic task is executed on level 1 bouncers, a notification email
     can be send to listowner or listmaster.

     "bouncers_level2"

     (Paragraph) Management of bouncers, 2nd level

     Single occurrence

     Level 2 is the highest level of bouncing users

     "bouncers_level2.rate"

     threshold

     Format:
	 Number of points.

     Default:
	 75 (points)

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Each bouncing user have a score (from 0 to 100).

     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.

     "bouncers_level2.action"

     action for this population

     Format:
	 "remove_bouncers" - remove bouncing users
	 "notify_bouncers" - send notify to bouncing users
	 "none" - do nothing

     Default:
	 "remove_bouncers"

     Context:
	 list (config)

     This parameter defines which task is automatically applied on level 2
     bouncers.

     "bouncers_level2.notification"

     notification

     Format:
	 "none" - do nothing
	 "owner" - owner
	 "listmaster" - listmaster

     Default:
	 "owner"

     Context:
	 list (config)

     When automatic task is executed on level 2 bouncers, a notification email
     can be send to listowner or listmaster.

     "verp_rate"

     percentage of list members in VERP mode

     Format:
	 "100%" - 100% - always
	 "50%" - 50%
	 "33%" - 33%
	 "25%" - 25%
	 "20%" - 20%
	 "10%" - 10%
	 "5%" - 5%
	 "2%" - 2%
	 "0%" - 0% - never

     Default:
	 "0%"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Uses variable envelope return path (VERP) to detect bouncing subscriber ad-
     dresses.

     0%: VERP is never used.

     100%: VERP is always in use.

     VERP requires address with extension to be supported by MTA. If tracking is
     enabled for a list or a message, VERP is applied for 100% of subscribers.

     "tracking"

     (Paragraph) Message tracking feature

     Single occurrence

     "tracking.delivery_status_notification"

     tracking message by delivery status notification

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 list (config), site (sympa.conf)

     "tracking.message_disposition_notification"

     tracking message by message disposition notification

     Format:
	 "on" - enabled
	 "on_demand" - on demand
	 "off" - disabled

     Default:
	 "off"

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 6.2a.41 and later.

     "tracking.tracking"

     who can view message tracking

     Format:
	 Name of "tracking" scenario:

	 "owner" - only owner (and listmaster)
	 "private" - restricted to subscribers

     Default:
	 "owner"

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 6.2a.3 and later.

     "tracking.retention_period"

     Tracking datas are removed after this number of days

     Format:
	 Number of days.

     Default:
	 90 (days)

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 6.2a.3 and later.

     "tracking.message_delivery_notification"

     See "tracking.message_disposition_notification".

     Context:
	 list (config)

     Available versions:
	 6.2a.0 to 6.2a.40.

     "verp_welcome"

     Remove bouncing new subscribers

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 6.2.71b.1 and later.

     If enabled, the welcome message is sent using VERP in order to remove the
     subscriber immediately in the case of a bounce.

     "verp_remind"

     Remove subscribers bouncing remind message

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 6.2.71b.1 and later.

     If enabled, the remind message is sent using VERP in order to remove the
     subscriber immediately in the case of a bounce.

     "expire_bounce_task"

     Task for expiration of old bounces

     Format:
	 /"\w+"/

     Default:
	 "daily"

     Context:
	 site (sympa.conf)

     This task resets bouncing information for addresses not bouncing in the
     last 10 days after the latest message distribution.

     "purge_orphan_bounces_task"

     Task for cleaning invalidated bounces

     Format:
	 /"\w+"/

     Default:
	 "monthly"

     Context:
	 site (sympa.conf)

     This task deletes bounce information for unsubscribed users.

     "eval_bouncers_task"

     Task for updating bounce scores

     Format:
	 /"\w+"/

     Default:
	 "daily"

     Context:
	 site (sympa.conf)

     This task scans all bouncing users for all lists, and updates
     "bounce_score_subscriber" field in "subscriber_table" table. The scores may
     be used for management of bouncers.

     "process_bouncers_task"

     Task for management of bouncers

     Format:
	 /"\w+"/

     Default:
	 "weekly"

     Context:
	 site (sympa.conf)

     This task executes actions on bouncing users configured by each list, ac-
     cording to their scores.

     "purge_tables_task"

     Task for cleaning tables

     Format:
	 /"\w+"/

     Default:
	 "daily"

     Context:
	 site (sympa.conf)

     This task cleans old tracking information from "notification_table" table.

     "minimum_bouncing_count"

     Minimum number of bounces

     Format:
	 /"\d+"/

     Default:
	 10

     Context:
	 site (sympa.conf)

     The minimum number of bounces received to update bounce score of a user.

     "minimum_bouncing_period"

     Minimum bouncing period

     Format:
	 Number of days.

     Default:
	 10 (days)

     Context:
	 site (sympa.conf)

     The minimum period for which bouncing lasted to update bounce score of a
     user.

     "bounce_delay"

     Delay of bounces

     Format:
	 Number of days.

     Default:
	 0 (days)

     Context:
	 site (sympa.conf)

     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 origi-
     nal message.

     "bounce_email_prefix"

     Prefix of VERP return address

     Format:
	 /"\S+"/

     Default:
	 "bounce"

     Context:
	 site (sympa.conf)

     The prefix to consist the return-path of probe messages used for bounce
     management, when variable envelope return path (VERP) is enabled. VERP re-
     quires address with extension to be supported by MTA.

     If you change the default value, you must modify the mail aliases too.

     "return_path_suffix"

     Suffix of list return address

     Format:
	 /"\S+"/

     Default:
	 "-owner"

     Context:
	 site (sympa.conf)

     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).

   Loop prevention
     "loop_command_max"

     Maximum number of responses to command message

     Format:
	 /"\d+"/

     Default:
	 200

     Context:
	 site (sympa.conf)

     The maximum number of command reports sent to an email address. Messages
     are stored in "bad" subdirectory of incoming message spool, and reports are
     not longer sent.

     "loop_command_sampling_delay"

     Delay before counting responses to command message

     Format:
	 Number of seconds.

     Default:
	 3600 (seconds)

     Context:
	 site (sympa.conf)

     This parameter defines the delay in seconds before decrementing the counter
     of reports sent to an email address.

     "loop_command_decrease_factor"

     Decrementing factor of responses to command message

     Format:
	 /"[.\d]+"/

     Default:
	 0.5

     Context:
	 site (sympa.conf)

     The decrementation factor (from 0 to 1), used to determine the new report
     counter after expiration of the delay.

     "msgid_table_cleanup_ttl"

     Expiration period of message ID table

     Format:
	 Number of seconds.

     Default:
	 86400 (seconds)

     Context:
	 site (sympa.conf)

     Expiration period of entries in the table maintained by sympa_msg.pl daemon
     to prevent delivery of duplicate messages caused by loop.

     "msgid_table_cleanup_frequency"

     Cleanup interval of message ID table

     Format:
	 Number of seconds.

     Default:
	 3600 (seconds)

     Context:
	 site (sympa.conf)

     Interval between cleanups of the table maintained by sympa_msg.pl daemon to
     prevent delivery of duplicate messages caused by loop.

   Automatic lists
     "automatic_list_feature"

     Automatic list

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 domain (robot.conf), site (sympa.conf)

     "automatic_list_removal"

     Remove empty automatic list

     Format:
	 "none" - do nothing
	 "if_empty" - if_empty

     Default:
	 "none"

     Context:
	 domain (robot.conf), site (sympa.conf)

     If set to "if_empty", then Sympa will remove automatically created mailing
     lists just after their creation, if they contain no list member.

     Example:

       automatic_list_removal if_empty

     "automatic_list_creation"

     Who is able to create automatic list

     Format:
	 Name of "automatic_list_creation" scenario:

	 "family_owner" - Restricted to people subscribed to the list of family
	 owners.
	 "listmaster" - restricted to listmaster
	 "public" - anybody. Be sure you know what you are doing

     Default:
	 "public"

     Context:
	 domain (robot.conf), site (sympa.conf)

     "automatic_list_families"

     Definition of automatic list families

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Defines the families the automatic lists are based on. It is a character
     string structured as follows:

     * each family is separated from the other by a semicolon (;)

     * inside a family definition, each field is separated from the other by a
     colon (:)

     * each field has the structure: "<field name>=<field value>"

     Basically, each time Sympa uses the automatic lists families, the values
     defined in this parameter will be available in the family object.

     * for scenarios: [family->name]

     * for templates: [% family.name %]

     Example:

       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;

     "parsed_family_files"

     Parsed files for families

     Format:
	 /"[-.\w]+"/

     Default:
	 "message_header,message_header.mime,message_footer,mes-
	 sage_footer.mime,info"

     Context:
	 domain (robot.conf), site (sympa.conf)

     comma-separated list of files that will be parsed by Sympa when instantiat-
     ing a family (no space allowed in file names)

     "family_signoff"

     Global unsubscription

     Format:
	 Name of "family_signoff" scenario:

	 "auth" - need authentication
	 "closed" - impossible

     Default:
	 "auth"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.54 and later.

   Tag based spam filtering
     "spam_status"

     Type of spam filter

     Format:
	 Name of "spam_status" scenario:

	 "bogofilter" - bogofilter
	 "j-chkmail" - j-chkmail
	 "none" - do nothing
	 "rspamd" - Rspamd
	 "spamassassin" - SpamAssassin
	 "x-spam-status" - test X-Spam-Status header

     Default:
	 "x-spam-status"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.1a.2 and later.

     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 or-
     der to decide the message's spam status: ham, spam or unsure.

   Directories
     "home"

     List home

     Format:
	 /".+"/

     Default:
	 $EXPLDIR

     Context:
	 site (sympa.conf)

     Base directory of list configurations.

     "etc"

     Directory for configuration files

     Format:
	 /".+"/

     Default:
	 $SYSCONFDIR

     Context:
	 site (sympa.conf)

     Base directory of global configuration (except "sympa.conf").

     "spool"

     Base directory of spools

     Format:
	 /".+"/

     Default:
	 $SPOOLDIR

     Context:
	 site (sympa.conf)

     Base directory of all spools which are created at runtime. This directory
     must be writable by Sympa user.

     "queue"

     Directory for message incoming spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/msg"

     Context:
	 site (sympa.conf)

     This spool is used both by "queue" program and "sympa_msg.pl" daemon.

     "queuemod"

     Directory for moderation spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/moderation"

     Context:
	 site (sympa.conf)

     "queuedigest"

     Directory for digest spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/digest"

     Context:
	 site (sympa.conf)

     "queueauth"

     Directory for held message spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/auth"

     Context:
	 site (sympa.conf)

     This parameter is named such by historical reason.

     "queueoutgoing"

     Directory for archive spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/outgoing"

     Context:
	 site (sympa.conf)

     This parameter is named such by historical reason.

     "queuesubscribe"

     Directory for held request spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/subscribe"

     Context:
	 site (sympa.conf)

     This parameter is named such by historical reason.

     "queuetopic"

     Directory for topic spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/topic"

     Context:
	 site (sympa.conf)

     "queuebounce"

     Directory for bounce incoming spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/bounce"

     Context:
	 site (sympa.conf)

     This spool is used both by "bouncequeue" program and "bounced.pl" daemon.

     "queuetask"

     Directory for task spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/task"

     Context:
	 site (sympa.conf)

     "queueautomatic"

     Directory for automatic list creation spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/automatic"

     Context:
	 site (sympa.conf)

     This spool is used both by "familyqueue" program and "sympa_automatic.pl"
     daemon.

     "queuebulk"

     Directory for message outgoing spool

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/bulk"

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2a.41 and later.

     This parameter is named such by historical reason.

     "tmpdir"

     Temporary directory used by external programs such as virus scanner. Also,
     outputs to daemons' standard error are redirected to the files under this
     directory.

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/tmp"

     Context:
	 site (sympa.conf)

     "viewmail_dir"

     Directory to cache formatted messages

     Format:
	 /".+"/

     Default:
	 "$SPOOLDIR/viewmail"

     Context:
	 site (sympa.conf)

     Base directory path of directories where HTML view of messages are cached.

     "bounce_path"

     Directory for storing bounces

     Format:
	 /".+"/

     Default:
	 $BOUNCEDIR

     Context:
	 site (sympa.conf)

     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 ID>.

     Users can access to these messages using web interface in the bounce man-
     agement page.

     Don't confuse with "queuebounce" parameter which defines the spool where
     incoming error reports are stored and picked by bounced.pl daemon.

     "arc_path"

     Directory for storing archives

     Format:
	 /".+"/

     Default:
	 $ARCDIR

     Context:
	 domain (robot.conf), site (sympa.conf)

     Where to store HTML archives. This parameter is used by the "archived.pl"
     daemon. It is a good idea to install the archive outside the web document
     hierarchy to prevent overcoming of WWSympa's access control.

     "purge_spools_task"

     Task for cleaning spools

     Format:
	 /"\w+"/

     Default:
	 "daily"

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2b.4 and later.

     This task cleans old content in spools.

     "clean_delay_queue"

     Max age of incoming bad messages

     Format:
	 Number of days.

     Default:
	 7 (days)

     Context:
	 site (sympa.conf)

     Number of days "bad" messages are kept in message incoming spool (as speci-
     fied by "queue" parameter). Sympa keeps messages rejected for various rea-
     sons (badly formatted, looping etc.).

     "clean_delay_queueoutgoing"

     Max age of bad messages for archives

     Format:
	 Number of days.

     Default:
	 7 (days)

     Context:
	 site (sympa.conf)

     Number of days "bad" messages are kept in message archive spool (as speci-
     fied by "queueoutgoing" parameter). Sympa keeps messages rejected for vari-
     ous reasons (unable to create archive directory, to copy file etc.).

     "clean_delay_queuebounce"

     Max age of bad bounce messages

     Format:
	 Number of days.

     Default:
	 7 (days)

     Context:
	 site (sympa.conf)

     Number of days "bad" messages are kept in bounce spool (as specified by
     "queuebounce" parameter). Sympa keeps messages rejected for various reasons
     (unknown original sender, unknown report type).

     "clean_delay_queueauth"

     Max age of held messages

     Format:
	 Number of days.

     Default:
	 30 (days)

     Context:
	 site (sympa.conf)

     Number of days messages are kept in held message spool (as specified by
     "queueauth" parameter). Beyond this deadline, messages that have not been
     confirmed are deleted.

     "clean_delay_queuesubscribe"

     Max age of held requests

     Format:
	 Number of days.

     Default:
	 30 (days)

     Context:
	 site (sympa.conf)

     Number of days requests are kept in held request spool (as specified by
     "queuesubscribe" parameter). Beyond this deadline, requests that have not
     been validated nor declined are deleted.

     "clean_delay_queuetopic"

     Max age of tagged topics

     Format:
	 Number of days.

     Default:
	 30 (days)

     Context:
	 site (sympa.conf)

     Number of days (automatically or manually) tagged topics are kept in topic
     spool (as specified by "queuetopic" parameter). Beyond this deadline, tag-
     ging is forgotten.

     "clean_delay_queueautomatic"

     Max age of incoming bad messages in automatic list creation spool

     Format:
	 Number of days.

     Default:
	 10 (days)

     Context:
	 site (sympa.conf)

     Number of days "bad" messages are kept in automatic list creation spool (as
     specified by "queueautomatic" parameter). Sympa keeps messages rejected for
     various reasons (badly formatted, looping etc.).

     "clean_delay_queuebulk"

     Max age of outgoing bad messages

     Format:
	 Number of days.

     Default:
	 7 (days)

     Context:
	 site (sympa.conf)

     Number of days "bad" messages are kept in message outgoing spool (as speci-
     fied by "queuebulk" parameter). Sympa keeps messages rejected for various
     reasons (failed personalization, bad configuration on MTA etc.).

     "clean_delay_queuedigest"

     Max age of bad messages in digest spool

     Format:
	 Number of days.

     Default:
	 14 (days)

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.6 and later.

     Number of days "bad" messages are kept in digest spool (as specified by
     "queuedigest" parameter). Sympa keeps messages rejected for various reasons
     (syntax errors in "digest.tt2" template etc.).

     "clean_delay_tmpdir"

     Max age of temporary files

     Format:
	 Number of days.

     Default:
	 7 (days)

     Context:
	 site (sympa.conf)

     Number of days files in temporary directory (as specified by "tmpdir" para-
     meter), including standard error logs, are kept.

   S/MIME and TLS
     S/MIME authentication, decryption and re-encryption. It requires these ex-
     ternal modules: Crypt-OpenSSL-X509 and Crypt-SMIME.

     TLS client authentication. It requires an external module: IO-Socket-SSL.

     "cafile"

     File containing trusted CA certificates

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Available versions:
	 3.3.6b.1 and later.

     This can be used alternatively and/or additionally to "capath".

     "capath"

     Directory containing trusted CA certificates

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Available versions:
	 3.3.6b.1 and later.

     CA certificates in this directory are used for client authentication.

     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 "c_rehash"
     script bundled in OpenSSL.

     "key_passwd"

     Password used to crypt lists private keys

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 site (sympa.conf)

     If not defined, Sympa assumes that list private keys are not encrypted.

     Example:

       key_passwd your_password

     "ssl_cert_dir"

     Directory containing user certificates

     Format:
	 /".+"/

     Default:
	 "$EXPLDIR/X509-user-certs"

     Context:
	 site (sympa.conf)

   Data sources setup
     Including subscribers, owners and moderators from data sources. Appropriate
     database driver (DBD) modules are required: DBD-CSV, DBD-mysql, DBD-ODBC,
     DBD-Oracle, DBD-Pg, DBD-SQLite and/or Net-LDAP. And also, if secure connec-
     tion (LDAPS) to LDAP server is required: IO-Socket-SSL.

     "inclusion_notification_feature"

     Notify subscribers when they are included from a data source?

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 list (config), site (sympa.conf)

     "member_include"

     (Paragraph) Subscribers defined in an external data source

     Multiple occurrences allowed

     "member_include.source"

     the data source

     Format:
	 /"[\w-]+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "member_include.source_parameters"

     data source parameters

     Format:
	 /".*"/

     Default:
	 None.

     Context:
	 list (config)

     "member_include.reception"

     reception mode

     Format:
	 Reception mode of list member.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.67b.2 and later.

     Mail reception mode.

     "member_include.visibility"

     visibility

     Format:
	 Visibility mode of list member.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.67b.2 and later.

     Visibility of the subscriber.

     "owner_include"

     (Paragraph) Owners defined in an external data source

     Multiple occurrences allowed

     "owner_include.source"

     the data source

     Format:
	 /"[\w-]+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "owner_include.source_parameters"

     data source parameters

     Format:
	 /".*"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 5.0a and later.

     "owner_include.profile"

     profile

     Format:
	 "privileged" - privileged owner
	 "normal" - normal owner

     Default:
	 None.

     Context:
	 list (config)

     "owner_include.reception"

     reception mode

     Format:
	 "mail" - receive notification email
	 "nomail" - no notifications

     Default:
	 None.

     Context:
	 list (config)

     "owner_include.visibility"

     visibility

     Format:
	 "conceal" - concealed from list menu
	 "noconceal" - listed on the list menu

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 5.4a.6 and later.

     "editor_include"

     (Paragraph) Moderators defined in an external data source

     Multiple occurrences allowed

     "editor_include.source"

     the data source

     Format:
	 /"[\w-]+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "editor_include.source_parameters"

     data source parameters

     Format:
	 /".*"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 5.0a and later.

     "editor_include.reception"

     reception mode

     Format:
	 "mail" - receive notification email
	 "nomail" - no notifications

     Default:
	 None.

     Context:
	 list (config)

     "editor_include.visibility"

     visibility

     Format:
	 "conceal" - concealed from list menu
	 "noconceal" - listed on the list menu

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 5.4a.6 and later.

     "sql_fetch_timeout"

     Timeout for fetch of include_sql_query

     Format:
	 Number of seconds.

     Default:
	 300 (seconds)

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 6.2a.0 and later.

     "include_file"

     File inclusion

     Format:
	 Multiple occurrences allowed.

	 /"\S+"/

     Default:
	 None.

     Context:
	 list (config)

     Include subscribers from this file.  The file should contain one e-mail ad-
     dress per line (lines beginning with a "#" are ignored).

     "include_remote_file"

     (Paragraph) Remote file inclusion

     Multiple occurrences allowed

     "include_remote_file.name"

     short name for this source

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_remote_file.url"

     data location URL

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_remote_file.user"

     remote user

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_remote_file.passwd"

     remote password

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 list (config)

     "include_remote_file.timeout"

     idle timeout

     Format:
	 Number of seconds.

     Default:
	 180 (seconds)

     Context:
	 list (config)

     "include_remote_file.ssl_version"

     SSL version

     Format:
	 "ssl_any" - any versions
	 "sslv2" - SSL version 2
	 "sslv3" - SSL version 3
	 "tlsv1" - TLS version 1
	 "tlsv1_1" - TLS version 1.1
	 "tlsv1_2" - TLS version 1.2
	 "tlsv1_3" - TLS version 1.3

     Default:
	 "ssl_any"

     Context:
	 list (config)

     "include_remote_file.ssl_ciphers"

     SSL ciphers used

     Format:
	 /".+"/

     Default:
	 "ALL"

     Context:
	 list (config)

     "include_remote_file.ca_verify"

     Certificate verification

     Format:
	 "none" - do nothing
	 "optional" - optional
	 "required" - required

     Default:
	 "none"

     Context:
	 list (config)

     "include_remote_file.nosync_time_ranges"

     Time ranges when inclusion is not allowed

     Format:
	 /$time_ranges/

     Default:
	 None.

     Context:
	 list (config)

     "include_sympa_list"

     (Paragraph) List inclusion

     Multiple occurrences allowed

     Include subscribers from other list. All subscribers of list listname be-
     come subscribers of the current list. You may include as many lists as re-
     quired, 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 in-
     clude list A in list B and then list B in list A, since this will give rise
     to an infinite loop.

     "include_sympa_list.name"

     short name for this source

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_sympa_list.listname"

     list name to include

     Format:
	 /"$listname(\@$host)?"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_sympa_list.filter"

     filter definition

     Format:
	 /".*"/

     Default:
	 None.

     Context:
	 list (config)

     "include_sympa_list.nosync_time_ranges"

     Time ranges when inclusion is not allowed

     Format:
	 /$time_ranges/

     Default:
	 None.

     Context:
	 list (config)

     "include_remote_sympa_list"

     (Paragraph) remote list inclusion

     Multiple occurrences allowed

     Sympa can contact another Sympa service using HTTPS to fetch a remote list
     in order to include each member of a remote list as subscriber. You may in-
     clude as many lists as required, using one include_remote_sympa_list para-
     graph for each included list. Be careful, however, not to give rise to an
     infinite loop resulting from cross includes.

     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 permis-
     sion to the remote Sympa to review the list. This is controlled by the re-
     view scenario.

     "include_remote_sympa_list.name"

     short name for this source

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_remote_sympa_list.url"

     data location URL

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.45b.1 and later.

     "include_remote_sympa_list.user"

     remote user

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.45b.1 and later.

     "include_remote_sympa_list.passwd"

     remote password

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.45b.1 and later.

     "include_remote_sympa_list.host"

     remote host

     Format:
	 /$host/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     obsoleted.  Use "data location URL".

     "include_remote_sympa_list.port"

     remote port

     Format:
	 /"\d+"/

     Default:
	 443

     Context:
	 list (config)

     obsoleted.  Use "data location URL".

     "include_remote_sympa_list.path"

     remote path of sympa list dump

     Format:
	 /"\S+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     obsoleted.  Use "data location URL".

     "include_remote_sympa_list.cert"

     Deprecated.

     Context:
	 list (config)

     Available versions:
	 up to 6.2.44.

     "include_remote_sympa_list.timeout"

     idle timeout

     Format:
	 Number of seconds.

     Default:
	 180 (seconds)

     Context:
	 list (config)

     Available versions:
	 6.2.45b.1 and later.

     "include_remote_sympa_list.ssl_version"

     SSL version

     Format:
	 "ssl_any" - any versions
	 "sslv2" - SSL version 2
	 "sslv3" - SSL version 3
	 "tlsv1" - TLS version 1
	 "tlsv1_1" - TLS version 1.1
	 "tlsv1_2" - TLS version 1.2
	 "tlsv1_3" - TLS version 1.3

     Default:
	 "ssl_any"

     Context:
	 list (config)

     Available versions:
	 6.2.45b.1 and later.

     "include_remote_sympa_list.ssl_ciphers"

     SSL ciphers used

     Format:
	 /".+"/

     Default:
	 "ALL"

     Context:
	 list (config)

     Available versions:
	 6.2.45b.1 and later.

     "include_remote_sympa_list.ca_verify"

     Certificate verification

     Format:
	 "none" - do nothing
	 "optional" - optional
	 "required" - required

     Default:
	 "optional"

     Context:
	 list (config)

     Available versions:
	 6.2.45b.1 and later.

     "include_remote_sympa_list.nosync_time_ranges"

     Time ranges when inclusion is not allowed

     Format:
	 /$time_ranges/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_query"

     (Paragraph) LDAP query inclusion

     Multiple occurrences allowed

     This paragraph defines parameters for a query returning a list of sub-
     scribers. This feature requires the Net::LDAP (perlldap) PERL module.

     "include_ldap_query.name"

     short name for this source

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_query.host"

     remote host

     Format:
	 /$multiple_host_or_url/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_query.use_tls"

     use TLS (formerly SSL)

     Format:
	 "starttls" - use STARTTLS
	 "ldaps" - use LDAPS (LDAP over TLS)
	 "none" - do nothing

     Default:
	 "none"

     Context:
	 list (config)

     Available versions:
	 6.2.15 and later.

     "include_ldap_query.ssl_version"

     SSL version

     Format:
	 "sslv2" - SSL version 2
	 "sslv3" - SSL version 3
	 "tlsv1" - TLS version 1
	 "tlsv1_1" - TLS version 1.1
	 "tlsv1_2" - TLS version 1.2
	 "tlsv1_3" - TLS version 1.3

     Default:
	 "tlsv1"

     Context:
	 list (config)

     "include_ldap_query.ssl_ciphers"

     SSL ciphers used

     Format:
	 /".+"/

     Default:
	 "ALL"

     Context:
	 list (config)

     "include_ldap_query.ca_verify"

     Certificate verification

     Format:
	 "none" - do nothing
	 "optional" - optional
	 "required" - required

     Default:
	 "required"

     Context:
	 list (config)

     Available versions:
	 6.2.13 and later.

     "include_ldap_query.bind_dn"

     remote user

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_ldap_query.bind_password"

     remote password

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_ldap_query.suffix"

     suffix

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_query.scope"

     search scope

     Format:
	 "base" - base
	 "one" - one level
	 "sub" - subtree

     Default:
	 "sub"

     Context:
	 list (config)

     "include_ldap_query.deref"

     dereferencing aliases

     Format:
	 "never" - never
	 "search" - in searching subordinates of the base object
	 "find" - in locating the base object
	 "always" - always

     Default:
	 "find"

     Context:
	 list (config)

     Available versions:
	 6.2.74 and later.

     "include_ldap_query.timeout"

     connection timeout

     Format:
	 Number of seconds.

     Default:
	 30 (seconds)

     Context:
	 list (config)

     "include_ldap_query.filter"

     filter

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_query.attrs"

     extracted attribute

     Format:
	 /"$ldap_attrdesc(\s*,\s*$ldap_attrdesc)?"/

     Default:
	 "mail"

     Context:
	 list (config)

     "include_ldap_query.select"

     selection (if multiple)

     Format:
	 "all" - all
	 "first" - first entry
	 "regex" - entries matching regular expression

     Default:
	 "first"

     Context:
	 list (config)

     "include_ldap_query.regex"

     regular expression

     Format:
	 /".+"/

     Default:
	 ""

     Context:
	 list (config)

     "include_ldap_query.nosync_time_ranges"

     Time ranges when inclusion is not allowed

     Format:
	 /$time_ranges/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2a.16 and later.

     "include_ldap_query.pagesize"

     LDAP page size

     Format:
	 /"\d*"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.74 and later.

     Number of records to fetch per batch (paging), for a LDAP server that sup-
     ports paging. If not set or set to zero, do not use paging. Typically 1000
     for an Active Directory server, to avoid "SizeLimit" errors

     "include_ldap_query.passwd"

     See "include_ldap_query.bind_password".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_ldap_query.port"

     Deprecated.

     Context:
	 list (config)

     "include_ldap_query.use_ssl"

     See "include_ldap_query.use_tls".

     Context:
	 list (config)

     Available versions:
	 5.3a.2 to 6.2.14.

     "include_ldap_query.user"

     See "include_ldap_query.bind_dn".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_ldap_2level_query"

     (Paragraph) LDAP 2-level query inclusion

     Multiple occurrences allowed

     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) PERL module.

     "include_ldap_2level_query.name"

     short name for this source

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_2level_query.host"

     remote host

     Format:
	 /$multiple_host_or_url/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_2level_query.use_tls"

     use TLS (formerly SSL)

     Format:
	 "starttls" - use STARTTLS
	 "ldaps" - use LDAPS (LDAP over TLS)
	 "none" - do nothing

     Default:
	 "none"

     Context:
	 list (config)

     Available versions:
	 6.2.15 and later.

     "include_ldap_2level_query.ssl_version"

     SSL version

     Format:
	 "sslv2" - SSL version 2
	 "sslv3" - SSL version 3
	 "tlsv1" - TLS version 1
	 "tlsv1_1" - TLS version 1.1
	 "tlsv1_2" - TLS version 1.2
	 "tlsv1_3" - TLS version 1.3

     Default:
	 "tlsv1"

     Context:
	 list (config)

     "include_ldap_2level_query.ssl_ciphers"

     SSL ciphers used

     Format:
	 /".+"/

     Default:
	 "ALL"

     Context:
	 list (config)

     "include_ldap_2level_query.ca_verify"

     Certificate verification

     Format:
	 "none" - do nothing
	 "optional" - optional
	 "required" - required

     Default:
	 "required"

     Context:
	 list (config)

     Available versions:
	 6.2.13 and later.

     "include_ldap_2level_query.bind_dn"

     remote user

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_ldap_2level_query.bind_password"

     remote password

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_ldap_2level_query.suffix1"

     first-level suffix

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_2level_query.scope1"

     first-level search scope

     Format:
	 "base" - base
	 "one" - one level
	 "sub" - subtree

     Default:
	 "sub"

     Context:
	 list (config)

     "include_ldap_2level_query.deref1"

     dereferencing aliases

     Format:
	 "never" - never
	 "search" - in searching subordinates of the base object
	 "find" - in locating the base object
	 "always" - always

     Default:
	 "find"

     Context:
	 list (config)

     Available versions:
	 6.2.74 and later.

     "include_ldap_2level_query.timeout1"

     first-level connection timeout

     Format:
	 Number of seconds.

     Default:
	 30 (seconds)

     Context:
	 list (config)

     "include_ldap_2level_query.filter1"

     first-level filter

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_2level_query.attrs1"

     first-level extracted attribute

     Format:
	 /$ldap_attrdesc/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_2level_query.select1"

     first-level selection

     Format:
	 "all" - all
	 "first" - first entry
	 "regex" - entries matching regular expression

     Default:
	 "first"

     Context:
	 list (config)

     "include_ldap_2level_query.regex1"

     first-level regular expression

     Format:
	 /".+"/

     Default:
	 ""

     Context:
	 list (config)

     "include_ldap_2level_query.suffix2"

     second-level suffix template

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_2level_query.scope2"

     second-level search scope

     Format:
	 "base" - base
	 "one" - one level
	 "sub" - subtree

     Default:
	 "sub"

     Context:
	 list (config)

     "include_ldap_2level_query.deref2"

     dereferencing aliases

     Format:
	 "never" - never
	 "search" - in searching subordinates of the base object
	 "find" - in locating the base object
	 "always" - always

     Default:
	 "find"

     Context:
	 list (config)

     Available versions:
	 6.2.74 and later.

     "include_ldap_2level_query.timeout2"

     second-level connection timeout

     Format:
	 Number of seconds.

     Default:
	 30 (seconds)

     Context:
	 list (config)

     "include_ldap_2level_query.filter2"

     second-level filter template

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_2level_query.attrs2"

     second-level extracted attribute

     Format:
	 /"$ldap_attrdesc(\s*,\s*$ldap_attrdesc)?"/

     Default:
	 "mail"

     Context:
	 list (config)

     "include_ldap_2level_query.select2"

     second-level selection

     Format:
	 "all" - all
	 "first" - first entry
	 "regex" - entries matching regular expression

     Default:
	 "first"

     Context:
	 list (config)

     "include_ldap_2level_query.regex2"

     second-level regular expression

     Format:
	 /".+"/

     Default:
	 ""

     Context:
	 list (config)

     "include_ldap_2level_query.nosync_time_ranges"

     Time ranges when inclusion is not allowed

     Format:
	 /$time_ranges/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2a.16 and later.

     "include_ldap_2level_query.pagesize"

     LDAP page size

     Format:
	 /"\d*"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.74 and later.

     Number of records to fetch per batch (paging), for a LDAP server that sup-
     ports paging. If not set or set to zero, do not use paging. Typically 1000
     for an Active Directory server, to avoid "SizeLimit" errors

     "include_ldap_2level_query.passwd"

     See "include_ldap_2level_query.bind_password".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_ldap_2level_query.port"

     Deprecated.

     Context:
	 list (config)

     "include_ldap_2level_query.use_ssl"

     See "include_ldap_2level_query.use_tls".

     Context:
	 list (config)

     Available versions:
	 5.3a.2 to 6.2.14.

     "include_ldap_2level_query.user"

     See "include_ldap_2level_query.bind_dn".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_sql_query"

     (Paragraph) SQL query inclusion

     Multiple occurrences allowed

     This parameter is used to define the SQL query parameters.

     "include_sql_query.name"

     short name for this source

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_sql_query.db_type"

     database type

     Format:
	 /"\S+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_sql_query.db_name"

     database name

     Format:
	 /"\S+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_sql_query.db_host"

     remote host

     Format:
	 /$host/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_sql_query.db_port"

     database port

     Format:
	 /"\d+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_sql_query.db_options"

     connection options

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_sql_query.db_env"

     environment variables for database connection

     Format:
	 /"\w+\=\S+(;\w+\=\S+)*"/

     Default:
	 None.

     Context:
	 list (config)

     "include_sql_query.db_user"

     remote user

     Format:
	 /"\S+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_sql_query.db_passwd"

     remote password

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_sql_query.sql_query"

     SQL query

     Format:
	 /$sql_query/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_sql_query.f_dir"

     See "include_sql_query.db_name".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.70.

     "include_sql_query.nosync_time_ranges"

     Time ranges when inclusion is not allowed

     Format:
	 /$time_ranges/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2a.16 and later.

     "include_sql_query.connect_options"

     See "include_sql_query.db_options".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_sql_query.host"

     See "include_sql_query.db_host".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_sql_query.passwd"

     See "include_sql_query.db_passwd".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_sql_query.user"

     See "include_sql_query.db_user".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "ttl"

     TTL of user data

     Format:
	 Number of seconds.

     Default:
	 3600 (seconds)

     Context:
	 list (config), site (sympa.conf)

     Sympa caches user data extracted using the include parameter. Their TTL
     (time-to-live) within Sympa can be controlled using this parameter. The de-
     fault value is 3600

     "distribution_ttl"

     TTL of user data for message distribution

     Format:
	 Number of seconds.

     Default:
	 None.

     Context:
	 list (config), site (sympa.conf)

     This parameter defines the delay since the last synchronization after which
     the user data will be updated before performing message distribution

     "include_ldap_ca"

     (Paragraph) LDAP query custom attribute

     Multiple occurrences allowed

     "include_ldap_ca.name"

     short name for this source

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_ca.host"

     remote host

     Format:
	 /$multiple_host_or_url/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_ca.use_tls"

     use TLS (formerly SSL)

     Format:
	 "starttls" - use STARTTLS
	 "ldaps" - use LDAPS (LDAP over TLS)
	 "none" - do nothing

     Default:
	 "none"

     Context:
	 list (config)

     Available versions:
	 6.2.15 and later.

     "include_ldap_ca.ssl_version"

     SSL version

     Format:
	 "sslv2" - SSL version 2
	 "sslv3" - SSL version 3
	 "tlsv1" - TLS version 1
	 "tlsv1_1" - TLS version 1.1
	 "tlsv1_2" - TLS version 1.2
	 "tlsv1_3" - TLS version 1.3

     Default:
	 "tlsv1"

     Context:
	 list (config)

     "include_ldap_ca.ssl_ciphers"

     SSL ciphers used

     Format:
	 /".+"/

     Default:
	 "ALL"

     Context:
	 list (config)

     "include_ldap_ca.ca_verify"

     Certificate verification

     Format:
	 "none" - do nothing
	 "optional" - optional
	 "required" - required

     Default:
	 "required"

     Context:
	 list (config)

     Available versions:
	 6.2.13 and later.

     "include_ldap_ca.bind_dn"

     remote user

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_ldap_ca.bind_password"

     remote password

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_ldap_ca.suffix"

     suffix

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_ca.scope"

     search scope

     Format:
	 "base" - base
	 "one" - one level
	 "sub" - subtree

     Default:
	 "sub"

     Context:
	 list (config)

     "include_ldap_ca.deref"

     dereferencing aliases

     Format:
	 "never" - never
	 "search" - in searching subordinates of the base object
	 "find" - in locating the base object
	 "always" - always

     Default:
	 "find"

     Context:
	 list (config)

     Available versions:
	 6.2.74 and later.

     "include_ldap_ca.timeout"

     connection timeout

     Format:
	 Number of seconds.

     Default:
	 30 (seconds)

     Context:
	 list (config)

     "include_ldap_ca.filter"

     filter

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_ca.attrs"

     extracted attribute

     Format:
	 /"$ldap_attrdesc(\s*,\s*$ldap_attrdesc)?"/

     Default:
	 "mail"

     Context:
	 list (config)

     "include_ldap_ca.email_entry"

     Name of email entry

     Format:
	 /"\S+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_ca.select"

     selection (if multiple)

     Format:
	 "all" - all
	 "first" - first entry
	 "regex" - entries matching regular expression

     Default:
	 "first"

     Context:
	 list (config)

     "include_ldap_ca.regex"

     regular expression

     Format:
	 /".+"/

     Default:
	 ""

     Context:
	 list (config)

     "include_ldap_ca.nosync_time_ranges"

     Time ranges when inclusion is not allowed

     Format:
	 /$time_ranges/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_ca.passwd"

     See "include_ldap_ca.bind_password".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_ldap_ca.port"

     Deprecated.

     Context:
	 list (config)

     "include_ldap_ca.use_ssl"

     See "include_ldap_ca.use_tls".

     Context:
	 list (config)

     Available versions:
	 6.2a? to 6.2.14.

     "include_ldap_ca.user"

     See "include_ldap_ca.bind_dn".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_ldap_2level_ca"

     (Paragraph) LDAP 2-level query custom attribute

     Multiple occurrences allowed

     "include_ldap_2level_ca.name"

     short name for this source

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_2level_ca.host"

     remote host

     Format:
	 /$multiple_host_or_url/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_2level_ca.use_tls"

     use TLS (formerly SSL)

     Format:
	 "starttls" - use STARTTLS
	 "ldaps" - use LDAPS (LDAP over TLS)
	 "none" - do nothing

     Default:
	 "none"

     Context:
	 list (config)

     Available versions:
	 6.2.15 and later.

     "include_ldap_2level_ca.ssl_version"

     SSL version

     Format:
	 "sslv2" - SSL version 2
	 "sslv3" - SSL version 3
	 "tlsv1" - TLS version 1
	 "tlsv1_1" - TLS version 1.1
	 "tlsv1_2" - TLS version 1.2
	 "tlsv1_3" - TLS version 1.3

     Default:
	 "tlsv1"

     Context:
	 list (config)

     "include_ldap_2level_ca.ssl_ciphers"

     SSL ciphers used

     Format:
	 /".+"/

     Default:
	 "ALL"

     Context:
	 list (config)

     "include_ldap_2level_ca.ca_verify"

     Certificate verification

     Format:
	 "none" - do nothing
	 "optional" - optional
	 "required" - required

     Default:
	 "required"

     Context:
	 list (config)

     Available versions:
	 6.2.13 and later.

     "include_ldap_2level_ca.bind_dn"

     remote user

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_ldap_2level_ca.bind_password"

     remote password

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_ldap_2level_ca.suffix1"

     first-level suffix

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_2level_ca.scope1"

     first-level search scope

     Format:
	 "base" - base
	 "one" - one level
	 "sub" - subtree

     Default:
	 "sub"

     Context:
	 list (config)

     "include_ldap_2level_ca.deref1"

     dereferencing aliases

     Format:
	 "never" - never
	 "search" - in searching subordinates of the base object
	 "find" - in locating the base object
	 "always" - always

     Default:
	 "find"

     Context:
	 list (config)

     Available versions:
	 6.2.74 and later.

     "include_ldap_2level_ca.timeout1"

     first-level connection timeout

     Format:
	 Number of seconds.

     Default:
	 30 (seconds)

     Context:
	 list (config)

     "include_ldap_2level_ca.filter1"

     first-level filter

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_2level_ca.attrs1"

     first-level extracted attribute

     Format:
	 /$ldap_attrdesc/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_2level_ca.select1"

     first-level selection

     Format:
	 "all" - all
	 "first" - first entry
	 "regex" - entries matching regular expression

     Default:
	 "first"

     Context:
	 list (config)

     "include_ldap_2level_ca.regex1"

     first-level regular expression

     Format:
	 /".+"/

     Default:
	 ""

     Context:
	 list (config)

     "include_ldap_2level_ca.suffix2"

     second-level suffix template

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_2level_ca.scope2"

     second-level search scope

     Format:
	 "base" - base
	 "one" - one level
	 "sub" - subtree

     Default:
	 "sub"

     Context:
	 list (config)

     "include_ldap_2level_ca.deref2"

     dereferencing aliases

     Format:
	 "never" - never
	 "search" - in searching subordinates of the base object
	 "find" - in locating the base object
	 "always" - always

     Default:
	 "find"

     Context:
	 list (config)

     Available versions:
	 6.2.74 and later.

     "include_ldap_2level_ca.timeout2"

     second-level connection timeout

     Format:
	 Number of seconds.

     Default:
	 30 (seconds)

     Context:
	 list (config)

     "include_ldap_2level_ca.filter2"

     second-level filter template

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_2level_ca.attrs2"

     second-level extracted attribute

     Format:
	 /$ldap_attrdesc/

     Default:
	 "mail"

     Context:
	 list (config)

     "include_ldap_2level_ca.select2"

     second-level selection

     Format:
	 "all" - all
	 "first" - first entry
	 "regex" - entries matching regular expression

     Default:
	 "first"

     Context:
	 list (config)

     "include_ldap_2level_ca.regex2"

     second-level regular expression

     Format:
	 /".+"/

     Default:
	 ""

     Context:
	 list (config)

     "include_ldap_2level_ca.email_entry"

     Name of email entry

     Format:
	 /"\S+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_ldap_2level_ca.nosync_time_ranges"

     Time ranges when inclusion is not allowed

     Format:
	 /$time_ranges/

     Default:
	 None.

     Context:
	 list (config)

     "include_ldap_2level_ca.passwd"

     See "include_ldap_2level_ca.bind_password".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_ldap_2level_ca.port"

     Deprecated.

     Context:
	 list (config)

     "include_ldap_2level_ca.use_ssl"

     See "include_ldap_2level_ca.use_tls".

     Context:
	 list (config)

     Available versions:
	 6.2a? to 6.2.14.

     "include_ldap_2level_ca.user"

     See "include_ldap_2level_ca.bind_dn".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_sql_ca"

     (Paragraph) SQL query custom attribute

     Multiple occurrences allowed

     "include_sql_ca.name"

     short name for this source

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_sql_ca.db_type"

     database type

     Format:
	 /"\S+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_sql_ca.db_name"

     database name

     Format:
	 /"\S+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_sql_ca.db_host"

     remote host

     Format:
	 /$host/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_sql_ca.db_port"

     database port

     Format:
	 /"\d+"/

     Default:
	 None.

     Context:
	 list (config)

     "include_sql_ca.db_options"

     connection options

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_sql_ca.db_env"

     environment variables for database connection

     Format:
	 /"\w+\=\S+(;\w+\=\S+)*"/

     Default:
	 None.

     Context:
	 list (config)

     "include_sql_ca.db_user"

     remote user

     Format:
	 /"\S+"/

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_sql_ca.db_passwd"

     remote password

     Format:
	 The value to be concealed.

     Default:
	 None.

     Context:
	 list (config)

     Available versions:
	 6.2.57b.1 and later.

     "include_sql_ca.sql_query"

     SQL query

     Format:
	 /$sql_query/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_sql_ca.f_dir"

     See "include_sql_ca.db_name".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.70.

     "include_sql_ca.email_entry"

     Name of email entry

     Format:
	 /"\S+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "include_sql_ca.nosync_time_ranges"

     Time ranges when inclusion is not allowed

     Format:
	 /$time_ranges/

     Default:
	 None.

     Context:
	 list (config)

     "include_sql_ca.connect_options"

     See "include_sql_ca.db_options".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_sql_ca.host"

     See "include_sql_ca.db_host".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_sql_ca.passwd"

     See "include_sql_ca.db_passwd".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

     "include_sql_ca.user"

     See "include_sql_ca.db_user".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.56.

   DKIM/DMARC/ARC
     DKIM signature verification and re-signing. It requires an external module:
     Mail-DKIM.

     ARC seals on forwarded messages. It requires an external module: Mail-DKIM.

     "dkim_add_signature_to"

     Which service messages to be signed

     Format:
	 /"(?:list|robot)(?:,(?:list|robot))*"/

     Default:
	 "robot,list"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Inserts a DKIM signature to service messages in context of robot, list or
     both

     "dkim_signer_identity"

     The "i=" tag as defined in rfc 4871

     Format:
	 /"\S+"/

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Default is null.

     "dkim_feature"

     Insert DKIM signature to messages sent to the list

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 domain (robot.conf), site (sympa.conf)

     If set to "on", Sympa may verify DKIM signatures of incoming messages
     and/or insert DKIM signature to outgoing messages.

     "dkim_parameters"

     (Paragraph) DKIM configuration

     Single occurrence

     A set of parameters in order to define outgoing DKIM signature

     "dkim_parameters.private_key_path"

     File path for DKIM private key

     Format:
	 /"\S+"/

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     The file must contain a PEM encoded private key

     "dkim_parameters.selector"

     Selector for DNS lookup of DKIM public key

     Format:
	 /"\S+"/

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     The selector is used in order to build the DNS query for public key. It is
     up to you to choose the value you want but verify that you can query the
     public DKIM key for "<selector>._domainkey.your_domain"

     "dkim_parameters.header_list"

     Deprecated.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "dkim_parameters.signer_domain"

     DKIM "d=" tag, you should probably use the default value

     Format:
	 /$domain/

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     The DKIM "d=" tag, is the domain of the signing entity. The list domain
     MUST be included in the "d=" domain

     "dkim_parameters.signer_identity"

     DKIM "i=" tag, you should probably leave this parameter empty

     Format:
	 /"\S+"/

     Default:
	 None.

     Context:
	 list (config)

     DKIM "i=" tag, you should probably not use this parameter, as recommended
     by RFC 4871, default for list broadcasted messages is i=<listname>-re-
     quest@<domain>

     "dkim_signature_apply_on"

     The categories of messages sent to the list that will be signed using DKIM.

     Format:
	 Multiple values allowed, separated by "","".

	 "md5_authenticated_messages" - authenticated by password
	 "smime_authenticated_messages" - authenticated by S/MIME signature
	 "dkim_authenticated_messages" - with successfully verified DKIM signa-
	 ture
	 "editor_validated_messages" - approved by moderator
	 "none" - do nothing
	 "any" - any messages

     Default:
	 "md5_authenticated_messages,smime_authenticated_messages,dkim_authenti-
	 cated_messages,editor_validated_messages"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     This parameter controls in which case messages must be signed using DKIM,
     you may sign every message choosing 'any' or a subset. The parameter value
     is a comma separated list of keywords

     "arc_feature"

     Add ARC seals to messages sent to the list

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.37b.1 and later.

     Enable/Disable ARC. This feature requires Mail::DKIM::ARC to be installed,
     and maybe some custom scenario to be updated

     "arc_srvid"

     Authentication service identifier (authserv-id) for Authentication-Results
     used in ARC seal

     Format:
	 /$rfc2045_parameter_value/

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.37b.1 and later.

     Typically the domain of the mail server

     "arc_parameters"

     (Paragraph) ARC configuration

     Single occurrence

     A set of parameters in order to define outgoing ARC seal

     "arc_parameters.private_key_path"

     File path for ARC private key

     Format:
	 /"\S+"/

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     The file must contain a PEM encoded private key. Defaults to same file as
     DKIM private key

     "arc_parameters.selector"

     Selector for DNS lookup of ARC public key

     Format:
	 /"\S+"/

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     The selector is used in order to build the DNS query for public key. It is
     up to you to choose the value you want but verify that you can query the
     public DKIM key for "<selector>._domainkey.your_domain". Default is the
     same selector as for DKIM signatures

     "arc_parameters.signer_domain"

     ARC "d=" tag, you should probably use the default value

     Format:
	 /$domain/

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     The ARC "d=" tag is the domain of the signing entity. The DKIM d= domain
     name is used as its default value

     "arc_parameters.arc_private_key_path"

     See "arc_parameters.private_key_path".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.70.

     "arc_parameters.arc_selector"

     See "arc_parameters.selector".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.70.

     "arc_parameters.arc_signer_domain"

     See "arc_parameters.signer_domain".

     Context:
	 list (config)

     Available versions:
	 up to 6.2.70.

     "dmarc_protection"

     (Paragraph) DMARC Protection

     Single occurrence

     Parameters to define how to manage From address processing to avoid some
     domains' excessive DMARC protection

     "dmarc_protection.mode"

     Protection modes

     Format:
	 Multiple values allowed, separated by "","".

	 "none" - do nothing
	 "all" - all
	 "dkim_signature" - DKIM signature exists
	 "dmarc_reject" - DMARC policy suggests rejection
	 "dmarc_any" - DMARC policy exists
	 "dmarc_quarantine" - DMARC policy suggests quarantine
	 "domain_regex" - domain matching regular expression

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Select one or more operation modes.  "Domain matching regular expression"
     (domain_regex) matches the specified Domain regular expression; "DKIM sig-
     nature exists" (dkim_signature) matches any message with a DKIM signature
     header; "DMARC policy ..." (dmarc_*) matches messages from sender domains
     with a DMARC policy as given; "all" (all) matches all messages.

     Example:

       dmarc_protection.mode dmarc_reject,dkim_signature

     "dmarc_protection.domain_regex"

     Regular expression for domain name match

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Regular expression match pattern for From domain

     "dmarc_protection.other_email"

     New From address

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     This is the email address to use when modifying the From header.  It de-
     faults to the list address.  This is similar to Anonymisation but preserves
     the original sender details in the From address phrase.

     "dmarc_protection.phrase"

     New From name format

     Format:
	 "display_name" - "Name"
	 "name_and_email" - "Name" (e-mail)
	 "name_via_list" - "Name" (via List)
	 "name_email_via_list" - "Name" (e-mail via List)
	 "list_for_name" - "List" (on behalf of Name)
	 "list_for_email" - "List" (on behalf of e-mail)

     Default:
	 "name_via_list"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     This is the format to be used for the sender name part of the new From
     header field.

     "remove_dkim_headers"

     Remove DKIM signatures in incoming messages

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.74 and later.

     Normally this should be turned off. It can be turned on when DKIM signa-
     tures that cannot be verified at the recipient site cause problems.

   List address verification
     Checks if an alias with the same name as the list to be created already ex-
     ists on the SMTP server. This feature requires an external module:
     Net-SMTP.

     "list_check_helo"

     SMTP HELO (EHLO) parameter used for address verification

     Format:
	 /"\S+"/

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.0 and later.

     Default value is the host part of "list_check_smtp" parameter.

     "list_check_smtp"

     SMTP server to verify existence of the same addresses as the list to be
     created

     Format:
	 /$hostport/

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     This is needed if you are running Sympa on a host but you handle all your
     mail on a separate mail relay.

     Default value is real FQDN of the host. Port number may be specified as
     "mail.example.org:25" or "203.0.113.1:25".  If port is not specified, stan-
     dard port (25) will be used.

     "list_check_suffixes"

     Address suffixes to verify

     Format:
	 /"\S+"/

     Default:
	 "request,owner,editor,unsubscribe,subscribe"

     Context:
	 domain (robot.conf), site (sympa.conf)

     List of suffixes you are using for list addresses, i.e. "mylist-request",
     "mylist-owner" and so on.

     This parameter is used with the "list_check_smtp" parameter. It is also
     used to check list names at list creation time.

   Antivirus plug-in
     "antivirus_path"

     Path to the antivirus scanner engine

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Supported antivirus: Clam AntiVirus/clamscan & clamdscan, McAfee/uvscan,
     Fsecure/fsav, Sophos, AVP and Trend Micro/VirusWall

     Example:

       antivirus_path /usr/local/bin/clamscan

     "antivirus_args"

     Antivirus plugin command line arguments

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Example:

       antivirus_args --no-summary --database /usr/local/share/clamav

     "antivirus_notify"

     Notify sender if virus checker detects malicious content

     Format:
	 "sender" - sender
	 "delivery_status" - send back DSN
	 "none" - do nothing

     Default:
	 "sender"

     Context:
	 domain (robot.conf), site (sympa.conf)

     "sender" to notify originator of the message, "delivery_status" to send de-
     livery status, or "none"

   Miscellaneous
     "email"

     Local part of Sympa email address

     Format:
	 /"\S+"/

     Default:
	 "sympa"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Local part (the part preceding the "@" sign) of the address by which mail
     interface of Sympa accepts mail commands.

     If you change the default value, you must modify the mail aliases too.

     "listmaster_email"

     Local part of listmaster email address

     Format:
	 /"\S+"/

     Default:
	 "listmaster"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Local part (the part preceding the "@" sign) of the address by which list-
     masters receive messages.

     If you change the default value, you must modify the mail aliases too.

     "custom_robot_parameter"

     Custom robot parameter

     Format:
	 Multiple occurrences allowed.

	 /".+"/

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Used to define a custom parameter for your server. Do not forget the semi-
     colon between the parameter name and the parameter value.

     You will be able to access the custom parameter value in web templates by
     variable "conf.custom_robot_parameter.<param_name>"

     Example:

       custom_robot_parameter param_name ; param_value

     "prohibited_listnames"

     Prevent people to use some names for their lists names

     Format:
	 Any.

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.63b.1 and later.

     This parameter is a comma-separated list of names. You can use * as a wild-
     card character. To use a regex for this, please use prohibited_list-
     names_regex setting.

     Example:

       prohibited_listnames www,root,*master

     "prohibited_listnames_regex"

     Prevent people to use some names for their lists names, based on a regex

     Format:
	 Any.

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.63b.1 and later.

     This parameter is a regex. Please note that prohibited_listnames and pro-
     hibited_listnames_regex will both be applied if set, they are not exclu-
     sive.

     Example:

       prohibited_listnames_regex www|root|.*master

     "cache_list_config"

     Use of binary cache of list configuration

     Format:
	 "binary_file" - use binary file
	 "none" - do nothing

     Default:
	 "none"

     Context:
	 site (sympa.conf)

     binary_file: Sympa processes will maintain a binary version of the list
     configuration, "config.bin" file on local disk. If you manage a big amount
     of lists (1000+), it should make the web interface startup faster.

     You can recreate cache by running "sympa.pl --reload_list_config".

     "db_list_cache"

     Use database cache to search lists

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 site (sympa.conf)

     Note that "list_table" database table should be filled at the first time by
     running:

       # sympa.pl --sync_list_db

     "purge_user_table_task"

     Task for expiring inactive users

     Format:
	 /"\w+"/

     Default:
	 "monthly"

     Context:
	 site (sympa.conf)

     This task removes rows in the "user_table" table which have not correspond-
     ing entries in the "subscriber_table" table.

     "purge_logs_table_task"

     Task for cleaning tables

     Format:
	 /"\w+"/

     Default:
	 "daily"

     Context:
	 site (sympa.conf)

     This task cleans old logs from "logs_table" table.

     "logs_expiration_period"

     Max age of logs in database

     Format:
	 Number of months.

     Default:
	 3 (months)

     Context:
	 site (sympa.conf)

     Number of months that elapse before a log is expired

     "stats_expiration_period"

     Max age of statistics information in database

     Format:
	 Number of months.

     Default:
	 3 (months)

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2b.7 and later.

     Number of months that elapse before statistics information are expired

     "umask"

     Umask

     Format:
	 /"[0-7]+"/

     Default:
	 027

     Context:
	 site (sympa.conf)

     Default mask for file creation (see umask(2)). Note that it will be inter-
     preted as an octal value.

     "clean_delay_queuemod"

     Max age of moderated messages

     Format:
	 Number of days.

     Default:
	 30 (days)

     Context:
	 list (config), site (sympa.conf)

     Number of days messages are kept in moderation spool (as specified by
     "queuemod" parameter). Beyond this deadline, messages that have not been
     processed are deleted.

     "custom_attribute"

     (Paragraph) Custom user attributes

     Multiple occurrences allowed

     "custom_attribute.id"

     internal identifier

     Format:
	 /"\w+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "custom_attribute.name"

     label

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "custom_attribute.comment"

     additional comment

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "custom_attribute.type"

     type

     Format:
	 "string" - string
	 "text" - multi-line text
	 "integer" - number
	 "enum" - set of keywords

     Default:
	 "string"

     Context:
	 list (config)

     "custom_attribute.enum_values"

     possible attribute values (if enum is used)

     Format:
	 /".+"/

     Default:
	 None.

     Context:
	 list (config)

     "custom_attribute.optional"

     is the attribute optional?

     Format:
	 "required" - required
	 "optional" - optional

     Default:
	 "optional"

     Context:
	 list (config)

     "custom_vars"

     (Paragraph) custom parameters

     Multiple occurrences allowed

     "custom_vars.name"

     var name

     Format:
	 /"\S+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "custom_vars.value"

     var value

     Format:
	 /".+"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "loop_prevention_regex"

     Regular expression applied to prevent loops with robots

     Format:
	 /"\S*"/

     Default:
	 "mailer-daemon|sympa|listserv|majordomo|smartlist|mailman"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     If the sender address matches the regular expression, then the message is
     rejected.

     "pictures_feature"

     Pictures

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "on"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Enables or disables the pictures feature by default.  If enabled, sub-
     scribers can upload their picture (from the "Subscriber option" page) to
     use as an avatar.

     Pictures are stored in a directory specified by the "static_content_path"
     parameter.

     "remind_task"

     Periodical subscription reminder task

     Format:
	 /"\w+"/

     Default:
	 None.

     Context:
	 list (config), site (sympa.conf)

     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.

     "latest_instantiation"

     (Paragraph) Latest family instantiation

     Single occurrence

     "latest_instantiation.email"

     who ran the instantiation

     Format:
	 /"listmaster|$email"/

     Default:
	 None.

     Context:
	 list (config)

     "latest_instantiation.date_epoch"

     date

     Format:
	 The time in second from Unix epoch.

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "latest_instantiation.date"

     Deprecated.

     Context:
	 list (config)

     Available versions:
	 up to 6.2.16.

     "creation"

     (Paragraph) Creation of the list

     Single occurrence

     "creation.email"

     who created the list

     Format:
	 /"listmaster|$email"/

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "creation.date_epoch"

     date

     Format:
	 The time in second from Unix epoch.

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "creation.date"

     Deprecated.

     Context:
	 list (config)

     Available versions:
	 up to 6.2.16.

     "update"

     (Paragraph) Last update of config

     Single occurrence

     "update.email"

     who updated the config

     Format:
	 /"(listmaster|automatic|$email)"/

     Default:
	 None.

     Context:
	 list (config)

     "update.date_epoch"

     date

     Format:
	 The time in second from Unix epoch.

     Default:
	 None, mandatory.

     Context:
	 list (config)

     "update.date"

     Deprecated.

     Context:
	 list (config)

     Available versions:
	 up to 6.2.16.

     "status"

     Status of the list

     Format:
	 Status of list.

     Default:
	 "open"

     Context:
	 list (config)

     "serial"

     Serial number of the config

     Format:
	 /"\d+"/

     Default:
	 0

     Context:
	 list (config)

   Web interface parameters
     "wwsympa_url"

     URL prefix of web interface

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     This is used to construct URLs of web interface. The protocol (either
     https:// or http://) is required.

     Example:

       wwsympa_url https://web.example.org/sympa

     "wwsympa_url_local"

     URL prefix of WWSympa behind proxy

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.56 and later.

     "static_content_url"

     URL for static contents

     Format:
	 Any.

     Default:
	 "/static-sympa"

     Context:
	 domain (robot.conf), site (sympa.conf)

     HTTP server have to map it with "static_content_path" directory.

     "static_content_path"

     Directory for static contents

     Format:
	 Any.

     Default:
	 $STATICDIR

     Context:
	 domain (robot.conf), site (sympa.conf)

     "css_path"

     Directory for static style sheets (CSS)

     Format:
	 Any.

     Default:
	 $CSSDIR

     Context:
	 site (sympa.conf)

     After an upgrade, static CSS files are upgraded with the newly installed
     "css.tt2" template. Therefore, this is not a good place to store customized
     CSS files.

     "css_url"

     URL for style sheets (CSS)

     Format:
	 Any.

     Default:
	 "/static-sympa/css"

     Context:
	 site (sympa.conf)

     To use auto-generated static CSS, HTTP server have to map it with
     "css_path".

     "pictures_path"

     Directory for subscribers pictures

     Format:
	 Any.

     Default:
	 $PICTURESDIR

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.25b.2 and later.

     "pictures_url"

     URL for subscribers pictures

     Format:
	 Any.

     Default:
	 "/static-sympa/pictures"

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.25b.2 and later.

     HTTP server have to map it with "pictures_path" directory.

     "mhonarc"

     Path to MHonArc mail-to-HTML converter

     Format:
	 Any.

     Default:
	 "/usr/bin/mhonarc"

     Context:
	 domain (robot.conf), site (sympa.conf)

     This is required for HTML mail archiving.

     "log_facility"

     System log facility for web interface

     Format:
	 Any.

     Default:
	 "LOCAL1"

     Context:
	 site (sympa.conf)

     System log facility for WWSympa, archived.pl and bounced.pl. Default is to
     use value of "syslog" parameter.

   Web interface parameters: Appearances
     "logo_html_definition"

     Custom logo

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     HTML fragment to insert a logo in the page of web interface.

     Example:

       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>

     "favicon_url"

     Custom favicon

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.5 and later.

     URL of favicon image

     "default_home"

     Type of main web page

     Format:
	 Any.

     Default:
	 "home"

     Context:
	 domain (robot.conf), site (sympa.conf)

     "lists" for the page of list of lists. "home" for home page.

     "archive_default_index"

     Default index organization of web archive

     Format:
	 Any.

     Default:
	 "thrd"

     Context:
	 site (sympa.conf)

     thrd: Threaded index.

     mail: Chronological index.

     "review_page_size"

     Size of review page

     Format:
	 Any.

     Default:
	 25

     Context:
	 domain (robot.conf), site (sympa.conf)

     Default number of lines of the array displaying users in the review page

     "viewlogs_page_size"

     Size of viewlogs page

     Format:
	 Any.

     Default:
	 25

     Context:
	 domain (robot.conf), site (sympa.conf)

     Default number of lines of the array displaying the log entries in the logs
     page.

     "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"

     Custom menus

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     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 URL and, optionally, a
     target.

     Example:

       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

   Password validation
     Checks if the password the user submitted has sufficient strength. This
     feature requires an external module: Data-Password.

     "password_validation"

     Password validation

     Format:
	 Any.

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Available versions:
	 6.1.23 and later.

     The password validation techniques to be used against user passwords that
     are added to mailing lists. Options come from Data::Password https://metac-
     pan.org/pod/Data::Password#VARIABLES

     Example:

       password_validation MINLEN=8,GROUPS=3,DICTIONARY=4,DICTIONARIES=/pentest/dictionaries

   Authentication with LDAP
     Authenticates users based on the directory on LDAP server. This feature re-
     quires an external module: Net-LDAP. And also, if secure connection (LDAPS)
     is required: IO-Socket-SSL.

     "ldap_force_canonical_email"

     Use canonical email address for LDAP authentication

     Format:
	 Any.

     Default:
	 1

     Context:
	 domain (robot.conf), site (sympa.conf)

     When using LDAP 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 LDAP server will be used.

   SOAP HTTP interface
     Provides some functions of Sympa through the SOAP HTTP interface. This fea-
     ture requires an external module: SOAP-Lite.

     "soap_url"

     URL of SympaSOAP

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     WSDL document of SympaSOAP refers to this URL in its service section.

     Example:

       soap_url http://web.example.org/sympasoap

     "soap_url_local"

     URL of SympaSOAP behind proxy

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.19b.1 and later.

   Web interface parameters: Miscellaneous
     "cookie_domain"

     HTTP cookies validity domain

     Format:
	 Any.

     Default:
	 "localhost"

     Context:
	 domain (robot.conf), site (sympa.conf)

     If beginning with a dot ("."), the cookie is available within the specified
     Internet domain. Otherwise, for the specified host. The only reason for re-
     placing the default value would be where WWSympa's authentication process
     is shared with an application running on another host.

     Example:

       cookie_domain .renater.fr

     "cookie_expire"

     HTTP cookies lifetime

     Format:
	 Any.

     Default:
	 0

     Context:
	 site (sympa.conf)

     This is the default value when not set explicitly by users. "0" means the
     cookie may be retained during browser sessions.

     "cookie_refresh"

     Average interval to refresh HTTP session ID.

     Format:
	 Any.

     Default:
	 60

     Context:
	 site (sympa.conf)

     "purge_session_table_task"

     Task for cleaning old sessions

     Format:
	 /"\w+"/

     Default:
	 "daily"

     Context:
	 site (sympa.conf)

     This task removes old entries in the "session_table" table.

     "session_table_ttl"

     Max age of sessions

     Format:
	 Any.

     Default:
	 "2d"

     Context:
	 site (sympa.conf)

     Session duration is controlled by "sympa_session" cookie validity at-
     tribute. However, by security reason, this delay also need to be controlled
     by server side. This task removes old entries in the "session_table" table.

     Format of values is a string without spaces including "y" for years, "m"
     for months, "d" for days, "h" for hours, "min" for minutes and "sec" for
     seconds.

     "anonymous_session_table_ttl"

     Max age of sessions for anonymous users

     Format:
	 Any.

     Default:
	 "1h"

     Context:
	 site (sympa.conf)

     "shared_feature"

     Enable shared repository

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.41b.2 and later.

     If set to "on", list owners can open shared repository.

     "shared_doc"

     (Paragraph) Shared documents

     Single occurrence

     This paragraph defines read and edit access to the shared document reposi-
     tory.

     "shared_doc.d_read"

     Who can view

     Format:
	 Name of "d_read" scenario:

	 "owner" - restricted to list owners
	 "private" - restricted to subscribers
	 "private-https" - restricted to subscribers authenticated with user
	 cert
	 "public" - public documents

     Default:
	 "private"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "shared_doc.d_edit"

     Who can edit

     Format:
	 Name of "d_edit" scenario:

	 "editor" - moderated for subscribers
	 "owner" - restricted to list owners
	 "private" - restricted to subscribers
	 "private-https" - restricted to subscribers authenticated with user
	 cert
	 "public" - public documents

     Default:
	 "owner"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "shared_doc.quota"

     quota

     Format:
	 Number of Kbytes.

     Default:
	 None.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     "use_html_editor"

     Use HTML editor

     Format:
	 "off" - disabled
	 "on" - enabled

     Default:
	 "off"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.0 and later.

     If set to "on", users will be able to post messages in HTML using a
     javascript WYSIWYG editor.

     Example:

       use_html_editor on

     "html_editor_url"

     URL of HTML editor

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.34 and later.

     URL path to the javascript file making the WYSIWYG HTML editor available.
     Relative path under <static_content_url> or absolute path.

     Example is for TinyMCE 4 installed under <static_content_path>/js/tinymce/.

     Example:

       html_editor_url js/tinymce/tinymce.min.js

     "html_editor_init"

     HTML editor initialization

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.0 and later.

     Javascript excerpt that enables and configures the WYSIWYG HTML editor.

     Example:

       html_editor_init tinymce.init({selector:"#body",language:lang.split(/[^a-zA-Z]+/).join("_")});

     "max_wrong_password"

     Count limit of wrong password submission

     Format:
	 Any.

     Default:
	 19

     Context:
	 domain (robot.conf), site (sympa.conf)

     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 per-
     forms so many tries.

     "password_case"

     Password case

     Format:
	 Any.

     Default:
	 "insensitive"

     Context:
	 site (sympa.conf)

     "insensitive" or "sensitive".

     If set to "insensitive", WWSympa's password check will be insensitive. This
     only concerns passwords stored in the Sympa database, not the ones in LDAP.

     Should not be changed! May invalid all user password.

     "password_hash"

     Password hashing algorithm

     Format:
	 Any.

     Default:
	 "md5"

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.25b.3 and later.

     "md5" or "bcrypt".

     If set to "md5", Sympa will use MD5 password hashes. If set to "bcrypt",
     bcrypt hashes will be used instead. This only concerns passwords stored in
     the Sympa database, not the ones in LDAP.

     "password_hash_update"

     Update password hashing algorithm when users log in

     Format:
	 Any.

     Default:
	 1

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.25b.3 and later.

     On successful login, update the encrypted user password to use the algo-
     rithm specified by "password_hash". This allows for a graceful transition
     to a new password hash algorithm. A value of 0 disables updating of exist-
     ing password hashes.  New and reset passwords will use the "password_hash"
     setting in all cases.

     "bcrypt_cost"

     Bcrypt hash cost

     Format:
	 Any.

     Default:
	 12

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.25b.3 and later.

     When "password_hash" is set to "bcrypt", this sets the "cost" parameter of
     the bcrypt hash function. The default of 12 is expected to require approxi-
     mately 250ms to calculate the password hash on a 3.2GHz CPU. This only con-
     cerns passwords stored in the Sympa database, not the ones in LDAP.

     Can be changed but any new cost setting will only apply to new passwords.

     "one_time_ticket_lifetime"

     Age of one time ticket

     Format:
	 Any.

     Default:
	 "2d"

     Context:
	 site (sympa.conf)

     Duration before the one time tickets are expired

     "one_time_ticket_lockout"

     Restrict access to one time ticket

     Format:
	 Any.

     Default:
	 "one_time"

     Context:
	 domain (robot.conf), site (sympa.conf)

     Is access to the one time ticket restricted, if any users previously ac-
     cessed? (one_time | remote_addr | open)

     "purge_one_time_ticket_table_task"

     Task for expiring old one time tickets

     Format:
	 /"\w+"/

     Default:
	 "daily"

     Context:
	 site (sympa.conf)

     "one_time_ticket_table_ttl"

     Expiration period of one time ticket

     Format:
	 Any.

     Default:
	 "10d"

     Context:
	 site (sympa.conf)

     "pictures_max_size"

     The maximum size of uploaded picture

     Format:
	 Number of bytes.

     Default:
	 102400 (bytes)

     Context:
	 domain (robot.conf), site (sympa.conf)

     "spam_protection"

     Protect web interface against spam harvesters

     Format:
	 "at" - replace @ characters
	 "javascript" - use JavaScript
	 "none" - do nothing

     Default:
	 "javascript"

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     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:

     javascript:

     the address is hidden using a javascript. A user who enables javascript can
     see a nice mailto address where others have nothing.

     at:

     the @ char is replaced by the string " AT ".

     none:

     no protection against spammer.

     "reporting_spam_script_path"

     Script to report spam

     Format:
	 Any.

     Default:
	 None.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.0 and later.

     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.

     "domains_blocklist"

     Prevent people to subscribe to a list with addresses using these domains

     Format:
	 Any.

     Default:
	 None.

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.61b.1 and later.

     This parameter is a comma-separated list.

     Example:

       domains_blocklist example.org,spammer.com

     "quiet_subscription"

     Quiet subscriptions policy

     Format:
	 "on" - enabled
	 "optional" - optional
	 "off" - disabled

     Default:
	 "optional"

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.41b.1 and later.

     Global policy for quiet subscriptions: "on" means that subscriptions will
     never send a notice to the subscriber, "off" will enforce a notice sending,
     and "optional" (default) allows the use of the list policy.

     "show_report_abuse"

     Add a "Report abuse" link in the side menu of the lists

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.37b.3 and later.

     The link is a mailto link, you can change that by overriding web_tt2/re-
     port_abuse.tt2

     "allow_account_deletion"

     EXPERIMENTAL! Allow users to delete their account. If enabled, shows a
     "delete my account" form in user's preferences page.

     Format:
	 "on" - enabled
	 "off" - disabled

     Default:
	 "off"

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.41b.1 and later.

     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 LDAP, no SSO...). See https://github.com/sympa-com-
     munity/sympa/issues/300 for details

   Renamed parameters
     These parameters were renamed.  Though older names are still available,
     their use is no longer recommended.

     "arc_parameters.arc_private_key_path"

     See "arc_parameters.private_key_path".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.57b.1 to 6.2.70.

     "arc_parameters.arc_selector"

     See "arc_parameters.selector".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.57b.1 to 6.2.70.

     "arc_parameters.arc_signer_domain"

     See "arc_parameters.signer_domain".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.57b.1 to 6.2.70.

     "arc_private_key_path"

     See "arc_parameters.private_key_path".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.37b.1 to 6.2.56.

     "arc_selector"

     See "arc_parameters.selector".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.37b.1 to 6.2.56.

     "arc_signer_domain"

     See "arc_parameters.signer_domain".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2.37b.1 to 6.2.56.

     "archive_mail_access"

     See "archive.mail_access".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "archive_web_access"

     See "archive.web_access".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "bounce_halt_rate"

     See "bounce.halt_rate".

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "bounce_warn_rate"

     See "bounce.warn_rate".

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "custom-header"

     See "custom_header".

     Context:
	 Unknown.

     "custom-subject"

     See "custom_subject".

     Context:
	 Unknown.

     "d_edit"

     See "shared_doc.d_edit".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "d_read"

     See "shared_doc.d_read".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "default_archive_quota"

     See "archive.quota".

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "default_bounce_level1_rate"

     See "bouncers_level1.rate".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "default_bounce_level2_rate"

     See "bouncers_level2.rate".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "default_list_priority"

     See "priority".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "default_max_list_members"

     See "max_list_members".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "default_remind_task"

     See "remind_task".

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "default_shared_quota"

     See "shared_doc.quota".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "default_sql_fetch_timeout"

     See "sql_fetch_timeout".

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2a.0 to 6.2.56.

     "default_ttl"

     See "ttl".

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "dkim_private_key_path"

     See "dkim_parameters.private_key_path".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "dkim_selector"

     See "dkim_parameters.selector".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "dkim_signer_domain"

     See "dkim_parameters.signer_domain".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "dmarc_protection_domain_regex"

     See "dmarc_protection.domain_regex".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "dmarc_protection_mode"

     See "dmarc_protection.mode".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "dmarc_protection_other_email"

     See "dmarc_protection.other_email".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "dmarc_protection_phrase"

     See "dmarc_protection.phrase".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "domains_blacklist"

     See "domains_blocklist".

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2.41b.1 to 6.2.60.

     "email_gecos"

     See "gecos".

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2a.5 to 6.2a.33.

     "forced_reply-to"

     See "forced_reply_to".

     Context:
	 Unknown.

     "forced_replyto"

     See "forced_reply_to".

     Context:
	 Unknown.

     "key_password"

     See "key_passwd".

     Context:
	 site (sympa.conf)

     "log_socket_type"

     See "syslog_socket.type".

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.2.72.

     "max-size"

     See "max_size".

     Context:
	 Unknown.

     "merge_feature"

     See "personalization_feature".

     Context:
	 Unknown.

     Available versions:
	 6.0b.2 to 6.2.59b.1.

     "remind_return_path"

     See "verp_remind".

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 2.5 to 6.2.70.

     "reply-to"

     See "reply_to".

     Context:
	 Unknown.

     "replyto"

     See "reply_to".

     Context:
	 Unknown.

     "subscription"

     See "subscribe".

     Context:
	 Unknown.

     "tracking_default_retention_period"

     See "tracking.retention_period".

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2a.3 to 6.2.56.

     "tracking_delivery_status_notification"

     See "tracking.delivery_status_notification".

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2a.0 to 6.2.56.

     "tracking_message_delivery_notification"

     See "tracking_message_disposition_notification".

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2a.0 to 6.2a.40.

     "tracking_message_disposition_notification"

     See "tracking.message_disposition_notification".

     Context:
	 site (sympa.conf)

     Available versions:
	 6.2a.41 to 6.2.56.

     "unsubscription"

     See "unsubscribe".

     Context:
	 Unknown.

     "use_blacklist"

     See "use_blocklist".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 5.3a.4 to 6.2.60.

     "welcome_return_path"

     See "verp_welcome".

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 2.5 to 6.2.70.

   Deprecated parameters
     These parameters were deprecated. They may not be used anymore.

     "account"

     Deprecated.

     Context:
	 list (config)

     "antispam_feature"

     Deprecated.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.0a.1 to 6.2.70.

     "antispam_tag_header_ham_regexp"

     Deprecated.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.0a.1 to 6.1a.1.

     "antispam_tag_header_name"

     Deprecated.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.0a.1 to 6.1a.1.

     "antispam_tag_header_spam_regexp"

     Deprecated.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.0a.1 to 6.1a.1.

     "archived_pidfile"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.1.17.

     "automatic_list_prefix"

     Deprecated.

     Context:
	 site (sympa.conf)

     "bounced_pidfile"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.1.17.

     "clean_delay_queueother"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 5.4a.9 to 5.4.7.

     "color_0", ..., "color_15"

     See description on web interface.	Deprecated.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 5.1b to 6.2.70.

     "cookie"

     Deprecated.

     Context:
	 list (config), site (sympa.conf)

     Available versions:
	 up to 6.2.60.

     "dark_color", "light_color", "text_color", "bg_color", "error_color", "se-
     lected_color", "shaded_color"

     See description on web interface.	Deprecated.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 3.3a to 6.2.70.

     "default_distribution_ttl"

     Deprecated.

     Context:
	 site (sympa.conf)

     "distribution_mode"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 5.0a.1 to 6.2a.40.

     "edit_list"

     Deprecated.

     Context:
	 site (sympa.conf)

     "editor"

     Deprecated.

     Context:
	 list (config)

     Available versions:
	 up to 6.2.32.

     "expire_task"

     Deprecated.

     Context:
	 list (config)

     "filesystem_encoding"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 5.3a.7 to 6.2.52.

     "forced_reply_to"

     Deprecated.

     Context:
	 list (config)

     "host"

     Deprecated.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.32.

     "html_editor_file"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 6.0a.0 to 6.2a.33.

     "htmlarea_url"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.2.35b.1.

     "http_host"

     Deprecated.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.54.

     "include_list"

     Deprecated.

     Context:
	 list (config)

     Available versions:
	 2.2.6 to 6.2.15.

     "ldap_export_connection_timeout"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 3.3b.3 to 4.1?.

     "ldap_export_dnmanager"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 3.3b.3 to 4.1?.

     "ldap_export_host"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 3.3b.3 to 4.1?.

     "ldap_export_name"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 3.3b.3 to 4.1?.

     "ldap_export_password"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 3.3b.3 to 4.1?.

     "ldap_export_suffix"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 3.3b.3 to 4.1?.

     "localedir"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 4.2b.2 to 6.2a.32.

     "lock_method"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 5.3b.3 to 6.2a.33.

     "log_condition"

     Deprecated.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.29 to 6.2.41b.1.

     "log_module"

     Deprecated.

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 6.2a.29 to 6.2.41b.1.

     "msgcat"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 4.2b.1.

     "openssl"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.2a.40.

     "owner"

     Deprecated.

     Context:
	 list (config)

     Available versions:
	 up to 6.2.32.

     "pidfile"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.1.17.

     "pidfile_bulk"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.1.17.

     "pidfile_creation"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.1.17.

     "pidfile_distribute"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.1.17.

     "queuedistribute"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 5.0a.1 to 6.2a.40.

     "queueexpire"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 5.1.2.

     "reply_to"

     Deprecated.

     Context:
	 list (config)

     "sort"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 1.4.0 and later.

     "task_manager_pidfile"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.1.17.

     "tracking" (domain and site)

     See "tracking.tracking".

     Context:
	 domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2.56.

     "tri"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 1.3.4-1.

     "trusted_ca_options"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 3.3.5.

     "use_fast_cgi"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 6.2.22.

     "user_data_source"

     Deprecated.

     Context:
	 list (config)

     "web_archive"

     Deprecated.

     Context:
	 list (config), domain (robot.conf), site (sympa.conf)

     Available versions:
	 up to 6.2a.43.

     "web_recode_to"

     Deprecated.

     Context:
	 site (sympa.conf)

     Available versions:
	 up to 5.2.

FILES
     /usr/local/etc/sympa/sympa.conf
	 Sympa main configuration file.

     $SYSCONFDIR/<mail domain name>/robot.conf
	 Configuration specific to each mail domain.

     $EXPLDIR/<list name>/config or $EXPLDIR/<mail domain name>/<list name>/con-
     fig
	 List main configuration file.

SEE ALSO
     Sympa Administration Manual.  <https://www.sympa.community/manual/>.

     auth.conf(5), charset.conf(5), edit_list.conf(5), ldap_alias_man-
     ager.conf(5), nrcpt_by_domain.conf(5), sympa_scenario(5), topics.conf(5).

6.2.76				   2026-08-04			 SYMPA_CONFIG(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=sympa_config&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help