1SYMPA_CONFIG(5) sympa 6.2.72 SYMPA_CONFIG(5)
2
6 sympa_config - Configuration files for Sympa mailing list manager
7
9 There are three levels in Sympa's main configuration: site global, mail
10 domain and list.
11 sympa.conf: Configuration file for global settings
13 /etc/sympa/sympa.conf is main configuration file of Sympa. Several
14 parameters defined in this file may be overridden by robot.conf
15 configuration file for each virtual domain, or by config configuration
16 file for each mailing list.
17 Format of sympa.conf and robot.conf is as following:
19 • Lines beginning with "#" and containing only spaces are ignored.
21 • Each line has the form "parameter value". value may contain spaces
23 but may not contain newlines.
24 There are simple parameters and compound parameters.
26 The name of compound parameter consist of a paragraph name and a
28 sub-parameter name separated by period ("."). However some
29 compound parameters have simple synonym names to keep compatibility
30 to earlier versions (See "Obsoleted sympa.conf parameters").
31 Example:
33 process_archive on
35 archive.web_access open
36 archive.mail_access closed
37 robot.conf: Optional configuration file for the mail domain
39 robot.conf is the optional configuration file for each mail domain.
40 Format of robot.conf is the same as sympa.conf above.
42 config: Configuration file for the mailing list
44 config is main configuration file of each mailing list.
45 Format of config is as following:
47 • Lines beginning with "#" and containing only spaces are ignored.
49 • There are simple parameters and compound parameters:
51 • A simple parameter is expressed by single line by each. The
53 line has the form "parameter value". value may contain spaces
54 but may not contain newlines.
55 Several parameters may have multiple values. If it's the case,
57 values may be separated by comma (",") or parameter lines may
58 be repeated. Some of parameters must have one or more of
59 limited values.
60 Example:
62 subject This is subject of my list
64 remove_headers User-Agent,Importance
66 custom_headers X-List: mylist
68 custom_headers X-Face: %`-W7!?^]Sg'I-K>P<cdn&k:~A^{x>(]Gc{V...
69 rfc2369_header_fields post,owner
71 • A compound parameter is expressed by multiple lines, so-called
73 "paragraph", that consists of the first line specifying
74 paragraph name and subsequent one or more sub-parameter lines.
75 Paragraph must be separated by one or more empty lines from the
76 other parameters.
77 Several multiple line parameters may occur multiple times.
79 Example:
81 archive
83 web_access open
84 mail_access closed
85
87 Below is entire list of configuration parameters.
88 • Sub-parameters in paragraph are listed as paragraph"."sub-parameter
90 by each.
91 • "Default" is built-in default value if any. About symbols for
93 paths, such as $SENDMAIL_ALIASES, see "Directory layout
94 <https://www.sympa.community/manual/layout.html>".
95 Service description
97 "domain"
98 Primary mail domain name
100 Format:
102 /$domain/
103 Default:
105 None, mandatory.
106 Context:
108 domain (robot.conf), site (sympa.conf)
109 Example:
111 domain mail.example.org
113 "listmaster"
115 Email addresses of listmasters
117 Format:
119 Multiple values allowed, separated by "","".
120 /$email/
122 Default:
124 None, mandatory.
125 Context:
127 domain (robot.conf), site (sympa.conf)
128 Email addresses of the listmasters (users authorized to perform global
130 server commands). Some error reports may also be sent to these
131 addresses. Listmasters can be defined for each virtual host, however,
132 the default listmasters will have privileges to manage all virtual
133 hosts.
134 Example:
136 listmaster your_email_address@domain.tld
138 "supported_lang"
140 Supported languages
142 Format:
144 /"\w+(\-\w+)*"/
145 Default:
147 "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"
148 Context:
150 domain (robot.conf), site (sympa.conf)
151 All supported languages for the user interface. Languages proper locale
153 information not installed are ignored.
154 "title"
156 Title of service
158 Format:
160 /".+"/
161 Default:
163 "Mailing lists service"
164 Context:
166 domain (robot.conf), site (sympa.conf)
167 The name of your mailing list service. It will appear in the header of
169 web interface and subjects of several service messages.
170 "gecos"
172 Display name of Sympa
174 Format:
176 /".+"/
177 Default:
179 "SYMPA"
180 Context:
182 domain (robot.conf), site (sympa.conf)
183 Available versions:
185 6.2a.34 and later.
186 This parameter is used for display name in the "From:" header field for
188 the messages sent by Sympa itself.
189 "legacy_character_support_feature"
191 Support of legacy character set
193 Format:
195 "on" - enabled
196 "off" - disabled
197 Default:
198 "off"
199 Context:
201 site (sympa.conf)
202 If set to "on", enables support of legacy character set according to
204 charset.conf(5) configuration file.
205 In some language environments, legacy encoding (character set) can be
207 preferred for e-mail messages: for example iso-2022-jp in Japanese
208 language.
209 Database related
211 "update_db_field_types"
212 Update database structure
214 Format:
216 "auto" - automatic
217 "off" - disabled
218 Default:
219 "auto"
220 Context:
222 site (sympa.conf)
223 auto: Updates database table structures automatically.
225 However, since version 5.3b.5, Sympa will not shorten field size if it
227 already have been longer than the size defined in database definition.
228 "db_type"
230 Type of the database
232 Format:
234 /"\w+"/
235 Default:
237 "mysql"
238 Context:
240 site (sympa.conf)
241 Possible types are "MySQL", "PostgreSQL", "Oracle" and "SQLite".
243 "db_name"
245 Name of the database
247 Format:
249 /".+"/
250 Default:
252 "sympa"
253 Context:
255 site (sympa.conf)
256 With SQLite, this must be the full path to database file.
258 With Oracle Database, this must be SID, net service name or easy
260 connection identifier (to use net service name, db_host should be set
261 to "none" and HOST, PORT and SERVICE_NAME should be defined in
262 tnsnames.ora file).
263 "db_host"
265 Hostname of the database server
267 Format:
269 /$host/
270 Default:
272 None.
273 Context:
275 site (sympa.conf)
276 With PostgreSQL, you can also use the path to Unix Socket Directory,
278 e.g. "/var/run/postgresql" for connection with Unix domain socket.
279 Example:
281 db_host localhost
283 "db_port"
285 Port of the database server
287 Format:
289 /"[-/\w]+"/
290 Default:
292 None.
293 Context:
295 site (sympa.conf)
296 "db_user"
298 User for the database connection
300 Format:
302 /".+"/
303 Default:
305 None.
306 Context:
308 site (sympa.conf)
309 Example:
311 db_user sympa
313 "db_passwd"
315 Password for the database connection
317 Format:
319 The value to be concealed.
320 Default:
322 None.
323 Context:
325 site (sympa.conf)
326 What ever you use a password or not, you must protect the SQL server
328 (is it not a public internet service ?)
329 Example:
331 db_passwd your_passwd
333 "db_options"
335 Database options
337 Format:
339 /".+"/
340 Default:
342 None.
343 Context:
345 site (sympa.conf)
346 If these options are defined, they will be appended to data source name
348 (DSN) fed to database driver. Check the related DBD documentation to
349 learn about the available options.
350 Example:
352 db_options mysql_read_default_file=/home/joe/my.cnf;mysql_socket=tmp/mysql.sock-test
354 "db_env"
356 Environment variables setting for database
358 Format:
360 /".+"/
361 Default:
363 None.
364 Context:
366 site (sympa.conf)
367 With Oracle Database, this is useful for defining ORACLE_HOME and
369 NLS_LANG.
370 Example:
372 db_env NLS_LANG=American_America.AL32UTF8;ORACLE_HOME=/u01/app/oracle/product/11.2.0/server
374 "db_timeout"
376 Database processing timeout
378 Format:
380 /"\d+"/
381 Default:
383 None.
384 Context:
386 site (sympa.conf)
387 Currently, this parameter may be used for SQLite only.
389 "db_additional_subscriber_fields"
391 Database private extension to subscriber table
393 Format:
395 Multiple values allowed, separated by "","".
396 /".+"/
398 Default:
400 None.
401 Context:
403 site (sympa.conf)
404 Adds more fields to "subscriber_table" table. Sympa recognizes fields
406 defined with this parameter. You will then be able to use them from
407 within templates and scenarios:
408 * for scenarios: [subscriber->field]
410 * for templates: [% subscriber.field %]
412 These fields will also appear in the list members review page and will
414 be editable by the list owner. This parameter is a comma-separated
415 list.
416 You need to extend the database format with these fields
418 Example:
420 db_additional_subscriber_fields billing_delay,subscription_expiration
422 "db_additional_user_fields"
424 Database private extension to user table
426 Format:
428 Multiple values allowed, separated by "","".
429 /".+"/
431 Default:
433 None.
434 Context:
436 site (sympa.conf)
437 Adds more fields to "user_table" table. Sympa recognizes fields defined
439 with this parameter. You will then be able to use them from within
440 templates: [% subscriber.field %]
441 This parameter is a comma-separated list.
443 You need to extend the database format with these fields
445 Example:
447 db_additional_user_fields age,address
449 System log
451 "syslog"
452 System log facility for Sympa
454 Format:
456 /"\S+"/
457 Default:
459 "LOCAL1"
460 Context:
462 site (sympa.conf)
463 Do not forget to configure syslog server.
465 "log_socket_type"
467 Communication mode with syslog server
469 Format:
471 /"\w+"/
472 Default:
474 "unix"
475 Context:
477 site (sympa.conf)
478 "log_level"
480 Log verbosity
482 Format:
484 /"\d+"/
485 Default:
487 0
488 Context:
490 domain (robot.conf), site (sympa.conf)
491 Sets the verbosity of logs.
493 0: Only main operations are logged
495 3: Almost everything is logged.
497 Example:
499 log_level 2
501 Mail server
503 "sendmail"
504 Path to sendmail
506 Format:
508 /".+"/
509 Default:
511 "/usr/sbin/sendmail"
512 Context:
514 site (sympa.conf)
515 Absolute path to sendmail command line utility (e.g.: a binary named
517 "sendmail" is distributed with Postfix).
518 Sympa expects this binary to be sendmail compatible (exim, Postfix,
520 qmail and so on provide it).
521 "sendmail_args"
523 Command line parameters passed to sendmail
525 Format:
527 /".+"/
528 Default:
530 "-oi -odi -oem"
531 Context:
533 site (sympa.conf)
534 Note that "-f", "-N" and "-V" options and recipient addresses should
536 not be included, because they will be included by Sympa.
537 "sendmail_aliases"
539 Path of the file that contains all list related aliases
541 Format:
543 /".+"/
544 Default:
546 $SENDMAIL_ALIASES
547 Context:
549 domain (robot.conf), site (sympa.conf)
550 It is recommended to create a specific alias file so that Sympa never
552 overwrites the standard alias file, but only a dedicated file.
553 Set this parameter to "none" if you want to disable alias management in
555 Sympa.
556 "aliases_program"
558 Program used to update alias database
560 Format:
562 /"makemap|newaliases|postalias|postmap|/.+|none"/
563 Default:
565 "newaliases"
566 Context:
568 domain (robot.conf), site (sympa.conf)
569 This may be "makemap", "newaliases", "postalias", "postmap" or full
571 path to custom program.
572 "aliases_wrapper"
574 Whether to use the alias wrapper
576 Format:
578 "off" - disabled
579 "on" - enabled
580 Default:
581 "on"
582 Context:
584 domain (robot.conf), site (sympa.conf)
585 Available versions:
587 6.2.59b.1 and later.
588 If the program to update alias database does not require root
590 privileges, set this parameter to "off" and remove the wrapper file
591 sympa_newaliases-wrapper.
592 "aliases_db_type"
594 Type of alias database
596 Format:
598 /"\w[-\w]*"/
599 Default:
601 "hash"
602 Context:
604 domain (robot.conf), site (sympa.conf)
605 "btree", "dbm", "hash" and so on. Available when aliases_program is
607 "makemap", "postalias" or "postmap"
608 "alias_manager"
610 Path to alias manager
612 Format:
614 /".+"/
615 Default:
617 "$SBINDIR/alias_manager.pl"
618 Context:
620 site (sympa.conf)
621 The absolute path to the script that will add/remove mail aliases
623 Example:
625 alias_manager /usr/local/libexec/ldap_alias_manager.pl
627 List definition
629 "subject"
630 Subject of the list
632 Format:
634 /".+"/
635 Default:
637 None, mandatory.
638 Context:
640 list (config)
641 This parameter indicates the subject of the list, which is sent in
643 response to the LISTS mail command. The subject is a free form text
644 limited to one line.
645 "visibility"
647 Visibility of the list
649 Format:
651 Name of "visibility" scenario:
652 "conceal" - conceal except for subscribers
654 "noconceal" - no conceal
655 "secret" - conceal even for subscribers
656 Default:
657 "conceal"
658 Context:
660 list (config), domain (robot.conf), site (sympa.conf)
661 This parameter indicates whether the list should feature in the output
663 generated in response to a LISTS command or should be shown in the list
664 overview of the web-interface.
665 "topics"
667 Topics for the list
669 Format:
671 Multiple values allowed, separated by "","".
672 List topic.
674 Default:
676 None.
677 Context:
679 list (config)
680 This parameter allows the classification of lists. You may define
682 multiple topics as well as hierarchical ones. WWSympa's list of public
683 lists uses this parameter.
684 "lang"
686 Language of the list
688 Format:
690 Language tag.
691 Default:
693 "en-US"
694 Context:
696 list (config), domain (robot.conf), site (sympa.conf)
697 This parameter defines the language used for the list. It is used to
699 initialize a user's language preference; Sympa command reports are
700 extracted from the associated message catalog.
701 "family_name"
703 Family name
705 Format:
707 /$family_name/
708 Default:
710 None.
711 Context:
713 list (config)
714 "max_list_members"
716 Maximum number of list members
718 Format:
720 Number of list members.
721 Default:
723 0 (list members)
724 Context:
726 list (config), domain (robot.conf), site (sympa.conf)
727 Available versions:
729 6.2a.5 and later.
730 limit for the number of subscribers. 0 means no limit.
732 "priority"
734 Priority
736 Format:
738 0 - 0 - highest priority
739 1 - 1
740 2 - 2
741 3 - 3
742 4 - 4
743 5 - 5
744 6 - 6
745 7 - 7
746 8 - 8
747 9 - 9 - lowest priority
748 "z" - queue messages only
749 Default:
750 5
751 Context:
753 list (config), domain (robot.conf), site (sympa.conf)
754 The priority with which Sympa will process messages for this list. This
756 level of priority is applied while the message is going through the
757 spool. The z priority will freeze the message in the spool.
758 Receiving
760 "sender_headers"
761 Header field name(s) used to determine sender of the messages
763 Format:
765 Any.
766 Default:
768 "From"
769 Context:
771 site (sympa.conf)
772 "Return-Path" means envelope sender (a.k.a. "UNIX From") which will be
774 alternative to sender of messages without "From" field. "Resent-From"
775 may also be inserted before "From", because some mailers add it into
776 redirected messages and keep original "From" field intact. In
777 particular cases, "Return-Path" can not give right sender: Several mail
778 gateway products rewrite envelope sender and add original one as non-
779 standard field such as "X-Envelope-From". If that is the case, you
780 might want to insert it in place of "Return-Path".
781 Example:
783 sender_headers Resent-From,From,Return-Path
785 "misaddressed_commands"
787 Reject misaddressed commands
789 Format:
791 Any.
792 Default:
794 "reject"
795 Context:
797 site (sympa.conf)
798 When a mail command is sent to a list, by default Sympa rejects this
800 message. This feature can be turned off by setting this parameter to
801 "ignore".
802 "misaddressed_commands_regexp"
804 Regular expression matching with misaddressed commands
806 Format:
808 Any.
809 Default:
811 "((subscribe\s+(\S+)|unsubscribe\s+(\S+)|signoff\s+(\S+)|set\s+(\S+)\s+(mail|nomail|digest))\s*)"
812 Context:
814 site (sympa.conf)
815 Perl regular expression applied on messages subject and body to detect
817 misaddressed commands.
818 "sympa_priority"
820 Priority for command messages
822 Format:
824 0 - 0 - highest priority
825 1 - 1
826 2 - 2
827 3 - 3
828 4 - 4
829 5 - 5
830 6 - 6
831 7 - 7
832 8 - 8
833 9 - 9 - lowest priority
834 "z" - queue messages only
835 Default:
836 1
837 Context:
839 domain (robot.conf), site (sympa.conf)
840 Priority applied to messages sent to Sympa command address.
842 "request_priority"
844 Priority for messages bound for list owners
846 Format:
848 0 - 0 - highest priority
849 1 - 1
850 2 - 2
851 3 - 3
852 4 - 4
853 5 - 5
854 6 - 6
855 7 - 7
856 8 - 8
857 9 - 9 - lowest priority
858 "z" - queue messages only
859 Default:
860 0
861 Context:
863 domain (robot.conf), site (sympa.conf)
864 Priority for processing of messages bound for "LIST-request" address,
866 i.e. owners of the list
867 "owner_priority"
869 Priority for non-VERP bounces
871 Format:
873 0 - 0 - highest priority
874 1 - 1
875 2 - 2
876 3 - 3
877 4 - 4
878 5 - 5
879 6 - 6
880 7 - 7
881 8 - 8
882 9 - 9 - lowest priority
883 "z" - queue messages only
884 Default:
885 9
886 Context:
888 domain (robot.conf), site (sympa.conf)
889 Priority for processing of messages bound for "LIST-owner" address,
891 i.e. non-delivery reports (bounces).
892 "incoming_max_count"
894 Max number of sympa_msg.pl workers
896 Format:
898 /"\d+"/
899 Default:
901 1
902 Context:
904 site (sympa.conf)
905 Available versions:
907 6.2b.5 and later.
908 Max number of workers of sympa_msg.pl daemon processing incoming spool.
910 "sleep"
912 Interval between scanning incoming message spool
914 Format:
916 Number of seconds.
917 Default:
919 5 (seconds)
920 Context:
922 site (sympa.conf)
923 Must not be 0.
925 Sending/receiving setup
927 "send"
928 Who can send messages
930 Format:
932 Name of "send" scenario:
933 "closed" - closed
935 "confidential" - restricted to subscribers, messages from others
936 are discarded
937 "editorkey" - Moderated
938 "editorkeyonly" - Moderated, even for moderators
939 "editorkeyonlyauth" - Moderated, need authentication from moderator
940 "newsletter" - Newsletter, restricted to moderators
941 "newsletterkeyonly" - Newsletter, restricted to moderators after
942 confirmation
943 "owner" - Restricted to list owners only
944 "ownerauth" - Restricted to list owners with previous MD5
945 authentication
946 "private" - restricted to subscribers
947 "private_smime" - restricted to subscribers and checked smime
948 signature
949 "privateandeditorkey" - Moderated, restricted to subscribers
950 "privateandnomultipartoreditorkey" - Moderated, for non subscribers
951 sending multipart messages
952 "privatekey" - restricted to subscribers with previous md5
953 authentication
954 "privatekeyandeditorkeyonly" - Moderated, for subscribers and even
955 moderators themself
956 "privateoreditorkey" - Private, moderated for non subscribers
957 "privateorpublickey" - Private, confirmation for non subscribers
958 "public" - public list
959 "public_nobcc" - public list, Bcc rejected (anti-spam)
960 "publickey" - anyone no authentication if DKIM signature is OK
961 "publicnoattachment" - public list multipart/mixed messages are
962 forwarded to moderator
963 "publicnomultipart" - public list multipart messages are rejected
964 Default:
965 "private"
966 Context:
968 list (config), domain (robot.conf), site (sympa.conf)
969 This parameter specifies who can send messages to the list.
971 "delivery_time"
973 Delivery time (hh:mm)
975 Format:
977 /"[0-2]?\d\:[0-6]\d"/
978 Default:
980 None.
981 Context:
983 list (config)
984 If this parameter is present, non-digest messages will be delivered to
986 subscribers at this time: When this time has been past, delivery is
987 postponed to the same time in next day.
988 "digest"
990 (Paragraph) Digest frequency
992 Single occurrence
994 Definition of digest mode. If this parameter is present, subscribers
996 can select the option of receiving messages in multipart/digest MIME
997 format, or as a plain text digest. Messages are then grouped together,
998 and compiled messages are sent to subscribers according to the
999 frequency selected with this parameter.
1000 "digest.days"
1002 days
1004 Format:
1006 Multiple occurrences allowed.
1007 Day of week, 0 - 6.
1009 Default:
1011 None, mandatory.
1012 Context:
1014 list (config)
1015 "digest.hour"
1017 hour
1019 Format:
1021 /"\d+"/
1022 Default:
1024 None, mandatory.
1025 Context:
1027 list (config)
1028 "digest.minute"
1030 minute
1032 Format:
1034 /"\d+"/
1035 Default:
1037 None, mandatory.
1038 Context:
1040 list (config)
1041 "digest_max_size"
1043 Digest maximum number of messages
1045 Format:
1047 Number of messages.
1048 Default:
1050 25 (messages)
1051 Context:
1053 list (config)
1054 "available_user_options"
1056 (Paragraph) Available subscription options
1058 Single occurrence
1060 "available_user_options.reception"
1062 reception mode
1064 Format:
1066 Multiple values allowed, separated by "","".
1067 Reception mode of list member.
1069 Default:
1071 "mail,notice,digest,digestplain,summary,nomail,txt,urlize,not_me"
1072 Context:
1074 list (config)
1075 Only these modes will be allowed for the subscribers of this list. If a
1077 subscriber has a reception mode not in the list, Sympa uses the mode
1078 specified in the default_user_options paragraph.
1079 "default_user_options"
1081 (Paragraph) Subscription profile
1083 Single occurrence
1085 Default profile for the subscribers of the list.
1087 "default_user_options.reception"
1089 reception mode
1091 Format:
1093 Reception mode of list member.
1094 Default:
1096 "mail"
1097 Context:
1099 list (config)
1100 Mail reception mode.
1102 "default_user_options.visibility"
1104 visibility
1106 Format:
1108 Visibility mode of list member.
1109 Default:
1111 "noconceal"
1112 Context:
1114 list (config)
1115 Visibility of the subscriber.
1117 "msg_topic"
1119 (Paragraph) Topics for message categorization
1121 Multiple occurrences allowed
1123 This paragraph defines a topic used to tag a message of a list, named
1125 by msg_topic.name ("other" is a reserved word), its title is
1126 msg_topic.title. The msg_topic.keywords entry is optional and allows
1127 automatic tagging. This should be a list of keywords, separated by ','.
1128 "msg_topic.name"
1130 Message topic name
1132 Format:
1134 /"[\-\w]+"/
1135 Default:
1137 None, mandatory.
1138 Context:
1140 list (config)
1141 "msg_topic.keywords"
1143 Message topic keywords
1145 Format:
1147 /"[^,\n]+(,[^,\n]+)*"/
1148 Default:
1150 None.
1151 Context:
1153 list (config)
1154 "msg_topic.title"
1156 Message topic title
1158 Format:
1160 /".+"/
1161 Default:
1163 None, mandatory.
1164 Context:
1166 list (config)
1167 "msg_topic_keywords_apply_on"
1169 Defines to which part of messages topic keywords are applied
1171 Format:
1173 "subject" - subject field
1174 "body" - message body
1175 "subject_and_body" - subject and body
1176 Default:
1177 "subject"
1178 Context:
1180 list (config)
1181 This parameter indicates which part of the message is used to perform
1183 automatic tagging.
1184 "msg_topic_tagging"
1186 Message tagging
1188 Format:
1190 "required_sender" - required to post message
1191 "required_moderator" - required to distribute message
1192 "optional" - optional
1193 Default:
1194 "optional"
1195 Context:
1197 list (config)
1198 This parameter indicates if the tagging is optional or required for a
1200 list.
1201 "reply_to_header"
1203 (Paragraph) Reply address
1205 Single occurrence
1207 This defines what Sympa will place in the Reply-To: SMTP header field
1209 of the messages it distributes.
1210 "reply_to_header.value"
1212 value
1214 Format:
1216 "sender" - sender
1217 "list" - list
1218 "all" - all
1219 "other_email" - other email address
1220 Default:
1221 "sender"
1222 Context:
1224 list (config)
1225 This parameter indicates whether the Reply-To: field should indicate
1227 the sender of the message (sender), the list itself (list), both list
1228 and sender (all) or an arbitrary e-mail address (defined by the
1229 other_email parameter).
1230 Note: it is inadvisable to change this parameter, and particularly
1232 inadvisable to set it to list. Experience has shown it to be almost
1233 inevitable that users, mistakenly believing that they are replying only
1234 to the sender, will send private messages to a list. This can lead, at
1235 the very least, to embarrassment, and sometimes to more serious
1236 consequences.
1237 "reply_to_header.other_email"
1239 other email address
1241 Format:
1243 /$email/
1244 Default:
1246 None.
1247 Context:
1249 list (config)
1250 If value was set to other_email, this parameter defines the e-mail
1252 address used.
1253 "reply_to_header.apply"
1255 respect of existing header field
1257 Format:
1259 "forced" - overwrite Reply-To: header field
1260 "respect" - preserve existing header field
1261 Default:
1262 "respect"
1263 Context:
1265 list (config)
1266 The default is to respect (preserve) the existing Reply-To: SMTP header
1268 field in incoming messages. If set to forced, Reply-To: SMTP header
1269 field will be overwritten.
1270 "anonymous_sender"
1272 Anonymous sender
1274 Format:
1276 /".+"/
1277 Default:
1279 None.
1280 Context:
1282 list (config)
1283 To hide the sender's email address before distributing the message. It
1285 is replaced by the provided email address.
1286 "anonymous_header_fields"
1288 Header fields removed when a mailing list is setup in anonymous mode
1290 Format:
1292 Any.
1293 Default:
1295 "ARC-Authentication-Results,ARC-Message-Signature,ARC-Seal,Authentication-Results,Disposition-Notification-To,DKIM-Signature,Domainkey-Signature,Fax,Injection-Info,Mailer,Organisation,Organization,Original-Recipient,Originating-Client,Originator,Path,Phone,Received,Received-SPF,Reply-To,Resent-Reply-To,Return-Receipt-To,Telefax,User-Agent,X-Envelope-From,X-Envelope-To,X-Face,X-Mailer,X-MimeOLE,X-Newsreader,X-Sender,X-X-Sender"
1296 Context:
1298 site (sympa.conf)
1299 "custom_header"
1301 Custom header field
1303 Format:
1305 Multiple occurrences allowed.
1306 /"\S+:\s+.*"/
1308 Default:
1310 None.
1311 Context:
1313 list (config)
1314 This parameter is optional. The headers specified will be added to the
1316 headers of messages distributed via the list. As of release 1.2.2 of
1317 Sympa, it is possible to put several custom header lines in the
1318 configuration file at the same time.
1319 "custom_subject"
1321 Subject tagging
1323 Format:
1325 /".+"/
1326 Default:
1328 None.
1329 Context:
1331 list (config)
1332 This parameter is optional. It specifies a string which is added to the
1334 subject of distributed messages (intended to help users who do not use
1335 automatic tools to sort incoming messages). This string will be
1336 surrounded by [] characters.
1337 "footer_type"
1339 Attachment type
1341 Format:
1343 "mime" - add a new MIME part
1344 "append" - append to message body
1345 Default:
1346 "mime"
1347 Context:
1349 list (config)
1350 List owners may decide to add message headers or footers to messages
1352 sent via the list. This parameter defines the way a footer/header is
1353 added to a message.
1354 mime:
1356 The default value. Sympa will add the footer/header as a new MIME part.
1358 append:
1360 Sympa will not create new MIME parts, but will try to append the
1362 header/footer to the body of the message. Predefined message-footers
1363 will be ignored.
1364 "max_size"
1366 Maximum message size
1368 Format:
1370 Number of bytes.
1371 Default:
1373 5242880 (bytes)
1374 Context:
1376 list (config), domain (robot.conf), host
1377 Maximum size of a message in 8-bit bytes.
1379 Example:
1381 max_size 2097152
1383 "personalization_feature"
1385 Allow message personalization
1387 Format:
1389 "on" - enabled
1390 "off" - disabled
1391 Default:
1392 "off"
1393 Context:
1395 list (config), domain (robot.conf), site (sympa.conf)
1396 Available versions:
1398 6.2.59b.2 and later.
1399 "personalization"
1401 (Paragraph) Message personalization
1403 Single occurrence
1405 "personalization.web_apply_on"
1407 Scope for messages from the web interface
1409 Format:
1411 "none" - do nothing
1412 "footer" - header and footer
1413 "all" - all
1414 Default:
1415 "footer"
1416 Context:
1418 list (config), domain (robot.conf), site (sympa.conf)
1419 "personalization.mail_apply_on"
1421 Scope for messages from incoming email
1423 Format:
1425 "none" - do nothing
1426 "footer" - header and footer
1427 "all" - all
1428 Default:
1429 "none"
1430 Context:
1432 list (config), domain (robot.conf), site (sympa.conf)
1433 "message_hook"
1435 (Paragraph) Hook modules for message processing
1437 Single occurrence
1439 "message_hook.pre_distribute"
1441 A hook on the messages before distribution
1443 Format:
1445 /"(::|\w)+"/
1446 Default:
1448 None.
1449 Context:
1451 list (config)
1452 "message_hook.post_archive"
1454 A hook on the messages just after archiving
1456 Format:
1458 /"(::|\w)+"/
1459 Default:
1461 None.
1462 Context:
1464 list (config)
1465 "reject_mail_from_automates_feature"
1467 Reject mail from automatic processes (crontab, etc)?
1469 Format:
1471 "on" - enabled
1472 "off" - disabled
1473 Default:
1474 "on"
1475 Context:
1477 list (config), site (sympa.conf)
1478 Available versions:
1480 6.2a.0 and later.
1481 Rejects messages that seem to be from automated services, based on a
1483 few header fields ("Content-Identifier:", "Auto-Submitted:").
1484 Sympa also can be configured to reject messages based on the "From:"
1486 header field value (see "loop_prevention_regex").
1487 "remove_headers"
1489 Header fields to be removed from incoming messages
1491 Format:
1493 Multiple values allowed, separated by "","".
1494 /"\S+"/
1496 Default:
1498 "X-Sympa-To,X-Family-To,Return-Receipt-To,Precedence,X-Sequence,Disposition-Notification-To,Sender"
1499 Context:
1501 list (config), site (sympa.conf)
1502 Use it, for example, to ensure some privacy for your users in case that
1504 "anonymous_sender" mode is inappropriate.
1505 The removal of these header fields is applied before Sympa adds its own
1507 header fields ("rfc2369_header_fields" and "custom_header").
1508 Example:
1510 remove_headers Resent-Date,Resent-From,Resent-To,Resent-Message-Id,Sender,Delivered-To
1512 "remove_outgoing_headers"
1514 Header fields to be removed before message distribution
1516 Format:
1518 Multiple values allowed, separated by "","".
1519 /"\S+"/
1521 Default:
1523 "none"
1524 Context:
1526 list (config), site (sympa.conf)
1527 The removal happens after Sympa's own header fields are added;
1529 therefore, it is a convenient way to remove Sympa's own header fields
1530 (like "X-Loop:" or "X-no-archive:") if you wish.
1531 Example:
1533 remove_outgoing_headers X-no-archive
1535 "rfc2369_header_fields"
1537 RFC 2369 header fields
1539 Format:
1541 Multiple values allowed, separated by "","".
1542 "help" - help
1544 "subscribe" - subscription
1545 "unsubscribe" - unsubscription
1546 "post" - posting address
1547 "owner" - owner
1548 "archive" - list archive
1549 Default:
1550 "help,subscribe,unsubscribe,post,owner,archive"
1551 Context:
1553 list (config), site (sympa.conf)
1554 Specify which RFC 2369 mailing list header fields to be added.
1556 "List-Id:" header field defined in RFC 2919 is always added. Sympa also
1558 adds "Archived-At:" header field defined in RFC 5064.
1559 Distribution
1561 "urlize_min_size"
1562 Minimum size to be urlized
1564 Format:
1566 Number of bytes.
1567 Default:
1569 10240 (bytes)
1570 Context:
1572 domain (robot.conf), site (sympa.conf)
1573 When a subscriber chose "urlize" reception mode, attachments not
1575 smaller than this size will be urlized.
1576 "allowed_external_origin"
1578 Allowed external links in sanitized HTML
1580 Format:
1582 /"(?:[^\@]+\@)?[-\w*]+(?:[.][-\w*]+)*(?:[:][\d*]+)?"/
1583 Default:
1585 None.
1586 Context:
1588 domain (robot.conf), site (sympa.conf)
1589 Available versions:
1591 6.2.19b.2 and later.
1592 When the HTML content of a message must be sanitized, links ("href" or
1594 "src" attributes) with the hosts listed in this parameter will not be
1595 scrubbed. If "*" character is included, it matches any subdomains.
1596 Single "*" allows any hosts.
1597 Example:
1599 allowed_external_origin *.example.org,www.example.com
1601 "sympa_packet_priority"
1603 Default priority for a packet
1605 Format:
1607 0 - 0 - highest priority
1608 1 - 1
1609 2 - 2
1610 3 - 3
1611 4 - 4
1612 5 - 5
1613 6 - 6
1614 7 - 7
1615 8 - 8
1616 9 - 9 - lowest priority
1617 "z" - queue messages only
1618 Default:
1619 5
1620 Context:
1622 domain (robot.conf), site (sympa.conf)
1623 The default priority set to a packet to be sent by the bulk.
1625 "bulk_fork_threshold"
1627 Fork threshold of bulk daemon
1629 Format:
1631 /"\d+"/
1632 Default:
1634 1
1635 Context:
1637 site (sympa.conf)
1638 The minimum number of packets before bulk daemon forks a new worker to
1640 increase sending rate.
1641 "bulk_max_count"
1643 Maximum number of bulk workers
1645 Format:
1647 /"\d+"/
1648 Default:
1650 3
1651 Context:
1653 site (sympa.conf)
1654 "bulk_lazytime"
1656 Idle timeout of bulk workers
1658 Format:
1660 Number of seconds.
1661 Default:
1663 600 (seconds)
1664 Context:
1666 site (sympa.conf)
1667 The number of seconds a bulk worker will remain running without
1669 processing a message before it spontaneously exits.
1670 "bulk_sleep"
1672 Sleep time of bulk workers
1674 Format:
1676 Number of seconds.
1677 Default:
1679 1 (seconds)
1680 Context:
1682 site (sympa.conf)
1683 The number of seconds a bulk worker sleeps between starting a new loop
1685 if it didn't find a message to send.
1686 Keep it small if you want your server to be reactive.
1688 "bulk_wait_to_fork"
1690 Interval between checks of packet numbers
1692 Format:
1694 Number of seconds.
1695 Default:
1697 10 (seconds)
1698 Context:
1700 site (sympa.conf)
1701 Number of seconds a master bulk daemon waits between two packets number
1703 checks.
1704 Keep it small if you expect brutal increases in the message sending
1706 load.
1707 "log_smtp"
1709 Log invocation of sendmail
1711 Format:
1713 "on" - enabled
1714 "off" - disabled
1715 Default:
1716 "off"
1717 Context:
1719 domain (robot.conf), site (sympa.conf)
1720 This can be overwritten by "-m" option for sympa.pl.
1722 "maxsmtp"
1724 Maximum number of sendmail processes
1726 Format:
1728 /"\d+"/
1729 Default:
1731 40
1732 Context:
1734 site (sympa.conf)
1735 Maximum number of simultaneous child processes spawned by Sympa. This
1737 is the main load control parameter.
1738 Proposed value is quite low, but you can rise it up to 100, 200 or even
1740 300 with powerful systems.
1741 Example:
1743 maxsmtp 500
1745 "nrcpt"
1747 Maximum number of recipients per call to sendmail
1749 Format:
1751 /"\d+"/
1752 Default:
1754 25
1755 Context:
1757 site (sympa.conf)
1758 This grouping factor makes it possible for the sendmail processes to
1760 optimize the number of SMTP sessions for message distribution. If
1761 needed, you can limit the number of recipients for a particular domain.
1762 Check the "nrcpt_by_domain.conf" configuration file.
1763 "avg"
1765 Maximum number of different mail domains per call to sendmail
1767 Format:
1769 /"\d+"/
1770 Default:
1772 10
1773 Context:
1775 site (sympa.conf)
1776 Privileges
1778 "create_list"
1779 Who is able to create lists
1781 Format:
1783 Name of "create_list" scenario:
1784 "listmaster" - restricted to listmaster
1786 "public_listmaster" - anybody by validation by listmaster required
1787 Default:
1788 "public_listmaster"
1789 Context:
1791 domain (robot.conf), site (sympa.conf)
1792 Defines who can create lists (or request list creation) by creating new
1794 lists or by renaming or copying existing lists.
1795 Example:
1797 create_list listmaster
1799 "allow_subscribe_if_pending"
1801 Allow adding subscribers to a list not open
1803 Format:
1805 "on" - enabled
1806 "off" - disabled
1807 Default:
1808 "on"
1809 Context:
1811 domain (robot.conf), site (sympa.conf)
1812 If set to "off", adding subscribers to, or removing subscribers from a
1814 list with status other than "open" is forbidden.
1815 "global_remind"
1817 Who is able to send remind messages over all lists
1819 Format:
1821 Name of "global_remind" scenario:
1822 "listmaster" - only for listmaster
1824 Default:
1825 "listmaster"
1826 Context:
1828 site (sympa.conf)
1829 "move_user"
1831 Who is able to change user's email
1833 Format:
1835 Name of "move_user" scenario:
1836 "auth" - need authentication
1838 "closed" - impossible
1839 "listmaster" - listmaster only
1840 Default:
1841 "auth"
1842 Context:
1844 domain (robot.conf), site (sympa.conf)
1845 Available versions:
1847 6.2.19b.1 and later.
1848 "use_blocklist"
1850 Use blocklist
1852 Format:
1854 /"[-.\w]+"/
1855 Default:
1857 "send,create_list"
1858 Context:
1860 domain (robot.conf), site (sympa.conf)
1861 Available versions:
1863 6.2.61b.1 and later.
1864 List of operations separated by comma for which blocklist filter is
1866 applied. Setting this parameter to "none" will hide the blocklist
1867 feature.
1868 "info"
1870 Who can view list information
1872 Format:
1874 Name of "info" scenario:
1875 "conceal" - restricted to subscribers - Silent rejection otherwise.
1877 "open" - for anyone
1878 "private" - restricted to subscribers
1879 Default:
1880 "open"
1881 Context:
1883 list (config), domain (robot.conf), site (sympa.conf)
1884 "subscribe"
1886 Who can subscribe to the list
1888 Format:
1890 Name of "subscribe" scenario:
1891 "auth" - subscription request confirmed
1893 "auth_notify" - need authentication (notification is sent to
1894 owners)
1895 "auth_owner" - requires authentication then owner approval
1896 "closed" - subscription is impossible
1897 "open" - for anyone without authentication
1898 "open_notify" - anyone, notification is sent to list owner
1899 "open_quiet" - anyone, no welcome message
1900 "owner" - owners approval
1901 "smime" - requires S/MIME signed
1902 "smimeorowner" - requires S/MIME signed or owner approval
1903 Default:
1904 "open"
1905 Context:
1907 list (config), domain (robot.conf), site (sympa.conf)
1908 The subscribe parameter defines the rules for subscribing to the list.
1910 "add"
1912 Who can add subscribers
1914 Format:
1916 Name of "add" scenario:
1917 "auth" - restricted to owner with authentication
1919 "closed" - add impossible
1920 "owner" - add performed by list owner does not need authentication
1921 "owner_notify" - add performed by owner does not need
1922 authentication (notification)
1923 Default:
1924 "owner"
1925 Context:
1927 list (config), domain (robot.conf), site (sympa.conf)
1928 Privilege for adding (ADD command) a subscriber to the list
1930 "unsubscribe"
1932 Who can unsubscribe
1934 Format:
1936 Name of "unsubscribe" scenario:
1937 "auth" - need authentication
1939 "auth_notify" - authentication requested, notification sent to
1940 owner
1941 "closed" - impossible
1942 "open" - open
1943 "open_notify" - open with mail confirmation, owner is notified
1944 "owner" - owners approval
1945 Default:
1946 "open"
1947 Context:
1949 list (config), domain (robot.conf), site (sympa.conf)
1950 This parameter specifies the unsubscription method for the list. Use
1952 open_notify or auth_notify to allow owner notification of each
1953 unsubscribe command.
1954 "del"
1956 Who can delete subscribers
1958 Format:
1960 Name of "del" scenario:
1961 "auth" - deletion performed only by list owners, need
1963 authentication
1964 "closed" - remove subscriber impossible
1965 "owner" - by owner without authentication
1966 "owner_notify" - list owners, authentication not needed
1967 (notification)
1968 Default:
1969 "owner"
1970 Context:
1972 list (config), domain (robot.conf), site (sympa.conf)
1973 "invite"
1975 Who can invite people
1977 Format:
1979 Name of "invite" scenario:
1980 "closed" - closed
1982 "owner" - invite perform by list owner do not need authentication
1983 "private" - restricted to subscribers
1984 "public" - public
1985 Default:
1986 "private"
1987 Context:
1989 list (config), domain (robot.conf), site (sympa.conf)
1990 "remind"
1992 Who can start a remind process
1994 Format:
1996 Name of "remind" scenario:
1997 "listmaster" - listmaster only
1999 "owner" - restricted to list owners
2000 Default:
2001 "owner"
2002 Context:
2004 list (config), domain (robot.conf), site (sympa.conf)
2005 This parameter specifies who is authorized to use the remind command.
2007 "review"
2009 Who can review subscribers
2011 Format:
2013 Name of "review" scenario:
2014 "closed" - no one can review
2016 "listmaster" - listmaster only
2017 "owner" - only owner (and listmaster)
2018 "private" - restricted to subscribers
2019 "public" - anyone can do it!
2020 Default:
2021 "owner"
2022 Context:
2024 list (config), domain (robot.conf), site (sympa.conf)
2025 This parameter specifies who can access the list of members. Since
2027 subscriber addresses can be abused by spammers, it is strongly
2028 recommended that you only authorize owners or subscribers to access the
2029 subscriber list.
2030 "owner_domain"
2032 Required domains for list owners
2034 Format:
2036 /"$host( +$host)*"/
2037 Default:
2039 None.
2040 Context:
2042 list (config), domain (robot.conf), site (sympa.conf)
2043 Available versions:
2045 6.2.23b.3 and later.
2046 Restrict list ownership to addresses in the specified domains. This can
2048 be used to reserve list ownership to a group of trusted users from a
2049 set of domains associated with an organization, while allowing
2050 moderators and subscribers from the Internet at large.
2051 "owner_domain_min"
2053 Minimum owners in required domains
2055 Format:
2057 /"\d+"/
2058 Default:
2060 0
2061 Context:
2063 list (config), domain (robot.conf), site (sympa.conf)
2064 Available versions:
2066 6.2.23b.3 and later.
2067 Minimum number of owners for each list must satisfy the owner_domain
2069 restriction. The default of zero (0) means *all* list owners must
2070 match. Setting to 1 requires only one list owner to match owner_domain;
2071 all other owners can be from any domain. This setting can be used to
2072 ensure that there is always at least one known contact point for any
2073 mailing list.
2074 "default_owner_options"
2076 (Paragraph) Owner profile
2078 Single occurrence
2080 Default profile for the owners of the list.
2082 "default_owner_options.profile"
2084 profile
2086 Format:
2088 "privileged" - privileged owner
2089 "normal" - normal owner
2090 Default:
2091 "normal"
2092 Context:
2094 list (config), domain (robot.conf), site (sympa.conf)
2095 "default_owner_options.reception"
2097 reception mode
2099 Format:
2101 "mail" - receive notification email
2102 "nomail" - no notifications
2103 Default:
2104 "mail"
2105 Context:
2107 list (config), domain (robot.conf), site (sympa.conf)
2108 Mail reception mode.
2110 "default_owner_options.visibility"
2112 visibility
2114 Format:
2116 "conceal" - concealed from list menu
2117 "noconceal" - listed on the list menu
2118 Default:
2119 "noconceal"
2120 Context:
2122 list (config), domain (robot.conf), site (sympa.conf)
2123 Visibility of the owner.
2125 "default_editor_options"
2127 (Paragraph) Moderator profile
2129 Single occurrence
2131 Default profile for the moderators of the list.
2133 "default_editor_options.reception"
2135 reception mode
2137 Format:
2139 "mail" - receive notification email
2140 "nomail" - no notifications
2141 Default:
2142 "mail"
2143 Context:
2145 list (config), domain (robot.conf), site (sympa.conf)
2146 Mail reception mode.
2148 "default_editor_options.visibility"
2150 visibility
2152 Format:
2154 "conceal" - concealed from list menu
2155 "noconceal" - listed on the list menu
2156 Default:
2157 "noconceal"
2158 Context:
2160 list (config), domain (robot.conf), site (sympa.conf)
2161 Visibility of the moderator.
2163 Archives
2165 "ignore_x_no_archive_header_feature"
2166 Ignore "X-no-archive:" header field
2168 Format:
2170 "on" - enabled
2171 "off" - disabled
2172 Default:
2173 "off"
2174 Context:
2176 site (sympa.conf)
2177 Sympa's default behavior is to skip archiving of incoming messages that
2179 have an "X-no-archive:" header field set. This parameter allows one to
2180 change this behavior.
2181 Example:
2183 ignore_x_no_archive_header_feature on
2185 "custom_archiver"
2187 Custom archiver
2189 Format:
2191 /".+"/
2192 Default:
2194 None.
2195 Context:
2197 site (sympa.conf)
2198 Activates a custom archiver to use instead of MHonArc. The value of
2200 this parameter is the absolute path to the executable file.
2201 Sympa invokes this file with these two arguments:
2203 --list
2205 The address of the list including domain part.
2207 --file
2209 Absolute path to the message to be archived.
2211 "process_archive"
2213 Store distributed messages into archive
2215 Format:
2217 "on" - enabled
2218 "off" - disabled
2219 Default:
2220 "off"
2221 Context:
2223 list (config), domain (robot.conf), site (sympa.conf)
2224 Available versions:
2226 6.2b.1 and later.
2227 If enabled, distributed messages via lists will be archived. Otherwise
2229 archiving is disabled.
2230 Note that even if setting this parameter disabled, past archives will
2232 not be removed and will be accessible according to access settings by
2233 each list.
2234 "archive"
2236 (Paragraph) Archives
2238 Single occurrence
2240 Privilege for reading mail archives and frequency of archiving.
2242 Defines who can access the list's web archive.
2244 "archive.period"
2246 Deprecated.
2248 Context:
2250 list (config)
2251 "archive.access"
2253 Deprecated.
2255 Context:
2257 list (config)
2258 Available versions:
2260 up to 6.2a.43.
2261 "archive.web_access"
2263 access right
2265 Format:
2267 Name of "archive_web_access" scenario:
2268 "closed" - closed
2270 "listmaster" - listmaster
2271 "owner" - by owner
2272 "private" - subscribers only
2273 "public" - public
2274 Default:
2275 "closed"
2276 Context:
2278 list (config), domain (robot.conf), site (sympa.conf)
2279 Available versions:
2281 6.2b.1 and later.
2282 "archive.mail_access"
2284 access right by mail commands
2286 Format:
2288 Name of "archive_mail_access" scenario:
2289 "closed" - closed
2291 "owner" - by owner
2292 "private" - subscribers only
2293 "public" - public
2294 Default:
2295 "closed"
2296 Context:
2298 list (config), domain (robot.conf), site (sympa.conf)
2299 Available versions:
2301 6.2b.1 and later.
2302 "archive.quota"
2304 quota
2306 Format:
2308 Number of Kbytes.
2309 Default:
2311 None.
2312 Context:
2314 list (config), site (sympa.conf)
2315 Available versions:
2317 6.2b.1 and later.
2318 "archive.max_month"
2320 Maximum number of month archived
2322 Format:
2324 Number of months.
2325 Default:
2327 None.
2328 Context:
2330 list (config)
2331 Available versions:
2333 6.2b.1 and later.
2334 "archive_crypted_msg"
2336 Archive encrypted mails as cleartext
2338 Format:
2340 "original" - original messages
2341 "decrypted" - decrypted messages
2342 Default:
2343 "original"
2344 Context:
2346 list (config)
2347 "web_archive_spam_protection"
2349 Protect web archive against spam harvesters
2351 Format:
2353 "cookie" - use HTTP cookie
2354 "javascript" - use JavaScript
2355 "at" - replace @ characters
2356 "concealed" - never show address
2357 "none" - do nothing
2358 Default:
2359 "cookie"
2360 Context:
2362 list (config), domain (robot.conf), site (sympa.conf)
2363 The same as "spam_protection", but restricted to the web archive.
2365 In addition to it:
2367 cookie: users must submit a small form in order to receive a cookie
2369 before browsing the web archive.
2370 concealed: e-mail addresses will never be displayed.
2372 Bounces
2374 "bounce"
2375 (Paragraph) Bounces management
2377 Single occurrence
2379 "bounce.warn_rate"
2381 warn rate
2383 Format:
2385 Number of %.
2386 Default:
2388 30 (%)
2389 Context:
2391 list (config), site (sympa.conf)
2392 The list owner receives a warning whenever a message is distributed and
2394 the number (percentage) of bounces exceeds this value.
2395 "bounce.halt_rate"
2397 Deprecated.
2399 Context:
2401 list (config), site (sympa.conf)
2402 "bouncers_level1"
2404 (Paragraph) Management of bouncers, 1st level
2406 Single occurrence
2408 Level 1 is the lower level of bouncing users
2410 "bouncers_level1.rate"
2412 threshold
2414 Format:
2416 Number of points.
2417 Default:
2419 45 (points)
2420 Context:
2422 list (config), domain (robot.conf), site (sympa.conf)
2423 Each bouncing user have a score (from 0 to 100).
2425 This parameter defines a lower limit for each category of bouncing
2427 users.For example, level 1 begins from 45 to level_2_treshold.
2428 "bouncers_level1.action"
2430 action for this population
2432 Format:
2434 "remove_bouncers" - remove bouncing users
2435 "notify_bouncers" - send notify to bouncing users
2436 "none" - do nothing
2437 Default:
2438 "notify_bouncers"
2439 Context:
2441 list (config)
2442 This parameter defines which task is automatically applied on level 1
2444 bouncers.
2445 "bouncers_level1.notification"
2447 notification
2449 Format:
2451 "none" - do nothing
2452 "owner" - owner
2453 "listmaster" - listmaster
2454 Default:
2455 "owner"
2456 Context:
2458 list (config)
2459 When automatic task is executed on level 1 bouncers, a notification
2461 email can be send to listowner or listmaster.
2462 "bouncers_level2"
2464 (Paragraph) Management of bouncers, 2nd level
2466 Single occurrence
2468 Level 2 is the highest level of bouncing users
2470 "bouncers_level2.rate"
2472 threshold
2474 Format:
2476 Number of points.
2477 Default:
2479 75 (points)
2480 Context:
2482 list (config), domain (robot.conf), site (sympa.conf)
2483 Each bouncing user have a score (from 0 to 100).
2485 This parameter defines the score range defining each category of
2487 bouncing users.For example, level 2 is for users with a score between
2488 80 and 100.
2489 "bouncers_level2.action"
2491 action for this population
2493 Format:
2495 "remove_bouncers" - remove bouncing users
2496 "notify_bouncers" - send notify to bouncing users
2497 "none" - do nothing
2498 Default:
2499 "remove_bouncers"
2500 Context:
2502 list (config)
2503 This parameter defines which task is automatically applied on level 2
2505 bouncers.
2506 "bouncers_level2.notification"
2508 notification
2510 Format:
2512 "none" - do nothing
2513 "owner" - owner
2514 "listmaster" - listmaster
2515 Default:
2516 "owner"
2517 Context:
2519 list (config)
2520 When automatic task is executed on level 2 bouncers, a notification
2522 email can be send to listowner or listmaster.
2523 "verp_rate"
2525 percentage of list members in VERP mode
2527 Format:
2529 "100%" - 100% - always
2530 "50%" - 50%
2531 "33%" - 33%
2532 "25%" - 25%
2533 "20%" - 20%
2534 "10%" - 10%
2535 "5%" - 5%
2536 "2%" - 2%
2537 "0%" - 0% - never
2538 Default:
2539 "0%"
2540 Context:
2542 list (config), domain (robot.conf), site (sympa.conf)
2543 Uses variable envelope return path (VERP) to detect bouncing subscriber
2545 addresses.
2546 0%: VERP is never used.
2548 100%: VERP is always in use.
2550 VERP requires address with extension to be supported by MTA. If
2552 tracking is enabled for a list or a message, VERP is applied for 100%
2553 of subscribers.
2554 "tracking"
2556 (Paragraph) Message tracking feature
2558 Single occurrence
2560 "tracking.delivery_status_notification"
2562 tracking message by delivery status notification
2564 Format:
2566 "on" - enabled
2567 "off" - disabled
2568 Default:
2569 "off"
2570 Context:
2572 list (config), site (sympa.conf)
2573 "tracking.message_disposition_notification"
2575 tracking message by message disposition notification
2577 Format:
2579 "on" - enabled
2580 "on_demand" - on demand
2581 "off" - disabled
2582 Default:
2583 "off"
2584 Context:
2586 list (config), site (sympa.conf)
2587 Available versions:
2589 6.2a.41 and later.
2590 "tracking.tracking"
2592 who can view message tracking
2594 Format:
2596 Name of "tracking" scenario:
2597 "owner" - only owner (and listmaster)
2599 "private" - restricted to subscribers
2600 Default:
2601 "owner"
2602 Context:
2604 list (config), site (sympa.conf)
2605 Available versions:
2607 6.2a.3 and later.
2608 "tracking.retention_period"
2610 Tracking datas are removed after this number of days
2612 Format:
2614 Number of days.
2615 Default:
2617 90 (days)
2618 Context:
2620 list (config), site (sympa.conf)
2621 Available versions:
2623 6.2a.3 and later.
2624 "tracking.message_delivery_notification"
2626 See "message_disposition_notification".
2628 Context:
2630 list (config)
2631 Available versions:
2633 6.2a.0 to 6.2a.40.
2634 "verp_welcome"
2636 Remove bouncing new subscribers
2638 Format:
2640 "on" - enabled
2641 "off" - disabled
2642 Default:
2643 "off"
2644 Context:
2646 list (config), site (sympa.conf)
2647 Available versions:
2649 6.2.71b.1 and later.
2650 If enabled, the welcome message is sent using VERP in order to remove
2652 the subscriber immediately in the case of a bounce.
2653 "verp_remind"
2655 Remove subscribers bouncing remind message
2657 Format:
2659 "on" - enabled
2660 "off" - disabled
2661 Default:
2662 "off"
2663 Context:
2665 list (config), site (sympa.conf)
2666 Available versions:
2668 6.2.71b.1 and later.
2669 If enabled, the remind message is sent using VERP in order to remove
2671 the subscriber immediately in the case of a bounce.
2672 "expire_bounce_task"
2674 Task for expiration of old bounces
2676 Format:
2678 /"\w+"/
2679 Default:
2681 "daily"
2682 Context:
2684 site (sympa.conf)
2685 This task resets bouncing information for addresses not bouncing in the
2687 last 10 days after the latest message distribution.
2688 "purge_orphan_bounces_task"
2690 Task for cleaning invalidated bounces
2692 Format:
2694 /"\w+"/
2695 Default:
2697 "monthly"
2698 Context:
2700 site (sympa.conf)
2701 This task deletes bounce information for unsubscribed users.
2703 "eval_bouncers_task"
2705 Task for updating bounce scores
2707 Format:
2709 /"\w+"/
2710 Default:
2712 "daily"
2713 Context:
2715 site (sympa.conf)
2716 This task scans all bouncing users for all lists, and updates
2718 "bounce_score_subscriber" field in "subscriber_table" table. The scores
2719 may be used for management of bouncers.
2720 "process_bouncers_task"
2722 Task for management of bouncers
2724 Format:
2726 /"\w+"/
2727 Default:
2729 "weekly"
2730 Context:
2732 site (sympa.conf)
2733 This task executes actions on bouncing users configured by each list,
2735 according to their scores.
2736 "purge_tables_task"
2738 Task for cleaning tables
2740 Format:
2742 /"\w+"/
2743 Default:
2745 "daily"
2746 Context:
2748 site (sympa.conf)
2749 This task cleans old tracking information from "notification_table"
2751 table.
2752 "minimum_bouncing_count"
2754 Minimum number of bounces
2756 Format:
2758 /"\d+"/
2759 Default:
2761 10
2762 Context:
2764 site (sympa.conf)
2765 The minimum number of bounces received to update bounce score of a
2767 user.
2768 "minimum_bouncing_period"
2770 Minimum bouncing period
2772 Format:
2774 Number of days.
2775 Default:
2777 10 (days)
2778 Context:
2780 site (sympa.conf)
2781 The minimum period for which bouncing lasted to update bounce score of
2783 a user.
2784 "bounce_delay"
2786 Delay of bounces
2788 Format:
2790 Number of days.
2791 Default:
2793 0 (days)
2794 Context:
2796 site (sympa.conf)
2797 Average time for a bounce sent back to mailing list server after a post
2799 was sent to a list. Usually bounces are sent back on the same day as
2800 the original message.
2801 "bounce_email_prefix"
2803 Prefix of VERP return address
2805 Format:
2807 /"\S+"/
2808 Default:
2810 "bounce"
2811 Context:
2813 site (sympa.conf)
2814 The prefix to consist the return-path of probe messages used for bounce
2816 management, when variable envelope return path (VERP) is enabled. VERP
2817 requires address with extension to be supported by MTA.
2818 If you change the default value, you must modify the mail aliases too.
2820 "return_path_suffix"
2822 Suffix of list return address
2824 Format:
2826 /"\S+"/
2827 Default:
2829 "-owner"
2830 Context:
2832 site (sympa.conf)
2833 The suffix appended to the list name to form the return-path of
2835 messages distributed through the list. This address will receive all
2836 non-delivery reports (also called bounces).
2837 Loop prevention
2839 "loop_command_max"
2840 Maximum number of responses to command message
2842 Format:
2844 /"\d+"/
2845 Default:
2847 200
2848 Context:
2850 site (sympa.conf)
2851 The maximum number of command reports sent to an email address.
2853 Messages are stored in "bad" subdirectory of incoming message spool,
2854 and reports are not longer sent.
2855 "loop_command_sampling_delay"
2857 Delay before counting responses to command message
2859 Format:
2861 Number of seconds.
2862 Default:
2864 3600 (seconds)
2865 Context:
2867 site (sympa.conf)
2868 This parameter defines the delay in seconds before decrementing the
2870 counter of reports sent to an email address.
2871 "loop_command_decrease_factor"
2873 Decrementing factor of responses to command message
2875 Format:
2877 /"[.\d]+"/
2878 Default:
2880 0.5
2881 Context:
2883 site (sympa.conf)
2884 The decrementation factor (from 0 to 1), used to determine the new
2886 report counter after expiration of the delay.
2887 "msgid_table_cleanup_ttl"
2889 Expiration period of message ID table
2891 Format:
2893 Number of seconds.
2894 Default:
2896 86400 (seconds)
2897 Context:
2899 site (sympa.conf)
2900 Expiration period of entries in the table maintained by sympa_msg.pl
2902 daemon to prevent delivery of duplicate messages caused by loop.
2903 "msgid_table_cleanup_frequency"
2905 Cleanup interval of message ID table
2907 Format:
2909 Number of seconds.
2910 Default:
2912 3600 (seconds)
2913 Context:
2915 site (sympa.conf)
2916 Interval between cleanups of the table maintained by sympa_msg.pl
2918 daemon to prevent delivery of duplicate messages caused by loop.
2919 Automatic lists
2921 "automatic_list_feature"
2922 Automatic list
2924 Format:
2926 "on" - enabled
2927 "off" - disabled
2928 Default:
2929 "off"
2930 Context:
2932 domain (robot.conf), site (sympa.conf)
2933 "automatic_list_removal"
2935 Remove empty automatic list
2937 Format:
2939 "none" - do nothing
2940 "if_empty" - if_empty
2941 Default:
2942 "none"
2943 Context:
2945 domain (robot.conf), site (sympa.conf)
2946 If set to "if_empty", then Sympa will remove automatically created
2948 mailing lists just after their creation, if they contain no list
2949 member.
2950 Example:
2952 automatic_list_removal if_empty
2954 "automatic_list_creation"
2956 Who is able to create automatic list
2958 Format:
2960 Name of "automatic_list_creation" scenario:
2961 "family_owner" - Restricted to people subscribed to the list of
2963 family owners.
2964 "listmaster" - restricted to listmaster
2965 "public" - anybody. Be sure you know what you are doing
2966 Default:
2967 "public"
2968 Context:
2970 domain (robot.conf), site (sympa.conf)
2971 "automatic_list_families"
2973 Definition of automatic list families
2975 Format:
2977 /".+"/
2978 Default:
2980 None.
2981 Context:
2983 domain (robot.conf), site (sympa.conf)
2984 Defines the families the automatic lists are based on. It is a
2986 character string structured as follows:
2987 * each family is separated from the other by a semicolon (;)
2989 * inside a family definition, each field is separated from the other by
2991 a colon (:)
2992 * each field has the structure: "<field name>=<field value>"
2994 Basically, each time Sympa uses the automatic lists families, the
2996 values defined in this parameter will be available in the family
2997 object.
2998 * for scenarios: [family->name]
3000 * for templates: [% family.name %]
3002 Example:
3004 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;
3006 "parsed_family_files"
3008 Parsed files for families
3010 Format:
3012 /"[-.\w]+"/
3013 Default:
3015 "message_header,message_header.mime,message_footer,message_footer.mime,info"
3016 Context:
3018 domain (robot.conf), site (sympa.conf)
3019 comma-separated list of files that will be parsed by Sympa when
3021 instantiating a family (no space allowed in file names)
3022 "family_signoff"
3024 Global unsubscription
3026 Format:
3028 Name of "family_signoff" scenario:
3029 "auth" - need authentication
3031 "closed" - impossible
3032 Default:
3033 "auth"
3034 Context:
3036 domain (robot.conf), site (sympa.conf)
3037 Available versions:
3039 6.2.54 and later.
3040 Tag based spam filtering
3042 "spam_status"
3043 Type of spam filter
3045 Format:
3047 Name of "spam_status" scenario:
3048 "bogofilter" - bogofilter
3050 "j-chkmail" - j-chkmail
3051 "none" - do nothing
3052 "rspamd" - Rspamd
3053 "spamassassin" - SpamAssassin
3054 "x-spam-status" - test X-Spam-Status header
3055 Default:
3056 "x-spam-status"
3057 Context:
3059 domain (robot.conf), site (sympa.conf)
3060 Available versions:
3062 6.1a.2 and later.
3063 Messages are supposed to be filtered by an spam filter that adds them
3065 one or more headers. This parameter is used to select a special
3066 scenario in order to decide the message's spam status: ham, spam or
3067 unsure.
3068 Directories
3070 "home"
3071 List home
3073 Format:
3075 /".+"/
3076 Default:
3078 $EXPLDIR
3079 Context:
3081 site (sympa.conf)
3082 Base directory of list configurations.
3084 "etc"
3086 Directory for configuration files
3088 Format:
3090 /".+"/
3091 Default:
3093 $SYSCONFDIR
3094 Context:
3096 site (sympa.conf)
3097 Base directory of global configuration (except "sympa.conf").
3099 "spool"
3101 Base directory of spools
3103 Format:
3105 /".+"/
3106 Default:
3108 $SPOOLDIR
3109 Context:
3111 site (sympa.conf)
3112 Base directory of all spools which are created at runtime. This
3114 directory must be writable by Sympa user.
3115 "queue"
3117 Directory for message incoming spool
3119 Format:
3121 /".+"/
3122 Default:
3124 "$SPOOLDIR/msg"
3125 Context:
3127 site (sympa.conf)
3128 This spool is used both by "queue" program and "sympa_msg.pl" daemon.
3130 "queuemod"
3132 Directory for moderation spool
3134 Format:
3136 /".+"/
3137 Default:
3139 "$SPOOLDIR/moderation"
3140 Context:
3142 site (sympa.conf)
3143 "queuedigest"
3145 Directory for digest spool
3147 Format:
3149 /".+"/
3150 Default:
3152 "$SPOOLDIR/digest"
3153 Context:
3155 site (sympa.conf)
3156 "queueauth"
3158 Directory for held message spool
3160 Format:
3162 /".+"/
3163 Default:
3165 "$SPOOLDIR/auth"
3166 Context:
3168 site (sympa.conf)
3169 This parameter is named such by historical reason.
3171 "queueoutgoing"
3173 Directory for archive spool
3175 Format:
3177 /".+"/
3178 Default:
3180 "$SPOOLDIR/outgoing"
3181 Context:
3183 site (sympa.conf)
3184 This parameter is named such by historical reason.
3186 "queuesubscribe"
3188 Directory for held request spool
3190 Format:
3192 /".+"/
3193 Default:
3195 "$SPOOLDIR/subscribe"
3196 Context:
3198 site (sympa.conf)
3199 This parameter is named such by historical reason.
3201 "queuetopic"
3203 Directory for topic spool
3205 Format:
3207 /".+"/
3208 Default:
3210 "$SPOOLDIR/topic"
3211 Context:
3213 site (sympa.conf)
3214 "queuebounce"
3216 Directory for bounce incoming spool
3218 Format:
3220 /".+"/
3221 Default:
3223 "$SPOOLDIR/bounce"
3224 Context:
3226 site (sympa.conf)
3227 This spool is used both by "bouncequeue" program and "bounced.pl"
3229 daemon.
3230 "queuetask"
3232 Directory for task spool
3234 Format:
3236 /".+"/
3237 Default:
3239 "$SPOOLDIR/task"
3240 Context:
3242 site (sympa.conf)
3243 "queueautomatic"
3245 Directory for automatic list creation spool
3247 Format:
3249 /".+"/
3250 Default:
3252 "$SPOOLDIR/automatic"
3253 Context:
3255 site (sympa.conf)
3256 This spool is used both by "familyqueue" program and
3258 "sympa_automatic.pl" daemon.
3259 "queuebulk"
3261 Directory for message outgoing spool
3263 Format:
3265 /".+"/
3266 Default:
3268 "$SPOOLDIR/bulk"
3269 Context:
3271 site (sympa.conf)
3272 Available versions:
3274 6.2a.41 and later.
3275 This parameter is named such by historical reason.
3277 "tmpdir"
3279 Temporary directory used by external programs such as virus scanner.
3281 Also, outputs to daemons' standard error are redirected to the files
3282 under this directory.
3283 Format:
3285 /".+"/
3286 Default:
3288 "$SPOOLDIR/tmp"
3289 Context:
3291 site (sympa.conf)
3292 "viewmail_dir"
3294 Directory to cache formatted messages
3296 Format:
3298 /".+"/
3299 Default:
3301 "$SPOOLDIR/viewmail"
3302 Context:
3304 site (sympa.conf)
3305 Base directory path of directories where HTML view of messages are
3307 cached.
3308 "bounce_path"
3310 Directory for storing bounces
3312 Format:
3314 /".+"/
3315 Default:
3317 $BOUNCEDIR
3318 Context:
3320 site (sympa.conf)
3321 The directory where bounced.pl daemon will store the last bouncing
3323 message for each user. A message is stored in the file:
3324 <bounce_path>/<list name>@<mail domain name>/<email address>, or, if
3325 tracking is enabled: <bounce_path>/<list name>@<mail domain
3326 name>/<email address>_<envelope ID>.
3327 Users can access to these messages using web interface in the bounce
3329 management page.
3330 Don't confuse with "queuebounce" parameter which defines the spool
3332 where incoming error reports are stored and picked by bounced.pl
3333 daemon.
3334 "arc_path"
3336 Directory for storing archives
3338 Format:
3340 /".+"/
3341 Default:
3343 $ARCDIR
3344 Context:
3346 domain (robot.conf), site (sympa.conf)
3347 Where to store HTML archives. This parameter is used by the
3349 "archived.pl" daemon. It is a good idea to install the archive outside
3350 the web document hierarchy to prevent overcoming of WWSympa's access
3351 control.
3352 "purge_spools_task"
3354 Task for cleaning spools
3356 Format:
3358 /"\w+"/
3359 Default:
3361 "daily"
3362 Context:
3364 site (sympa.conf)
3365 Available versions:
3367 6.2b.4 and later.
3368 This task cleans old content in spools.
3370 "clean_delay_queue"
3372 Max age of incoming bad messages
3374 Format:
3376 Number of days.
3377 Default:
3379 7 (days)
3380 Context:
3382 site (sympa.conf)
3383 Number of days "bad" messages are kept in message incoming spool (as
3385 specified by "queue" parameter). Sympa keeps messages rejected for
3386 various reasons (badly formatted, looping etc.).
3387 "clean_delay_queueoutgoing"
3389 Max age of bad messages for archives
3391 Format:
3393 Number of days.
3394 Default:
3396 7 (days)
3397 Context:
3399 site (sympa.conf)
3400 Number of days "bad" messages are kept in message archive spool (as
3402 specified by "queueoutgoing" parameter). Sympa keeps messages rejected
3403 for various reasons (unable to create archive directory, to copy file
3404 etc.).
3405 "clean_delay_queuebounce"
3407 Max age of bad bounce messages
3409 Format:
3411 Number of days.
3412 Default:
3414 7 (days)
3415 Context:
3417 site (sympa.conf)
3418 Number of days "bad" messages are kept in bounce spool (as specified by
3420 "queuebounce" parameter). Sympa keeps messages rejected for various
3421 reasons (unknown original sender, unknown report type).
3422 "clean_delay_queueauth"
3424 Max age of held messages
3426 Format:
3428 Number of days.
3429 Default:
3431 30 (days)
3432 Context:
3434 site (sympa.conf)
3435 Number of days messages are kept in held message spool (as specified by
3437 "queueauth" parameter). Beyond this deadline, messages that have not
3438 been confirmed are deleted.
3439 "clean_delay_queuesubscribe"
3441 Max age of held requests
3443 Format:
3445 Number of days.
3446 Default:
3448 30 (days)
3449 Context:
3451 site (sympa.conf)
3452 Number of days requests are kept in held request spool (as specified by
3454 "queuesubscribe" parameter). Beyond this deadline, requests that have
3455 not been validated nor declined are deleted.
3456 "clean_delay_queuetopic"
3458 Max age of tagged topics
3460 Format:
3462 Number of days.
3463 Default:
3465 30 (days)
3466 Context:
3468 site (sympa.conf)
3469 Number of days (automatically or manually) tagged topics are kept in
3471 topic spool (as specified by "queuetopic" parameter). Beyond this
3472 deadline, tagging is forgotten.
3473 "clean_delay_queueautomatic"
3475 Max age of incoming bad messages in automatic list creation spool
3477 Format:
3479 Number of days.
3480 Default:
3482 10 (days)
3483 Context:
3485 site (sympa.conf)
3486 Number of days "bad" messages are kept in automatic list creation spool
3488 (as specified by "queueautomatic" parameter). Sympa keeps messages
3489 rejected for various reasons (badly formatted, looping etc.).
3490 "clean_delay_queuebulk"
3492 Max age of outgoing bad messages
3494 Format:
3496 Number of days.
3497 Default:
3499 7 (days)
3500 Context:
3502 site (sympa.conf)
3503 Number of days "bad" messages are kept in message outgoing spool (as
3505 specified by "queuebulk" parameter). Sympa keeps messages rejected for
3506 various reasons (failed personalization, bad configuration on MTA
3507 etc.).
3508 "clean_delay_queuedigest"
3510 Max age of bad messages in digest spool
3512 Format:
3514 Number of days.
3515 Default:
3517 14 (days)
3518 Context:
3520 site (sympa.conf)
3521 Available versions:
3523 6.2.6 and later.
3524 Number of days "bad" messages are kept in digest spool (as specified by
3526 "queuedigest" parameter). Sympa keeps messages rejected for various
3527 reasons (syntax errors in "digest.tt2" template etc.).
3528 "clean_delay_tmpdir"
3530 Max age of temporary files
3532 Format:
3534 Number of days.
3535 Default:
3537 7 (days)
3538 Context:
3540 site (sympa.conf)
3541 Number of days files in temporary directory (as specified by "tmpdir"
3543 parameter), including standard error logs, are kept.
3544 S/MIME and TLS
3546 S/MIME authentication, decryption and re-encryption. It requires these
3547 external modules: Crypt-OpenSSL-X509 and Crypt-SMIME.
3548 TLS client authentication. It requires an external module: IO-Socket-
3550 SSL.
3551 "cafile"
3553 File containing trusted CA certificates
3555 Format:
3557 /".+"/
3558 Default:
3560 None.
3561 Context:
3563 site (sympa.conf)
3564 Available versions:
3566 3.3.6b.1 and later.
3567 This can be used alternatively and/or additionally to "capath".
3569 "capath"
3571 Directory containing trusted CA certificates
3573 Format:
3575 /".+"/
3576 Default:
3578 None.
3579 Context:
3581 site (sympa.conf)
3582 Available versions:
3584 3.3.6b.1 and later.
3585 CA certificates in this directory are used for client authentication.
3587 The certificates need to have names including hash of subject, or
3589 symbolic links to them with such names. The links may be created by
3590 using "c_rehash" script bundled in OpenSSL.
3591 "key_passwd"
3593 Password used to crypt lists private keys
3595 Format:
3597 The value to be concealed.
3598 Default:
3600 None.
3601 Context:
3603 site (sympa.conf)
3604 If not defined, Sympa assumes that list private keys are not encrypted.
3606 Example:
3608 key_passwd your_password
3610 "ssl_cert_dir"
3612 Directory containing user certificates
3614 Format:
3616 /".+"/
3617 Default:
3619 "$EXPLDIR/X509-user-certs"
3620 Context:
3622 site (sympa.conf)
3623 Data sources setup
3625 Including subscribers, owners and moderators from data sources.
3626 Appropriate database driver (DBD) modules are required: DBD-CSV, DBD-
3627 mysql, DBD-ODBC, DBD-Oracle, DBD-Pg, DBD-SQLite and/or Net-LDAP. And
3628 also, if secure connection (LDAPS) to LDAP server is required: IO-
3629 Socket-SSL.
3630 "inclusion_notification_feature"
3632 Notify subscribers when they are included from a data source?
3634 Format:
3636 "on" - enabled
3637 "off" - disabled
3638 Default:
3639 "off"
3640 Context:
3642 list (config), site (sympa.conf)
3643 "member_include"
3645 (Paragraph) Subscribers defined in an external data source
3647 Multiple occurrences allowed
3649 "member_include.source"
3651 the data source
3653 Format:
3655 /"[\w-]+"/
3656 Default:
3658 None, mandatory.
3659 Context:
3661 list (config)
3662 "member_include.source_parameters"
3664 data source parameters
3666 Format:
3668 /".*"/
3669 Default:
3671 None.
3672 Context:
3674 list (config)
3675 "member_include.reception"
3677 reception mode
3679 Format:
3681 Reception mode of list member.
3682 Default:
3684 None.
3685 Context:
3687 list (config)
3688 Available versions:
3690 6.2.67b.2 and later.
3691 Mail reception mode.
3693 "member_include.visibility"
3695 visibility
3697 Format:
3699 Visibility mode of list member.
3700 Default:
3702 None.
3703 Context:
3705 list (config)
3706 Available versions:
3708 6.2.67b.2 and later.
3709 Visibility of the subscriber.
3711 "owner_include"
3713 (Paragraph) Owners defined in an external data source
3715 Multiple occurrences allowed
3717 "owner_include.source"
3719 the data source
3721 Format:
3723 /"[\w-]+"/
3724 Default:
3726 None, mandatory.
3727 Context:
3729 list (config)
3730 "owner_include.source_parameters"
3732 data source parameters
3734 Format:
3736 /".*"/
3737 Default:
3739 None.
3740 Context:
3742 list (config)
3743 Available versions:
3745 5.0a and later.
3746 "owner_include.profile"
3748 profile
3750 Format:
3752 "privileged" - privileged owner
3753 "normal" - normal owner
3754 Default:
3755 None.
3756 Context:
3758 list (config)
3759 "owner_include.reception"
3761 reception mode
3763 Format:
3765 "mail" - receive notification email
3766 "nomail" - no notifications
3767 Default:
3768 None.
3769 Context:
3771 list (config)
3772 "owner_include.visibility"
3774 visibility
3776 Format:
3778 "conceal" - concealed from list menu
3779 "noconceal" - listed on the list menu
3780 Default:
3781 None.
3782 Context:
3784 list (config)
3785 Available versions:
3787 5.4a.6 and later.
3788 "editor_include"
3790 (Paragraph) Moderators defined in an external data source
3792 Multiple occurrences allowed
3794 "editor_include.source"
3796 the data source
3798 Format:
3800 /"[\w-]+"/
3801 Default:
3803 None, mandatory.
3804 Context:
3806 list (config)
3807 "editor_include.source_parameters"
3809 data source parameters
3811 Format:
3813 /".*"/
3814 Default:
3816 None.
3817 Context:
3819 list (config)
3820 Available versions:
3822 5.0a and later.
3823 "editor_include.reception"
3825 reception mode
3827 Format:
3829 "mail" - receive notification email
3830 "nomail" - no notifications
3831 Default:
3832 None.
3833 Context:
3835 list (config)
3836 "editor_include.visibility"
3838 visibility
3840 Format:
3842 "conceal" - concealed from list menu
3843 "noconceal" - listed on the list menu
3844 Default:
3845 None.
3846 Context:
3848 list (config)
3849 Available versions:
3851 5.4a.6 and later.
3852 "sql_fetch_timeout"
3854 Timeout for fetch of include_sql_query
3856 Format:
3858 Number of seconds.
3859 Default:
3861 300 (seconds)
3862 Context:
3864 list (config), site (sympa.conf)
3865 Available versions:
3867 6.2a.0 and later.
3868 "include_file"
3870 File inclusion
3872 Format:
3874 Multiple occurrences allowed.
3875 /"\S+"/
3877 Default:
3879 None.
3880 Context:
3882 list (config)
3883 Include subscribers from this file. The file should contain one e-mail
3885 address per line (lines beginning with a "#" are ignored).
3886 "include_remote_file"
3888 (Paragraph) Remote file inclusion
3890 Multiple occurrences allowed
3892 "include_remote_file.name"
3894 short name for this source
3896 Format:
3898 /".+"/
3899 Default:
3901 None.
3902 Context:
3904 list (config)
3905 "include_remote_file.url"
3907 data location URL
3909 Format:
3911 /".+"/
3912 Default:
3914 None, mandatory.
3915 Context:
3917 list (config)
3918 "include_remote_file.user"
3920 remote user
3922 Format:
3924 /".+"/
3925 Default:
3927 None.
3928 Context:
3930 list (config)
3931 "include_remote_file.passwd"
3933 remote password
3935 Format:
3937 The value to be concealed.
3938 Default:
3940 None.
3941 Context:
3943 list (config)
3944 "include_remote_file.timeout"
3946 idle timeout
3948 Format:
3950 Number of seconds.
3951 Default:
3953 180 (seconds)
3954 Context:
3956 list (config)
3957 "include_remote_file.ssl_version"
3959 SSL version
3961 Format:
3963 "ssl_any" - any versions
3964 "sslv2" - SSL version 2
3965 "sslv3" - SSL version 3
3966 "tlsv1" - TLS version 1
3967 "tlsv1_1" - TLS version 1.1
3968 "tlsv1_2" - TLS version 1.2
3969 "tlsv1_3" - TLS version 1.3
3970 Default:
3971 "ssl_any"
3972 Context:
3974 list (config)
3975 "include_remote_file.ssl_ciphers"
3977 SSL ciphers used
3979 Format:
3981 /".+"/
3982 Default:
3984 "ALL"
3985 Context:
3987 list (config)
3988 "include_remote_file.ca_verify"
3990 Certificate verification
3992 Format:
3994 "none" - do nothing
3995 "optional" - optional
3996 "required" - required
3997 Default:
3998 "none"
3999 Context:
4001 list (config)
4002 "include_remote_file.nosync_time_ranges"
4004 Time ranges when inclusion is not allowed
4006 Format:
4008 /$time_ranges/
4009 Default:
4011 None.
4012 Context:
4014 list (config)
4015 "include_sympa_list"
4017 (Paragraph) List inclusion
4019 Multiple occurrences allowed
4021 Include subscribers from other list. All subscribers of list listname
4023 become subscribers of the current list. You may include as many lists
4024 as required, using one include_sympa_list paragraph for each included
4025 list. Any list at all may be included; you may therefore include lists
4026 which are also defined by the inclusion of other lists. Be careful,
4027 however, not to include list A in list B and then list B in list A,
4028 since this will give rise to an infinite loop.
4029 "include_sympa_list.name"
4031 short name for this source
4033 Format:
4035 /".+"/
4036 Default:
4038 None.
4039 Context:
4041 list (config)
4042 "include_sympa_list.listname"
4044 list name to include
4046 Format:
4048 /"$listname(\@$host)?"/
4049 Default:
4051 None, mandatory.
4052 Context:
4054 list (config)
4055 "include_sympa_list.filter"
4057 filter definition
4059 Format:
4061 /".*"/
4062 Default:
4064 None.
4065 Context:
4067 list (config)
4068 "include_sympa_list.nosync_time_ranges"
4070 Time ranges when inclusion is not allowed
4072 Format:
4074 /$time_ranges/
4075 Default:
4077 None.
4078 Context:
4080 list (config)
4081 "include_remote_sympa_list"
4083 (Paragraph) remote list inclusion
4085 Multiple occurrences allowed
4087 Sympa can contact another Sympa service using HTTPS to fetch a remote
4089 list in order to include each member of a remote list as subscriber.
4090 You may include as many lists as required, using one
4091 include_remote_sympa_list paragraph for each included list. Be careful,
4092 however, not to give rise to an infinite loop resulting from cross
4093 includes.
4094 For this operation, one Sympa site acts as a server while the other one
4096 acs as client. On the server side, the only setting needed is to give
4097 permission to the remote Sympa to review the list. This is controlled
4098 by the review scenario.
4099 "include_remote_sympa_list.name"
4101 short name for this source
4103 Format:
4105 /".+"/
4106 Default:
4108 None.
4109 Context:
4111 list (config)
4112 "include_remote_sympa_list.url"
4114 data location URL
4116 Format:
4118 /".+"/
4119 Default:
4121 None.
4122 Context:
4124 list (config)
4125 Available versions:
4127 6.2.45b.1 and later.
4128 "include_remote_sympa_list.user"
4130 remote user
4132 Format:
4134 /".+"/
4135 Default:
4137 None.
4138 Context:
4140 list (config)
4141 Available versions:
4143 6.2.45b.1 and later.
4144 "include_remote_sympa_list.passwd"
4146 remote password
4148 Format:
4150 The value to be concealed.
4151 Default:
4153 None.
4154 Context:
4156 list (config)
4157 Available versions:
4159 6.2.45b.1 and later.
4160 "include_remote_sympa_list.host"
4162 remote host
4164 Format:
4166 /$host/
4167 Default:
4169 None, mandatory.
4170 Context:
4172 list (config)
4173 obsoleted. Use "data location URL".
4175 "include_remote_sympa_list.port"
4177 remote port
4179 Format:
4181 /"\d+"/
4182 Default:
4184 443
4185 Context:
4187 list (config)
4188 obsoleted. Use "data location URL".
4190 "include_remote_sympa_list.path"
4192 remote path of sympa list dump
4194 Format:
4196 /"\S+"/
4197 Default:
4199 None, mandatory.
4200 Context:
4202 list (config)
4203 obsoleted. Use "data location URL".
4205 "include_remote_sympa_list.cert"
4207 Deprecated.
4209 Context:
4211 list (config)
4212 Available versions:
4214 up to 6.2.44.
4215 "include_remote_sympa_list.timeout"
4217 idle timeout
4219 Format:
4221 Number of seconds.
4222 Default:
4224 180 (seconds)
4225 Context:
4227 list (config)
4228 Available versions:
4230 6.2.45b.1 and later.
4231 "include_remote_sympa_list.ssl_version"
4233 SSL version
4235 Format:
4237 "ssl_any" - any versions
4238 "sslv2" - SSL version 2
4239 "sslv3" - SSL version 3
4240 "tlsv1" - TLS version 1
4241 "tlsv1_1" - TLS version 1.1
4242 "tlsv1_2" - TLS version 1.2
4243 "tlsv1_3" - TLS version 1.3
4244 Default:
4245 "ssl_any"
4246 Context:
4248 list (config)
4249 Available versions:
4251 6.2.45b.1 and later.
4252 "include_remote_sympa_list.ssl_ciphers"
4254 SSL ciphers used
4256 Format:
4258 /".+"/
4259 Default:
4261 "ALL"
4262 Context:
4264 list (config)
4265 Available versions:
4267 6.2.45b.1 and later.
4268 "include_remote_sympa_list.ca_verify"
4270 Certificate verification
4272 Format:
4274 "none" - do nothing
4275 "optional" - optional
4276 "required" - required
4277 Default:
4278 "optional"
4279 Context:
4281 list (config)
4282 Available versions:
4284 6.2.45b.1 and later.
4285 "include_remote_sympa_list.nosync_time_ranges"
4287 Time ranges when inclusion is not allowed
4289 Format:
4291 /$time_ranges/
4292 Default:
4294 None.
4295 Context:
4297 list (config)
4298 "include_ldap_query"
4300 (Paragraph) LDAP query inclusion
4302 Multiple occurrences allowed
4304 This paragraph defines parameters for a query returning a list of
4306 subscribers. This feature requires the Net::LDAP (perlldap) PERL
4307 module.
4308 "include_ldap_query.name"
4310 short name for this source
4312 Format:
4314 /".+"/
4315 Default:
4317 None.
4318 Context:
4320 list (config)
4321 "include_ldap_query.host"
4323 remote host
4325 Format:
4327 /$multiple_host_or_url/
4328 Default:
4330 None, mandatory.
4331 Context:
4333 list (config)
4334 "include_ldap_query.use_tls"
4336 use TLS (formerly SSL)
4338 Format:
4340 "starttls" - use STARTTLS
4341 "ldaps" - use LDAPS (LDAP over TLS)
4342 "none" - do nothing
4343 Default:
4344 "none"
4345 Context:
4347 list (config)
4348 Available versions:
4350 6.2.15 and later.
4351 "include_ldap_query.ssl_version"
4353 SSL version
4355 Format:
4357 "sslv2" - SSL version 2
4358 "sslv3" - SSL version 3
4359 "tlsv1" - TLS version 1
4360 "tlsv1_1" - TLS version 1.1
4361 "tlsv1_2" - TLS version 1.2
4362 "tlsv1_3" - TLS version 1.3
4363 Default:
4364 "tlsv1"
4365 Context:
4367 list (config)
4368 "include_ldap_query.ssl_ciphers"
4370 SSL ciphers used
4372 Format:
4374 /".+"/
4375 Default:
4377 "ALL"
4378 Context:
4380 list (config)
4381 "include_ldap_query.ca_verify"
4383 Certificate verification
4385 Format:
4387 "none" - do nothing
4388 "optional" - optional
4389 "required" - required
4390 Default:
4391 "required"
4392 Context:
4394 list (config)
4395 Available versions:
4397 6.2.13 and later.
4398 "include_ldap_query.bind_dn"
4400 remote user
4402 Format:
4404 /".+"/
4405 Default:
4407 None.
4408 Context:
4410 list (config)
4411 Available versions:
4413 6.2.57b.1 and later.
4414 "include_ldap_query.bind_password"
4416 remote password
4418 Format:
4420 The value to be concealed.
4421 Default:
4423 None.
4424 Context:
4426 list (config)
4427 Available versions:
4429 6.2.57b.1 and later.
4430 "include_ldap_query.suffix"
4432 suffix
4434 Format:
4436 /".+"/
4437 Default:
4439 None.
4440 Context:
4442 list (config)
4443 "include_ldap_query.scope"
4445 search scope
4447 Format:
4449 "base" - base
4450 "one" - one level
4451 "sub" - subtree
4452 Default:
4453 "sub"
4454 Context:
4456 list (config)
4457 "include_ldap_query.timeout"
4459 connection timeout
4461 Format:
4463 Number of seconds.
4464 Default:
4466 30 (seconds)
4467 Context:
4469 list (config)
4470 "include_ldap_query.filter"
4472 filter
4474 Format:
4476 /".+"/
4477 Default:
4479 None, mandatory.
4480 Context:
4482 list (config)
4483 "include_ldap_query.attrs"
4485 extracted attribute
4487 Format:
4489 /"$ldap_attrdesc(\s*,\s*$ldap_attrdesc)?"/
4490 Default:
4492 "mail"
4493 Context:
4495 list (config)
4496 "include_ldap_query.select"
4498 selection (if multiple)
4500 Format:
4502 "all" - all
4503 "first" - first entry
4504 "regex" - entries matching regular expression
4505 Default:
4506 "first"
4507 Context:
4509 list (config)
4510 "include_ldap_query.regex"
4512 regular expression
4514 Format:
4516 /".+"/
4517 Default:
4519 ""
4520 Context:
4522 list (config)
4523 "include_ldap_query.nosync_time_ranges"
4525 Time ranges when inclusion is not allowed
4527 Format:
4529 /$time_ranges/
4530 Default:
4532 None.
4533 Context:
4535 list (config)
4536 Available versions:
4538 6.2a.16 and later.
4539 "include_ldap_query.passwd"
4541 See "bind_password".
4543 Context:
4545 list (config)
4546 Available versions:
4548 up to 6.2.56.
4549 "include_ldap_query.port"
4551 Deprecated.
4553 Context:
4555 list (config)
4556 "include_ldap_query.use_ssl"
4558 See "use_tls".
4560 Context:
4562 list (config)
4563 Available versions:
4565 5.3a.2 to 6.2.14.
4566 "include_ldap_query.user"
4568 See "bind_dn".
4570 Context:
4572 list (config)
4573 Available versions:
4575 up to 6.2.56.
4576 "include_ldap_2level_query"
4578 (Paragraph) LDAP 2-level query inclusion
4580 Multiple occurrences allowed
4582 This paragraph defines parameters for a two-level query returning a
4584 list of subscribers. Usually the first-level query returns a list of
4585 DNs and the second-level queries convert the DNs into e-mail addresses.
4586 This feature requires the Net::LDAP (perlldap) PERL module.
4587 "include_ldap_2level_query.name"
4589 short name for this source
4591 Format:
4593 /".+"/
4594 Default:
4596 None.
4597 Context:
4599 list (config)
4600 "include_ldap_2level_query.host"
4602 remote host
4604 Format:
4606 /$multiple_host_or_url/
4607 Default:
4609 None, mandatory.
4610 Context:
4612 list (config)
4613 "include_ldap_2level_query.use_tls"
4615 use TLS (formerly SSL)
4617 Format:
4619 "starttls" - use STARTTLS
4620 "ldaps" - use LDAPS (LDAP over TLS)
4621 "none" - do nothing
4622 Default:
4623 "none"
4624 Context:
4626 list (config)
4627 Available versions:
4629 6.2.15 and later.
4630 "include_ldap_2level_query.ssl_version"
4632 SSL version
4634 Format:
4636 "sslv2" - SSL version 2
4637 "sslv3" - SSL version 3
4638 "tlsv1" - TLS version 1
4639 "tlsv1_1" - TLS version 1.1
4640 "tlsv1_2" - TLS version 1.2
4641 "tlsv1_3" - TLS version 1.3
4642 Default:
4643 "tlsv1"
4644 Context:
4646 list (config)
4647 "include_ldap_2level_query.ssl_ciphers"
4649 SSL ciphers used
4651 Format:
4653 /".+"/
4654 Default:
4656 "ALL"
4657 Context:
4659 list (config)
4660 "include_ldap_2level_query.ca_verify"
4662 Certificate verification
4664 Format:
4666 "none" - do nothing
4667 "optional" - optional
4668 "required" - required
4669 Default:
4670 "required"
4671 Context:
4673 list (config)
4674 Available versions:
4676 6.2.13 and later.
4677 "include_ldap_2level_query.bind_dn"
4679 remote user
4681 Format:
4683 /".+"/
4684 Default:
4686 None.
4687 Context:
4689 list (config)
4690 Available versions:
4692 6.2.57b.1 and later.
4693 "include_ldap_2level_query.bind_password"
4695 remote password
4697 Format:
4699 The value to be concealed.
4700 Default:
4702 None.
4703 Context:
4705 list (config)
4706 Available versions:
4708 6.2.57b.1 and later.
4709 "include_ldap_2level_query.suffix1"
4711 first-level suffix
4713 Format:
4715 /".+"/
4716 Default:
4718 None.
4719 Context:
4721 list (config)
4722 "include_ldap_2level_query.scope1"
4724 first-level search scope
4726 Format:
4728 "base" - base
4729 "one" - one level
4730 "sub" - subtree
4731 Default:
4732 "sub"
4733 Context:
4735 list (config)
4736 "include_ldap_2level_query.timeout1"
4738 first-level connection timeout
4740 Format:
4742 Number of seconds.
4743 Default:
4745 30 (seconds)
4746 Context:
4748 list (config)
4749 "include_ldap_2level_query.filter1"
4751 first-level filter
4753 Format:
4755 /".+"/
4756 Default:
4758 None, mandatory.
4759 Context:
4761 list (config)
4762 "include_ldap_2level_query.attrs1"
4764 first-level extracted attribute
4766 Format:
4768 /$ldap_attrdesc/
4769 Default:
4771 None.
4772 Context:
4774 list (config)
4775 "include_ldap_2level_query.select1"
4777 first-level selection
4779 Format:
4781 "all" - all
4782 "first" - first entry
4783 "regex" - entries matching regular expression
4784 Default:
4785 "first"
4786 Context:
4788 list (config)
4789 "include_ldap_2level_query.regex1"
4791 first-level regular expression
4793 Format:
4795 /".+"/
4796 Default:
4798 ""
4799 Context:
4801 list (config)
4802 "include_ldap_2level_query.suffix2"
4804 second-level suffix template
4806 Format:
4808 /".+"/
4809 Default:
4811 None.
4812 Context:
4814 list (config)
4815 "include_ldap_2level_query.scope2"
4817 second-level search scope
4819 Format:
4821 "base" - base
4822 "one" - one level
4823 "sub" - subtree
4824 Default:
4825 "sub"
4826 Context:
4828 list (config)
4829 "include_ldap_2level_query.timeout2"
4831 second-level connection timeout
4833 Format:
4835 Number of seconds.
4836 Default:
4838 30 (seconds)
4839 Context:
4841 list (config)
4842 "include_ldap_2level_query.filter2"
4844 second-level filter template
4846 Format:
4848 /".+"/
4849 Default:
4851 None, mandatory.
4852 Context:
4854 list (config)
4855 "include_ldap_2level_query.attrs2"
4857 second-level extracted attribute
4859 Format:
4861 /"$ldap_attrdesc(\s*,\s*$ldap_attrdesc)?"/
4862 Default:
4864 "mail"
4865 Context:
4867 list (config)
4868 "include_ldap_2level_query.select2"
4870 second-level selection
4872 Format:
4874 "all" - all
4875 "first" - first entry
4876 "regex" - entries matching regular expression
4877 Default:
4878 "first"
4879 Context:
4881 list (config)
4882 "include_ldap_2level_query.regex2"
4884 second-level regular expression
4886 Format:
4888 /".+"/
4889 Default:
4891 ""
4892 Context:
4894 list (config)
4895 "include_ldap_2level_query.nosync_time_ranges"
4897 Time ranges when inclusion is not allowed
4899 Format:
4901 /$time_ranges/
4902 Default:
4904 None.
4905 Context:
4907 list (config)
4908 Available versions:
4910 6.2a.16 and later.
4911 "include_ldap_2level_query.passwd"
4913 See "bind_password".
4915 Context:
4917 list (config)
4918 Available versions:
4920 up to 6.2.56.
4921 "include_ldap_2level_query.port"
4923 Deprecated.
4925 Context:
4927 list (config)
4928 "include_ldap_2level_query.use_ssl"
4930 See "use_tls".
4932 Context:
4934 list (config)
4935 Available versions:
4937 5.3a.2 to 6.2.14.
4938 "include_ldap_2level_query.user"
4940 See "bind_dn".
4942 Context:
4944 list (config)
4945 Available versions:
4947 up to 6.2.56.
4948 "include_sql_query"
4950 (Paragraph) SQL query inclusion
4952 Multiple occurrences allowed
4954 This parameter is used to define the SQL query parameters.
4956 "include_sql_query.name"
4958 short name for this source
4960 Format:
4962 /".+"/
4963 Default:
4965 None.
4966 Context:
4968 list (config)
4969 "include_sql_query.db_type"
4971 database type
4973 Format:
4975 /"\S+"/
4976 Default:
4978 None, mandatory.
4979 Context:
4981 list (config)
4982 "include_sql_query.db_name"
4984 database name
4986 Format:
4988 /"\S+"/
4989 Default:
4991 None, mandatory.
4992 Context:
4994 list (config)
4995 "include_sql_query.db_host"
4997 remote host
4999 Format:
5001 /$host/
5002 Default:
5004 None.
5005 Context:
5007 list (config)
5008 Available versions:
5010 6.2.57b.1 and later.
5011 "include_sql_query.db_port"
5013 database port
5015 Format:
5017 /"\d+"/
5018 Default:
5020 None.
5021 Context:
5023 list (config)
5024 "include_sql_query.db_options"
5026 connection options
5028 Format:
5030 /".+"/
5031 Default:
5033 None.
5034 Context:
5036 list (config)
5037 Available versions:
5039 6.2.57b.1 and later.
5040 "include_sql_query.db_env"
5042 environment variables for database connection
5044 Format:
5046 /"\w+\=\S+(;\w+\=\S+)*"/
5047 Default:
5049 None.
5050 Context:
5052 list (config)
5053 "include_sql_query.db_user"
5055 remote user
5057 Format:
5059 /"\S+"/
5060 Default:
5062 None.
5063 Context:
5065 list (config)
5066 Available versions:
5068 6.2.57b.1 and later.
5069 "include_sql_query.db_passwd"
5071 remote password
5073 Format:
5075 The value to be concealed.
5076 Default:
5078 None.
5079 Context:
5081 list (config)
5082 Available versions:
5084 6.2.57b.1 and later.
5085 "include_sql_query.sql_query"
5087 SQL query
5089 Format:
5091 /$sql_query/
5092 Default:
5094 None, mandatory.
5095 Context:
5097 list (config)
5098 "include_sql_query.f_dir"
5100 See "db_name".
5102 Context:
5104 list (config)
5105 Available versions:
5107 up to 6.2.70.
5108 "include_sql_query.nosync_time_ranges"
5110 Time ranges when inclusion is not allowed
5112 Format:
5114 /$time_ranges/
5115 Default:
5117 None.
5118 Context:
5120 list (config)
5121 Available versions:
5123 6.2a.16 and later.
5124 "include_sql_query.connect_options"
5126 See "db_options".
5128 Context:
5130 list (config)
5131 Available versions:
5133 up to 6.2.56.
5134 "include_sql_query.host"
5136 See "db_host".
5138 Context:
5140 list (config)
5141 Available versions:
5143 up to 6.2.56.
5144 "include_sql_query.passwd"
5146 See "db_passwd".
5148 Context:
5150 list (config)
5151 Available versions:
5153 up to 6.2.56.
5154 "include_sql_query.user"
5156 See "db_user".
5158 Context:
5160 list (config)
5161 Available versions:
5163 up to 6.2.56.
5164 "ttl"
5166 Inclusions timeout
5168 Format:
5170 Number of seconds.
5171 Default:
5173 3600 (seconds)
5174 Context:
5176 list (config), site (sympa.conf)
5177 Sympa caches user data extracted using the include parameter. Their TTL
5179 (time-to-live) within Sympa can be controlled using this parameter. The
5180 default value is 3600
5181 "distribution_ttl"
5183 Inclusions timeout for message distribution
5185 Format:
5187 Number of seconds.
5188 Default:
5190 None.
5191 Context:
5193 list (config), site (sympa.conf)
5194 This parameter defines the delay since the last synchronization after
5196 which the user's list will be updated before performing either of
5197 following actions:
5198 * Reviewing list members
5200 * Message distribution
5202 "include_ldap_ca"
5204 (Paragraph) LDAP query custom attribute
5206 Multiple occurrences allowed
5208 "include_ldap_ca.name"
5210 short name for this source
5212 Format:
5214 /".+"/
5215 Default:
5217 None.
5218 Context:
5220 list (config)
5221 "include_ldap_ca.host"
5223 remote host
5225 Format:
5227 /$multiple_host_or_url/
5228 Default:
5230 None, mandatory.
5231 Context:
5233 list (config)
5234 "include_ldap_ca.use_tls"
5236 use TLS (formerly SSL)
5238 Format:
5240 "starttls" - use STARTTLS
5241 "ldaps" - use LDAPS (LDAP over TLS)
5242 "none" - do nothing
5243 Default:
5244 "none"
5245 Context:
5247 list (config)
5248 Available versions:
5250 6.2.15 and later.
5251 "include_ldap_ca.ssl_version"
5253 SSL version
5255 Format:
5257 "sslv2" - SSL version 2
5258 "sslv3" - SSL version 3
5259 "tlsv1" - TLS version 1
5260 "tlsv1_1" - TLS version 1.1
5261 "tlsv1_2" - TLS version 1.2
5262 "tlsv1_3" - TLS version 1.3
5263 Default:
5264 "tlsv1"
5265 Context:
5267 list (config)
5268 "include_ldap_ca.ssl_ciphers"
5270 SSL ciphers used
5272 Format:
5274 /".+"/
5275 Default:
5277 "ALL"
5278 Context:
5280 list (config)
5281 "include_ldap_ca.ca_verify"
5283 Certificate verification
5285 Format:
5287 "none" - do nothing
5288 "optional" - optional
5289 "required" - required
5290 Default:
5291 "required"
5292 Context:
5294 list (config)
5295 Available versions:
5297 6.2.13 and later.
5298 "include_ldap_ca.bind_dn"
5300 remote user
5302 Format:
5304 /".+"/
5305 Default:
5307 None.
5308 Context:
5310 list (config)
5311 Available versions:
5313 6.2.57b.1 and later.
5314 "include_ldap_ca.bind_password"
5316 remote password
5318 Format:
5320 The value to be concealed.
5321 Default:
5323 None.
5324 Context:
5326 list (config)
5327 Available versions:
5329 6.2.57b.1 and later.
5330 "include_ldap_ca.suffix"
5332 suffix
5334 Format:
5336 /".+"/
5337 Default:
5339 None.
5340 Context:
5342 list (config)
5343 "include_ldap_ca.scope"
5345 search scope
5347 Format:
5349 "base" - base
5350 "one" - one level
5351 "sub" - subtree
5352 Default:
5353 "sub"
5354 Context:
5356 list (config)
5357 "include_ldap_ca.timeout"
5359 connection timeout
5361 Format:
5363 Number of seconds.
5364 Default:
5366 30 (seconds)
5367 Context:
5369 list (config)
5370 "include_ldap_ca.filter"
5372 filter
5374 Format:
5376 /".+"/
5377 Default:
5379 None, mandatory.
5380 Context:
5382 list (config)
5383 "include_ldap_ca.attrs"
5385 extracted attribute
5387 Format:
5389 /"$ldap_attrdesc(\s*,\s*$ldap_attrdesc)?"/
5390 Default:
5392 "mail"
5393 Context:
5395 list (config)
5396 "include_ldap_ca.email_entry"
5398 Name of email entry
5400 Format:
5402 /"\S+"/
5403 Default:
5405 None, mandatory.
5406 Context:
5408 list (config)
5409 "include_ldap_ca.select"
5411 selection (if multiple)
5413 Format:
5415 "all" - all
5416 "first" - first entry
5417 "regex" - entries matching regular expression
5418 Default:
5419 "first"
5420 Context:
5422 list (config)
5423 "include_ldap_ca.regex"
5425 regular expression
5427 Format:
5429 /".+"/
5430 Default:
5432 ""
5433 Context:
5435 list (config)
5436 "include_ldap_ca.nosync_time_ranges"
5438 Time ranges when inclusion is not allowed
5440 Format:
5442 /$time_ranges/
5443 Default:
5445 None.
5446 Context:
5448 list (config)
5449 "include_ldap_ca.passwd"
5451 See "bind_password".
5453 Context:
5455 list (config)
5456 Available versions:
5458 up to 6.2.56.
5459 "include_ldap_ca.port"
5461 Deprecated.
5463 Context:
5465 list (config)
5466 "include_ldap_ca.use_ssl"
5468 See "use_tls".
5470 Context:
5472 list (config)
5473 Available versions:
5475 6.2a? to 6.2.14.
5476 "include_ldap_ca.user"
5478 See "bind_dn".
5480 Context:
5482 list (config)
5483 Available versions:
5485 up to 6.2.56.
5486 "include_ldap_2level_ca"
5488 (Paragraph) LDAP 2-level query custom attribute
5490 Multiple occurrences allowed
5492 "include_ldap_2level_ca.name"
5494 short name for this source
5496 Format:
5498 /".+"/
5499 Default:
5501 None.
5502 Context:
5504 list (config)
5505 "include_ldap_2level_ca.host"
5507 remote host
5509 Format:
5511 /$multiple_host_or_url/
5512 Default:
5514 None, mandatory.
5515 Context:
5517 list (config)
5518 "include_ldap_2level_ca.use_tls"
5520 use TLS (formerly SSL)
5522 Format:
5524 "starttls" - use STARTTLS
5525 "ldaps" - use LDAPS (LDAP over TLS)
5526 "none" - do nothing
5527 Default:
5528 "none"
5529 Context:
5531 list (config)
5532 Available versions:
5534 6.2.15 and later.
5535 "include_ldap_2level_ca.ssl_version"
5537 SSL version
5539 Format:
5541 "sslv2" - SSL version 2
5542 "sslv3" - SSL version 3
5543 "tlsv1" - TLS version 1
5544 "tlsv1_1" - TLS version 1.1
5545 "tlsv1_2" - TLS version 1.2
5546 "tlsv1_3" - TLS version 1.3
5547 Default:
5548 "tlsv1"
5549 Context:
5551 list (config)
5552 "include_ldap_2level_ca.ssl_ciphers"
5554 SSL ciphers used
5556 Format:
5558 /".+"/
5559 Default:
5561 "ALL"
5562 Context:
5564 list (config)
5565 "include_ldap_2level_ca.ca_verify"
5567 Certificate verification
5569 Format:
5571 "none" - do nothing
5572 "optional" - optional
5573 "required" - required
5574 Default:
5575 "required"
5576 Context:
5578 list (config)
5579 Available versions:
5581 6.2.13 and later.
5582 "include_ldap_2level_ca.bind_dn"
5584 remote user
5586 Format:
5588 /".+"/
5589 Default:
5591 None.
5592 Context:
5594 list (config)
5595 Available versions:
5597 6.2.57b.1 and later.
5598 "include_ldap_2level_ca.bind_password"
5600 remote password
5602 Format:
5604 The value to be concealed.
5605 Default:
5607 None.
5608 Context:
5610 list (config)
5611 Available versions:
5613 6.2.57b.1 and later.
5614 "include_ldap_2level_ca.suffix1"
5616 first-level suffix
5618 Format:
5620 /".+"/
5621 Default:
5623 None.
5624 Context:
5626 list (config)
5627 "include_ldap_2level_ca.scope1"
5629 first-level search scope
5631 Format:
5633 "base" - base
5634 "one" - one level
5635 "sub" - subtree
5636 Default:
5637 "sub"
5638 Context:
5640 list (config)
5641 "include_ldap_2level_ca.timeout1"
5643 first-level connection timeout
5645 Format:
5647 Number of seconds.
5648 Default:
5650 30 (seconds)
5651 Context:
5653 list (config)
5654 "include_ldap_2level_ca.filter1"
5656 first-level filter
5658 Format:
5660 /".+"/
5661 Default:
5663 None, mandatory.
5664 Context:
5666 list (config)
5667 "include_ldap_2level_ca.attrs1"
5669 first-level extracted attribute
5671 Format:
5673 /$ldap_attrdesc/
5674 Default:
5676 None.
5677 Context:
5679 list (config)
5680 "include_ldap_2level_ca.select1"
5682 first-level selection
5684 Format:
5686 "all" - all
5687 "first" - first entry
5688 "regex" - entries matching regular expression
5689 Default:
5690 "first"
5691 Context:
5693 list (config)
5694 "include_ldap_2level_ca.regex1"
5696 first-level regular expression
5698 Format:
5700 /".+"/
5701 Default:
5703 ""
5704 Context:
5706 list (config)
5707 "include_ldap_2level_ca.suffix2"
5709 second-level suffix template
5711 Format:
5713 /".+"/
5714 Default:
5716 None.
5717 Context:
5719 list (config)
5720 "include_ldap_2level_ca.scope2"
5722 second-level search scope
5724 Format:
5726 "base" - base
5727 "one" - one level
5728 "sub" - subtree
5729 Default:
5730 "sub"
5731 Context:
5733 list (config)
5734 "include_ldap_2level_ca.timeout2"
5736 second-level connection timeout
5738 Format:
5740 Number of seconds.
5741 Default:
5743 30 (seconds)
5744 Context:
5746 list (config)
5747 "include_ldap_2level_ca.filter2"
5749 second-level filter template
5751 Format:
5753 /".+"/
5754 Default:
5756 None, mandatory.
5757 Context:
5759 list (config)
5760 "include_ldap_2level_ca.attrs2"
5762 second-level extracted attribute
5764 Format:
5766 /$ldap_attrdesc/
5767 Default:
5769 "mail"
5770 Context:
5772 list (config)
5773 "include_ldap_2level_ca.select2"
5775 second-level selection
5777 Format:
5779 "all" - all
5780 "first" - first entry
5781 "regex" - entries matching regular expression
5782 Default:
5783 "first"
5784 Context:
5786 list (config)
5787 "include_ldap_2level_ca.regex2"
5789 second-level regular expression
5791 Format:
5793 /".+"/
5794 Default:
5796 ""
5797 Context:
5799 list (config)
5800 "include_ldap_2level_ca.email_entry"
5802 Name of email entry
5804 Format:
5806 /"\S+"/
5807 Default:
5809 None, mandatory.
5810 Context:
5812 list (config)
5813 "include_ldap_2level_ca.nosync_time_ranges"
5815 Time ranges when inclusion is not allowed
5817 Format:
5819 /$time_ranges/
5820 Default:
5822 None.
5823 Context:
5825 list (config)
5826 "include_ldap_2level_ca.passwd"
5828 See "bind_password".
5830 Context:
5832 list (config)
5833 Available versions:
5835 up to 6.2.56.
5836 "include_ldap_2level_ca.port"
5838 Deprecated.
5840 Context:
5842 list (config)
5843 "include_ldap_2level_ca.use_ssl"
5845 See "use_tls".
5847 Context:
5849 list (config)
5850 Available versions:
5852 6.2a? to 6.2.14.
5853 "include_ldap_2level_ca.user"
5855 See "bind_dn".
5857 Context:
5859 list (config)
5860 Available versions:
5862 up to 6.2.56.
5863 "include_sql_ca"
5865 (Paragraph) SQL query custom attribute
5867 Multiple occurrences allowed
5869 "include_sql_ca.name"
5871 short name for this source
5873 Format:
5875 /".+"/
5876 Default:
5878 None.
5879 Context:
5881 list (config)
5882 "include_sql_ca.db_type"
5884 database type
5886 Format:
5888 /"\S+"/
5889 Default:
5891 None, mandatory.
5892 Context:
5894 list (config)
5895 "include_sql_ca.db_name"
5897 database name
5899 Format:
5901 /"\S+"/
5902 Default:
5904 None, mandatory.
5905 Context:
5907 list (config)
5908 "include_sql_ca.db_host"
5910 remote host
5912 Format:
5914 /$host/
5915 Default:
5917 None.
5918 Context:
5920 list (config)
5921 Available versions:
5923 6.2.57b.1 and later.
5924 "include_sql_ca.db_port"
5926 database port
5928 Format:
5930 /"\d+"/
5931 Default:
5933 None.
5934 Context:
5936 list (config)
5937 "include_sql_ca.db_options"
5939 connection options
5941 Format:
5943 /".+"/
5944 Default:
5946 None.
5947 Context:
5949 list (config)
5950 Available versions:
5952 6.2.57b.1 and later.
5953 "include_sql_ca.db_env"
5955 environment variables for database connection
5957 Format:
5959 /"\w+\=\S+(;\w+\=\S+)*"/
5960 Default:
5962 None.
5963 Context:
5965 list (config)
5966 "include_sql_ca.db_user"
5968 remote user
5970 Format:
5972 /"\S+"/
5973 Default:
5975 None.
5976 Context:
5978 list (config)
5979 Available versions:
5981 6.2.57b.1 and later.
5982 "include_sql_ca.db_passwd"
5984 remote password
5986 Format:
5988 The value to be concealed.
5989 Default:
5991 None.
5992 Context:
5994 list (config)
5995 Available versions:
5997 6.2.57b.1 and later.
5998 "include_sql_ca.sql_query"
6000 SQL query
6002 Format:
6004 /$sql_query/
6005 Default:
6007 None, mandatory.
6008 Context:
6010 list (config)
6011 "include_sql_ca.f_dir"
6013 See "db_name".
6015 Context:
6017 list (config)
6018 Available versions:
6020 up to 6.2.70.
6021 "include_sql_ca.email_entry"
6023 Name of email entry
6025 Format:
6027 /"\S+"/
6028 Default:
6030 None, mandatory.
6031 Context:
6033 list (config)
6034 "include_sql_ca.nosync_time_ranges"
6036 Time ranges when inclusion is not allowed
6038 Format:
6040 /$time_ranges/
6041 Default:
6043 None.
6044 Context:
6046 list (config)
6047 "include_sql_ca.connect_options"
6049 See "db_options".
6051 Context:
6053 list (config)
6054 Available versions:
6056 up to 6.2.56.
6057 "include_sql_ca.host"
6059 See "db_host".
6061 Context:
6063 list (config)
6064 Available versions:
6066 up to 6.2.56.
6067 "include_sql_ca.passwd"
6069 See "db_passwd".
6071 Context:
6073 list (config)
6074 Available versions:
6076 up to 6.2.56.
6077 "include_sql_ca.user"
6079 See "db_user".
6081 Context:
6083 list (config)
6084 Available versions:
6086 up to 6.2.56.
6087 DKIM/DMARC/ARC
6089 DKIM signature verification and re-signing. It requires an external
6090 module: Mail-DKIM.
6091 ARC seals on forwarded messages. It requires an external module: Mail-
6093 DKIM.
6094 "dkim_add_signature_to"
6096 Which service messages to be signed
6098 Format:
6100 /"(?:list|robot)(?:,(?:list|robot))*"/
6101 Default:
6103 "robot,list"
6104 Context:
6106 domain (robot.conf), site (sympa.conf)
6107 Inserts a DKIM signature to service messages in context of robot, list
6109 or both
6110 "dkim_signer_identity"
6112 The "i=" tag as defined in rfc 4871
6114 Format:
6116 /"\S+"/
6117 Default:
6119 None.
6120 Context:
6122 domain (robot.conf), site (sympa.conf)
6123 Default is null.
6125 "dkim_feature"
6127 Insert DKIM signature to messages sent to the list
6129 Format:
6131 "on" - enabled
6132 "off" - disabled
6133 Default:
6134 "off"
6135 Context:
6137 domain (robot.conf), site (sympa.conf)
6138 If set to "on", Sympa may verify DKIM signatures of incoming messages
6140 and/or insert DKIM signature to outgoing messages.
6141 "dkim_parameters"
6143 (Paragraph) DKIM configuration
6145 Single occurrence
6147 A set of parameters in order to define outgoing DKIM signature
6149 "dkim_parameters.private_key_path"
6151 File path for DKIM private key
6153 Format:
6155 /"\S+"/
6156 Default:
6158 None.
6159 Context:
6161 list (config), domain (robot.conf), site (sympa.conf)
6162 The file must contain a PEM encoded private key
6164 "dkim_parameters.selector"
6166 Selector for DNS lookup of DKIM public key
6168 Format:
6170 /"\S+"/
6171 Default:
6173 None.
6174 Context:
6176 list (config), domain (robot.conf), site (sympa.conf)
6177 The selector is used in order to build the DNS query for public key. It
6179 is up to you to choose the value you want but verify that you can query
6180 the public DKIM key for "<selector>._domainkey.your_domain"
6181 "dkim_parameters.header_list"
6183 Deprecated.
6185 Context:
6187 list (config), domain (robot.conf), site (sympa.conf)
6188 "dkim_parameters.signer_domain"
6190 DKIM "d=" tag, you should probably use the default value
6192 Format:
6194 /$domain/
6195 Default:
6197 None.
6198 Context:
6200 list (config), domain (robot.conf), site (sympa.conf)
6201 The DKIM "d=" tag, is the domain of the signing entity. The list domain
6203 MUST be included in the "d=" domain
6204 "dkim_parameters.signer_identity"
6206 DKIM "i=" tag, you should probably leave this parameter empty
6208 Format:
6210 /"\S+"/
6211 Default:
6213 None.
6214 Context:
6216 list (config)
6217 DKIM "i=" tag, you should probably not use this parameter, as
6219 recommended by RFC 4871, default for list broadcasted messages is
6220 i=<listname>-request@<domain>
6221 "dkim_signature_apply_on"
6223 The categories of messages sent to the list that will be signed using
6225 DKIM.
6226 Format:
6228 Multiple values allowed, separated by "","".
6229 "md5_authenticated_messages" - authenticated by password
6231 "smime_authenticated_messages" - authenticated by S/MIME signature
6232 "dkim_authenticated_messages" - authenticated by DKIM signature
6233 "editor_validated_messages" - approved by moderator
6234 "none" - do nothing
6235 "any" - any messages
6236 Default:
6237 "md5_authenticated_messages,smime_authenticated_messages,dkim_authenticated_messages,editor_validated_messages"
6238 Context:
6240 list (config), domain (robot.conf), site (sympa.conf)
6241 This parameter controls in which case messages must be signed using
6243 DKIM, you may sign every message choosing 'any' or a subset. The
6244 parameter value is a comma separated list of keywords
6245 "arc_feature"
6247 Add ARC seals to messages sent to the list
6249 Format:
6251 "on" - enabled
6252 "off" - disabled
6253 Default:
6254 "off"
6255 Context:
6257 list (config), domain (robot.conf), site (sympa.conf)
6258 Available versions:
6260 6.2.37b.1 and later.
6261 Enable/Disable ARC. This feature requires Mail::DKIM::ARC to be
6263 installed, and maybe some custom scenario to be updated
6264 "arc_srvid"
6266 SRV ID for Authentication-Results used in ARC seal
6268 Format:
6270 /$rfc2045_parameter_value/
6271 Default:
6273 None.
6274 Context:
6276 domain (robot.conf), site (sympa.conf)
6277 Available versions:
6279 6.2.37b.1 and later.
6280 Typically the domain of the mail server
6282 "arc_parameters"
6284 (Paragraph) ARC configuration
6286 Single occurrence
6288 A set of parameters in order to define outgoing ARC seal
6290 "arc_parameters.private_key_path"
6292 File path for ARC private key
6294 Format:
6296 /"\S+"/
6297 Default:
6299 None.
6300 Context:
6302 list (config), domain (robot.conf), site (sympa.conf)
6303 The file must contain a PEM encoded private key. Defaults to same file
6305 as DKIM private key
6306 "arc_parameters.selector"
6308 Selector for DNS lookup of ARC public key
6310 Format:
6312 /"\S+"/
6313 Default:
6315 None.
6316 Context:
6318 list (config), domain (robot.conf), site (sympa.conf)
6319 The selector is used in order to build the DNS query for public key. It
6321 is up to you to choose the value you want but verify that you can query
6322 the public DKIM key for "<selector>._domainkey.your_domain". Default is
6323 the same selector as for DKIM signatures
6324 "arc_parameters.signer_domain"
6326 ARC "d=" tag, you should probably use the default value
6328 Format:
6330 /$domain/
6331 Default:
6333 None.
6334 Context:
6336 list (config), domain (robot.conf), site (sympa.conf)
6337 The ARC "d=" tag is the domain of the signing entity. The DKIM d=
6339 domain name is used as its default value
6340 "arc_parameters.arc_private_key_path"
6342 See "private_key_path".
6344 Context:
6346 list (config)
6347 Available versions:
6349 up to 6.2.70.
6350 "arc_parameters.arc_selector"
6352 See "selector".
6354 Context:
6356 list (config)
6357 Available versions:
6359 up to 6.2.70.
6360 "arc_parameters.arc_signer_domain"
6362 See "signer_domain".
6364 Context:
6366 list (config)
6367 Available versions:
6369 up to 6.2.70.
6370 "dmarc_protection"
6372 (Paragraph) DMARC Protection
6374 Single occurrence
6376 Parameters to define how to manage From address processing to avoid
6378 some domains' excessive DMARC protection
6379 "dmarc_protection.mode"
6381 Protection modes
6383 Format:
6385 Multiple values allowed, separated by "","".
6386 "none" - do nothing
6388 "all" - all
6389 "dkim_signature" - DKIM signature exists
6390 "dmarc_reject" - DMARC policy suggests rejection
6391 "dmarc_any" - DMARC policy exists
6392 "dmarc_quarantine" - DMARC policy suggests quarantine
6393 "domain_regex" - domain matching regular expression
6394 Default:
6395 None.
6396 Context:
6398 list (config), domain (robot.conf), site (sympa.conf)
6399 Select one or more operation modes. "Domain matching regular
6401 expression" (domain_regex) matches the specified Domain regular
6402 expression; "DKIM signature exists" (dkim_signature) matches any
6403 message with a DKIM signature header; "DMARC policy ..." (dmarc_*)
6404 matches messages from sender domains with a DMARC policy as given;
6405 "all" (all) matches all messages.
6406 Example:
6408 dmarc_protection.mode dmarc_reject,dkim_signature
6410 "dmarc_protection.domain_regex"
6412 Regular expression for domain name match
6414 Format:
6416 /".+"/
6417 Default:
6419 None.
6420 Context:
6422 list (config), domain (robot.conf), site (sympa.conf)
6423 Regular expression match pattern for From domain
6425 "dmarc_protection.other_email"
6427 New From address
6429 Format:
6431 /".+"/
6432 Default:
6434 None.
6435 Context:
6437 list (config), domain (robot.conf), site (sympa.conf)
6438 This is the email address to use when modifying the From header. It
6440 defaults to the list address. This is similar to Anonymisation but
6441 preserves the original sender details in the From address phrase.
6442 "dmarc_protection.phrase"
6444 New From name format
6446 Format:
6448 "display_name" - "Name"
6449 "name_and_email" - "Name" (e-mail)
6450 "name_via_list" - "Name" (via List)
6451 "name_email_via_list" - "Name" (e-mail via List)
6452 "list_for_name" - "List" (on behalf of Name)
6453 "list_for_email" - "List" (on behalf of e-mail)
6454 Default:
6455 "name_via_list"
6456 Context:
6458 list (config), domain (robot.conf), site (sympa.conf)
6459 This is the format to be used for the sender name part of the new From
6461 header field.
6462 List address verification
6464 Checks if an alias with the same name as the list to be created already
6465 exists on the SMTP server. This feature requires an external module:
6466 Net-SMTP.
6467 "list_check_helo"
6469 SMTP HELO (EHLO) parameter used for address verification
6471 Format:
6473 /"\S+"/
6474 Default:
6476 None.
6477 Context:
6479 domain (robot.conf), site (sympa.conf)
6480 Available versions:
6482 6.2a.0 and later.
6483 Default value is the host part of "list_check_smtp" parameter.
6485 "list_check_smtp"
6487 SMTP server to verify existence of the same addresses as the list to be
6489 created
6490 Format:
6492 /$hostport/
6493 Default:
6495 None.
6496 Context:
6498 domain (robot.conf), site (sympa.conf)
6499 This is needed if you are running Sympa on a host but you handle all
6501 your mail on a separate mail relay.
6502 Default value is real FQDN of the host. Port number may be specified as
6504 "mail.example.org:25" or "203.0.113.1:25". If port is not specified,
6505 standard port (25) will be used.
6506 "list_check_suffixes"
6508 Address suffixes to verify
6510 Format:
6512 /"\S+"/
6513 Default:
6515 "request,owner,editor,unsubscribe,subscribe"
6516 Context:
6518 domain (robot.conf), site (sympa.conf)
6519 List of suffixes you are using for list addresses, i.e. "mylist-
6521 request", "mylist-owner" and so on.
6522 This parameter is used with the "list_check_smtp" parameter. It is also
6524 used to check list names at list creation time.
6525 Antivirus plug-in
6527 "antivirus_path"
6528 Path to the antivirus scanner engine
6530 Format:
6532 /".+"/
6533 Default:
6535 None.
6536 Context:
6538 domain (robot.conf), site (sympa.conf)
6539 Supported antivirus: Clam AntiVirus/clamscan & clamdscan,
6541 McAfee/uvscan, Fsecure/fsav, Sophos, AVP and Trend Micro/VirusWall
6542 Example:
6544 antivirus_path /usr/local/bin/clamscan
6546 "antivirus_args"
6548 Antivirus plugin command line arguments
6550 Format:
6552 /".+"/
6553 Default:
6555 None.
6556 Context:
6558 domain (robot.conf), site (sympa.conf)
6559 Example:
6561 antivirus_args --no-summary --database /usr/local/share/clamav
6563 "antivirus_notify"
6565 Notify sender if virus checker detects malicious content
6567 Format:
6569 "sender" - sender
6570 "delivery_status" - send back DSN
6571 "none" - do nothing
6572 Default:
6573 "sender"
6574 Context:
6576 domain (robot.conf), site (sympa.conf)
6577 "sender" to notify originator of the message, "delivery_status" to send
6579 delivery status, or "none"
6580 Miscellaneous
6582 "email"
6583 Local part of Sympa email address
6585 Format:
6587 /"\S+"/
6588 Default:
6590 "sympa"
6591 Context:
6593 domain (robot.conf), site (sympa.conf)
6594 Local part (the part preceding the "@" sign) of the address by which
6596 mail interface of Sympa accepts mail commands.
6597 If you change the default value, you must modify the mail aliases too.
6599 "listmaster_email"
6601 Local part of listmaster email address
6603 Format:
6605 /"\S+"/
6606 Default:
6608 "listmaster"
6609 Context:
6611 domain (robot.conf), site (sympa.conf)
6612 Local part (the part preceding the "@" sign) of the address by which
6614 listmasters receive messages.
6615 If you change the default value, you must modify the mail aliases too.
6617 "custom_robot_parameter"
6619 Custom robot parameter
6621 Format:
6623 Multiple occurrences allowed.
6624 /".+"/
6626 Default:
6628 None.
6629 Context:
6631 domain (robot.conf), site (sympa.conf)
6632 Used to define a custom parameter for your server. Do not forget the
6634 semicolon between the parameter name and the parameter value.
6635 You will be able to access the custom parameter value in web templates
6637 by variable "conf.custom_robot_parameter.<param_name>"
6638 Example:
6640 custom_robot_parameter param_name ; param_value
6642 "prohibited_listnames"
6644 Prevent people to use some names for their lists names
6646 Format:
6648 Any.
6649 Default:
6651 None.
6652 Context:
6654 site (sympa.conf)
6655 Available versions:
6657 6.2.63b.1 and later.
6658 This parameter is a comma-separated list of names. You can use * as a
6660 wildcard character. To use a regex for this, please use
6661 prohibited_listnames_regex setting.
6662 Example:
6664 prohibited_listnames www,root,*master
6666 "prohibited_listnames_regex"
6668 Prevent people to use some names for their lists names, based on a
6670 regex
6671 Format:
6673 Any.
6674 Default:
6676 None.
6677 Context:
6679 site (sympa.conf)
6680 Available versions:
6682 6.2.63b.1 and later.
6683 This parameter is a regex. Please note that prohibited_listnames and
6685 prohibited_listnames_regex will both be applied if set, they are not
6686 exclusive.
6687 Example:
6689 prohibited_listnames_regex www|root|.*master
6691 "cache_list_config"
6693 Use of binary cache of list configuration
6695 Format:
6697 "binary_file" - use binary file
6698 "none" - do nothing
6699 Default:
6700 "none"
6701 Context:
6703 site (sympa.conf)
6704 binary_file: Sympa processes will maintain a binary version of the list
6706 configuration, "config.bin" file on local disk. If you manage a big
6707 amount of lists (1000+), it should make the web interface startup
6708 faster.
6709 You can recreate cache by running "sympa.pl --reload_list_config".
6711 "db_list_cache"
6713 Use database cache to search lists
6715 Format:
6717 "on" - enabled
6718 "off" - disabled
6719 Default:
6720 "off"
6721 Context:
6723 site (sympa.conf)
6724 Note that "list_table" database table should be filled at the first
6726 time by running:
6727 # sympa.pl --sync_list_db
6729 "purge_user_table_task"
6731 Task for expiring inactive users
6733 Format:
6735 /"\w+"/
6736 Default:
6738 "monthly"
6739 Context:
6741 site (sympa.conf)
6742 This task removes rows in the "user_table" table which have not
6744 corresponding entries in the "subscriber_table" table.
6745 "purge_logs_table_task"
6747 Task for cleaning tables
6749 Format:
6751 /"\w+"/
6752 Default:
6754 "daily"
6755 Context:
6757 site (sympa.conf)
6758 This task cleans old logs from "logs_table" table.
6760 "logs_expiration_period"
6762 Max age of logs in database
6764 Format:
6766 Number of months.
6767 Default:
6769 3 (months)
6770 Context:
6772 site (sympa.conf)
6773 Number of months that elapse before a log is expired
6775 "stats_expiration_period"
6777 Max age of statistics information in database
6779 Format:
6781 Number of months.
6782 Default:
6784 3 (months)
6785 Context:
6787 site (sympa.conf)
6788 Available versions:
6790 6.2b.7 and later.
6791 Number of months that elapse before statistics information are expired
6793 "umask"
6795 Umask
6797 Format:
6799 /"[0-7]+"/
6800 Default:
6802 027
6803 Context:
6805 site (sympa.conf)
6806 Default mask for file creation (see umask(2)). Note that it will be
6808 interpreted as an octal value.
6809 "clean_delay_queuemod"
6811 Max age of moderated messages
6813 Format:
6815 Number of days.
6816 Default:
6818 30 (days)
6819 Context:
6821 list (config), site (sympa.conf)
6822 Number of days messages are kept in moderation spool (as specified by
6824 "queuemod" parameter). Beyond this deadline, messages that have not
6825 been processed are deleted.
6826 "custom_attribute"
6828 (Paragraph) Custom user attributes
6830 Multiple occurrences allowed
6832 "custom_attribute.id"
6834 internal identifier
6836 Format:
6838 /"\w+"/
6839 Default:
6841 None, mandatory.
6842 Context:
6844 list (config)
6845 "custom_attribute.name"
6847 label
6849 Format:
6851 /".+"/
6852 Default:
6854 None, mandatory.
6855 Context:
6857 list (config)
6858 "custom_attribute.comment"
6860 additional comment
6862 Format:
6864 /".+"/
6865 Default:
6867 None.
6868 Context:
6870 list (config)
6871 "custom_attribute.type"
6873 type
6875 Format:
6877 "string" - string
6878 "text" - multi-line text
6879 "integer" - number
6880 "enum" - set of keywords
6881 Default:
6882 "string"
6883 Context:
6885 list (config)
6886 "custom_attribute.enum_values"
6888 possible attribute values (if enum is used)
6890 Format:
6892 /".+"/
6893 Default:
6895 None.
6896 Context:
6898 list (config)
6899 "custom_attribute.optional"
6901 is the attribute optional?
6903 Format:
6905 "required" - required
6906 "optional" - optional
6907 Default:
6908 "optional"
6909 Context:
6911 list (config)
6912 "custom_vars"
6914 (Paragraph) custom parameters
6916 Multiple occurrences allowed
6918 "custom_vars.name"
6920 var name
6922 Format:
6924 /"\S+"/
6925 Default:
6927 None, mandatory.
6928 Context:
6930 list (config)
6931 "custom_vars.value"
6933 var value
6935 Format:
6937 /".+"/
6938 Default:
6940 None, mandatory.
6941 Context:
6943 list (config)
6944 "loop_prevention_regex"
6946 Regular expression applied to prevent loops with robots
6948 Format:
6950 /"\S*"/
6951 Default:
6953 "mailer-daemon|sympa|listserv|majordomo|smartlist|mailman"
6954 Context:
6956 list (config), domain (robot.conf), site (sympa.conf)
6957 If the sender address matches the regular expression, then the message
6959 is rejected.
6960 "pictures_feature"
6962 Pictures
6964 Format:
6966 "on" - enabled
6967 "off" - disabled
6968 Default:
6969 "on"
6970 Context:
6972 list (config), domain (robot.conf), site (sympa.conf)
6973 Enables or disables the pictures feature by default. If enabled,
6975 subscribers can upload their picture (from the "Subscriber option"
6976 page) to use as an avatar.
6977 Pictures are stored in a directory specified by the
6979 "static_content_path" parameter.
6980 "remind_task"
6982 Periodical subscription reminder task
6984 Format:
6986 /"\w+"/
6987 Default:
6989 None.
6990 Context:
6992 list (config), site (sympa.conf)
6993 This parameter states which model is used to create a remind task. A
6995 remind task regularly sends subscribers a message which reminds them
6996 of their list subscriptions.
6997 "latest_instantiation"
6999 (Paragraph) Latest family instantiation
7001 Single occurrence
7003 "latest_instantiation.email"
7005 who ran the instantiation
7007 Format:
7009 /"listmaster|$email"/
7010 Default:
7012 None.
7013 Context:
7015 list (config)
7016 "latest_instantiation.date_epoch"
7018 date
7020 Format:
7022 The time in second from Unix epoch.
7023 Default:
7025 None, mandatory.
7026 Context:
7028 list (config)
7029 "latest_instantiation.date"
7031 Deprecated.
7033 Context:
7035 list (config)
7036 Available versions:
7038 up to 6.2.16.
7039 "creation"
7041 (Paragraph) Creation of the list
7043 Single occurrence
7045 "creation.email"
7047 who created the list
7049 Format:
7051 /"listmaster|$email"/
7052 Default:
7054 None, mandatory.
7055 Context:
7057 list (config)
7058 "creation.date_epoch"
7060 date
7062 Format:
7064 The time in second from Unix epoch.
7065 Default:
7067 None, mandatory.
7068 Context:
7070 list (config)
7071 "creation.date"
7073 Deprecated.
7075 Context:
7077 list (config)
7078 Available versions:
7080 up to 6.2.16.
7081 "update"
7083 (Paragraph) Last update of config
7085 Single occurrence
7087 "update.email"
7089 who updated the config
7091 Format:
7093 /"(listmaster|automatic|$email)"/
7094 Default:
7096 None.
7097 Context:
7099 list (config)
7100 "update.date_epoch"
7102 date
7104 Format:
7106 The time in second from Unix epoch.
7107 Default:
7109 None, mandatory.
7110 Context:
7112 list (config)
7113 "update.date"
7115 Deprecated.
7117 Context:
7119 list (config)
7120 Available versions:
7122 up to 6.2.16.
7123 "status"
7125 Status of the list
7127 Format:
7129 Status of list.
7130 Default:
7132 "open"
7133 Context:
7135 list (config)
7136 "serial"
7138 Serial number of the config
7140 Format:
7142 /"\d+"/
7143 Default:
7145 0
7146 Context:
7148 list (config)
7149 Web interface parameters
7151 "wwsympa_url"
7152 URL prefix of web interface
7154 Format:
7156 Any.
7157 Default:
7159 None.
7160 Context:
7162 domain (robot.conf), site (sympa.conf)
7163 This is used to construct URLs of web interface. The protocol (either
7165 https:// or http://) is required.
7166 Example:
7168 wwsympa_url https://web.example.org/sympa
7170 "wwsympa_url_local"
7172 URL prefix of WWSympa behind proxy
7174 Format:
7176 Any.
7177 Default:
7179 None.
7180 Context:
7182 domain (robot.conf), site (sympa.conf)
7183 Available versions:
7185 6.2.56 and later.
7186 "static_content_url"
7188 URL for static contents
7190 Format:
7192 Any.
7193 Default:
7195 "/static-sympa"
7196 Context:
7198 domain (robot.conf), site (sympa.conf)
7199 HTTP server have to map it with "static_content_path" directory.
7201 "static_content_path"
7203 Directory for static contents
7205 Format:
7207 Any.
7208 Default:
7210 $STATICDIR
7211 Context:
7213 domain (robot.conf), site (sympa.conf)
7214 "css_path"
7216 Directory for static style sheets (CSS)
7218 Format:
7220 Any.
7221 Default:
7223 $CSSDIR
7224 Context:
7226 site (sympa.conf)
7227 After an upgrade, static CSS files are upgraded with the newly
7229 installed "css.tt2" template. Therefore, this is not a good place to
7230 store customized CSS files.
7231 "css_url"
7233 URL for style sheets (CSS)
7235 Format:
7237 Any.
7238 Default:
7240 "/static-sympa/css"
7241 Context:
7243 site (sympa.conf)
7244 To use auto-generated static CSS, HTTP server have to map it with
7246 "css_path".
7247 "pictures_path"
7249 Directory for subscribers pictures
7251 Format:
7253 Any.
7254 Default:
7256 $PICTURESDIR
7257 Context:
7259 site (sympa.conf)
7260 Available versions:
7262 6.2.25b.2 and later.
7263 "pictures_url"
7265 URL for subscribers pictures
7267 Format:
7269 Any.
7270 Default:
7272 "/static-sympa/pictures"
7273 Context:
7275 site (sympa.conf)
7276 Available versions:
7278 6.2.25b.2 and later.
7279 HTTP server have to map it with "pictures_path" directory.
7281 "mhonarc"
7283 Path to MHonArc mail-to-HTML converter
7285 Format:
7287 Any.
7288 Default:
7290 "/usr/bin/mhonarc"
7291 Context:
7293 domain (robot.conf), site (sympa.conf)
7294 This is required for HTML mail archiving.
7296 "log_facility"
7298 System log facility for web interface
7300 Format:
7302 Any.
7303 Default:
7305 "LOCAL1"
7306 Context:
7308 site (sympa.conf)
7309 System log facility for WWSympa, archived.pl and bounced.pl. Default is
7311 to use value of "syslog" parameter.
7312 Web interface parameters: Appearances
7314 "logo_html_definition"
7315 Custom logo
7317 Format:
7319 Any.
7320 Default:
7322 None.
7323 Context:
7325 domain (robot.conf), site (sympa.conf)
7326 HTML fragment to insert a logo in the page of web interface.
7328 Example:
7330 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>
7332 "favicon_url"
7334 Custom favicon
7336 Format:
7338 Any.
7339 Default:
7341 None.
7342 Context:
7344 domain (robot.conf), site (sympa.conf)
7345 Available versions:
7347 6.2a.5 and later.
7348 URL of favicon image
7350 "default_home"
7352 Type of main web page
7354 Format:
7356 Any.
7357 Default:
7359 "home"
7360 Context:
7362 domain (robot.conf), site (sympa.conf)
7363 "lists" for the page of list of lists. "home" for home page.
7365 "archive_default_index"
7367 Default index organization of web archive
7369 Format:
7371 Any.
7372 Default:
7374 "thrd"
7375 Context:
7377 site (sympa.conf)
7378 thrd: Threaded index.
7380 mail: Chronological index.
7382 "review_page_size"
7384 Size of review page
7386 Format:
7388 Any.
7389 Default:
7391 25
7392 Context:
7394 domain (robot.conf), site (sympa.conf)
7395 Default number of lines of the array displaying users in the review
7397 page
7398 "viewlogs_page_size"
7400 Size of viewlogs page
7402 Format:
7404 Any.
7405 Default:
7407 25
7408 Context:
7410 domain (robot.conf), site (sympa.conf)
7411 Default number of lines of the array displaying the log entries in the
7413 logs page.
7414 "main_menu_custom_button_1_title", ...
7416 "main_menu_custom_button_3_title", "main_menu_custom_button_1_url", ...
7417 "main_menu_custom_button_3_url", "main_menu_custom_button_1_target",
7418 ... "main_menu_custom_button_3_target"
7419 Custom menus
7421 Format:
7423 Any.
7424 Default:
7426 None.
7427 Context:
7429 domain (robot.conf), site (sympa.conf)
7430 You may modify the main menu content by editing the menu.tt2 file, but
7432 you can also edit these parameters in order to add up to 3 buttons.
7433 Each button is defined by a title (the text in the button), an URL and,
7434 optionally, a target.
7435 Example:
7437 main_menu_custom_button_1_title FAQ
7439 main_menu_custom_button_1_url http://www.renater.fr/faq/universalistes/index
7440 main_menu_custom_button_1_target Help
7441 Password validation
7443 Checks if the password the user submitted has sufficient strength. This
7444 feature requires an external module: Data-Password.
7445 "password_validation"
7447 Password validation
7449 Format:
7451 Any.
7452 Default:
7454 None.
7455 Context:
7457 site (sympa.conf)
7458 Available versions:
7460 6.1.23 and later.
7461 The password validation techniques to be used against user passwords
7463 that are added to mailing lists. Options come from Data::Password
7464 https://metacpan.org/pod/Data::Password#VARIABLES
7465 Example:
7467 password_validation MINLEN=8,GROUPS=3,DICTIONARY=4,DICTIONARIES=/pentest/dictionaries
7469 Authentication with LDAP
7471 Authenticates users based on the directory on LDAP server. This feature
7472 requires an external module: Net-LDAP. And also, if secure connection
7473 (LDAPS) is required: IO-Socket-SSL.
7474 "ldap_force_canonical_email"
7476 Use canonical email address for LDAP authentication
7478 Format:
7480 Any.
7481 Default:
7483 1
7484 Context:
7486 domain (robot.conf), site (sympa.conf)
7487 When using LDAP authentication, if the identifier provided by the user
7489 was a valid email, if this parameter is set to false, then the provided
7490 email will be used to authenticate the user. Otherwise, use of the
7491 first email returned by the LDAP server will be used.
7492 SOAP HTTP interface
7494 Provides some functions of Sympa through the SOAP HTTP interface. This
7495 feature requires an external module: SOAP-Lite.
7496 "soap_url"
7498 URL of SympaSOAP
7500 Format:
7502 Any.
7503 Default:
7505 None.
7506 Context:
7508 domain (robot.conf), site (sympa.conf)
7509 WSDL document of SympaSOAP refers to this URL in its service section.
7511 Example:
7513 soap_url http://web.example.org/sympasoap
7515 "soap_url_local"
7517 URL of SympaSOAP behind proxy
7519 Format:
7521 Any.
7522 Default:
7524 None.
7525 Context:
7527 domain (robot.conf), site (sympa.conf)
7528 Available versions:
7530 6.2.19b.1 and later.
7531 Web interface parameters: Miscellaneous
7533 "cookie_domain"
7534 HTTP cookies validity domain
7536 Format:
7538 Any.
7539 Default:
7541 "localhost"
7542 Context:
7544 domain (robot.conf), site (sympa.conf)
7545 If beginning with a dot ("."), the cookie is available within the
7547 specified Internet domain. Otherwise, for the specified host. The only
7548 reason for replacing the default value would be where WWSympa's
7549 authentication process is shared with an application running on another
7550 host.
7551 Example:
7553 cookie_domain .renater.fr
7555 "cookie_expire"
7557 HTTP cookies lifetime
7559 Format:
7561 Any.
7562 Default:
7564 0
7565 Context:
7567 site (sympa.conf)
7568 This is the default value when not set explicitly by users. "0" means
7570 the cookie may be retained during browser sessions.
7571 "cookie_refresh"
7573 Average interval to refresh HTTP session ID.
7575 Format:
7577 Any.
7578 Default:
7580 60
7581 Context:
7583 site (sympa.conf)
7584 "purge_session_table_task"
7586 Task for cleaning old sessions
7588 Format:
7590 /"\w+"/
7591 Default:
7593 "daily"
7594 Context:
7596 site (sympa.conf)
7597 This task removes old entries in the "session_table" table.
7599 "session_table_ttl"
7601 Max age of sessions
7603 Format:
7605 Any.
7606 Default:
7608 "2d"
7609 Context:
7611 site (sympa.conf)
7612 Session duration is controlled by "sympa_session" cookie validity
7614 attribute. However, by security reason, this delay also need to be
7615 controlled by server side. This task removes old entries in the
7616 "session_table" table.
7617 Format of values is a string without spaces including "y" for years,
7619 "m" for months, "d" for days, "h" for hours, "min" for minutes and
7620 "sec" for seconds.
7621 "anonymous_session_table_ttl"
7623 Max age of sessions for anonymous users
7625 Format:
7627 Any.
7628 Default:
7630 "1h"
7631 Context:
7633 site (sympa.conf)
7634 "shared_feature"
7636 Enable shared repository
7638 Format:
7640 "on" - enabled
7641 "off" - disabled
7642 Default:
7643 "off"
7644 Context:
7646 domain (robot.conf), site (sympa.conf)
7647 Available versions:
7649 6.2.41b.2 and later.
7650 If set to "on", list owners can open shared repository.
7652 "shared_doc"
7654 (Paragraph) Shared documents
7656 Single occurrence
7658 This paragraph defines read and edit access to the shared document
7660 repository.
7661 "shared_doc.d_read"
7663 Who can view
7665 Format:
7667 Name of "d_read" scenario:
7668 "owner" - restricted to list owners
7670 "private" - restricted to subscribers
7671 "private-https" - restricted to subscribers authenticated with user
7672 cert
7673 "public" - public documents
7674 Default:
7675 "private"
7676 Context:
7678 list (config), domain (robot.conf), site (sympa.conf)
7679 "shared_doc.d_edit"
7681 Who can edit
7683 Format:
7685 Name of "d_edit" scenario:
7686 "editor" - moderated for subscribers
7688 "owner" - restricted to list owners
7689 "private" - restricted to subscribers
7690 "private-https" - restricted to subscribers authenticated with user
7691 cert
7692 "public" - public documents
7693 Default:
7694 "owner"
7695 Context:
7697 list (config), domain (robot.conf), site (sympa.conf)
7698 "shared_doc.quota"
7700 quota
7702 Format:
7704 Number of Kbytes.
7705 Default:
7707 None.
7708 Context:
7710 list (config), domain (robot.conf), site (sympa.conf)
7711 "use_html_editor"
7713 Use HTML editor
7715 Format:
7717 "off" - disabled
7718 "on" - enabled
7719 Default:
7720 "off"
7721 Context:
7723 domain (robot.conf), site (sympa.conf)
7724 Available versions:
7726 6.2a.0 and later.
7727 If set to "on", users will be able to post messages in HTML using a
7729 javascript WYSIWYG editor.
7730 Example:
7732 use_html_editor on
7734 "html_editor_url"
7736 URL of HTML editor
7738 Format:
7740 Any.
7741 Default:
7743 None.
7744 Context:
7746 domain (robot.conf), site (sympa.conf)
7747 Available versions:
7749 6.2a.34 and later.
7750 URL path to the javascript file making the WYSIWYG HTML editor
7752 available. Relative path under <static_content_url> or absolute path.
7753 Example is for TinyMCE 4 installed under
7755 <static_content_path>/js/tinymce/.
7756 Example:
7758 html_editor_url js/tinymce/tinymce.min.js
7760 "html_editor_init"
7762 HTML editor initialization
7764 Format:
7766 Any.
7767 Default:
7769 None.
7770 Context:
7772 domain (robot.conf), site (sympa.conf)
7773 Available versions:
7775 6.2a.0 and later.
7776 Javascript excerpt that enables and configures the WYSIWYG HTML editor.
7778 Example:
7780 html_editor_init tinymce.init({selector:"#body",language:lang.split(/[^a-zA-Z]+/).join("_")});
7782 "max_wrong_password"
7784 Count limit of wrong password submission
7786 Format:
7788 Any.
7789 Default:
7791 19
7792 Context:
7794 domain (robot.conf), site (sympa.conf)
7795 If this limit is reached, the account is locked until the user renews
7797 their password. The default value is chosen in order to block bots
7798 trying to log in using brute force strategy. This value should never be
7799 reached by real users that will probably uses the renew password
7800 service before they performs so many tries.
7801 "password_case"
7803 Password case
7805 Format:
7807 Any.
7808 Default:
7810 "insensitive"
7811 Context:
7813 site (sympa.conf)
7814 "insensitive" or "sensitive".
7816 If set to "insensitive", WWSympa's password check will be insensitive.
7818 This only concerns passwords stored in the Sympa database, not the ones
7819 in LDAP.
7820 Should not be changed! May invalid all user password.
7822 "password_hash"
7824 Password hashing algorithm
7826 Format:
7828 Any.
7829 Default:
7831 "md5"
7832 Context:
7834 site (sympa.conf)
7835 Available versions:
7837 6.2.25b.3 and later.
7838 "md5" or "bcrypt".
7840 If set to "md5", Sympa will use MD5 password hashes. If set to
7842 "bcrypt", bcrypt hashes will be used instead. This only concerns
7843 passwords stored in the Sympa database, not the ones in LDAP.
7844 "password_hash_update"
7846 Update password hashing algorithm when users log in
7848 Format:
7850 Any.
7851 Default:
7853 1
7854 Context:
7856 site (sympa.conf)
7857 Available versions:
7859 6.2.25b.3 and later.
7860 On successful login, update the encrypted user password to use the
7862 algorithm specified by "password_hash". This allows for a graceful
7863 transition to a new password hash algorithm. A value of 0 disables
7864 updating of existing password hashes. New and reset passwords will use
7865 the "password_hash" setting in all cases.
7866 "bcrypt_cost"
7868 Bcrypt hash cost
7870 Format:
7872 Any.
7873 Default:
7875 12
7876 Context:
7878 site (sympa.conf)
7879 Available versions:
7881 6.2.25b.3 and later.
7882 When "password_hash" is set to "bcrypt", this sets the "cost" parameter
7884 of the bcrypt hash function. The default of 12 is expected to require
7885 approximately 250ms to calculate the password hash on a 3.2GHz CPU.
7886 This only concerns passwords stored in the Sympa database, not the ones
7887 in LDAP.
7888 Can be changed but any new cost setting will only apply to new
7890 passwords.
7891 "one_time_ticket_lifetime"
7893 Age of one time ticket
7895 Format:
7897 Any.
7898 Default:
7900 "2d"
7901 Context:
7903 site (sympa.conf)
7904 Duration before the one time tickets are expired
7906 "one_time_ticket_lockout"
7908 Restrict access to one time ticket
7910 Format:
7912 Any.
7913 Default:
7915 "one_time"
7916 Context:
7918 domain (robot.conf), site (sympa.conf)
7919 Is access to the one time ticket restricted, if any users previously
7921 accessed? (one_time | remote_addr | open)
7922 "purge_one_time_ticket_table_task"
7924 Task for expiring old one time tickets
7926 Format:
7928 /"\w+"/
7929 Default:
7931 "daily"
7932 Context:
7934 site (sympa.conf)
7935 "one_time_ticket_table_ttl"
7937 Expiration period of one time ticket
7939 Format:
7941 Any.
7942 Default:
7944 "10d"
7945 Context:
7947 site (sympa.conf)
7948 "pictures_max_size"
7950 The maximum size of uploaded picture
7952 Format:
7954 Number of bytes.
7955 Default:
7957 102400 (bytes)
7958 Context:
7960 domain (robot.conf), site (sympa.conf)
7961 "spam_protection"
7963 Protect web interface against spam harvesters
7965 Format:
7967 "at" - replace @ characters
7968 "javascript" - use JavaScript
7969 "none" - do nothing
7970 Default:
7971 "javascript"
7972 Context:
7974 list (config), domain (robot.conf), site (sympa.conf)
7975 There is a need to protect Sympa web sites against spambots which
7977 collect email addresses from public web sites. Various methods are
7978 available in Sympa and you can choose to use them with the
7979 spam_protection and web_archive_spam_protection parameters. Possible
7980 value are:
7981 javascript:
7983 the address is hidden using a javascript. A user who enables javascript
7985 can see a nice mailto address where others have nothing.
7986 at:
7988 the @ char is replaced by the string " AT ".
7990 none:
7992 no protection against spammer.
7994 "reporting_spam_script_path"
7996 Script to report spam
7998 Format:
8000 Any.
8001 Default:
8003 None.
8004 Context:
8006 domain (robot.conf), site (sympa.conf)
8007 Available versions:
8009 6.2a.0 and later.
8010 If set, when a list moderator report undetected spams for list
8012 moderation, this external script is invoked and the message is injected
8013 into standard input of the script.
8014 "domains_blocklist"
8016 Prevent people to subscribe to a list with addresses using these
8018 domains
8019 Format:
8021 Any.
8022 Default:
8024 None.
8025 Context:
8027 site (sympa.conf)
8028 Available versions:
8030 6.2.61b.1 and later.
8031 This parameter is a comma-separated list.
8033 Example:
8035 domains_blocklist example.org,spammer.com
8037 "quiet_subscription"
8039 Quiet subscriptions policy
8041 Format:
8043 "on" - enabled
8044 "optional" - optional
8045 "off" - disabled
8046 Default:
8047 "optional"
8048 Context:
8050 site (sympa.conf)
8051 Available versions:
8053 6.2.41b.1 and later.
8054 Global policy for quiet subscriptions: "on" means that subscriptions
8056 will never send a notice to the subscriber, "off" will enforce a notice
8057 sending, and "optional" (default) allows the use of the list policy.
8058 "show_report_abuse"
8060 Add a "Report abuse" link in the side menu of the lists
8062 Format:
8064 "on" - enabled
8065 "off" - disabled
8066 Default:
8067 "off"
8068 Context:
8070 site (sympa.conf)
8071 Available versions:
8073 6.2.37b.3 and later.
8074 The link is a mailto link, you can change that by overriding
8076 web_tt2/report_abuse.tt2
8077 "allow_account_deletion"
8079 EXPERIMENTAL! Allow users to delete their account. If enabled, shows a
8081 "delete my account" form in user's preferences page.
8082 Format:
8084 "on" - enabled
8085 "off" - disabled
8086 Default:
8087 "off"
8088 Context:
8090 site (sympa.conf)
8091 Available versions:
8093 6.2.41b.1 and later.
8094 Account deletion unsubscribes the users from his/her lists and removes
8096 him/her from lists ownership. It is only available to users using
8097 internal authentication (i.e. no LDAP, no SSO...). See
8098 https://github.com/sympa-community/sympa/issues/300 for details
8099 Renamed parameters
8101 These parameters were renamed. Though older names are still available,
8102 their use is no longer recommended.
8103 "arc_parameters.arc_private_key_path"
8105 See "arc_parameters.private_key_path".
8107 Context:
8109 domain (robot.conf), site (sympa.conf)
8110 Available versions:
8112 6.2.57b.1 to 6.2.70.
8113 "arc_parameters.arc_selector"
8115 See "arc_parameters.selector".
8117 Context:
8119 domain (robot.conf), site (sympa.conf)
8120 Available versions:
8122 6.2.57b.1 to 6.2.70.
8123 "arc_parameters.arc_signer_domain"
8125 See "arc_parameters.signer_domain".
8127 Context:
8129 domain (robot.conf), site (sympa.conf)
8130 Available versions:
8132 6.2.57b.1 to 6.2.70.
8133 "arc_private_key_path"
8135 See "arc_parameters.private_key_path".
8137 Context:
8139 domain (robot.conf), site (sympa.conf)
8140 Available versions:
8142 6.2.37b.1 to 6.2.56.
8143 "arc_selector"
8145 See "arc_parameters.selector".
8147 Context:
8149 domain (robot.conf), site (sympa.conf)
8150 Available versions:
8152 6.2.37b.1 to 6.2.56.
8153 "arc_signer_domain"
8155 See "arc_parameters.signer_domain".
8157 Context:
8159 domain (robot.conf), site (sympa.conf)
8160 Available versions:
8162 6.2.37b.1 to 6.2.56.
8163 "archive_mail_access"
8165 See "archive.mail_access".
8167 Context:
8169 domain (robot.conf), site (sympa.conf)
8170 Available versions:
8172 up to 6.2.56.
8173 "archive_web_access"
8175 See "archive.web_access".
8177 Context:
8179 domain (robot.conf), site (sympa.conf)
8180 Available versions:
8182 up to 6.2.56.
8183 "bounce_halt_rate"
8185 See "bounce.halt_rate".
8187 Context:
8189 site (sympa.conf)
8190 Available versions:
8192 up to 6.2.56.
8193 "bounce_warn_rate"
8195 See "bounce.warn_rate".
8197 Context:
8199 site (sympa.conf)
8200 Available versions:
8202 up to 6.2.56.
8203 "custom-header"
8205 See "custom_header".
8207 Context:
8209 Unknown.
8210 "custom-subject"
8212 See "custom_subject".
8214 Context:
8216 Unknown.
8217 "d_edit"
8219 See "shared_doc.d_edit".
8221 Context:
8223 domain (robot.conf), site (sympa.conf)
8224 Available versions:
8226 up to 6.2.56.
8227 "d_read"
8229 See "shared_doc.d_read".
8231 Context:
8233 domain (robot.conf), site (sympa.conf)
8234 Available versions:
8236 up to 6.2.56.
8237 "default_archive_quota"
8239 See "archive.quota".
8241 Context:
8243 site (sympa.conf)
8244 Available versions:
8246 up to 6.2.56.
8247 "default_bounce_level1_rate"
8249 See "bouncers_level1.rate".
8251 Context:
8253 domain (robot.conf), site (sympa.conf)
8254 Available versions:
8256 up to 6.2.56.
8257 "default_bounce_level2_rate"
8259 See "bouncers_level2.rate".
8261 Context:
8263 domain (robot.conf), site (sympa.conf)
8264 Available versions:
8266 up to 6.2.56.
8267 "default_list_priority"
8269 See "priority".
8271 Context:
8273 domain (robot.conf), site (sympa.conf)
8274 Available versions:
8276 up to 6.2.56.
8277 "default_max_list_members"
8279 See "max_list_members".
8281 Context:
8283 domain (robot.conf), site (sympa.conf)
8284 Available versions:
8286 up to 6.2.56.
8287 "default_remind_task"
8289 See "remind_task".
8291 Context:
8293 site (sympa.conf)
8294 Available versions:
8296 up to 6.2.56.
8297 "default_shared_quota"
8299 See "shared_doc.quota".
8301 Context:
8303 domain (robot.conf), site (sympa.conf)
8304 Available versions:
8306 up to 6.2.56.
8307 "default_sql_fetch_timeout"
8309 See "sql_fetch_timeout".
8311 Context:
8313 site (sympa.conf)
8314 Available versions:
8316 6.2a.0 to 6.2.56.
8317 "default_ttl"
8319 See "ttl".
8321 Context:
8323 site (sympa.conf)
8324 Available versions:
8326 up to 6.2.56.
8327 "dkim_private_key_path"
8329 See "dkim_parameters.private_key_path".
8331 Context:
8333 domain (robot.conf), site (sympa.conf)
8334 Available versions:
8336 up to 6.2.56.
8337 "dkim_selector"
8339 See "dkim_parameters.selector".
8341 Context:
8343 domain (robot.conf), site (sympa.conf)
8344 Available versions:
8346 up to 6.2.56.
8347 "dkim_signer_domain"
8349 See "dkim_parameters.signer_domain".
8351 Context:
8353 domain (robot.conf), site (sympa.conf)
8354 Available versions:
8356 up to 6.2.56.
8357 "dmarc_protection_domain_regex"
8359 See "dmarc_protection.domain_regex".
8361 Context:
8363 domain (robot.conf), site (sympa.conf)
8364 Available versions:
8366 up to 6.2.56.
8367 "dmarc_protection_mode"
8369 See "dmarc_protection.mode".
8371 Context:
8373 domain (robot.conf), site (sympa.conf)
8374 Available versions:
8376 up to 6.2.56.
8377 "dmarc_protection_other_email"
8379 See "dmarc_protection.other_email".
8381 Context:
8383 domain (robot.conf), site (sympa.conf)
8384 Available versions:
8386 up to 6.2.56.
8387 "dmarc_protection_phrase"
8389 See "dmarc_protection.phrase".
8391 Context:
8393 domain (robot.conf), site (sympa.conf)
8394 Available versions:
8396 up to 6.2.56.
8397 "domains_blacklist"
8399 See "domains_blocklist".
8401 Context:
8403 site (sympa.conf)
8404 Available versions:
8406 6.2.41b.1 to 6.2.60.
8407 "email_gecos"
8409 See "gecos".
8411 Context:
8413 site (sympa.conf)
8414 Available versions:
8416 6.2a.5 to 6.2a.33.
8417 "forced_reply-to"
8419 See "forced_reply_to".
8421 Context:
8423 Unknown.
8424 "forced_replyto"
8426 See "forced_reply_to".
8428 Context:
8430 Unknown.
8431 "key_password"
8433 See "key_passwd".
8435 Context:
8437 site (sympa.conf)
8438 "max-size"
8440 See "max_size".
8442 Context:
8444 Unknown.
8445 "merge_feature"
8447 See "personalization_feature".
8449 Context:
8451 Unknown.
8452 Available versions:
8454 6.0b.2 to 6.2.59b.1.
8455 "remind_return_path"
8457 See "verp_remind".
8459 Context:
8461 list (config), site (sympa.conf)
8462 Available versions:
8464 2.5 to 6.2.70.
8465 "reply-to"
8467 See "reply_to".
8469 Context:
8471 Unknown.
8472 "replyto"
8474 See "reply_to".
8476 Context:
8478 Unknown.
8479 "subscription"
8481 See "subscribe".
8483 Context:
8485 Unknown.
8486 "tracking_default_retention_period"
8488 See "tracking.retention_period".
8490 Context:
8492 site (sympa.conf)
8493 Available versions:
8495 6.2a.3 to 6.2.56.
8496 "tracking_delivery_status_notification"
8498 See "tracking.delivery_status_notification".
8500 Context:
8502 site (sympa.conf)
8503 Available versions:
8505 6.2a.0 to 6.2.56.
8506 "tracking_message_delivery_notification"
8508 See "tracking_message_disposition_notification".
8510 Context:
8512 site (sympa.conf)
8513 Available versions:
8515 6.2a.0 to 6.2a.40.
8516 "tracking_message_disposition_notification"
8518 See "tracking.message_disposition_notification".
8520 Context:
8522 site (sympa.conf)
8523 Available versions:
8525 6.2a.41 to 6.2.56.
8526 "unsubscription"
8528 See "unsubscribe".
8530 Context:
8532 Unknown.
8533 "use_blacklist"
8535 See "use_blocklist".
8537 Context:
8539 domain (robot.conf), site (sympa.conf)
8540 Available versions:
8542 5.3a.4 to 6.2.60.
8543 "welcome_return_path"
8545 See "verp_welcome".
8547 Context:
8549 list (config), site (sympa.conf)
8550 Available versions:
8552 2.5 to 6.2.70.
8553 Deprecated parameters
8555 These parameters were deprecated. They may not be used anymore.
8556 "account"
8558 Deprecated.
8560 Context:
8562 list (config)
8563 "antispam_feature"
8565 Deprecated.
8567 Context:
8569 domain (robot.conf), site (sympa.conf)
8570 Available versions:
8572 6.0a.1 to 6.2.70.
8573 "antispam_tag_header_ham_regexp"
8575 Deprecated.
8577 Context:
8579 domain (robot.conf), site (sympa.conf)
8580 Available versions:
8582 6.0a.1 to 6.1a.1.
8583 "antispam_tag_header_name"
8585 Deprecated.
8587 Context:
8589 domain (robot.conf), site (sympa.conf)
8590 Available versions:
8592 6.0a.1 to 6.1a.1.
8593 "antispam_tag_header_spam_regexp"
8595 Deprecated.
8597 Context:
8599 domain (robot.conf), site (sympa.conf)
8600 Available versions:
8602 6.0a.1 to 6.1a.1.
8603 "archived_pidfile"
8605 Deprecated.
8607 Context:
8609 site (sympa.conf)
8610 Available versions:
8612 up to 6.1.17.
8613 "automatic_list_prefix"
8615 Deprecated.
8617 Context:
8619 site (sympa.conf)
8620 "bounced_pidfile"
8622 Deprecated.
8624 Context:
8626 site (sympa.conf)
8627 Available versions:
8629 up to 6.1.17.
8630 "clean_delay_queueother"
8632 Deprecated.
8634 Context:
8636 site (sympa.conf)
8637 Available versions:
8639 5.4a.9 to 5.4.7.
8640 "color_0", ..., "color_15"
8642 See description on web interface. Deprecated.
8644 Context:
8646 domain (robot.conf), site (sympa.conf)
8647 Available versions:
8649 5.1b to 6.2.70.
8650 "cookie"
8652 Deprecated.
8654 Context:
8656 list (config), site (sympa.conf)
8657 Available versions:
8659 up to 6.2.60.
8660 "dark_color", "light_color", "text_color", "bg_color", "error_color",
8662 "selected_color", "shaded_color"
8663 See description on web interface. Deprecated.
8665 Context:
8667 domain (robot.conf), site (sympa.conf)
8668 Available versions:
8670 3.3a to 6.2.70.
8671 "default_distribution_ttl"
8673 Deprecated.
8675 Context:
8677 site (sympa.conf)
8678 "distribution_mode"
8680 Deprecated.
8682 Context:
8684 site (sympa.conf)
8685 Available versions:
8687 5.0a.1 to 6.2a.40.
8688 "edit_list"
8690 Deprecated.
8692 Context:
8694 site (sympa.conf)
8695 "editor"
8697 Deprecated.
8699 Context:
8701 list (config)
8702 Available versions:
8704 up to 6.2.32.
8705 "expire_task"
8707 Deprecated.
8709 Context:
8711 list (config)
8712 "filesystem_encoding"
8714 Deprecated.
8716 Context:
8718 site (sympa.conf)
8719 Available versions:
8721 5.3a.7 to 6.2.52.
8722 "forced_reply_to"
8724 Deprecated.
8726 Context:
8728 list (config)
8729 "host"
8731 Deprecated.
8733 Context:
8735 list (config), domain (robot.conf), site (sympa.conf)
8736 Available versions:
8738 up to 6.2.32.
8739 "html_editor_file"
8741 Deprecated.
8743 Context:
8745 site (sympa.conf)
8746 Available versions:
8748 6.0a.0 to 6.2a.33.
8749 "htmlarea_url"
8751 Deprecated.
8753 Context:
8755 site (sympa.conf)
8756 Available versions:
8758 up to 6.2.35b.1.
8759 "http_host"
8761 Deprecated.
8763 Context:
8765 domain (robot.conf), site (sympa.conf)
8766 Available versions:
8768 up to 6.2.54.
8769 "include_list"
8771 Deprecated.
8773 Context:
8775 list (config)
8776 Available versions:
8778 2.2.6 to 6.2.15.
8779 "ldap_export_connection_timeout"
8781 Deprecated.
8783 Context:
8785 site (sympa.conf)
8786 Available versions:
8788 3.3b.3 to 4.1?.
8789 "ldap_export_dnmanager"
8791 Deprecated.
8793 Context:
8795 site (sympa.conf)
8796 Available versions:
8798 3.3b.3 to 4.1?.
8799 "ldap_export_host"
8801 Deprecated.
8803 Context:
8805 site (sympa.conf)
8806 Available versions:
8808 3.3b.3 to 4.1?.
8809 "ldap_export_name"
8811 Deprecated.
8813 Context:
8815 site (sympa.conf)
8816 Available versions:
8818 3.3b.3 to 4.1?.
8819 "ldap_export_password"
8821 Deprecated.
8823 Context:
8825 site (sympa.conf)
8826 Available versions:
8828 3.3b.3 to 4.1?.
8829 "ldap_export_suffix"
8831 Deprecated.
8833 Context:
8835 site (sympa.conf)
8836 Available versions:
8838 3.3b.3 to 4.1?.
8839 "localedir"
8841 Deprecated.
8843 Context:
8845 site (sympa.conf)
8846 Available versions:
8848 4.2b.2 to 6.2a.32.
8849 "lock_method"
8851 Deprecated.
8853 Context:
8855 site (sympa.conf)
8856 Available versions:
8858 5.3b.3 to 6.2a.33.
8859 "log_condition"
8861 Deprecated.
8863 Context:
8865 domain (robot.conf), site (sympa.conf)
8866 Available versions:
8868 6.2a.29 to 6.2.41b.1.
8869 "log_module"
8871 Deprecated.
8873 Context:
8875 domain (robot.conf), site (sympa.conf)
8876 Available versions:
8878 6.2a.29 to 6.2.41b.1.
8879 "msgcat"
8881 Deprecated.
8883 Context:
8885 site (sympa.conf)
8886 Available versions:
8888 up to 4.2b.1.
8889 "openssl"
8891 Deprecated.
8893 Context:
8895 site (sympa.conf)
8896 Available versions:
8898 up to 6.2a.40.
8899 "owner"
8901 Deprecated.
8903 Context:
8905 list (config)
8906 Available versions:
8908 up to 6.2.32.
8909 "pidfile"
8911 Deprecated.
8913 Context:
8915 site (sympa.conf)
8916 Available versions:
8918 up to 6.1.17.
8919 "pidfile_bulk"
8921 Deprecated.
8923 Context:
8925 site (sympa.conf)
8926 Available versions:
8928 up to 6.1.17.
8929 "pidfile_creation"
8931 Deprecated.
8933 Context:
8935 site (sympa.conf)
8936 Available versions:
8938 up to 6.1.17.
8939 "pidfile_distribute"
8941 Deprecated.
8943 Context:
8945 site (sympa.conf)
8946 Available versions:
8948 up to 6.1.17.
8949 "queuedistribute"
8951 Deprecated.
8953 Context:
8955 site (sympa.conf)
8956 Available versions:
8958 5.0a.1 to 6.2a.40.
8959 "queueexpire"
8961 Deprecated.
8963 Context:
8965 site (sympa.conf)
8966 Available versions:
8968 up to 5.1.2.
8969 "reply_to"
8971 Deprecated.
8973 Context:
8975 list (config)
8976 "sort"
8978 Deprecated.
8980 Context:
8982 site (sympa.conf)
8983 Available versions:
8985 1.4.0 and later.
8986 "task_manager_pidfile"
8988 Deprecated.
8990 Context:
8992 site (sympa.conf)
8993 Available versions:
8995 up to 6.1.17.
8996 "tracking" (domain and site)
8998 See "tracking.tracking".
9000 Context:
9002 domain (robot.conf), site (sympa.conf)
9003 Available versions:
9005 up to 6.2.56.
9006 "tri"
9008 Deprecated.
9010 Context:
9012 site (sympa.conf)
9013 Available versions:
9015 up to 1.3.4-1.
9016 "trusted_ca_options"
9018 Deprecated.
9020 Context:
9022 site (sympa.conf)
9023 Available versions:
9025 up to 3.3.5.
9026 "use_fast_cgi"
9028 Deprecated.
9030 Context:
9032 site (sympa.conf)
9033 Available versions:
9035 up to 6.2.22.
9036 "user_data_source"
9038 Deprecated.
9040 Context:
9042 list (config)
9043 "web_archive"
9045 Deprecated.
9047 Context:
9049 list (config), domain (robot.conf), site (sympa.conf)
9050 Available versions:
9052 up to 6.2a.43.
9053 "web_recode_to"
9055 Deprecated.
9057 Context:
9059 site (sympa.conf)
9060 Available versions:
9062 up to 5.2.
9063
9065 /etc/sympa/sympa.conf
9066 Sympa main configuration file.
9067 $SYSCONFDIR/<mail domain name>/robot.conf
9069 Configuration specific to each mail domain.
9070 $EXPLDIR/<list name>/config or $EXPLDIR/<mail domain name>/<list
9072 name>/config
9073 List main configuration file.
9074
9076 Sympa Administration Manual. <https://www.sympa.community/manual/>.
9077 auth.conf(5), charset.conf(5), crawlers_detection.conf(5),
9079 edit_list.conf(5), ldap_alias_manager.conf(5), nrcpt_by_domain.conf(5),
9080 sympa_scenario(5), topics.conf(5).
90816.2.72 2023-06-01 SYMPA_CONFIG(5)
