Mercurial > hg > mlmmj
annotate TUNABLES @ 887:3032cb926799 BRANCH_1_2_18
Added tag RELEASE_1_2_18_1 for changeset c1b22b049682
author | Ben Schmidt |
---|---|
date | Wed, 05 Feb 2014 17:14:22 +1100 |
parents | 0f90ad70a59f |
children | 49efd4fe7557 |
rev | line source |
---|---|
89 | 1 TUNABLES for lists managed with mlmmj: |
2 -------------------------------------- | |
3 | |
4 The following files can be used for changing the behaviour of a list. The | |
5 filename is supposed to be below listdir/control. In the case it's a "boolean", | |
6 the contents of a file does not matter, the mere presence of it, will set the | |
7 variable to "true". If it's a "normal" file, the first line will be used as | |
228
fda21d560980
Make it possible to specify several owner emailaddresses, not just one
mmj
parents:
222
diff
changeset
|
8 value, leaving line 2 and forward ready for commentary etc. If it's possible |
714 | 9 to specify several entries (one pr. line), it's marked "list". If the file's |
10 entire content is used as value, it's marked "text". | |
255 | 11 |
735 | 12 · listaddress (list) |
460 | 13 |
14 This file contains all addresses which mlmmj sees as listaddresses (see | |
15 tocc below). The first one is the one used as the primary one, when mlmmj | |
16 sends out mail. | |
17 | |
735 | 18 · closedlist (boolean) |
89 | 19 |
570 | 20 Is the list is open or closed. If it's closed subscription and |
514 | 21 unsubscription via mail is disabled. |
89 | 22 |
735 | 23 · closedlistsub (boolean) |
528 | 24 |
25 Closed for subscription. Unsubscription is possible. | |
26 | |
735 | 27 · moderated (boolean) |
89 | 28 |
281 | 29 If this file is present, the emailaddresses in the file |
30 listdir/control/moderators will act as moderators for the list. | |
89 | 31 |
735 | 32 · submod (list) |
560
3258e74426b3
Subscriber moderation finished. Will test it all later tonight, but
mmj
parents:
528
diff
changeset
|
33 |
3258e74426b3
Subscriber moderation finished. Will test it all later tonight, but
mmj
parents:
528
diff
changeset
|
34 If this file is present, subscription will be moderated by owner(s). |
570 | 35 If there are emailaddresses in this file, then these will be used |
560
3258e74426b3
Subscriber moderation finished. Will test it all later tonight, but
mmj
parents:
528
diff
changeset
|
36 instead of owner. |
3258e74426b3
Subscriber moderation finished. Will test it all later tonight, but
mmj
parents:
528
diff
changeset
|
37 |
735 | 38 · tocc (boolean) |
219
7dcc23ad4387
Mention control/tocc and control/subonlypost in TUNABLES and ChangeLog
mmj
parents:
90
diff
changeset
|
39 |
7dcc23ad4387
Mention control/tocc and control/subonlypost in TUNABLES and ChangeLog
mmj
parents:
90
diff
changeset
|
40 If this file is present, the list address does not have to be in the To: |
7dcc23ad4387
Mention control/tocc and control/subonlypost in TUNABLES and ChangeLog
mmj
parents:
90
diff
changeset
|
41 or Cc: header of the email to the list. |
7dcc23ad4387
Mention control/tocc and control/subonlypost in TUNABLES and ChangeLog
mmj
parents:
90
diff
changeset
|
42 |
735 | 43 · subonlypost (boolean) |
219
7dcc23ad4387
Mention control/tocc and control/subonlypost in TUNABLES and ChangeLog
mmj
parents:
90
diff
changeset
|
44 |
7dcc23ad4387
Mention control/tocc and control/subonlypost in TUNABLES and ChangeLog
mmj
parents:
90
diff
changeset
|
45 When this file is present, only people who are subscribed to the list, |
7dcc23ad4387
Mention control/tocc and control/subonlypost in TUNABLES and ChangeLog
mmj
parents:
90
diff
changeset
|
46 are allowed to post to it. The check is made against the "From:" header. |
7dcc23ad4387
Mention control/tocc and control/subonlypost in TUNABLES and ChangeLog
mmj
parents:
90
diff
changeset
|
47 |
735 | 48 · modnonsubposts (boolean) |
602 | 49 |
842
c6fe438f3e60
Fix access logic so subonlypost doesn't override a send access rule.
Ben Schmidt
parents:
735
diff
changeset
|
50 When this file is present, all postings from people who are not subscribed |
c6fe438f3e60
Fix access logic so subonlypost doesn't override a send access rule.
Ben Schmidt
parents:
735
diff
changeset
|
51 to the list will be moderated. |
602 | 52 |
735 | 53 · prefix (normal) |
89 | 54 |
55 The prefix for the Subject: line of mails to the list. This will alter the | |
56 Subject: line, and add a prefix if it's not present elsewhere. | |
57 | |
735 | 58 · owner (list) |
228
fda21d560980
Make it possible to specify several owner emailaddresses, not just one
mmj
parents:
222
diff
changeset
|
59 |
fda21d560980
Make it possible to specify several owner emailaddresses, not just one
mmj
parents:
222
diff
changeset
|
60 The emailaddresses in this file (1 pr. line) will get mails to |
fda21d560980
Make it possible to specify several owner emailaddresses, not just one
mmj
parents:
222
diff
changeset
|
61 listname+owner@listdomain.tld |
fda21d560980
Make it possible to specify several owner emailaddresses, not just one
mmj
parents:
222
diff
changeset
|
62 |
735 | 63 · customheaders (list) |
359
ca217febcfbd
Rerwrite the way listtexts are handled and move Subject: out into the file
mmj
parents:
355
diff
changeset
|
64 |
ca217febcfbd
Rerwrite the way listtexts are handled and move Subject: out into the file
mmj
parents:
355
diff
changeset
|
65 These headers are added to every mail coming through. This is the place you |
ca217febcfbd
Rerwrite the way listtexts are handled and move Subject: out into the file
mmj
parents:
355
diff
changeset
|
66 want to add Reply-To: header in case you want such. |
ca217febcfbd
Rerwrite the way listtexts are handled and move Subject: out into the file
mmj
parents:
355
diff
changeset
|
67 |
735 | 68 · delheaders (list) |
89 | 69 |
231 | 70 In this file is specified *ONE* headertoken to match pr. line. If the file |
71 consists of: | |
72 Received: | |
73 Message-ID: | |
74 Then all occurences of these headers in incoming list mail will be deleted. | |
234 | 75 "From " and "Return-Path:" are deleted no matter what. |
255 | 76 |
735 | 77 · access (list) |
255 | 78 |
79 If this file exists, all headers of a post to the list is matched against | |
80 the rules. The first rule to match wins. See README.access for syntax and | |
81 examples. | |
268
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
82 |
735 | 83 · memorymailsize (normal) |
268
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
84 |
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
85 Here is specified in bytes how big a mail can be and still be prepared for |
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
86 sending in memory. It's greatly reducing the amount of write system calls to |
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
87 prepare it in memory before sending it, but can also lead to denial of |
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
88 service attacks. Default is 16k (16384 bytes). |
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
89 |
735 | 90 · addtohdr (boolean) |
268
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
91 |
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
92 When this file is present, a To: header including the recipients |
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
93 emailaddress will be added to outgoing mail. Recommended usage is to remove |
1dbadf407849
mlmmj-send now prepares headers and mail, and To: header feature added
mmj
parents:
255
diff
changeset
|
94 existing To: headers with delheaders (see above) first. |
291 | 95 |
735 | 96 · relayhost (normal) |
291 | 97 |
293 | 98 The host specified (IP address or hostname, both works) in this file will |
291 | 99 be used for relaying the mail sent to the list. Defaults to 127.0.0.1. |
100 | |
735 | 101 · notifysub (boolean) |
291 | 102 |
103 If this file is present, the owner(s) will get a mail with the address of | |
104 someone sub/unsubscribing to a mailinglist. | |
320
b2fe9c6cb9fe
Bouncelife and crontab entry fix and a commented out genmsgid() function
mmj
parents:
293
diff
changeset
|
105 |
735 | 106 · notifymod (boolean) |
729
d78eb18576b0
Added feature to notify users when their posts are moderated
Ben Schmidt
parents:
728
diff
changeset
|
107 |
d78eb18576b0
Added feature to notify users when their posts are moderated
Ben Schmidt
parents:
728
diff
changeset
|
108 If this file is present, the poster (based on the envelope from) will |
879 | 109 get a mail when their post is being moderated. |
729
d78eb18576b0
Added feature to notify users when their posts are moderated
Ben Schmidt
parents:
728
diff
changeset
|
110 |
735 | 111 · digestinterval (normal) |
338 | 112 |
113 This file specifies how many seconds will pass before the next digest is | |
114 sent. Defaults to 604800 seconds, which is 7 days. | |
115 | |
735 | 116 · digestmaxmails (normal) |
338 | 117 |
118 This file specifies how many mails can accumulate before digest sending is | |
119 triggered. Defaults to 50 mails, meaning that if 50 mails arrive to the list | |
120 before digestinterval have passed, the digest is delivered. | |
121 | |
735 | 122 · bouncelife (normal) |
320
b2fe9c6cb9fe
Bouncelife and crontab entry fix and a commented out genmsgid() function
mmj
parents:
293
diff
changeset
|
123 |
b2fe9c6cb9fe
Bouncelife and crontab entry fix and a commented out genmsgid() function
mmj
parents:
293
diff
changeset
|
124 Here is specified for how long time in seconds an address can bounce before |
b2fe9c6cb9fe
Bouncelife and crontab entry fix and a commented out genmsgid() function
mmj
parents:
293
diff
changeset
|
125 it's unsubscribed. Defaults to 432000 seconds, which is 5 days. |
343
6d1f589dee87
This is post crash commit of working copy mmj. Will test compile etc.
mmj
parents:
338
diff
changeset
|
126 |
735 | 127 · noarchive (boolean) |
343
6d1f589dee87
This is post crash commit of working copy mmj. Will test compile etc.
mmj
parents:
338
diff
changeset
|
128 |
6d1f589dee87
This is post crash commit of working copy mmj. Will test compile etc.
mmj
parents:
338
diff
changeset
|
129 If this file exists, the mail won't be saved in the archive but simply |
6d1f589dee87
This is post crash commit of working copy mmj. Will test compile etc.
mmj
parents:
338
diff
changeset
|
130 deleted. |
355 | 131 |
735 | 132 · nosubconfirm (boolean) |
355 | 133 |
134 If this file exists, no mail confirmation is needed to subscribe to the | |
135 list. This should in principle never ever be used, but there is times | |
136 on local lists etc. where this is useful. HANDLE WITH CARE! | |
426 | 137 |
735 | 138 · noget (boolean) |
444 | 139 |
140 If this file exists, then retrieving old posts with +get-N is disabled | |
141 | |
735 | 142 · subonlyget (boolean) |
513 | 143 |
144 If this file exists, then retrieving old posts with +get-N is only | |
145 possible for subscribers. The above mentioned 'noget' have precedence. | |
146 | |
735 | 147 · verp (normal) |
426 | 148 |
845 | 149 Control how Mlmmj does VERP (variable envelope return path). If this tunable |
150 does not exist, Mlmmj will send a message to the SMTP server for each | |
151 recipient, with an appropriate envelope return path, i.e. it will handle | |
152 VERP itself. If the tunable does exist, Mlmmj will instead divide the | |
153 recipients into groups (the maximum number of recipients in a group can be | |
154 controlled by the maxverprecips tunable) and send one message to the SMTP | |
155 server per group. The content of this tunable allows VERP to be handled by | |
156 the SMTP server. If the tunable contains "postfix", Mlmmj will make Postfix | |
157 use VERP by adding XVERP=-= to the MAIL FROM: line. If it contains something | |
158 else, that text will be appended to the MAIL FROM: line. If it contains | |
159 nothing, VERP will effectively be disabled, as neither Mlmmj nor the SMTP | |
160 server will do it. | |
426 | 161 |
735 | 162 · maxverprecips (normal) |
426 | 163 |
845 | 164 How many recipients per mail delivered to the SMTP server. Defaults to 100. |
439
b75073f25e60
Add switches to control whether or not mlmmj sends out mails explaining
mmj
parents:
426
diff
changeset
|
165 |
735 | 166 · notoccdenymails (boolean) |
167 · noaccessdenymails (boolean) | |
168 · nosubonlydenymails (boolean) | |
439
b75073f25e60
Add switches to control whether or not mlmmj sends out mails explaining
mmj
parents:
426
diff
changeset
|
169 |
b75073f25e60
Add switches to control whether or not mlmmj sends out mails explaining
mmj
parents:
426
diff
changeset
|
170 These switches turns off whether mlmmj sends out notification about postings |
b75073f25e60
Add switches to control whether or not mlmmj sends out mails explaining
mmj
parents:
426
diff
changeset
|
171 being denied due to the listaddress not being in To: or Cc: (see 'tocc'), |
b75073f25e60
Add switches to control whether or not mlmmj sends out mails explaining
mmj
parents:
426
diff
changeset
|
172 when it was rejected due to an access rule (see 'access') or whether it's a |
b75073f25e60
Add switches to control whether or not mlmmj sends out mails explaining
mmj
parents:
426
diff
changeset
|
173 subscribers only posting list (see 'subonlypost'). |
458 | 174 |
735 | 175 · nosubmodmails (boolean) |
728
e5286b45f9ca
Fixed documentation regarding silent subscription, and added
Ben Schmidt
parents:
727
diff
changeset
|
176 |
e5286b45f9ca
Fixed documentation regarding silent subscription, and added
Ben Schmidt
parents:
727
diff
changeset
|
177 This switch turns off whether mlmmj sends out notification about |
e5286b45f9ca
Fixed documentation regarding silent subscription, and added
Ben Schmidt
parents:
727
diff
changeset
|
178 subscription being moderated to the person requesting subscription |
e5286b45f9ca
Fixed documentation regarding silent subscription, and added
Ben Schmidt
parents:
727
diff
changeset
|
179 (see 'submod'). |
e5286b45f9ca
Fixed documentation regarding silent subscription, and added
Ben Schmidt
parents:
727
diff
changeset
|
180 |
735 | 181 · smtpport (normal) |
458 | 182 |
183 In this file a port other than port 25 for connecting to the relayhost | |
184 can be specified. | |
520 | 185 |
735 | 186 · delimiter (normal) |
520 | 187 |
188 This specifies what to use as recipient delimiter for the list. | |
189 Default is "+". | |
565
e3a9ca0e9c33
added support for digest text part and digestissue keyword
mortenp
parents:
560
diff
changeset
|
190 |
735 | 191 · nodigesttext (boolean) |
565
e3a9ca0e9c33
added support for digest text part and digestissue keyword
mortenp
parents:
560
diff
changeset
|
192 |
e3a9ca0e9c33
added support for digest text part and digestissue keyword
mortenp
parents:
560
diff
changeset
|
193 If this file exists, digest mails won't have a text part with a thread |
570 | 194 summary. |
612
ded3bd1059cd
Added 'nodigestsub' tunable which will disable subscription to the digest version of a list (Henne Vogelsang)
mortenp
parents:
603
diff
changeset
|
195 |
735 | 196 · nodigestsub (boolean) |
612
ded3bd1059cd
Added 'nodigestsub' tunable which will disable subscription to the digest version of a list (Henne Vogelsang)
mortenp
parents:
603
diff
changeset
|
197 |
ded3bd1059cd
Added 'nodigestsub' tunable which will disable subscription to the digest version of a list (Henne Vogelsang)
mortenp
parents:
603
diff
changeset
|
198 If this file exists, subscription to the digest version of the mailinglist |
614 | 199 will be denied. (Useful if you don't want to allow digests and notify users |
612
ded3bd1059cd
Added 'nodigestsub' tunable which will disable subscription to the digest version of a list (Henne Vogelsang)
mortenp
parents:
603
diff
changeset
|
200 about it). |
616
62743c7b96c0
Added 'nonomailsub' tunable which will disable nomail subscriptions to a list (Henne Vogelsang)
mortenp
parents:
614
diff
changeset
|
201 |
735 | 202 · nonomailsub (boolean) |
616
62743c7b96c0
Added 'nonomailsub' tunable which will disable nomail subscriptions to a list (Henne Vogelsang)
mortenp
parents:
614
diff
changeset
|
203 |
62743c7b96c0
Added 'nonomailsub' tunable which will disable nomail subscriptions to a list (Henne Vogelsang)
mortenp
parents:
614
diff
changeset
|
204 If this file exists, subscription to the nomail version of the mailinglist |
62743c7b96c0
Added 'nonomailsub' tunable which will disable nomail subscriptions to a list (Henne Vogelsang)
mortenp
parents:
614
diff
changeset
|
205 will be denied. (Useful if you don't want to allow nomail and notify users |
62743c7b96c0
Added 'nonomailsub' tunable which will disable nomail subscriptions to a list (Henne Vogelsang)
mortenp
parents:
614
diff
changeset
|
206 about it). |
629
61e93e5c3ecf
Added support for mail size limit (Christoph Wilke)
mortenp
parents:
616
diff
changeset
|
207 |
735 | 208 · maxmailsize (normal) |
629
61e93e5c3ecf
Added support for mail size limit (Christoph Wilke)
mortenp
parents:
616
diff
changeset
|
209 |
61e93e5c3ecf
Added support for mail size limit (Christoph Wilke)
mortenp
parents:
616
diff
changeset
|
210 With this option the maximal allowed size of incoming mails can be specified. |
61e93e5c3ecf
Added support for mail size limit (Christoph Wilke)
mortenp
parents:
616
diff
changeset
|
211 |
735 | 212 · nomaxmailsizedenymails (boolean) |
629
61e93e5c3ecf
Added support for mail size limit (Christoph Wilke)
mortenp
parents:
616
diff
changeset
|
213 |
61e93e5c3ecf
Added support for mail size limit (Christoph Wilke)
mortenp
parents:
616
diff
changeset
|
214 If this is set, no reject notifications caused by violation of maxmailsize |
61e93e5c3ecf
Added support for mail size limit (Christoph Wilke)
mortenp
parents:
616
diff
changeset
|
215 will be sent. |
659 | 216 |
735 | 217 · nolistsubsemail (boolean) |
659 | 218 |
219 If this is set, the LISTNAME+list@ functionality for requesting an | |
220 email with the subscribers for owner is disabled. | |
677
c8e85bb330ed
Added support for static bounce addresses (Thomas Jarosch)
mortenp
parents:
659
diff
changeset
|
221 |
735 | 222 · staticbounceaddr (normal) |
677
c8e85bb330ed
Added support for static bounce addresses (Thomas Jarosch)
mortenp
parents:
659
diff
changeset
|
223 |
c8e85bb330ed
Added support for static bounce addresses (Thomas Jarosch)
mortenp
parents:
659
diff
changeset
|
224 If this is set to something@example.org, the bounce address (Return-Path:) |
c8e85bb330ed
Added support for static bounce addresses (Thomas Jarosch)
mortenp
parents:
659
diff
changeset
|
225 will be fixed to something+listname-bounces-and-so-on@example.org |
c8e85bb330ed
Added support for static bounce addresses (Thomas Jarosch)
mortenp
parents:
659
diff
changeset
|
226 in case you need to disable automatic bounce handling. |
705 | 227 |
735 | 228 · ifmodsendonlymodmoderate (boolean) |
705 | 229 |
230 If this file is present, then mlmmj in case of moderation checks the | |
231 envelope from, to see if the sender is a moderator, and in that case | |
232 only send the moderation mails to that address. In practice this means that | |
714 | 233 a moderator sending mail to the list won't bother all the other moderators |
705 | 234 with his mail. |
714 | 235 |
735 | 236 · footer (text) |
714 | 237 |
238 The content of this file is appended to mail sent to the list. | |
239 | |
735 | 240 · notmetoo (boolean) |
727
4575d3181ca1
Added notmetoo feature where posts are not mirrored to their senders.
Ben Schmidt
parents:
714
diff
changeset
|
241 |
4575d3181ca1
Added notmetoo feature where posts are not mirrored to their senders.
Ben Schmidt
parents:
714
diff
changeset
|
242 If this file is present, mlmmj attempts to exclude the sender of a post |
4575d3181ca1
Added notmetoo feature where posts are not mirrored to their senders.
Ben Schmidt
parents:
714
diff
changeset
|
243 from the distribution list for that post so people don't receive copies |
4575d3181ca1
Added notmetoo feature where posts are not mirrored to their senders.
Ben Schmidt
parents:
714
diff
changeset
|
244 of their own posts. |
4575d3181ca1
Added notmetoo feature where posts are not mirrored to their senders.
Ben Schmidt
parents:
714
diff
changeset
|
245 |