1PERL-NOCEM(8)             InterNetNews Documentation             PERL-NOCEM(8)
2
3
4

NAME

6       perl-nocem - A NoCeM-on-spool implementation for INN 2.x
7

SYNOPSIS

9       perl-nocem
10

DESCRIPTION

12       NoCeM, which is pronounced No See 'Em, is a protocol enabling
13       authenticated third-parties to issue notices which can be used to
14       cancel unwanted articles (like spam and articles in moderated
15       newsgroups which were not approved by their moderators).  It can also
16       be used by readers as a third-party killfile.  It is intended to
17       eventually replace the protocol for third-party cancel messages.
18
19       perl-nocem processes third-party, PGP-signed article cancellation
20       notices.  It is possible not to honour all NoCeM notices but only those
21       which are sent by people whom you trust (that is to say if you trust
22       the PGP key they use to sign their NoCeM notices).  Indeed, it is up to
23       you to decide whether you wish to honour their notices, depending on
24       the criteria they use.
25
26       Processing NoCeM notices is easy to set up:
27
28       1.  Import the keys of the NoCeM issuers you trust in order to check
29           the authenticity of their notices.  You can do:
30
31               gpg --no-default-keyring --primary-keyring <pathetc>/pgp/ncmring.gpg --import <key-file>
32               chmod 644 <pathetc>/pgp/ncmring.gpg
33
34           where <pathetc> is the value of the pathetc parameter set in
35           inn.conf and <key-file> the file containing the key(s) to import.
36           The keyring must be located in <pathetc>/pgp/ncmring.gpg; you only
37           have to create the directory <pathetc>/pgp before using gpg (it
38           will automatically generate the ncmring.gpg file) and make sure the
39           news user can read this file, once generated.
40
41           For old PGP-generated keys, you may have to use
42           --allow-non-selfsigned-uid if they are not properly self-signed,
43           but anyone creating a key really should self-sign the key.  Current
44           PGP implementations do this automatically.
45
46           The keys of NoCeM issuers can be found in the web site of The NoCeM
47           Registry: <http://rosalind.home.xs4all.nl/nocemreg/nocemreg.html>.
48           You can even download there a unique file which contains all the
49           keys.
50
51       2.  Create a nocem.ctl config file in pathetc indicating the NoCeM
52           issuers and notices you want to follow.  This permission file
53           contains lines like:
54
55               bleachbot@httrack.com:spam,site
56               pgpmoose@killfile.org:pgpmoose-forged-moderation
57
58           This will remove all articles for which the issuer (first part of
59           the line, before the colon ":") has issued NoCeM notices
60           corresponding to the criteria specified after the colon.
61
62           You will also find information about that on the web site of The
63           NoCeM Registry.
64
65       3.  Add to the newsfeeds file an entry like this one in order to feed
66           perl-nocem the NoCeM notices posted to alt.nocem.misc and
67           news.lists.filters:
68
69               nocem!\
70                   :!*,alt.nocem.misc,news.lists.filters\
71                   :Tc,Wf,Ap:<pathbin>/perl-nocem
72
73           with the correct path to perl-nocem, located in <pathbin>.  Then,
74           reload the newsfeeds file ("ctlinnd reload newsfeeds 'NoCeM channel
75           feed'").
76
77           Note that you should at least carry news.lists.filters on your news
78           server (or other newsgroups where NoCeM notices are sent) if you
79           wish to process them.
80
81       4.  Everything should now work.  However, do not hesitate to manually
82           test perl-nocem with a NoCeM notice, using:
83
84               grephistory '<Message-ID>' | perl-nocem
85
86           Indeed, perl-nocem expects tokens on its standard input, and
87           grephistory can easily give it the token of a known article, thanks
88           to its Message-ID.
89
90       When you have verified that everything works, you can eventually turn
91       off regular spam cancels, if you want, not processing any longer
92       cancels containing "cyberspam" in the Path: header (see the
93       refusecybercancels parameter in inn.conf).
94

FILES

96       pathbin/perl-nocem
97           The Perl script itself used to process NoCeM notices.
98
99       pathetc/nocem.ctl
100           The configuration file which specifies the NoCeM notices to be
101           processed.
102
103       pathetc/pgp/ncmring.gpg
104           The keyring which contains the public keys of trusted NoCeM
105           issuers.
106

BUGS

108       The Subject: header is not checked for the @@NCM string and there is no
109       check for the presence of the References: header.
110
111       The Newsgroups: pseudo header is not checked, but this can be done in
112       local_want_cancel_id().
113
114       The Hierarchies: header is ignored.
115

HISTORY

117       Copyright 2000 by Miquel van Smoorenburg <miquels@cistron.nl>.
118
119       Copyright 2001 by Marco d'Itri <md@linux.it>.
120
121       $Id: perl-nocem.in 10245 2018-02-16 21:11:59Z iulius $
122

SEE ALSO

124       gpg(1), gpgv(1), grephistory(1), inn.conf(5), newsfeeds(5), pgp(1).
125
126
127
128INN 2.6.3                         2018-03-18                     PERL-NOCEM(8)