annotate noffle.conf.example @ 500:614a3177b15c noffle tip

Add mail-from option. Some modern mail systems will try and ensure the sender email is a legitimate address. Which will fail if there isn't such an address.
author Jim Hague <jim.hague@acm.org>
date Wed, 14 Aug 2013 12:04:39 +0100
parents b0ee77fa24d4
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
1 ###############################################################################
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
2 #
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
3 # NOFFLE news server config file
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
4 #
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
5 ###############################################################################
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
6
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
7 # Remote news server. Format: <hostname>[:<port>] [<user> <pass>]
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
8 # (<user> and <pass> only for servers with authentication,
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
9 # the password may not contain white-spaces)
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
10
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
11 server news
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
12
89
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
13 # Don't get *.binaries.* from server 'news'
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
14 #omitgroups *.binaries.*
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
15
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
16 # Second server
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
17 # server bins
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
18 #
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
19 # Only get binaries groups from server 'bins'
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
20 # getgroups *.binaries.*
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
21
500
614a3177b15c Add mail-from option.
Jim Hague <jim.hague@acm.org>
parents: 357
diff changeset
22 # Email notifications of failed postings to this address.
614a3177b15c Add mail-from option.
Jim Hague <jim.hague@acm.org>
parents: 357
diff changeset
23 # Leave blank to have address extracted from the posted article.
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
24 #mail-to root
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
25
500
614a3177b15c Add mail-from option.
Jim Hague <jim.hague@acm.org>
parents: 357
diff changeset
26 # From address for emailed notifications of failed postings.
614a3177b15c Add mail-from option.
Jim Hague <jim.hague@acm.org>
parents: 357
diff changeset
27 #mail-from news@example.com
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
28
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
29 # Never get more than <max-fetch> articles. Discard oldest, if there are more
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
30
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
31 max-fetch 300
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
32
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
33
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
34 # Automatically remove groups from fetch list if they have not been
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
35 # accessed for <n> days.
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
36
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
37 auto-unsubscribe no
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
38 #auto-unsubscribe-days 30
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
39
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
40
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
41 # Parameter for thread mode. Retrieve articles, if they are referencing an
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
42 # article that has been read within the last <n> days
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
43
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
44 thread-follow-time 7
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
45
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
46
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
47 # Timeout for connecting to remote server in seconds.
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
48
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
49 connect-timeout 30
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
50
185
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents: 134
diff changeset
51 # Log all protocol traffic
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents: 134
diff changeset
52 #log-debug protocol
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
53
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
54 # Automatically put groups on fetchlist, if someone accesses them.
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
55 # Mode can be: full, thread, over
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
56
107
2869baa02f3c [svn] Auto subscribe mode by group
bears
parents: 89
diff changeset
57 auto-subscribe yes
2869baa02f3c [svn] Auto subscribe mode by group
bears
parents: 89
diff changeset
58 default-auto-subscribe-mode full
2869baa02f3c [svn] Auto subscribe mode by group
bears
parents: 89
diff changeset
59 #auto-subscribe-mode *.binaries.* over
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
60
195
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
61 # Replace Message-ID in posted articles. If you are in a local domain,
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
62 # ask your news provider for a domain name for generating Message-IDs.
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
63 # If the hostname option is unused, it is replaced by the fully qualified
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
64 # domain name of your system.
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
65
222
bf290632d29e [svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents: 195
diff changeset
66 replace-messageid no
195
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
67 #hostname UserId-XXXXX_newsserver
249
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
68 #hostname %user@domain.tld
38
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
69
357
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5,
bears
parents: 249
diff changeset
70 # Append a "Reply-To" header with the address mentioned in the "From" header.
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5,
bears
parents: 249
diff changeset
71 # gererally a good idea
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5,
bears
parents: 249
diff changeset
72 append-reply-to yes
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5,
bears
parents: 249
diff changeset
73
89
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
74 # Post articles to remote groups into the local database immediately
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
75 # on receipt of article.
222
bf290632d29e [svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents: 195
diff changeset
76 #post-locally no
89
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
77
38
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
78 # Set the default expire period in days
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
79 default-expire 14
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
80
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
81 # Expire all alt.* groups after 2 days, except for alt.oxford.*
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
82 # expire after 4 days and alt.oxford.talk never expire.
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
83 #expire alt.oxford.talk 0
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
84 #expire alt.oxford.* 4
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
85 #expire alt.* 2
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
86
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
87 # Appearing here, this is equivalent to 'default-expire 20' above. If it
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
88 # appeared before the other expire lines, all groups would be
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
89 # expired at 20 days, as it would be the first custom match
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
90 # for every group.
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
91 #expire * 20
131
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
92
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
93 # Sample article filtering.
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
94 # 1. Silently dump without fetching any article with a title
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
95 # looking like '$$$ Make Money Now $$$'.
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
96 # 2. Fetch articles cross-posted to more than 3 groups where one of the
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
97 # groups is alt.flame in overview mode only.
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
98 # 3. Fetch all articles > 20k in size in overview mode only.
249
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
99 # 4. Fetch all articles older than 9.5 weeks in overview mode only.
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
100 # 5. Fetch all articles referencing your or other NOFFLE users'
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
101 # articles in full mode. Works only with 'replace-messageid yes'.
131
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
102
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
103 #filter subject="\$+.*Make.*Money.*Now.*\$\$\$" action=discard
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
104 #filter xposts>3 group=alt.flame action=over
134
7dfbb1c20a81 [svn] k and m suffices on filter numbers
bears
parents: 131
diff changeset
105 #filter bytes>20k action=over
249
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
106 #filter date<lastupdate-66.5 action=over
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
107 #filter reference="NOFFLE" action=full