« back to all changes in this revision
Viewing changes to doc/html/node8.html
- browse files at revision 7
- compare with another revision
- download diff
- download tarball
- view history from revision 7
- Committer: Bazaar Package Importer
- Author(s): Stefan Hornburg (Racke)
- Date: 2008-10-05 12:36:30 UTC
- mfrom: (1.1.5 upstream) (6.1.3 gutsy)
- Revision ID: james.westby@ubuntu.com-20081005123630-8ga1kt0ogrkqaizf
Tags: 5.3.4-6
* fix usage of $* Perl variable deprecated in Perl 5.10
(Closes: #501154, thanks to Micah Anderson <micah@debian.org> and
David Moreno <david@dev.axiombox.com> for the report and patches)
* add the sympa.pl --upgrade procedure to the debian/postinst
to migrate existing installs (Closes: #498144, thanks to Micah
Anderson <micah@debian.org> for the patch)
* additional patch for insecure use of /tmp (Closes: #496520)
* missing debian/compat file added
(Closes: #501154, thanks to Micah Anderson <micah@debian.org> and
David Moreno <david@dev.axiombox.com> for the report and patches)
* add the sympa.pl --upgrade procedure to the debian/postinst
to migrate existing installs (Closes: #498144, thanks to Micah
Anderson <micah@debian.org> for the patch)
* additional patch for insecure use of /tmp (Closes: #496520)
* missing debian/compat file added
- files added:
- debian/compat
- src/etc/families
- src/etc/families/sample-auto
- web_tt2/fr_FR
- files removed:
- debian/patches
- doc/auto
- doc/html
- doc/latex2htmlicons
- files modified:
- .version
added
removed
doc/html/node8.html
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2
3
<!--Converted with LaTeX2HTML 2002-2-1 (1.70)
4
original version by: Nikos Drakos, CBLU, University of Leeds
5
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
6
* with significant contributions from:
7
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
8
<HTML>
9
<HEAD>
10
<TITLE>7. sympa.conf parameters</TITLE>
11
<META NAME="description" CONTENT="7. sympa.conf parameters">
12
<META NAME="keywords" CONTENT="sympa">
13
<META NAME="resource-type" CONTENT="document">
14
<META NAME="distribution" CONTENT="global">
15
16
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
17
<META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1">
18
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
19
20
<LINK REL="STYLESHEET" HREF="sympa.css">
21
22
<LINK REL="next" HREF="node9.html">
23
<LINK REL="previous" HREF="node7.html">
24
<LINK REL="up" HREF="sympa.html">
25
<LINK REL="next" HREF="node9.html">
26
</HEAD>
27
28
<BODY TEXT="#000000" BGCOLOR="#ffffff">
29
<!--Navigation Panel-->
30
<A NAME="tex2html893"
31
HREF="node9.html">
32
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
33
<A NAME="tex2html887"
34
HREF="sympa.html">
35
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
36
<A NAME="tex2html881"
37
HREF="node7.html">
38
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
39
<A NAME="tex2html889"
40
HREF="node1.html">
41
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
42
<A NAME="tex2html891"
43
HREF="node30.html">
44
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
45
<BR>
46
<B> Next:</B> <A NAME="tex2html894"
47
HREF="node9.html">8. Sympa and its database</A>
48
<B> Up:</B> <A NAME="tex2html888"
49
HREF="sympa.html">Sympa Mailing Lists Management Software version</A>
50
<B> Previous:</B> <A NAME="tex2html882"
51
HREF="node7.html">6. Mail aliases</A>
52
<B> <A NAME="tex2html890"
53
HREF="node1.html">Contents</A></B>
54
<B> <A NAME="tex2html892"
55
HREF="node30.html">Index</A></B>
56
<BR>
57
<BR>
58
<!--End of Navigation Panel-->
59
<!--Table of Child-Links-->
60
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
61
62
<UL>
63
<LI><A NAME="tex2html895"
64
HREF="node8.html#SECTION00810000000000000000">7.1 Site customization</A>
65
<UL>
66
<LI><A NAME="tex2html896"
67
HREF="node8.html#SECTION00811000000000000000">7.1.1 <TT>domain</TT></A>
68
<LI><A NAME="tex2html897"
69
HREF="node8.html#SECTION00812000000000000000">7.1.2 <TT>email</TT></A>
70
<LI><A NAME="tex2html898"
71
HREF="node8.html#SECTION00813000000000000000">7.1.3 <TT>listmaster</TT></A>
72
<LI><A NAME="tex2html899"
73
HREF="node8.html#SECTION00814000000000000000">7.1.4 <TT>listmaster_email</TT></A>
74
<LI><A NAME="tex2html900"
75
HREF="node8.html#SECTION00815000000000000000">7.1.5 <TT>wwsympa_url</TT></A>
76
<LI><A NAME="tex2html901"
77
HREF="node8.html#SECTION00816000000000000000">7.1.6 <TT>soap_url</TT></A>
78
<LI><A NAME="tex2html902"
79
HREF="node8.html#SECTION00817000000000000000">7.1.7 <TT>spam_protection</TT></A>
80
<LI><A NAME="tex2html903"
81
HREF="node8.html#SECTION00818000000000000000">7.1.8 <TT>web_archive_spam_protection</TT></A>
82
<LI><A NAME="tex2html904"
83
HREF="node8.html#SECTION00819000000000000000">7.1.9 <TT>color_0</TT>, <TT>color_1</TT> .. <TT>color_15</TT></A>
84
<LI><A NAME="tex2html905"
85
HREF="node8.html#SECTION008110000000000000000">7.1.10 <TT>dark_color</TT> <TT>light_color</TT> <TT>text_color</TT> <TT>bg_color</TT> <TT>error_color</TT> <TT>selected_color</TT> <TT>shaded_color</TT></A>
86
<LI><A NAME="tex2html906"
87
HREF="node8.html#SECTION008111000000000000000">7.1.11 <TT>logo_html_definition</TT></A>
88
<LI><A NAME="tex2html907"
89
HREF="node8.html#SECTION008112000000000000000">7.1.12 <TT>css_path</TT></A>
90
<LI><A NAME="tex2html908"
91
HREF="node8.html#SECTION008113000000000000000">7.1.13 <TT>css_url</TT></A>
92
<LI><A NAME="tex2html909"
93
HREF="node8.html#SECTION008114000000000000000">7.1.14 <TT>cookie</TT></A>
94
<LI><A NAME="tex2html910"
95
HREF="node8.html#SECTION008115000000000000000">7.1.15 <TT>create_list</TT></A>
96
<LI><A NAME="tex2html911"
97
HREF="node8.html#SECTION008116000000000000000">7.1.16 <TT>global_remind</TT></A>
98
</UL>
99
<BR>
100
<LI><A NAME="tex2html912"
101
HREF="node8.html#SECTION00820000000000000000">7.2 Directories</A>
102
<UL>
103
<LI><A NAME="tex2html913"
104
HREF="node8.html#SECTION00821000000000000000">7.2.1 <TT>home</TT></A>
105
<LI><A NAME="tex2html914"
106
HREF="node8.html#SECTION00822000000000000000">7.2.2 <TT>etc</TT></A>
107
</UL>
108
<BR>
109
<LI><A NAME="tex2html915"
110
HREF="node8.html#SECTION00830000000000000000">7.3 System related</A>
111
<UL>
112
<LI><A NAME="tex2html916"
113
HREF="node8.html#SECTION00831000000000000000">7.3.1 <TT>syslog</TT></A>
114
<LI><A NAME="tex2html917"
115
HREF="node8.html#SECTION00832000000000000000">7.3.2 <TT>log_level</TT></A>
116
<LI><A NAME="tex2html918"
117
HREF="node8.html#SECTION00833000000000000000">7.3.3 <TT>log_socket_type</TT></A>
118
<LI><A NAME="tex2html919"
119
HREF="node8.html#SECTION00834000000000000000">7.3.4 <TT>pidfile</TT></A>
120
<LI><A NAME="tex2html920"
121
HREF="node8.html#SECTION00835000000000000000">7.3.5 <TT>umask</TT></A>
122
</UL>
123
<BR>
124
<LI><A NAME="tex2html921"
125
HREF="node8.html#SECTION00840000000000000000">7.4 Sending related</A>
126
<UL>
127
<LI><A NAME="tex2html922"
128
HREF="node8.html#SECTION00841000000000000000">7.4.1 <TT>distribution_mode</TT></A>
129
<LI><A NAME="tex2html923"
130
HREF="node8.html#SECTION00842000000000000000">7.4.2 <TT>maxsmtp</TT></A>
131
<LI><A NAME="tex2html924"
132
HREF="node8.html#SECTION00843000000000000000">7.4.3 <TT>log_smtp</TT></A>
133
<LI><A NAME="tex2html925"
134
HREF="node8.html#SECTION00844000000000000000">7.4.4 <TT>max_size</TT></A>
135
<LI><A NAME="tex2html926"
136
HREF="node8.html#SECTION00845000000000000000">7.4.5 <TT>misaddressed_commands</TT></A>
137
<LI><A NAME="tex2html927"
138
HREF="node8.html#SECTION00846000000000000000">7.4.6 <TT>misaddressed_commands_regexp</TT></A>
139
<LI><A NAME="tex2html928"
140
HREF="node8.html#SECTION00847000000000000000">7.4.7 <TT>nrcpt</TT></A>
141
<LI><A NAME="tex2html929"
142
HREF="node8.html#SECTION00848000000000000000">7.4.8 <TT>avg</TT></A>
143
<LI><A NAME="tex2html930"
144
HREF="node8.html#SECTION00849000000000000000">7.4.9 <TT>sendmail</TT></A>
145
<LI><A NAME="tex2html931"
146
HREF="node8.html#SECTION008410000000000000000">7.4.10 <TT>sendmail_args</TT></A>
147
<LI><A NAME="tex2html932"
148
HREF="node8.html#SECTION008411000000000000000">7.4.11 <TT>sendmail_aliases</TT></A>
149
<LI><A NAME="tex2html933"
150
HREF="node8.html#SECTION008412000000000000000">7.4.12 <TT>rfc2369_header_fields</TT></A>
151
<LI><A NAME="tex2html934"
152
HREF="node8.html#SECTION008413000000000000000">7.4.13 <TT>remove_headers</TT></A>
153
<LI><A NAME="tex2html935"
154
HREF="node8.html#SECTION008414000000000000000">7.4.14 <TT>anonymous_headers_fields</TT></A>
155
<LI><A NAME="tex2html936"
156
HREF="node8.html#SECTION008415000000000000000">7.4.15 <TT>list_check_smtp</TT></A>
157
<LI><A NAME="tex2html937"
158
HREF="node8.html#SECTION008416000000000000000">7.4.16 <TT>list_check_suffixes</TT></A>
159
<LI><A NAME="tex2html938"
160
HREF="node8.html#SECTION008417000000000000000">7.4.17 <TT>urlize_min_size</TT></A>
161
</UL>
162
<BR>
163
<LI><A NAME="tex2html939"
164
HREF="node8.html#SECTION00850000000000000000">7.5 Quotas</A>
165
<UL>
166
<LI><A NAME="tex2html940"
167
HREF="node8.html#SECTION00851000000000000000">7.5.1 <TT>default_shared_quota</TT></A>
168
<LI><A NAME="tex2html941"
169
HREF="node8.html#SECTION00852000000000000000">7.5.2 <TT>default_archive_quota</TT></A>
170
</UL>
171
<BR>
172
<LI><A NAME="tex2html942"
173
HREF="node8.html#SECTION00860000000000000000">7.6 Spool related</A>
174
<UL>
175
<LI><A NAME="tex2html943"
176
HREF="node8.html#SECTION00861000000000000000">7.6.1 <TT>spool</TT></A>
177
<LI><A NAME="tex2html944"
178
HREF="node8.html#SECTION00862000000000000000">7.6.2 <TT>queue</TT></A>
179
<LI><A NAME="tex2html945"
180
HREF="node8.html#SECTION00863000000000000000">7.6.3 <TT>queuedistribute</TT></A>
181
<LI><A NAME="tex2html946"
182
HREF="node8.html#SECTION00864000000000000000">7.6.4 <TT>queuemod</TT></A>
183
<LI><A NAME="tex2html947"
184
HREF="node8.html#SECTION00865000000000000000">7.6.5 <TT>queuedigest</TT></A>
185
<LI><A NAME="tex2html948"
186
HREF="node8.html#SECTION00866000000000000000">7.6.6 <TT>queueauth</TT></A>
187
<LI><A NAME="tex2html949"
188
HREF="node8.html#SECTION00867000000000000000">7.6.7 <TT>queueoutgoing</TT></A>
189
<LI><A NAME="tex2html950"
190
HREF="node8.html#SECTION00868000000000000000">7.6.8 <TT>queuetopic</TT></A>
191
<LI><A NAME="tex2html951"
192
HREF="node8.html#SECTION00869000000000000000">7.6.9 <TT>queuebounce</TT></A>
193
<LI><A NAME="tex2html952"
194
HREF="node8.html#SECTION008610000000000000000">7.6.10 <TT>queuetask</TT></A>
195
<LI><A NAME="tex2html953"
196
HREF="node8.html#SECTION008611000000000000000">7.6.11 <TT>tmpdir</TT></A>
197
<LI><A NAME="tex2html954"
198
HREF="node8.html#SECTION008612000000000000000">7.6.12 <TT>sleep</TT></A>
199
<LI><A NAME="tex2html955"
200
HREF="node8.html#SECTION008613000000000000000">7.6.13 <TT>clean_delay_queue</TT></A>
201
<LI><A NAME="tex2html956"
202
HREF="node8.html#SECTION008614000000000000000">7.6.14 <TT>clean_delay_queuemod</TT></A>
203
<LI><A NAME="tex2html957"
204
HREF="node8.html#SECTION008615000000000000000">7.6.15 <TT>clean_delay_queueauth</TT></A>
205
<LI><A NAME="tex2html958"
206
HREF="node8.html#SECTION008616000000000000000">7.6.16 <TT>clean_delay_queuesubscribe</TT></A>
207
<LI><A NAME="tex2html959"
208
HREF="node8.html#SECTION008617000000000000000">7.6.17 <TT>clean_delay_queuetopic</TT></A>
209
</UL>
210
<BR>
211
<LI><A NAME="tex2html960"
212
HREF="node8.html#SECTION00870000000000000000">7.7 Internationalization related</A>
213
<UL>
214
<LI><A NAME="tex2html961"
215
HREF="node8.html#SECTION00871000000000000000">7.7.1 <TT>localedir</TT></A>
216
<LI><A NAME="tex2html962"
217
HREF="node8.html#SECTION00872000000000000000">7.7.2 <TT>supported_lang</TT></A>
218
<LI><A NAME="tex2html963"
219
HREF="node8.html#SECTION00873000000000000000">7.7.3 <TT>lang</TT></A>
220
<LI><A NAME="tex2html964"
221
HREF="node8.html#SECTION00874000000000000000">7.7.4 <TT>web_recode_to</TT></A>
222
</UL>
223
<BR>
224
<LI><A NAME="tex2html965"
225
HREF="node8.html#SECTION00880000000000000000">7.8 Bounce related</A>
226
<UL>
227
<LI><A NAME="tex2html966"
228
HREF="node8.html#SECTION00881000000000000000">7.8.1 <TT>verp_rate</TT></A>
229
<LI><A NAME="tex2html967"
230
HREF="node8.html#SECTION00882000000000000000">7.8.2 <TT>welcome_return_path</TT></A>
231
<LI><A NAME="tex2html968"
232
HREF="node8.html#SECTION00883000000000000000">7.8.3 <TT>remind_return_path</TT></A>
233
<LI><A NAME="tex2html969"
234
HREF="node8.html#SECTION00884000000000000000">7.8.4 <TT>return_path_suffix</TT></A>
235
<LI><A NAME="tex2html970"
236
HREF="node8.html#SECTION00885000000000000000">7.8.5 <TT>expire_bounce_task</TT></A>
237
<LI><A NAME="tex2html971"
238
HREF="node8.html#SECTION00886000000000000000">7.8.6 <TT>purge_orphan_bounces_task</TT></A>
239
<LI><A NAME="tex2html972"
240
HREF="node8.html#SECTION00887000000000000000">7.8.7 <TT>eval_bouncers_task</TT></A>
241
<LI><A NAME="tex2html973"
242
HREF="node8.html#SECTION00888000000000000000">7.8.8 <TT>process_bouncers_task</TT></A>
243
<LI><A NAME="tex2html974"
244
HREF="node8.html#SECTION00889000000000000000">7.8.9 <TT>minimum_bouncing_count</TT></A>
245
<LI><A NAME="tex2html975"
246
HREF="node8.html#SECTION008810000000000000000">7.8.10 <TT>minimum_bouncing_period</TT></A>
247
<LI><A NAME="tex2html976"
248
HREF="node8.html#SECTION008811000000000000000">7.8.11 <TT>bounce_delay</TT></A>
249
<LI><A NAME="tex2html977"
250
HREF="node8.html#SECTION008812000000000000000">7.8.12 <TT>default_bounce_level1_rate</TT></A>
251
<LI><A NAME="tex2html978"
252
HREF="node8.html#SECTION008813000000000000000">7.8.13 <TT>default_bounce_level2_rate</TT></A>
253
<LI><A NAME="tex2html979"
254
HREF="node8.html#SECTION008814000000000000000">7.8.14 <TT>bounce_email_prefix</TT></A>
255
<LI><A NAME="tex2html980"
256
HREF="node8.html#SECTION008815000000000000000">7.8.15 <TT>bounce_warn_rate</TT></A>
257
<LI><A NAME="tex2html981"
258
HREF="node8.html#SECTION008816000000000000000">7.8.16 <TT>bounce_halt_rate</TT></A>
259
<LI><A NAME="tex2html982"
260
HREF="node8.html#SECTION008817000000000000000">7.8.17 <TT>default_remind_task</TT></A>
261
</UL>
262
<BR>
263
<LI><A NAME="tex2html983"
264
HREF="node8.html#SECTION00890000000000000000">7.9 Tuning</A>
265
<UL>
266
<LI><A NAME="tex2html984"
267
HREF="node8.html#SECTION00891000000000000000">7.9.1 <TT>cache_list_config</TT></A>
268
<LI><A NAME="tex2html985"
269
HREF="node8.html#SECTION00892000000000000000">7.9.2 <TT>sympa_priority</TT></A>
270
<LI><A NAME="tex2html986"
271
HREF="node8.html#SECTION00893000000000000000">7.9.3 <TT>request_priority</TT></A>
272
<LI><A NAME="tex2html987"
273
HREF="node8.html#SECTION00894000000000000000">7.9.4 <TT>owner_priority</TT></A>
274
<LI><A NAME="tex2html988"
275
HREF="node8.html#SECTION00895000000000000000">7.9.5 <TT>default_list_priority</TT></A>
276
</UL>
277
<BR>
278
<LI><A NAME="tex2html989"
279
HREF="node8.html#SECTION008100000000000000000">7.10 Database related</A>
280
<UL>
281
<LI><A NAME="tex2html990"
282
HREF="node8.html#SECTION008101000000000000000">7.10.1 <TT>update_db_field_types</TT></A>
283
<LI><A NAME="tex2html991"
284
HREF="node8.html#SECTION008102000000000000000">7.10.2 <TT>db_type</TT></A>
285
<LI><A NAME="tex2html992"
286
HREF="node8.html#SECTION008103000000000000000">7.10.3 <TT>db_name</TT></A>
287
<LI><A NAME="tex2html993"
288
HREF="node8.html#SECTION008104000000000000000">7.10.4 <TT>db_host</TT></A>
289
<LI><A NAME="tex2html994"
290
HREF="node8.html#SECTION008105000000000000000">7.10.5 <TT>db_port</TT></A>
291
<LI><A NAME="tex2html995"
292
HREF="node8.html#SECTION008106000000000000000">7.10.6 <TT>db_user</TT></A>
293
<LI><A NAME="tex2html996"
294
HREF="node8.html#SECTION008107000000000000000">7.10.7 <TT>db_passwd</TT></A>
295
<LI><A NAME="tex2html997"
296
HREF="node8.html#SECTION008108000000000000000">7.10.8 <TT>db_timeout</TT></A>
297
<LI><A NAME="tex2html998"
298
HREF="node8.html#SECTION008109000000000000000">7.10.9 <TT>db_options</TT></A>
299
<LI><A NAME="tex2html999"
300
HREF="node8.html#SECTION0081010000000000000000">7.10.10 <TT>db_env</TT></A>
301
<LI><A NAME="tex2html1000"
302
HREF="node8.html#SECTION0081011000000000000000">7.10.11 <TT>db_additional_subscriber_fields</TT></A>
303
<LI><A NAME="tex2html1001"
304
HREF="node8.html#SECTION0081012000000000000000">7.10.12 <TT>db_additional_user_fields</TT></A>
305
<LI><A NAME="tex2html1002"
306
HREF="node8.html#SECTION0081013000000000000000">7.10.13 <TT>purge_user_table_task</TT></A>
307
</UL>
308
<BR>
309
<LI><A NAME="tex2html1003"
310
HREF="node8.html#SECTION008110000000000000000">7.11 Loop prevention</A>
311
<UL>
312
<LI><A NAME="tex2html1004"
313
HREF="node8.html#SECTION008111000000000000000">7.11.1 <TT>loop_command_max</TT></A>
314
<LI><A NAME="tex2html1005"
315
HREF="node8.html#SECTION008112000000000000000">7.11.2 <TT>loop_command_sampling_delay</TT></A>
316
<LI><A NAME="tex2html1006"
317
HREF="node8.html#SECTION008113000000000000000">7.11.3 <TT>loop_command_decrease_factor</TT></A>
318
<LI><A NAME="tex2html1007"
319
HREF="node8.html#SECTION008114000000000000000">7.11.4 <TT>loop_prevention_regex</TT></A>
320
</UL>
321
<BR>
322
<LI><A NAME="tex2html1008"
323
HREF="node8.html#SECTION008120000000000000000">7.12 S/MIME configuration</A>
324
<UL>
325
<LI><A NAME="tex2html1009"
326
HREF="node8.html#SECTION008121000000000000000">7.12.1 <TT>openssl</TT></A>
327
<LI><A NAME="tex2html1010"
328
HREF="node8.html#SECTION008122000000000000000">7.12.2 <TT>capath</TT></A>
329
<LI><A NAME="tex2html1011"
330
HREF="node8.html#SECTION008123000000000000000">7.12.3 <TT>cafile</TT></A>
331
<LI><A NAME="tex2html1012"
332
HREF="node8.html#SECTION008124000000000000000">7.12.4 <TT>key_passwd</TT></A>
333
<LI><A NAME="tex2html1013"
334
HREF="node8.html#SECTION008125000000000000000">7.12.5 <TT>chk_cert_expiration_task</TT></A>
335
<LI><A NAME="tex2html1014"
336
HREF="node8.html#SECTION008126000000000000000">7.12.6 <TT>crl_update_task</TT></A>
337
</UL>
338
<BR>
339
<LI><A NAME="tex2html1015"
340
HREF="node8.html#SECTION008130000000000000000">7.13 Antivirus plug-in</A>
341
<UL>
342
<LI><A NAME="tex2html1016"
343
HREF="node8.html#SECTION008131000000000000000">7.13.1 <TT>antivirus_path</TT></A>
344
<LI><A NAME="tex2html1017"
345
HREF="node8.html#SECTION008132000000000000000">7.13.2 <TT>antivirus_args</TT></A>
346
<LI><A NAME="tex2html1018"
347
HREF="node8.html#SECTION008133000000000000000">7.13.3 <TT>antivirus_notify</TT></A>
348
</UL></UL>
349
<!--End of Table of Child-Links-->
350
<HR>
351
352
<H1><A NAME="SECTION00800000000000000000"></A>
353
<A NAME="exp-admin"></A> <A NAME="854"></A>
354
<A NAME="855"></A>
355
<BR>
356
7. sympa.conf parameters
357
</H1>
358
359
<P>
360
The <A NAME="7873"></A><TT>/etc/sympa.conf</TT> configuration file contains numerous
361
parameters which are read on start-up of <I>Sympa</I>. If you change this file, do not forget
362
that you will need to restart <I>Sympa</I> afterwards.
363
364
<P>
365
The <A NAME="7878"></A><TT>/etc/sympa.conf</TT> file contains directives in the following
366
format:
367
368
<P>
369
<BLOCKQUOTE>
370
<I>keyword value</I>
371
372
</BLOCKQUOTE>
373
374
<P>
375
Comments start with the <TT>#</TT> character at the beginning of
376
a line. Empty lines are also considered as comments and are ignored.
377
There should only be one directive per line, but their order in
378
the file is of no importance.
379
380
<P>
381
382
<H1><A NAME="SECTION00810000000000000000">
383
7.1 Site customization</A>
384
</H1>
385
386
<P>
387
388
<H2><A NAME="SECTION00811000000000000000"></A><A NAME="7881"></A>
389
<BR>
390
7.1.1 <TT>domain</TT>
391
</H2>
392
393
<P>
394
This keyword is <B>mandatory</B>. It is the domain name
395
used in the <A NAME="7884"></A><TT>From:</TT> header in replies to administrative
396
requests. So the smtp engine (qmail, sendmail, postfix or whatever) must
397
recognize this domain as a local address. The old keyword <A NAME="7887"></A><TT>host</TT>
398
is still recognized but should not be used anymore.
399
400
<P>
401
Example: <TT>domain cru.fr</TT>
402
403
<P>
404
405
<H2><A NAME="SECTION00812000000000000000"></A><A NAME="7891"></A>
406
<BR>
407
7.1.2 <TT>email</TT>
408
</H2>
409
410
<P>
411
(Default value: <TT>sympa</TT>)
412
413
<P>
414
Username (the part of the address preceding the <TT>@</TT> sign) used
415
in the <A NAME="7895"></A><TT>From:</TT> header in replies to administrative requests.
416
417
<P>
418
Example: <TT>email listserv</TT>
419
420
<P>
421
422
<H2><A NAME="SECTION00813000000000000000"></A><A NAME="7899"></A>
423
<BR>
424
7.1.3 <TT>listmaster</TT>
425
</H2>
426
427
<P>
428
The list of e-mail addresses of listmasters (users authorized to perform
429
global server commands). Listmasters can be defined for each virtual host.
430
431
<P>
432
Example: <TT>listmaster postmaster@cru.fr,root@cru.fr</TT>
433
434
<P>
435
436
<H2><A NAME="SECTION00814000000000000000"></A><A NAME="7903"></A>
437
<BR>
438
7.1.4 <TT>listmaster_email</TT>
439
</H2>
440
441
<P>
442
(Default value: <TT>listmaster</TT>)
443
444
<P>
445
Username (the part of the address preceding the <TT>@</TT> sign) used
446
in the listmaster email. This parameter is useful if you want to run
447
more than one sympa on the same host (a sympa test for example).
448
449
<P>
450
If you change the default value, you must modify the sympa aliases too.
451
452
<P>
453
For example, if you put :
454
455
<P>
456
<BLOCKQUOTE>
457
listmaster listmaster-test
458
459
</BLOCKQUOTE>
460
461
<P>
462
you must modify the sympa aliases like this :
463
464
<P>
465
<BLOCKQUOTE>
466
listmaster-test: "| /home/sympa/bin/queue listmaster@my.domain.org"
467
468
</BLOCKQUOTE>
469
470
<P>
471
See <A HREF="node7.html#robot-aliases">6.1</A>,page <A HREF="node7.html#robot-aliases"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A> for all aliases.
472
473
<P>
474
475
<H2><A NAME="SECTION00815000000000000000"></A><A NAME="7907"></A>
476
<BR>
477
7.1.5 <TT>wwsympa_url</TT>
478
</H2>
479
480
<P>
481
(Default value: <TT>http://<TT><</TT>host<TT>></TT>/wws</TT>)
482
483
<P>
484
This is the root URL of <A NAME="7913"></A><I>WWSympa</I>.
485
486
<P>
487
Example: <TT>wwsympa_url https://my.server/sympa</TT>
488
489
<P>
490
491
<H2><A NAME="SECTION00816000000000000000"></A><A NAME="7917"></A>
492
<BR>
493
7.1.6 <TT>soap_url</TT>
494
</H2>
495
496
<P>
497
This is the root URL of Sympa's SOAP server. Sympa's WSDL document refer to this URL in its <TT>service</TT> section.
498
499
<P>
500
Example: <TT>soap_url http://my.server/sympasoap</TT>
501
502
<P>
503
504
<H2><A NAME="SECTION00817000000000000000"></A><A NAME="7921"></A>
505
<BR>
506
7.1.7 <TT>spam_protection</TT>
507
</H2>
508
509
<P>
510
<A NAME="7924"></A>spam_protection
511
(Default value: <TT>javascript</TT>)
512
513
<P>
514
There is a need to protection Sympa web site against spambot which collect
515
email adresse in public web site. Various method are availble into Sympa
516
and you can choose it with <A NAME="7926"></A><TT>spam_protection</TT> and
517
<A NAME="7929"></A><TT>web_archive_spam_protection</TT> parameters.
518
Possible value are :
519
520
<UL>
521
<LI>javascript : the adresse is hidden using a javascript. User who enable javascript can
522
see a nice mailto adresses where others have nothing.
523
</LI>
524
<LI>at : the @ char is replaced by the string " AT ".
525
</LI>
526
<LI>none : no protection against spammer.
527
</LI>
528
</UL>
529
530
<P>
531
532
<H2><A NAME="SECTION00818000000000000000"></A><A NAME="7932"></A>
533
<BR>
534
7.1.8 <TT>web_archive_spam_protection</TT>
535
</H2>
536
(Default value: <TT>cookie</TT>)
537
538
<P>
539
Idem <A NAME="7936"></A><TT>spam_protection</TT> but restricted to web archive.
540
A additional value is availible : cookie which mean that users
541
must submit a small form in order to receive a cookie before
542
browsing archives. This block all robot, even google and co.
543
544
<P>
545
546
<H2><A NAME="SECTION00819000000000000000"></A><A NAME="7939"></A><A NAME="7942"></A><A NAME="7945"></A>
547
<A NAME="colors"></A>
548
<BR>
549
7.1.9 <TT>color_0</TT>, <TT>color_1</TT> .. <TT>color_15</TT>
550
</H2>
551
They are the color definition for web interface. These parameters can be overwritten in each virtual host definition.
552
The color are used in the CSS file and unfortunitly they are also in use in some web templates. The sympa admin interface
553
show every colors in use.
554
555
<P>
556
557
<H2><A NAME="SECTION008110000000000000000"></A><A NAME="7948"></A><A NAME="7951"></A><A NAME="7954"></A><A NAME="7957"></A><A NAME="7960"></A><A NAME="7963"></A><A NAME="7966"></A>
558
<BR>
559
7.1.10 <TT>dark_color</TT> <TT>light_color</TT> <TT>text_color</TT> <TT>bg_color</TT> <TT>error_color</TT> <TT>selected_color</TT> <TT>shaded_color</TT>
560
</H2>
561
562
<P>
563
Deprecated. They are the color definition for previous web interface. These parameters are unused in 5.1 and higher
564
version but still availible.style.css, print.css, print-preview.css and fullPage.css
565
566
<P>
567
568
<H2><A NAME="SECTION008111000000000000000"></A><A NAME="7969"></A>
569
<BR>
570
7.1.11 <TT>logo_html_definition</TT>
571
</H2>
572
This parameter allow you to insert in the left top page corner oa piece of html code, usually to insert la logo in the page. This is a very basic but easy customization.
573
Example: <TT>logo_html_definition <a href="http://www.mycompagnie.com"><img style="float: left; margin-top: 7px; margin-left: 37px;" src="http:/logos/mylogo.jpg" alt="my compagnie" /></a></TT>
574
575
<P>
576
577
<H2><A NAME="SECTION008112000000000000000"></A><A NAME="7973"></A>
578
<BR>
579
7.1.12 <TT>css_path</TT>
580
</H2>
581
582
<P>
583
Pre-parsed CSS files (let's say static css files) can be installed using Sympa server skins module. These CSS files are
584
installed in a part of the web server that can be reached without using sympa web engine. In order to do this edit the
585
robot.conf file and set the css_path parameter. Then retart the server and use skins module from the "admin sympa" page
586
to install preparsed CSS file. The in order to replace dynamic CSS by these static files
587
set the <A NAME="7976"></A><TT>css_url</TT> parameter.
588
589
<P>
590
591
<H2><A NAME="SECTION008113000000000000000"></A><A NAME="7979"></A>
592
<BR>
593
7.1.13 <TT>css_url</TT>
594
</H2>
595
596
<P>
597
By default, CSS files style.css, print.css, print-preview.css and fullPage.css are delivred by Sympa web interface itself using a sympa action
598
named css. URL look like http://foo.org/sympa/css/style.css . CSS file are made parsing a web_tt2 file named css.tt2. This allow dynamique
599
definition of colors and in a near futur a complete definition of the skin, user preference skins etc.
600
601
<P>
602
In order to make sympa web interface faster, it is strongly recommended to install static css file somewhere in your web site. This way sympa will deliver
603
only one page insteed of one page and four css page at each clic. This can be done using css_url parameter. The parameter must contain the URL of the
604
directory where style.css, print.css, print-preview.css and fullPage.css are installed. You can make your own a sophisticated new skin editing these
605
files. The server admin module include a CSS administration page that can help you to install static CSS.
606
607
<P>
608
609
<H2><A NAME="SECTION008114000000000000000"></A><A NAME="7982"></A>
610
<BR>
611
7.1.14 <TT>cookie</TT>
612
</H2>
613
614
<P>
615
This string is used to generate MD5 authentication keys.
616
It allows generated authentication keys to differ from one
617
site to another. It is also used for reversible encryption of
618
user passwords stored in the database. The presence of this string
619
is one reason why access to <A NAME="7985"></A><TT>sympa.conf</TT> needs to be restricted
620
to the Sympa user.
621
622
<P>
623
Note that changing this parameter will break all
624
http cookies stored in users' browsers, as well as all user passwords
625
and lists X509 private keys. To prevent a catastroph, sympa.pl refuse to start if the cookie parameter was changed.
626
627
<P>
628
Example: <TT>cookie gh869jku5</TT>
629
630
<P>
631
632
<H2><A NAME="SECTION008115000000000000000"></A><A NAME="7989"></A>
633
<BR>
634
7.1.15 <TT>create_list</TT>
635
</H2>
636
637
<P>
638
<A NAME="create-list"></A>
639
<P>
640
(Default value: <TT>public_listmaster</TT>)
641
642
<P>
643
<TT>create_list</TT> parameter is defined by an authorization scenario (see <A HREF="node14.html#scenarios">13</A>, page <A HREF="node14.html#scenarios"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)
644
645
<P>
646
Defines who can create lists (or request list creations).
647
Sympa will use the corresponding authorization scenario.
648
649
<P>
650
Example: <TT>create_list intranet</TT>
651
652
<P>
653
654
<H2><A NAME="SECTION008116000000000000000"></A><A NAME="7997"></A>
655
<BR>
656
7.1.16 <TT>global_remind</TT>
657
</H2>
658
659
<P>
660
<A NAME="global-remind"></A>
661
<P>
662
(Default value: <TT>listmaster</TT>)
663
664
<P>
665
<TT>global_remind</TT> parameter is defined by an authorization scenario (see <A HREF="node14.html#scenarios">13</A>, page <A HREF="node14.html#scenarios"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)
666
667
<P>
668
Defines who can run a <TT>REMIND *</TT> command.
669
670
<P>
671
672
<H1><A NAME="SECTION00820000000000000000">
673
7.2 Directories</A>
674
</H1>
675
676
<H2><A NAME="SECTION00821000000000000000"></A><A NAME="8004"></A>
677
<BR>
678
7.2.1 <TT>home</TT>
679
</H2>
680
681
<P>
682
(Default value: <TT><A NAME="8009"></A><TT>/home/sympa/expl</TT></TT>)
683
684
<P>
685
The directory whose subdirectories correspond to the different lists.
686
687
<P>
688
Example: <TT>home /home/sympa/expl</TT>
689
690
<P>
691
692
<H2><A NAME="SECTION00822000000000000000"></A><A NAME="8013"></A>
693
<BR>
694
7.2.2 <TT>etc</TT>
695
</H2>
696
697
<P>
698
(Default value: <TT><A NAME="8018"></A><TT>/home/sympa/etc</TT></TT>)
699
700
<P>
701
This is the local directory for configuration files (such as
702
<A NAME="8021"></A><TT>edit_list.conf</TT>. It contains 5 subdirectories:
703
<A NAME="8024"></A><TT>scenari</TT> for local authorization scenarios; <A NAME="8027"></A><TT>mail_tt2</TT>
704
for the site's local mail templates and default list templates; <A NAME="8030"></A><TT>web_tt2</TT>
705
for the site's local html templates; <A NAME="8033"></A><TT>global_task_models</TT> for local
706
global task models; and <A NAME="8036"></A><TT>list_task_models</TT> for local list task models
707
708
<P>
709
Example: <TT>etc /home/sympa/etc</TT>
710
711
<P>
712
713
<H1><A NAME="SECTION00830000000000000000">
714
7.3 System related</A>
715
</H1>
716
717
<P>
718
719
<H2><A NAME="SECTION00831000000000000000"></A><A NAME="8040"></A>
720
<BR>
721
7.3.1 <TT>syslog</TT>
722
</H2>
723
724
<P>
725
(Default value: <TT>LOCAL1</TT>)
726
727
<P>
728
Name of the sub-system (facility) for logging messages.
729
730
<P>
731
Example: <TT>syslog LOCAL2</TT>
732
733
<P>
734
735
<H2><A NAME="SECTION00832000000000000000"></A><A NAME="8045"></A>
736
<BR>
737
7.3.2 <TT>log_level</TT>
738
</H2>
739
740
<P>
741
(Default value: <TT>0</TT>)
742
743
<P>
744
This parameter sets the verbosity of Sympa processes (including) in log files.
745
With level 0 only main operations are logged, in level 3 almost everything is
746
logged.
747
748
<P>
749
Example: <TT>log_level 2</TT>
750
751
<P>
752
753
<H2><A NAME="SECTION00833000000000000000"></A><A NAME="8050"></A>
754
<A NAME="par-log-socket-type"></A>
755
<BR>
756
7.3.3 <TT>log_socket_type</TT>
757
</H2>
758
759
<P>
760
(Default value: <TT>unix</TT>)
761
762
<P>
763
<I>Sympa</I> communicates with <A NAME="8055"></A><TT>syslogd</TT>
764
using either UDP or UNIX sockets. Set <A NAME="8058"></A><TT>log_socket_type</TT> to <TT>inet</TT> to use UDP, or <TT>unix</TT> for UNIX sockets.
765
766
<P>
767
768
<H2><A NAME="SECTION00834000000000000000"></A><A NAME="8061"></A>
769
<BR>
770
7.3.4 <TT>pidfile</TT>
771
</H2>
772
773
<P>
774
(Default value: <TT><A NAME="8066"></A><TT>/home/sympa/etc/sympa.pid</TT></TT>)
775
776
<P>
777
The file where the <A NAME="8069"></A><TT>sympa.pl</TT> daemon stores its
778
process number. Warning: the <TT>sympa</TT> user must be
779
able to write to this file, and to create it if it doesn't
780
exist.
781
782
<P>
783
Example: <TT>pidfile /var/run/sympa.pid</TT>
784
785
<P>
786
787
<H2><A NAME="SECTION00835000000000000000"></A><A NAME="8073"></A>
788
<BR>
789
7.3.5 <TT>umask</TT>
790
</H2>
791
792
<P>
793
(Default value: <TT>027</TT>)
794
795
<P>
796
Default mask for file creation (see <A NAME="8077"></A><TT>umask</TT>(2)).
797
Note that it will be interpreted as an octual value.
798
799
<P>
800
Example: <TT>umask 007</TT>
801
802
<P>
803
804
<H1><A NAME="SECTION00840000000000000000">
805
7.4 Sending related</A>
806
</H1>
807
808
<P>
809
810
<H2><A NAME="SECTION00841000000000000000"></A><A NAME="8081"></A>
811
<BR>
812
7.4.1 <TT>distribution_mode</TT>
813
</H2>
814
815
<P>
816
(Default value: <TT>single</TT>)
817
Use this parameter to determine if your installation nrun only one sympa.pl daemon that process both messages
818
to distribute and commands (single) or if sympa.pl will fork to run two separate processus one dedicated to message distribution
819
and one dedicated to commands and message pre-processing (fork). The second choice make a better priority processing for message
820
distribution and faster command response, but it require a bit more computer ressources.
821
822
<P>
823
Example: <TT>distribution_mode fork</TT>
824
825
<P>
826
827
<H2><A NAME="SECTION00842000000000000000"></A><A NAME="8086"></A>
828
<BR>
829
7.4.2 <TT>maxsmtp</TT>
830
</H2>
831
832
<P>
833
(Default value: <TT>20</TT>)
834
835
<P>
836
Maximum number of SMTP delivery child processes spawned
837
by <I>Sympa</I>. This is the main load control parameter.
838
839
<P>
840
Example: <TT>maxsmtp 500</TT>
841
842
<P>
843
844
<H2><A NAME="SECTION00843000000000000000"></A><A NAME="8092"></A>
845
<BR>
846
7.4.3 <TT>log_smtp</TT>
847
</H2>
848
849
<P>
850
(Default value: <TT>off</TT>)
851
852
<P>
853
Set logging of each MTA call. Can be overwritten by -m sympa option.
854
855
<P>
856
Example: <TT>log_smtp on</TT>
857
858
<P>
859
860
<H2><A NAME="SECTION00844000000000000000"></A><A NAME="8097"></A>
861
<BR>
862
7.4.4 <TT>max_size</TT>
863
</H2>
864
865
<P>
866
(Default value: <TT>5 Mb</TT>)
867
868
<P>
869
Maximum size allowed for messages distributed by <I>Sympa</I>.
870
This may be customized per virtual host or per list by setting the <A NAME="8102"></A><TT>max_size</TT>
871
robot or list parameter.
872
873
<P>
874
Example: <TT>max_size 2097152</TT>
875
876
<P>
877
878
<H2><A NAME="SECTION00845000000000000000"></A><A NAME="8106"></A>
879
<BR>
880
7.4.5 <TT>misaddressed_commands</TT>
881
</H2>
882
883
<P>
884
(Default value: <TT>reject</TT>)
885
886
<P>
887
When a robot command is sent to a list, by default Sympa reject this message. This feature
888
can be turned off setting this parameter to <A NAME="8110"></A><TT>ignore</TT>.
889
890
<P>
891
892
<H2><A NAME="SECTION00846000000000000000"></A><A NAME="8113"></A>
893
<BR>
894
7.4.6 <TT>misaddressed_commands_regexp</TT>
895
</H2>
896
897
<P>
898
(Default value: <TT>(subscribe|unsubscribe|signoff)</TT>)
899
900
<P>
901
This is the Perl regular expression applied on messages subject and body to detect
902
misaddressed commands, see <A NAME="8117"></A><TT>misaddressed_commands</TT> parameter above.
903
904
<P>
905
906
<H2><A NAME="SECTION00847000000000000000"></A><A NAME="8120"></A>
907
<BR>
908
7.4.7 <TT>nrcpt</TT>
909
</H2>
910
911
<P>
912
(Default value: <TT>25</TT>)
913
914
<P>
915
<A NAME="nrcpt"></A> Maximum number of recipients per <A NAME="8124"></A><TT>sendmail</TT> call.
916
This grouping factor makes it possible for the (<A NAME="8127"></A><TT>sendmail</TT>) MTA to optimize the number of SMTP sessions for
917
message distribution. If needed, you can limit the number of receipient for a particular domain.
918
Check nrcpt_by_domain configuration file. (see
919
<A HREF="node3.html#nrcptbydomain">2.3</A>, page <A HREF="node3.html#nrcptbydomain"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)
920
921
<P>
922
923
<H2><A NAME="SECTION00848000000000000000"></A><A NAME="8130"></A>
924
<BR>
925
7.4.8 <TT>avg</TT>
926
</H2>
927
928
<P>
929
(Default value: <TT>10</TT>)
930
931
<P>
932
Maximum number of different internet domains within addresses per
933
<A NAME="8134"></A><TT>sendmail</TT> call.
934
935
<P>
936
937
<H2><A NAME="SECTION00849000000000000000"></A><A NAME="8137"></A>
938
<BR>
939
7.4.9 <TT>sendmail</TT>
940
</H2>
941
942
<P>
943
(Default value: <TT>/usr/sbin/sendmail</TT>)
944
945
<P>
946
Absolute path to SMTP message transfer agent binary. Sympa expects this binary to
947
be sendmail compatible (<A NAME="8141"></A>postfix, <A NAME="8142"></A>Qmail and <A NAME="8143"></A>Exim binaries all
948
provide sendmail compatibility).
949
950
<P>
951
Example: <TT>sendmail /usr/sbin/sendmail</TT>
952
953
<P>
954
955
<H2><A NAME="SECTION008410000000000000000"></A><A NAME="8145"></A>
956
<BR>
957
7.4.10 <TT>sendmail_args</TT>
958
</H2>
959
960
<P>
961
(Default value: <TT>-oi -odi -oem</TT>)
962
963
<P>
964
Arguments passed to SMTP message transfer agent
965
966
<P>
967
968
<H2><A NAME="SECTION008411000000000000000"></A><A NAME="8149"></A>
969
<BR>
970
7.4.11 <TT>sendmail_aliases</TT>
971
</H2>
972
973
<P>
974
(Default value: <TT>defined by makefile, sendmail_aliases</TT>)
975
976
<P>
977
Path of the alias file that contain all lists related aliases. It is recommended to create a specific alias file so Sympa never overright the standard alias file but only a dedicated file.You must refer to this aliases file in your <A NAME="8153"></A><TT>sendmail.mc</TT> :
978
979
<P>
980
981
<H2><A NAME="SECTION008412000000000000000"></A><A NAME="8156"></A>
982
<BR>
983
7.4.12 <TT>rfc2369_header_fields</TT>
984
</H2>
985
986
<P>
987
(Default value: <TT>help,subscribe,unsubscribe,post,owner,archive</TT>)
988
989
<P>
990
RFC2369 compliant header fields (List-xxx) to be added to
991
distributed messages. These header-fields should be implemented
992
by MUA's, adding menus.
993
994
<P>
995
996
<H2><A NAME="SECTION008413000000000000000"></A><A NAME="8160"></A>
997
<BR>
998
7.4.13 <TT>remove_headers</TT>
999
</H2>
1000
1001
<P>
1002
(Default value: <TT>Return-Receipt-To,Precedence,X-Sequence,Disposition-Notification-To</TT>)
1003
1004
<P>
1005
This is the list of headers that <I>Sympa</I> should remove from
1006
outgoing messages. Use it, for example, to ensure some privacy
1007
for your users by discarding anonymous options.
1008
It is (for the moment) site-wide. It is applied before the
1009
<I>Sympa</I>, rfc2369_header_fields, and custom_header fields are
1010
added.
1011
1012
<P>
1013
Example: <TT>remove_headers Resent-Date,Resent-From,Resent-To,Resent-Message-Id,Sender,Delivered-To,Return-Receipt-To,Precedence,X-Sequence,Disposition-Notification-To</TT>
1014
1015
<P>
1016
1017
<H2><A NAME="SECTION008414000000000000000"></A><A NAME="8167"></A>
1018
<BR>
1019
7.4.14 <TT>anonymous_headers_fields</TT>
1020
</H2>
1021
1022
<P>
1023
(Default value: <TT>Sender,X-Sender,Received,Message-id,From,X-Envelope-To,Resent-From,Reply-To,Organization,Disposition-Notification-To,X-Envelope-From,X-X-Sender</TT>)
1024
1025
<P>
1026
This parameter defines the list of SMTP header fields that should be
1027
removed when a mailing list is setup in anonymous mode (see
1028
<A HREF="node21.html#par-anonymous-sender">20.4.3</A>, page <A HREF="node21.html#par-anonymous-sender"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>).
1029
1030
<P>
1031
1032
<H2><A NAME="SECTION008415000000000000000"></A><A NAME="8171"></A>
1033
<BR>
1034
7.4.15 <TT>list_check_smtp</TT>
1035
</H2>
1036
1037
<P>
1038
(Default value: <TT>NONE</TT>)
1039
1040
<P>
1041
If this parameter is set with a SMTP server address, <I>Sympa</I> will check if alias
1042
with the same name as the list you're gonna create already exists on the
1043
SMTP server. It is robot specific, i.e. you can specify a different SMTP
1044
server for every virtual host you are running. This is needed if you are
1045
running <I>Sympa</I> on somehost.foo.org, but you handle all your mail on a
1046
separate mail relay.
1047
1048
<P>
1049
1050
<H2><A NAME="SECTION008416000000000000000"></A><A NAME="8177"></A>
1051
<BR>
1052
7.4.16 <TT>list_check_suffixes</TT>
1053
</H2>
1054
1055
<P>
1056
(Default value: <TT>request,owner,unsubscribe</TT>)
1057
1058
<P>
1059
This paramater is a comma-separated list of admin suffixes you're using
1060
for <I>Sympa</I> aliases, i.e. mylist-request, mylist-owner etc...
1061
This parameter is used with <A NAME="8182"></A><TT>list_check_smtp</TT> parameter.
1062
It is also used to check list names at list creation time.
1063
1064
<P>
1065
1066
<H2><A NAME="SECTION008417000000000000000"></A><A NAME="8185"></A>
1067
<BR>
1068
7.4.17 <TT>urlize_min_size</TT>
1069
</H2>
1070
1071
<P>
1072
(Default value: <TT>10240</TT>)
1073
1074
<P>
1075
This parameter is related to the <TT>URLIZE</TT> subscriber reception mode ; it
1076
defines the minimum size (in bytes) for MIME attachments to be urlized.
1077
1078
<P>
1079
1080
<H1><A NAME="SECTION00850000000000000000"></A>
1081
<A NAME="quotas"></A>
1082
<BR>
1083
7.5 Quotas
1084
</H1>
1085
1086
<P>
1087
1088
<H2><A NAME="SECTION00851000000000000000"></A><A NAME="8189"></A>
1089
<BR>
1090
7.5.1 <TT>default_shared_quota</TT>
1091
</H2>
1092
1093
<P>
1094
The default disk quota (the unit is Kbytes) for lists' document repository.
1095
1096
<P>
1097
1098
<H2><A NAME="SECTION00852000000000000000"></A><A NAME="8192"></A>
1099
<BR>
1100
7.5.2 <TT>default_archive_quota</TT>
1101
</H2>
1102
1103
<P>
1104
The default disk quota (the unit is Kbytes) for lists' web archives.
1105
1106
<P>
1107
1108
<H1><A NAME="SECTION00860000000000000000"></A>
1109
<A NAME="spool-related"></A>
1110
<BR>
1111
7.6 Spool related
1112
</H1>
1113
1114
<H2><A NAME="SECTION00861000000000000000"></A><A NAME="8195"></A>
1115
<BR>
1116
7.6.1 <TT>spool</TT>
1117
</H2>
1118
1119
<P>
1120
(Default value: <TT><A NAME="8200"></A><TT>/home/sympa/spool</TT></TT>)
1121
1122
<P>
1123
The parent directory which contains all the other spools.
1124
1125
<P>
1126
1127
<H2><A NAME="SECTION00862000000000000000"></A><A NAME="8203"></A>
1128
<BR>
1129
7.6.2 <TT>queue</TT>
1130
</H2>
1131
1132
<P>
1133
The absolute path of the directory which contains the queue, used both by the
1134
<A NAME="8206"></A><TT>queue</TT> program and the <A NAME="8209"></A><TT>sympa.pl</TT> daemon. This
1135
parameter is mandatory.
1136
1137
<P>
1138
Example: <TT><A NAME="8214"></A><TT>/home/sympa/spool/msg</TT></TT>
1139
1140
<P>
1141
1142
<H2><A NAME="SECTION00863000000000000000"></A><A NAME="8217"></A>
1143
<A NAME="1039"></A>
1144
<A NAME="1040"></A>
1145
<BR>
1146
7.6.3 <TT>queuedistribute</TT>
1147
</H2>
1148
1149
<P>
1150
(Default value: <TT><A NAME="8222"></A><TT>/home/sympa/spool/distribute</TT></TT>)
1151
1152
<P>
1153
This parameter is optional and retained solely for backward compatibility.
1154
1155
<P>
1156
1157
<H2><A NAME="SECTION00864000000000000000"></A><A NAME="8225"></A>
1158
<A NAME="cf:queuemod"></A> <A NAME="1044"></A>
1159
<BR>
1160
7.6.4 <TT>queuemod</TT>
1161
</H2>
1162
1163
<P>
1164
(Default value: <TT><A NAME="8230"></A><TT>/home/sympa/spool/moderation</TT></TT>)
1165
1166
<P>
1167
This parameter is optional and retained solely for backward compatibility.
1168
1169
<P>
1170
1171
<H2><A NAME="SECTION00865000000000000000"></A><A NAME="8233"></A>
1172
<A NAME="1047"></A>
1173
<A NAME="1048"></A>
1174
<BR>
1175
7.6.5 <TT>queuedigest</TT>
1176
</H2>
1177
1178
<P>
1179
This parameter is optional and retained solely for backward compatibility.
1180
1181
<P>
1182
1183
<H2><A NAME="SECTION00866000000000000000"></A><A NAME="8236"></A>
1184
<BR>
1185
7.6.6 <TT>queueauth</TT>
1186
</H2>
1187
1188
<P>
1189
(Default value: <TT><A NAME="8241"></A><TT>/home/sympa/spool/auth</TT></TT>)
1190
1191
<P>
1192
This parameter is optional and retained solely for backward compatibility.
1193
1194
<P>
1195
1196
<H2><A NAME="SECTION00867000000000000000"></A><A NAME="8244"></A>
1197
<BR>
1198
7.6.7 <TT>queueoutgoing</TT>
1199
</H2>
1200
1201
<P>
1202
(Default value: <TT><A NAME="8249"></A><TT>/home/sympa/spool/outgoing</TT></TT>)
1203
1204
<P>
1205
This parameter is optional and retained solely for backward compatibility.
1206
1207
<P>
1208
1209
<H2><A NAME="SECTION00868000000000000000"></A><A NAME="8252"></A>
1210
<BR>
1211
7.6.8 <TT>queuetopic</TT>
1212
</H2>
1213
1214
<P>
1215
(Default value: <TT><A NAME="8257"></A><TT>/home/sympa/spool/topic</TT></TT>)
1216
1217
<P>
1218
This parameter is optional and retained solely for backward compatibility.
1219
1220
<P>
1221
1222
<H2><A NAME="SECTION00869000000000000000"></A><A NAME="8260"></A>
1223
<A NAME="1056"></A>
1224
<BR>
1225
7.6.9 <TT>queuebounce</TT>
1226
</H2>
1227
1228
<P>
1229
(Default value: <TT><A NAME="8265"></A><TT>/home/sympa/spool/bounce</TT></TT>)
1230
1231
<P>
1232
Spool to store bounces (non-delivery reports) received by the <A NAME="8268"></A><TT>bouncequeue</TT>
1233
program via the mylist-owner (unless this suffix was customized) or bounce+* addresses (VERP) . This parameter is mandatory
1234
and must be an absolute path.
1235
1236
<P>
1237
1238
<H2><A NAME="SECTION008610000000000000000"></A><A NAME="8271"></A>
1239
<A NAME="1060"></A>
1240
<BR>
1241
7.6.10 <TT>queuetask</TT>
1242
</H2>
1243
1244
<P>
1245
(Default value: <TT><A NAME="8276"></A><TT>/home/sympa/spool/task</TT></TT>)
1246
1247
<P>
1248
Spool to store task files created by the task manager. This parameter is mandatory
1249
and must be an absolute path.
1250
1251
<P>
1252
1253
<H2><A NAME="SECTION008611000000000000000"></A><A NAME="8279"></A>
1254
<BR>
1255
7.6.11 <TT>tmpdir</TT>
1256
</H2>
1257
1258
<P>
1259
(Default value: <TT><A NAME="8284"></A><TT>/home/sympa/spool/tmp</TT></TT>)
1260
1261
<P>
1262
Temporary directory used by OpenSSL and antiviruses.
1263
1264
<P>
1265
1266
<H2><A NAME="SECTION008612000000000000000"></A><A NAME="8287"></A>
1267
<A NAME="kw-sleep"></A>
1268
<BR>
1269
7.6.12 <TT>sleep</TT>
1270
</H2>
1271
1272
<P>
1273
(Default value: <TT>5</TT>)
1274
1275
<P>
1276
Waiting period (in seconds) between each scan of the main queue.
1277
Never set this value to 0!
1278
1279
<P>
1280
1281
<H2><A NAME="SECTION008613000000000000000"></A><A NAME="8291"></A>
1282
<BR>
1283
7.6.13 <TT>clean_delay_queue</TT>
1284
</H2>
1285
1286
<P>
1287
(Default value: <TT>1</TT>)
1288
1289
<P>
1290
Retention period (in days) for ``bad'' messages in
1291
<A NAME="8295"></A>spool (as specified by <A NAME="8296"></A><TT>queue</TT>).
1292
<I>Sympa</I> keeps messages rejected for various reasons (badly
1293
formatted, looping, etc.) in
1294
this directory, with a name prefixed by <TT>BAD</TT>.
1295
This configuration variable controls the number of days
1296
these messages are kept.
1297
1298
<P>
1299
Example: <TT>clean_delay_queue 3</TT>
1300
1301
<P>
1302
1303
<H2><A NAME="SECTION008614000000000000000"></A><A NAME="8301"></A>
1304
<BR>
1305
7.6.14 <TT>clean_delay_queuemod</TT>
1306
</H2>
1307
1308
<P>
1309
(Default value: <TT>10</TT>)
1310
1311
<P>
1312
Expiration delay (in days) in the <A NAME="8305"></A>moderation
1313
<A NAME="8306"></A>spool (as specified by <A NAME="8307"></A><TT>queuemod</TT>).
1314
Beyond this deadline, messages that have not been processed
1315
are deleted. For moderated lists, the contents of this spool
1316
can be consulted using a key along with the <A NAME="8310"></A><TT>MODINDEX</TT> command.
1317
1318
<P>
1319
1320
<H2><A NAME="SECTION008615000000000000000"></A><A NAME="8313"></A>
1321
<BR>
1322
7.6.15 <TT>clean_delay_queueauth</TT>
1323
</H2>
1324
1325
<P>
1326
(Default value: <TT>3</TT>)
1327
1328
<P>
1329
Expiration delay (in days) in the <A NAME="8317"></A>authentication
1330
queue. Beyond this deadline, messages not enabled are
1331
deleted.
1332
1333
<P>
1334
1335
<H2><A NAME="SECTION008616000000000000000"></A><A NAME="8318"></A>
1336
<BR>
1337
7.6.16 <TT>clean_delay_queuesubscribe</TT>
1338
</H2>
1339
1340
<P>
1341
(Default value: <TT>10</TT>)
1342
1343
<P>
1344
Expiration delay (in days) in the <A NAME="8322"></A>subscription requests
1345
queue. Beyond this deadline, requests not validated are deleted.
1346
1347
<P>
1348
1349
<H2><A NAME="SECTION008617000000000000000"></A><A NAME="8323"></A>
1350
<BR>
1351
7.6.17 <TT>clean_delay_queuetopic</TT>
1352
</H2>
1353
1354
<P>
1355
(Default value: <TT>7</TT>)
1356
1357
<P>
1358
Delay for keeping message topic files (in days) in the <A NAME="8327"></A>topic
1359
queue. Beyond this deadline, files are
1360
deleted.
1361
1362
<P>
1363
1364
<H1><A NAME="SECTION00870000000000000000">
1365
7.7 Internationalization related</A>
1366
</H1>
1367
1368
<P>
1369
1370
<H2><A NAME="SECTION00871000000000000000"></A><A NAME="8328"></A>
1371
<BR>
1372
7.7.1 <TT>localedir</TT>
1373
</H2>
1374
1375
<P>
1376
(Default value: <TT><A NAME="8333"></A><TT>/home/sympa/locale</TT></TT>)
1377
1378
<P>
1379
The location of multilingual catalog files. Must correspond to <A NAME="8336"></A><TT>~src/locale/Makefile</TT>.
1380
1381
<P>
1382
1383
<H2><A NAME="SECTION00872000000000000000"></A><A NAME="8341"></A>
1384
<BR>
1385
7.7.2 <TT>supported_lang</TT>
1386
</H2>
1387
1388
<P>
1389
Example: <TT>supported_lang fr,en_US,de,es</TT>
1390
1391
<P>
1392
This parameter lists all supported languages (comma separated) for the user interface. The default value will include
1393
all message catalogues but it can be narrowed by the listmaster.
1394
1395
<P>
1396
1397
<H2><A NAME="SECTION00873000000000000000"></A><A NAME="8345"></A>
1398
<BR>
1399
7.7.3 <TT>lang</TT>
1400
</H2>
1401
1402
<P>
1403
(Default value: <TT>en_US</TT>)
1404
1405
<P>
1406
This is the default language for <I>Sympa</I>. The message catalog (.po, compiled as a .mo file) located
1407
in the corresponding <A NAME="8350"></A><TT>locale</TT> directory will be used.
1408
1409
<P>
1410
1411
<H2><A NAME="SECTION00874000000000000000"></A><A NAME="8353"></A>
1412
<BR>
1413
7.7.4 <TT>web_recode_to</TT>
1414
</H2>
1415
1416
<P>
1417
If you set this parameter to a charset then web pages will be recoded to this specified charset. This is usefull to have web pages
1418
in UTF-8, allowing multi-lingual contents. You should check that customized web templates, topics.conf, list config files, info files are
1419
all using the same charset.
1420
1421
<P>
1422
Example :<PRE>
1423
web_recode_to utf-8
1424
</PRE>
1425
1426
<P>
1427
Note : if you recode web pages to utf-8, you should also add the following tag to your <A NAME="8356"></A><TT>mhonarc-ressources.tt2</TT> file :<PRE>
1428
<TextEncode>
1429
utf-8; MHonArc::UTF8::to_utf8; MHonArc/UTF8.pm
1430
</TextEncode>
1431
</PRE>
1432
1433
<P>
1434
1435
<H1><A NAME="SECTION00880000000000000000">
1436
7.8 Bounce related</A>
1437
</H1>
1438
1439
<P>
1440
1441
<H2><A NAME="SECTION00881000000000000000"></A><A NAME="8359"></A>
1442
<A NAME="kw-verp-rate"></A>
1443
<BR>
1444
7.8.1 <TT>verp_rate</TT>
1445
</H2>
1446
(Default value: <TT>0%</TT>)
1447
1448
<P>
1449
See <A HREF="node24.html#verp">23.1</A>,page <A HREF="node24.html#verp"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A> for more information on VERP in Sympa.
1450
1451
<P>
1452
When <A NAME="8363"></A><TT>verp_rate</TT> is null VERP is not used ; if <A NAME="8366"></A><TT>verp_rate</TT> is 100% VERP is alway in use.
1453
1454
<P>
1455
VERP requires plussed aliases to be supported and the bounce+* alias to be installed.
1456
1457
<P>
1458
1459
<H2><A NAME="SECTION00882000000000000000"></A><A NAME="8369"></A>
1460
<A NAME="kw-welcome-return-path"></A>
1461
<BR>
1462
7.8.2 <TT>welcome_return_path</TT>
1463
</H2>
1464
1465
<P>
1466
(Default value: <TT>owner</TT>)
1467
1468
<P>
1469
If set to string <TT>unique</TT>, Sympa enable VERP for welcome message and bounce processing will
1470
remove the subscription if a bounce is received for the welcome message. This prevent to add bad address in subscriber list.
1471
1472
<P>
1473
1474
<H2><A NAME="SECTION00883000000000000000"></A><A NAME="8373"></A>
1475
<A NAME="kw-remind-return-path"></A>
1476
<BR>
1477
7.8.3 <TT>remind_return_path</TT>
1478
</H2>
1479
1480
<P>
1481
(Default value: <TT>owner</TT>)
1482
1483
<P>
1484
Like <A NAME="8377"></A><TT>welcome_return_path</TT>, but relates to the remind message.
1485
1486
<P>
1487
1488
<H2><A NAME="SECTION00884000000000000000"></A><A NAME="8380"></A>
1489
<A NAME="kw-return-path-suffix"></A>
1490
<BR>
1491
7.8.4 <TT>return_path_suffix</TT>
1492
</H2>
1493
1494
<P>
1495
(Default value: <TT>-owner</TT>)
1496
1497
<P>
1498
This defines the suffix that is appended to the list name to build the return-path
1499
of messages sent to the lists. This is the address that will receive all non delivery
1500
reports (also called bounces).
1501
1502
<P>
1503
1504
<H2><A NAME="SECTION00885000000000000000"></A><A NAME="8384"></A>
1505
<A NAME="kw-expire-bounce-task"></A>
1506
<BR>
1507
7.8.5 <TT>expire_bounce_task</TT>
1508
</H2>
1509
1510
<P>
1511
(Default value: <TT>daily</TT>)
1512
1513
<P>
1514
This parameter tells what task will be used by <A NAME="8388"></A><TT>task_manager.pl</TT>
1515
to perform bounces expiration. This task resets bouncing information for
1516
addresses not bouncing in the last 10 days after the latest message distribution.
1517
1518
<P>
1519
1520
<H2><A NAME="SECTION00886000000000000000"></A><A NAME="8391"></A>
1521
<A NAME="kw-purge-orphan-bounce-task"></A>
1522
<BR>
1523
7.8.6 <TT>purge_orphan_bounces_task</TT>
1524
</H2>
1525
1526
<P>
1527
(Default value: <TT>Monthly</TT>)
1528
1529
<P>
1530
This parameter tells what task will be used by <A NAME="8395"></A><TT>task_manager.pl</TT>
1531
to perform bounces cleaning. This task delete bounces archives for
1532
unsubscribed users.
1533
1534
<P>
1535
1536
<H2><A NAME="SECTION00887000000000000000"></A><A NAME="8398"></A>
1537
<A NAME="kw-eval-bouncers-task"></A>
1538
<BR>
1539
7.8.7 <TT>eval_bouncers_task</TT>
1540
</H2>
1541
1542
<P>
1543
(Default value: <TT>daily</TT>)
1544
1545
<P>
1546
The task eval_bouncers evaluate all bouncing users for all lists, and fill
1547
the field <A NAME="8402"></A><TT>bounce_score_suscriber</TT> in table <A NAME="8405"></A><TT>suscriber_table</TT>
1548
with a score. This score allow the auto-management of bouncing-users.
1549
1550
<P>
1551
1552
<H2><A NAME="SECTION00888000000000000000"></A><A NAME="8408"></A>
1553
<A NAME="kw-process-bouncers-task"></A>
1554
<BR>
1555
7.8.8 <TT>process_bouncers_task</TT>
1556
</H2>
1557
1558
<P>
1559
(Default value: <TT>monthly</TT>)
1560
1561
<P>
1562
The task process_bouncers execute configured actions on bouncing users, according to
1563
their Score. The association between score and actions has to be done in List configuration,
1564
This parameter define the frequency of execution for this task.
1565
1566
<P>
1567
1568
<H2><A NAME="SECTION00889000000000000000"></A><A NAME="8412"></A>
1569
<A NAME="kw-minimum-bouncing-count"></A>
1570
<BR>
1571
7.8.9 <TT>minimum_bouncing_count</TT>
1572
</H2>
1573
1574
<P>
1575
(Default value: <TT>10</TT>)
1576
1577
<P>
1578
This parameter is for the bounce-score evaluation : the bounce-score is a note that
1579
allows the auto-management of bouncing users. This score is evaluated with,in particular,
1580
the number of messages bounces received for the user. This parameter sets the minimum number
1581
of these messages to allow the bounce-score evaluation for a user.
1582
1583
<P>
1584
1585
<H2><A NAME="SECTION008810000000000000000"></A><A NAME="8416"></A>
1586
<A NAME="kw-minimum-bouncing-period"></A>
1587
<BR>
1588
7.8.10 <TT>minimum_bouncing_period</TT>
1589
</H2>
1590
1591
<P>
1592
(Default value: <TT>10</TT>)
1593
1594
<P>
1595
Determine the minimum bouncing period for a user to allow his bounce-score evaluation.
1596
Like previous parameter, if this value is too low, bounce-score will be 0.
1597
1598
<P>
1599
1600
<H2><A NAME="SECTION008811000000000000000"></A><A NAME="8420"></A>
1601
<A NAME="kw-bounce-score-min-bouncing-period"></A>
1602
<BR>
1603
7.8.11 <TT>bounce_delay</TT>
1604
</H2>
1605
1606
<P>
1607
(Default value: <TT>0</TT>) Days
1608
1609
<P>
1610
Another parameter for the bounce-score evaluation : This one represent the average time
1611
(days) for a bounce to come back to sympa-server after a post was send to a list.
1612
Usually bounces are arriving same day as the original message.
1613
1614
<P>
1615
1616
<H2><A NAME="SECTION008812000000000000000"></A><A NAME="8424"></A>
1617
<A NAME="kw-default-bounce-level1-rate"></A>
1618
<BR>
1619
7.8.12 <TT>default_bounce_level1_rate</TT>
1620
</H2>
1621
1622
<P>
1623
(Default value: <TT>45</TT>)
1624
1625
<P>
1626
This is the default value for <A NAME="8428"></A><TT>bouncerslevel1</TT> <A NAME="8431"></A><TT>rate</TT> entry
1627
(<A HREF="#bouncers-level1"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>, page <A HREF="#bouncers-level1"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)
1628
1629
<P>
1630
1631
<H2><A NAME="SECTION008813000000000000000"></A><A NAME="8434"></A>
1632
<A NAME="kw-default-bounce-level1-rate"></A>
1633
<BR>
1634
7.8.13 <TT>default_bounce_level2_rate</TT>
1635
</H2>
1636
1637
<P>
1638
(Default value: <TT>75</TT>)
1639
1640
<P>
1641
This is the default value for <A NAME="8438"></A><TT>bouncerslevel2</TT> <A NAME="8441"></A><TT>rate</TT> entry
1642
(<A HREF="node21.html#bouncers-level2">20.5.3</A>, page <A HREF="node21.html#bouncers-level2"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)
1643
1644
<P>
1645
1646
<H2><A NAME="SECTION008814000000000000000"></A><A NAME="8444"></A>
1647
<BR>
1648
7.8.14 <TT>bounce_email_prefix</TT>
1649
</H2>
1650
1651
<P>
1652
(Default value: <TT>bounce</TT>)
1653
1654
<P>
1655
The prefix string used to build variable envelope return path (VERP). In the context
1656
of VERP enabled, the local part of the address start with a constant string specified by this parameter. The email is used to collect bounce.
1657
Plussed aliases are used in order to introduce the variable part of the email that encode the subscriber address.
1658
This parameter is useful if you want to run more than one sympa on the
1659
same host (a sympa test for example).
1660
1661
<P>
1662
If you change the default value, you must modify the sympa aliases too.
1663
1664
<P>
1665
For example, if you set it as :
1666
1667
<P>
1668
<BLOCKQUOTE>
1669
bounce_email_prefix bounce-test
1670
1671
</BLOCKQUOTE>
1672
1673
<P>
1674
you must modify the sympa aliases like this :
1675
1676
<P>
1677
<BLOCKQUOTE>
1678
bounce-test+*: "| /home/sympa/bin/queuebounce sympa@my.domain.org"
1679
1680
</BLOCKQUOTE>
1681
1682
<P>
1683
See <A HREF="node7.html#robot-aliases">6.1</A>,page <A HREF="node7.html#robot-aliases"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A> for all aliases.
1684
1685
<P>
1686
1687
<H2><A NAME="SECTION008815000000000000000"></A><A NAME="8448"></A>
1688
<A NAME="kw-bounce-warn-rate"></A>
1689
<BR>
1690
7.8.15 <TT>bounce_warn_rate</TT>
1691
</H2>
1692
1693
<P>
1694
(Default value: <TT>30</TT>)
1695
1696
<P>
1697
Site default value for <A NAME="8452"></A><TT>bounce</TT>.
1698
The list owner receives a warning whenever a message is distributed and
1699
the number of bounces exceeds this value.
1700
1701
<P>
1702
1703
<H2><A NAME="SECTION008816000000000000000"></A><A NAME="8455"></A>
1704
<A NAME="kw-bounce-halt-rate"></A>
1705
<BR>
1706
7.8.16 <TT>bounce_halt_rate</TT>
1707
</H2>
1708
1709
<P>
1710
(Default value: <TT>50</TT>)
1711
1712
<P>
1713
<TT>FOR FUTURE USE</TT>
1714
1715
<P>
1716
Site default value for <A NAME="8459"></A><TT>bounce</TT>.
1717
Messages will cease to be distributed if the number of bounces exceeds this value.
1718
1719
<P>
1720
1721
<H2><A NAME="SECTION008817000000000000000"></A><A NAME="8462"></A>
1722
<A NAME="kw-default-remind-task"></A>
1723
<BR>
1724
7.8.17 <TT>default_remind_task</TT>
1725
</H2>
1726
1727
<P>
1728
(Default value: <TT>2month</TT>)
1729
1730
<P>
1731
This parameter defines the default <A NAME="8466"></A><TT>remind_task</TT> list parameter.
1732
1733
<P>
1734
1735
<H1><A NAME="SECTION00890000000000000000">
1736
7.9 Tuning</A>
1737
</H1>
1738
1739
<P>
1740
1741
<H2><A NAME="SECTION00891000000000000000"></A><A NAME="8469"></A>
1742
<A NAME="cache-list"></A>
1743
<BR>
1744
7.9.1 <TT>cache_list_config</TT>
1745
</H2>
1746
<TT>Format: none | binary_file</TT>
1747
(Default value: <TT>none</TT>)
1748
1749
<P>
1750
If this parameter is set to binary_file, then Sympa processes will maintain a binary version of the
1751
list config structure on disk (<A NAME="8473"></A><TT>config.bin</TT> file). This file is bypassed whenever the <A NAME="8476"></A><TT>config</TT>
1752
file changes on disk. Thanks to this method, the startup of Sympa processes is much faster because it
1753
saves the time for parse all config files. The drawback of this method is that the list config cache could
1754
live for a long time (not recreated when Sympa process restart) ; Sympa processes could still use authorization
1755
scenario rules that have changed on disk in the meanwhile.
1756
1757
<P>
1758
You should use list config cache if you are managing a big amount of lists (1000+).
1759
1760
<P>
1761
1762
<H2><A NAME="SECTION00892000000000000000"></A><A NAME="8479"></A>
1763
<A NAME="kw-sympa-priority"></A>
1764
<BR>
1765
7.9.2 <TT>sympa_priority</TT>
1766
</H2>
1767
1768
<P>
1769
(Default value: <TT>1</TT>)
1770
1771
<P>
1772
Priority applied to <I>Sympa</I> commands while running the spool.
1773
1774
<P>
1775
Available since release 2.3.1.
1776
1777
<P>
1778
1779
<H2><A NAME="SECTION00893000000000000000"></A><A NAME="8484"></A>
1780
<A NAME="kw-request-priority"></A>
1781
<BR>
1782
7.9.3 <TT>request_priority</TT>
1783
</H2>
1784
1785
<P>
1786
(Default value: <TT>0</TT>)
1787
1788
<P>
1789
Priority for processing of messages for mylist-request,
1790
i.e. for owners of the list.
1791
1792
<P>
1793
Available since release 2.3.3
1794
1795
<P>
1796
1797
<H2><A NAME="SECTION00894000000000000000"></A><A NAME="8488"></A>
1798
<A NAME="kw-owner-priority"></A>
1799
<BR>
1800
7.9.4 <TT>owner_priority</TT>
1801
</H2>
1802
1803
<P>
1804
(Default value: <TT>9</TT>)
1805
1806
<P>
1807
Priority for processing messages for mylist-owner in
1808
the spool. This address will receive non-delivery reports
1809
(bounces) and should have a low priority.
1810
1811
<P>
1812
Available since release 2.3.3
1813
1814
<P>
1815
1816
<H2><A NAME="SECTION00895000000000000000"></A><A NAME="8492"></A>
1817
<A NAME="kw-default-list-priority"></A>
1818
<BR>
1819
7.9.5 <TT>default_list_priority</TT>
1820
</H2>
1821
1822
<P>
1823
(Default value: <TT>5</TT>)
1824
1825
<P>
1826
Default priority for messages if not defined in the list
1827
configuration file.
1828
1829
<P>
1830
Available since release 2.3.1.
1831
1832
<P>
1833
1834
<H1><A NAME="SECTION008100000000000000000">
1835
7.10 Database related</A>
1836
</H1>
1837
1838
<P>
1839
The following parameters are needed when using an RDBMS, but are otherwise not required:
1840
1841
<P>
1842
1843
<H2><A NAME="SECTION008101000000000000000"></A><A NAME="8496"></A>
1844
<BR>
1845
7.10.1 <TT>update_db_field_types</TT>
1846
</H2>
1847
1848
<P>
1849
<TT>Format: update_db_field_types auto | disabled</TT>
1850
1851
<P>
1852
(Default value: <TT>auto</TT>)
1853
1854
<P>
1855
This parameter defines if Sympa may automatically update database structure to match the expected datafield types.
1856
This feature is only available with <A NAME="8500"></A>mysql.
1857
1858
<P>
1859
1860
<H2><A NAME="SECTION008102000000000000000"></A><A NAME="8501"></A>
1861
<BR>
1862
7.10.2 <TT>db_type</TT>
1863
</H2>
1864
1865
<P>
1866
<TT>Format: db_type mysql | SQLite | Pg | Oracle | Sybase</TT>
1867
1868
<P>
1869
Database management system used (e.g. MySQL, Pg, Oracle)
1870
1871
<P>
1872
This corresponds to the PERL DataBase Driver (DBD) name and
1873
is therefore case-sensitive.
1874
1875
<P>
1876
1877
<H2><A NAME="SECTION008103000000000000000"></A><A NAME="8504"></A>
1878
<BR>
1879
7.10.3 <TT>db_name</TT>
1880
</H2>
1881
1882
<P>
1883
(Default value: <TT>sympa</TT>)
1884
1885
<P>
1886
Name of the database containing user information. See
1887
detailed notes on database structure, <A HREF="#rdbms-struct"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>,
1888
page <A HREF="#rdbms-struct"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>. If you are using SQLite, then this
1889
parameter is the DB file name.
1890
1891
<P>
1892
1893
<H2><A NAME="SECTION008104000000000000000"></A><A NAME="8508"></A>
1894
<BR>
1895
7.10.4 <TT>db_host</TT>
1896
</H2>
1897
1898
<P>
1899
Database host name.
1900
1901
<P>
1902
1903
<H2><A NAME="SECTION008105000000000000000"></A><A NAME="8511"></A>
1904
<BR>
1905
7.10.5 <TT>db_port</TT>
1906
</H2>
1907
1908
<P>
1909
Database port.
1910
1911
<P>
1912
1913
<H2><A NAME="SECTION008106000000000000000"></A><A NAME="8514"></A>
1914
<BR>
1915
7.10.6 <TT>db_user</TT>
1916
</H2>
1917
1918
<P>
1919
User with read access to the database.
1920
1921
<P>
1922
1923
<H2><A NAME="SECTION008107000000000000000"></A><A NAME="8517"></A>
1924
<BR>
1925
7.10.7 <TT>db_passwd</TT>
1926
</H2>
1927
1928
<P>
1929
Password for <A NAME="8520"></A><TT>db_user</TT>.
1930
1931
<P>
1932
1933
<H2><A NAME="SECTION008108000000000000000"></A><A NAME="8523"></A>
1934
<BR>
1935
7.10.8 <TT>db_timeout</TT>
1936
</H2>
1937
1938
<P>
1939
This parameter is used for SQLite only.
1940
1941
<P>
1942
1943
<H2><A NAME="SECTION008109000000000000000"></A><A NAME="8526"></A>
1944
<BR>
1945
7.10.9 <TT>db_options</TT>
1946
</H2>
1947
1948
<P>
1949
If these options are defined, they will be appended to the
1950
database connect string.
1951
1952
<P>
1953
Example for MySQL:<PRE>
1954
db_options mysql_read_default_file=/home/joe/my.cnf
1955
</PRE>
1956
1957
<P>
1958
1959
<H2><A NAME="SECTION0081010000000000000000"></A><A NAME="8529"></A>
1960
<BR>
1961
7.10.10 <TT>db_env</TT>
1962
</H2>
1963
1964
<P>
1965
Gives a list of environment variables to set before database connexion.
1966
This is a ';' separated list of variable assignments.
1967
1968
<P>
1969
Example for Oracle:<PRE>
1970
db_env ORACLE_TERM=vt100;ORACLE_HOME=/var/hote/oracle/7.3.4
1971
</PRE>
1972
1973
<P>
1974
1975
<H2><A NAME="SECTION0081011000000000000000"></A><A NAME="8532"></A>
1976
<A NAME="db-additional-subscriber-fields"></A>
1977
<BR>
1978
7.10.11 <TT>db_additional_subscriber_fields</TT>
1979
</H2>
1980
1981
<P>
1982
If your <B>subscriber_table</B> database table has more fields
1983
than required by <I>Sympa</I> (because other programs access this
1984
table), you can make <I>Sympa</I> recognize these fields. You will then be able to
1985
use them from within mail/web templates and authorization scenarios (as [subscriber-<TT>></TT>field]).
1986
These fields will also appear in the list members review page and will be editable by the list owner.
1987
This parameter is a comma-separated list.
1988
1989
<P>
1990
Example :<PRE>
1991
db_additional_subscriber_fields billing_delay,subscription_expiration
1992
</PRE>
1993
1994
<P>
1995
1996
<H2><A NAME="SECTION0081012000000000000000"></A><A NAME="8537"></A>
1997
<BR>
1998
7.10.12 <TT>db_additional_user_fields</TT>
1999
</H2>
2000
2001
<P>
2002
<A NAME="db-additional-user-fields"></A>
2003
<P>
2004
If your <B>user_table</B> database table has more fields
2005
than required by <I>Sympa</I> (because other programs access this
2006
table), you can make <I>Sympa</I> recognize these fields. You will then be able to
2007
use them from within mail/web templates (as [user-<TT>></TT>field]).
2008
2009
<P>
2010
This parameter is a comma-separated list.
2011
2012
<P>
2013
Example :<PRE>
2014
db_additional_user_fields address,gender
2015
</PRE>
2016
2017
<P>
2018
2019
<H2><A NAME="SECTION0081013000000000000000"></A><A NAME="8542"></A>
2020
<BR>
2021
7.10.13 <TT>purge_user_table_task</TT>
2022
</H2>
2023
2024
<P>
2025
<A NAME="purge-user-table-task"></A>
2026
<P>
2027
This parameter refers to the name of the task (Example: <TT>monthly</TT>) that will be regularly run
2028
by the <A NAME="8546"></A><TT>task_manager.pl</TT> to remove entries in the <A NAME="8549"></A>user_table table that
2029
have no corresponding entries in the <A NAME="8550"></A>subscriber_table table.
2030
2031
<P>
2032
2033
<H1><A NAME="SECTION008110000000000000000">
2034
7.11 Loop prevention</A>
2035
</H1>
2036
2037
<P>
2038
The following define your loop prevention policy for commands.
2039
(see <A HREF="node17.html#loop-detection">16.7</A>, page <A HREF="node17.html#loop-detection"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)
2040
2041
<P>
2042
2043
<H2><A NAME="SECTION008111000000000000000"></A><A NAME="8551"></A>
2044
<BR>
2045
7.11.1 <TT>loop_command_max</TT>
2046
</H2>
2047
2048
<P>
2049
(Default value: <TT>200</TT>)
2050
2051
<P>
2052
The maximum number of command reports sent to an e-mail
2053
address. When it is reached, messages are stored with the BAD
2054
prefix, and reports are no longer sent.
2055
2056
<P>
2057
2058
<H2><A NAME="SECTION008112000000000000000"></A><A NAME="8555"></A>
2059
<BR>
2060
7.11.2 <TT>loop_command_sampling_delay</TT>
2061
</H2>
2062
2063
<P>
2064
(Default value: <TT>3600</TT>)
2065
2066
<P>
2067
This parameter defines the delay in seconds before decrementing
2068
the counter of reports sent to an e-mail address.
2069
2070
<P>
2071
2072
<H2><A NAME="SECTION008113000000000000000"></A><A NAME="8559"></A>
2073
<BR>
2074
7.11.3 <TT>loop_command_decrease_factor</TT>
2075
</H2>
2076
2077
<P>
2078
(Default value: <TT>0.5</TT>)
2079
2080
<P>
2081
The decrementation factor (<TT>from 0 to 1</TT>), used to
2082
determine the new report counter after expiration of the delay.
2083
2084
<P>
2085
2086
<H2><A NAME="SECTION008114000000000000000"></A><A NAME="8563"></A>
2087
<BR>
2088
7.11.4 <TT>loop_prevention_regex</TT>
2089
</H2>
2090
2091
<P>
2092
(Default value: <TT>mailer-daemon|sympa|listserv|majordomo|smartlist|mailman</TT>)
2093
2094
<P>
2095
This regular expression is applied to messages sender address. If the sender address matches the regular expression, then
2096
the message is rejected. The goal of this parameter is to prevent loops between Sympa and other robots.
2097
2098
<P>
2099
2100
<H1><A NAME="SECTION008120000000000000000">
2101
7.12 S/MIME configuration</A>
2102
</H1>
2103
2104
<P>
2105
<I>Sympa</I> can optionally verify and use S/MIME signatures for security purposes.
2106
In this case, the three first following parameters must be set by the listmaster
2107
(see <A HREF="node27.html#smimeconf">26.4.2</A>, page <A HREF="node27.html#smimeconf"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>). The two others are optionnal.
2108
2109
<P>
2110
2111
<H2><A NAME="SECTION008121000000000000000"></A><A NAME="8568"></A>
2112
<BR>
2113
7.12.1 <TT>openssl</TT>
2114
</H2>
2115
2116
<P>
2117
The path for the openSSL binary file.
2118
2119
<P>
2120
2121
<H2><A NAME="SECTION008122000000000000000"></A><A NAME="8571"></A>
2122
<BR>
2123
7.12.2 <TT>capath</TT>
2124
</H2>
2125
The directory path use by openssl for trusted CA certificates.
2126
2127
<P>
2128
A directory of trusted certificates. The certificates should
2129
have names of the form: hash.0 or have symbolic links to
2130
them of this form ("hash" is the hashed certificate subject
2131
name: see the -hash option of the openssl x509 utility). This
2132
directory should be the same as the directory
2133
SSLCACertificatePath specified for mod_ssl module for Apache.
2134
2135
<P>
2136
2137
<H2><A NAME="SECTION008123000000000000000"></A><A NAME="8574"></A>
2138
<BR>
2139
7.12.3 <TT>cafile</TT>
2140
</H2>
2141
This parameter sets the all-in-one file where you can assemble
2142
the Certificates of Certification Authorities (CA) whose clients
2143
you deal with. These are used for Client Authentication. Such a
2144
file is simply the concatenation of the various PEM-encoded
2145
Certificate files, in order of preference. This can be used
2146
alternatively and/or additionally to <A NAME="8577"></A><TT>capath</TT>.
2147
2148
<P>
2149
2150
<H2><A NAME="SECTION008124000000000000000"></A><A NAME="8580"></A>
2151
<BR>
2152
7.12.4 <TT>key_passwd</TT>
2153
</H2>
2154
2155
<P>
2156
The password for list private key encryption. If not
2157
defined, <I>Sympa</I> assumes that list private keys are not encrypted.
2158
2159
<P>
2160
<A NAME="certificate-task-config"></A>
2161
<H2><A NAME="SECTION008125000000000000000"></A><A NAME="8584"></A>
2162
<BR>
2163
7.12.5 <TT>chk_cert_expiration_task</TT>
2164
</H2>
2165
2166
<P>
2167
States the model version used to create the task which regularly checks the certificate
2168
expiration dates and warns users whose certificate have expired or are going to.
2169
To know more about tasks, see <A HREF="node17.html#tasks">16.8</A>, page <A HREF="node17.html#tasks"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>.
2170
2171
<P>
2172
2173
<H2><A NAME="SECTION008126000000000000000"></A><A NAME="8587"></A>
2174
<BR>
2175
7.12.6 <TT>crl_update_task</TT>
2176
</H2>
2177
2178
<P>
2179
Specifies the model version used to create the task which regurlaly updates the certificate
2180
revocation lists.
2181
2182
<P>
2183
2184
<H1><A NAME="SECTION008130000000000000000"></A>
2185
<A NAME="Antivirus_plug-in"></A>
2186
<BR>
2187
7.13 Antivirus plug-in
2188
</H1>
2189
2190
<P>
2191
<I>Sympa</I> can optionally check incoming messages before delivering them, using an external antivirus solution.
2192
You must then set two parameters.
2193
2194
<P>
2195
2196
<H2><A NAME="SECTION008131000000000000000"></A><A NAME="8591"></A>
2197
<BR>
2198
7.13.1 <TT>antivirus_path</TT>
2199
</H2>
2200
2201
<P>
2202
The path to your favorite antivirus binary file (including the binary file).
2203
2204
<P>
2205
Example :<PRE>
2206
antivirus_path /usr/local/bin/uvscan
2207
</PRE>
2208
2209
<P>
2210
2211
<H2><A NAME="SECTION008132000000000000000"></A><A NAME="8594"></A>
2212
<BR>
2213
7.13.2 <TT>antivirus_args</TT>
2214
</H2>
2215
2216
<P>
2217
The arguments used by the antivirus software to look for viruses.
2218
You must set them so as to get the virus name.
2219
You should use, if available, the 'unzip' option and check all extensions.
2220
2221
<P>
2222
Example with uvscan :<PRE>
2223
antivirus_args --summary --secure
2224
</PRE>
2225
2226
<P>
2227
Example with fsav :<PRE>
2228
antivirus_args --dumb --archive
2229
</PRE>
2230
2231
<P>
2232
Exemple with AVP :<PRE>
2233
antivirus_path /opt/AVP/kavscanner
2234
antivirus_args -Y -O- -MP -I0
2235
</PRE>
2236
2237
<P>
2238
Exemple with Sophos :<PRE>
2239
antivirus_path /usr/local/bin/sweep
2240
antivirus_args -nc -nb -ss -archive
2241
</PRE>
2242
2243
<P>
2244
Exemple with Clam :<PRE>
2245
antivirus_path /usr/local/bin/clamscan
2246
antivirus_args --stdout
2247
</PRE>
2248
2249
<P>
2250
2251
<H2><A NAME="SECTION008133000000000000000"></A><A NAME="8597"></A>
2252
<BR>
2253
7.13.3 <TT>antivirus_notify</TT>
2254
</H2> <TT>sender</TT> | <TT>nobody</TT>
2255
2256
<P>
2257
(Default value: <TT>sender</TT>)
2258
2259
<P>
2260
This parameter tells if <I>Sympa</I> should notify the email sender when a virus has been
2261
detected.
2262
2263
<P>
2264
2265
<HR>
2266
<!--Navigation Panel-->
2267
<A NAME="tex2html893"
2268
HREF="node9.html">
2269
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
2270
<A NAME="tex2html887"
2271
HREF="sympa.html">
2272
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
2273
<A NAME="tex2html881"
2274
HREF="node7.html">
2275
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
2276
<A NAME="tex2html889"
2277
HREF="node1.html">
2278
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
2279
<A NAME="tex2html891"
2280
HREF="node30.html">
2281
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
2282
<BR>
2283
<B> Next:</B> <A NAME="tex2html894"
2284
HREF="node9.html">8. Sympa and its database</A>
2285
<B> Up:</B> <A NAME="tex2html888"
2286
HREF="sympa.html">Sympa Mailing Lists Management Software version</A>
2287
<B> Previous:</B> <A NAME="tex2html882"
2288
HREF="node7.html">6. Mail aliases</A>
2289
<B> <A NAME="tex2html890"
2290
HREF="node1.html">Contents</A></B>
2291
<B> <A NAME="tex2html892"
2292
HREF="node30.html">Index</A></B>
2293
<!--End of Navigation Panel-->
2294
<ADDRESS>
2295
root
2296
2006-10-20
2297
</ADDRESS>
2298
</BODY>
2299
</HTML>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1