INN commit: trunk (control/perl-nocem.in samples/newsfeeds.in)
INN Commit
Russ_Allbery at isc.org
Sun Aug 5 07:52:39 UTC 2007
Date: Sunday, August 5, 2007 @ 00:52:38
Author: iulius
Revision: 7631
Improve POD documentation for perl-nocem(8).
Add a sample entry in newsfeeds for the NoCeM channel feed.
(Also fix @bindir@ for controlchan in newsfeeds.)
Modified:
trunk/control/perl-nocem.in
trunk/samples/newsfeeds.in
-----------------------+
control/perl-nocem.in | 109 +++++++++++++++++++++++++++++++++++++++++-------
samples/newsfeeds.in | 16 ++++---
2 files changed, 105 insertions(+), 20 deletions(-)
Modified: control/perl-nocem.in
===================================================================
--- control/perl-nocem.in 2007-08-04 17:24:40 UTC (rev 7630)
+++ control/perl-nocem.in 2007-08-05 07:52:38 UTC (rev 7631)
@@ -6,6 +6,14 @@
# Copyright 2000 by Miquel van Smoorenburg <miquels at cistron.nl>
# Copyright 2001 by Marco d'Itri <md at linux.it>
# This program is licensed under the terms of the GNU General Public License.
+#
+# List of changes:
+#
+# 2002: Patch by Steven M. Christey for untrusted printf input.
+# 2007: Patch by Christoph Biedl for checking a timeout.
+# Documentation improved by Jeffrey M. Vinocur (2002), Russ Allbery (2006)
+# and Julien Elie (2007).
+#
##############################################################################
require 5.00403;
@@ -486,42 +494,113 @@
=head1 DESCRIPTION
-Add to the newsfeeds file an entry like this one:
+NoCeM, which is pronounced I<No See 'Em>, is a protocol enabling
+authenticated third-parties to issue notices which can be used
+to cancel unwanted articles (like spam and articles in moderated
+newsgroups which were not approved by their moderators). It can
+also be used by readers as a I<third-party killfile>. It is
+intended to eventually replace the protocol for third-party cancel
+messages.
- nocem:!*,alt.nocem.misc,news.lists.filter\
- :Tc,Wf,Ap:/usr/local/news/bin/perl-nocem
+B<perl-nocem> processes third-party, PGP-signed article cancellation
+notices. It is possible not to honour all NoCeM notices but only those
+which are sent by people whom you trust (that is to say if you trust
+the PGP key they use to sign their NoCeM notices). Indeed, it is up
+to you to decide whether you wish to honour their notices, depending
+on the criteria they use.
-Import new keys with:
+Processing NoCeM notices is easy to set up:
+=over 4
+
+=item 1.
+
+Import the keys of the NoCeM issuers you trust in order to check
+the authenticity of their notices. You can do:
+
gpg --primary-keyring /usr/local/news/etc/pgp/ncmring.gpg --import
<key-file>
-where <key-file> is the file containing the key. For old PGP-generated
-keys, you may have to use B<--allow-non-selfsigned-uid> if they're not
-properly self-signed, but anyone creating a key really should self-sign
-the key. Current PGP implementations do this automatically.
+where <key-file> is the file containing the key(s) to import. The keyring
+must be located in I<pathetc>/pgp/ncmring.gpg (create the directory
+before using B<gpg>). For old PGP-generated keys, you may have to use
+B<--allow-non-selfsigned-uid> if they are not properly self-signed,
+but anyone creating a key really should self-sign the key. Current
+PGP implementations do this automatically.
-The nocem.ctl config file contains lines like:
+The keys of NoCeM issuers can be found in the web site of I<The NoCem Registry>:
+L<http://www.xs4all.nl/~rosalind/nocemreg/nocemreg.html>. You can even
+download there a unique file which contains all the keys.
- annihilator-1 at erlenstar.demon.co.uk:*
- clewis at ferret:mmf,spam
+=item 2.
+Create a F<nocem.ctl> config file in I<pathetc> indicating the NoCeM issuers
+and notices you want to follow. This permission file contains lines like:
+
+ annihilator-1:*
+ clewis at ferret.ocunix:mmf
+ stephane at asynchrone:mmf,openproxy,spam
+
+This will remove all articles for which the issuer (first part of the line,
+before the colon C<:>) has issued NoCeM notices corresponding to the
+criteria specified after the colon.
+
+You will also find information about that on the web site of
+I<The NoCem Registry>.
+
+=item 3.
+
+Add to the F<newsfeeds> file an entry like this one in order to feed
+B<perl-nocem> the NoCeM notices posted to alt.nocem.misc and
+news.lists.filter:
+
+ nocem!:!*,alt.nocem.misc,news.lists.filter\
+ :Tc,Wf,Ap:/usr/local/news/bin/perl-nocem
+
+with the correct path to B<perl-nocem>, located in I<pathbin>. Then, reload
+the F<newsfeeds> file (C<ctlinnd reload newsfeeds 'NoCeM channel feed'>).
+
+Note that you should at least carry news.lists.filters on your news
+server or other newsgroups where NoCeM notices are sent if you wish
+to process them.
+
+=item 4.
+
+Everything should now work. However, do not hesitate to manually test
+B<perl-nocem> with a NoCeM notice, using:
+
+ perl-nocem < /path/to/a/notice
+
+When you have verified that everything works, you can eventually turn
+off regular spam cancels, if you want, not processing any longer
+cancels containing C<cyberspam> in the Path: header.
+
+=back
+
=head1 FILES
/usr/local/news/etc/nocem.ctl
=head1 BUGS
-The Subject header is not checked for the @@NCM string and there is no
-check for the presence of the References header.
+The Subject: header is not checked for the @@NCM string and there is no
+check for the presence of the References: header.
-The Newsgroups pseudo header is not checked, but this can be done in
+The Newsgroups: pseudo header is not checked, but this can be done in
local_want_cancel_id().
-The Hierarchies header is ignored.
+The Hierarchies: header is ignored.
=head1 HISTORY
Copyright 2000 by Miquel van Smoorenburg <miquels at cistron.nl>.
Copyright 2001 by Marco d'Itri <md at linux.it>.
+
+$Id$
+
+=head1 SEE ALSO
+
+gpgv(1), newsfeeds(5), pgp(1).
+
+=cut
Modified: samples/newsfeeds.in
===================================================================
--- samples/newsfeeds.in 2007-08-04 17:24:40 UTC (rev 7630)
+++ samples/newsfeeds.in 2007-08-05 07:52:38 UTC (rev 7631)
@@ -51,7 +51,7 @@
# no longer handles any control messages except cancel internally.
controlchan!\
:!*,control,control.*,!control.cancel\
- :Tc,Wnsm:@prefix@/bin/controlchan
+ :Tc,Wnsm:@bindir@/controlchan
## Uncomment if you're using innfeed. This feed tells INN how to run
## innfeed, and then every site you're feeding with innfeed has a
@@ -102,7 +102,7 @@
## OUTGOING SPECIAL FEED EXAMPLES
-# Accumulate Path header statistics. See ninpaths(8) for more details on
+# Accumulate Path: header statistics. See ninpaths(8) for more details on
# how to set this up.
#inpaths!:*:Tc,WP:@bindir@/ninpaths -p -d @LOGDIR@/path/inpaths.%d
@@ -110,6 +110,12 @@
#source-archive!:!*,*sources*,!*wanted*,!*.d\
# :Tc,Wn:@bindir@/archive -f -i @SPOOLDIR@/archive/INDEX
+# Feed NoCeM notices to perl-nocem in order to process third-party,
+# PGP-signed article cancellation notices. See perl-nocem(8) for more
+# details on how to set this up.
+#nocem!:!*,alt.nocem.misc,news.lists.filter\
+# :Tc,Wf,Ap:@bindir@/perl-nocem
+
# News to mail gateway. Similar to innfeed, this uses a master feed and
# then individual feeds for every separate address that news is being
# gated to. This sends all posts to rec.pets.redants.* to the address
@@ -118,8 +124,8 @@
#news-software at example.com:rec.pets.redants.*:Tm:news2mail!
# Capture all local postings (with a distribution of "foo" and no more
-# than two sites in the Path) using a local program (that doesn't come with
-# INN).
-#capture\
+# than two sites in the Path: header) using a local program (that doesn't
+# come with INN).
+#capture!\
# :*/foo\
# :Tp,H2:/usr/local/bin/capture %s
More information about the inn-committers
mailing list