news::article::nocem(3pm) [debian man page]

NoCeM(3pm)						User Contributed Perl Documentation						NoCeM(3pm)

NAME

       News::Article::NoCeM - a module to generate accurate nocem notices

SYNOPSIS

	 use News::Article::NoCeM;
	 my $nocem = new News::Article::NoCeM();

	 $nocem->hide($type, $spam);
	 $nocem->make_notice($type, $name, $issuer, $group, $prefix);
	 $nocem->sign($keyid, $passphrase);
	 $nocem->issue($conn, $ihave);

DESCRIPTION

       Creates a nocem notice on the Usenet articles, which may be posted normally to hide the messages.

USAGE

       use News::Article::NoCeM;

       News::Article::NoCeM is class that inherits News::Article and adds four new functions: hide(), make_notice(), sign() and issue(), redefine
       to disable two functions: post() and ihave().

   Article Methods
       hide ( TYPE, ARTICLE, [ARTICLE, ...] )
	   Hide one or more articles in the given "TYPE".  "ARTICLE" is an News::Article object that going to be hid. hide() will skip the
	   articles without Newsgroup or Message-ID and skip the ones already hid.

	   hide() returns the number of the articles hid.

       post
       ihave
	   post() and ihave() is disabled in News::Article::NoCeM.  Please use issue() instead.

       make_notice ( TYPE, NAME, GROUP, ISSUER, [ PREFIX ] )
	   Retrive articles marked by hide with "TYPE", and make a notice fot them. If there's only one type within a container, then the
	   container itself can be a notice. "NAME" is the identifier of the issuer. "GROUP" is the newsgroup the you will post nocem notice to.
	   "ISSUER" is the email address of the issuer. "PREFIX" is the announcement before the nocem notice, which may explain the criteria of
	   this notice, or where to find your public key for PGP verification.

	   make_notice() returns a News::Article::NoCeM object if success, and return undef if no article is hid.

       sign ( KEYID, PASSPHRASE )
	   Sign the content of the nocem notice with "KEYID" and "PASSPHRASE".	Please make sure that the issuer's public/secret keyring is ready.

	   sign() returns a News::Article::NoCeM object if success, and return undef if no article is hid, or pgp_sign failed.

       issue ( [ CONN, IHAVE ] )
	   Take optional "CONN" as a Net::NNTP object and issue the nocem notice.  "IHAVE" indicates that call Net::NNTP::ihave() for submitting
	   the notice, otherwise issue() will call News::Article::post() by default.

	   issue() return the result of News::Article::post() or issue().

NOTES

       Standard article manipulation information can be read in the News::Article manpages.

       NoCeM FAQ is available on the web at <URL:http://www.cm.org/faq.html>.

AUTHOR

       Written by Yen-Ming Lee <leeym@leeym.com>, based on a module by Tim Skirvin <tskirvin@killfile.org>.

COPYRIGHT

       Copyright 2004-2005 by Yen-Ming Lee <leeym@leeym.com>.  This code may be redistributed under the same terms as Perl itself.

perl v5.12.4							    2006-06-23								NoCeM(3pm)

PERL-NOCEM(8)						    InterNetNews Documentation						     PERL-NOCEM(8)

NAME

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

SYNOPSIS

       perl-nocem

DESCRIPTION

       NoCeM, which is pronounced 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 third-party killfile.  It is intended to eventually replace the protocol for third-party cancel messages.

       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.

       Processing NoCeM notices is easy to set up:

       1.  Import the keys of the NoCeM issuers you trust in order to check the authenticity of their notices.	You can do:

	       gpg --no-default-keyring --primary-keyring <pathetc>/pgp/ncmring.gpg --import <key-file>

	   where <pathetc> is the value of the pathetc parameter set in inn.conf and <key-file> the file containing the key(s) to import.  The
	   keyring must be located in <pathetc>/pgp/ncmring.gpg; you only have to create the directory <pathetc>/pgp before using gpg (it will
	   automatically generate the ncmring.gpg file).  For old PGP-generated keys, you may have to use --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 keys of NoCeM issuers can be found in the web site of The NoCeM Registry: <http://www.xs4all.nl/~rosalind/nocemreg/nocemreg.html>.
	   You can even download there a unique file which contains all the keys.

       2.  Create a nocem.ctl config file in pathetc indicating the NoCeM issuers and notices you want to follow.  This permission file contains
	   lines like:

	       bleachbot@httrack.com:spam,site
	       pgpmoose@killfile.org:pgpmoose-forged-moderation

	   This will remove all articles for which the issuer (first part of the line, before the colon ":") has issued NoCeM notices
	   corresponding to the criteria specified after the colon.

	   You will also find information about that on the web site of The NoCeM Registry.

       3.  Add to the newsfeeds file an entry like this one in order to feed perl-nocem the NoCeM notices posted to alt.nocem.misc and
	   news.lists.filters:

	       nocem!
		   :!*,alt.nocem.misc,news.lists.filters
		   :Tc,Wf,Ap:<pathbin>/perl-nocem

	   with the correct path to perl-nocem, located in <pathbin>.  Then, reload the newsfeeds file ("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.

       4.  Everything should now work.	However, do not hesitate to manually test perl-nocem with a NoCeM notice, using:

	       grephistory '<Message-ID>' | perl-nocem

	   Indeed, perl-nocem expects tokens on its standard input, and grephistory can easily give it the token of a known article, thanks to its
	   Message-ID.

       When you have verified that everything works, you can eventually turn off regular spam cancels, if you want, not processing any longer
       cancels containing "cyberspam" in the Path: header (see the refusecybercancels parameter in inn.conf).

FILES

       pathbin/perl-nocem
	   The Perl script itself used to process NoCeM notices.

       pathetc/nocem.ctl
	   The configuration file which specifies the NoCeM notices to be processed.

       pathetc/pgp/ncmring.gpg
	   The keyring which contains the public keys of trusted NoCeM issuers.

BUGS

       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 local_want_cancel_id().

       The Hierarchies: header is ignored.

HISTORY

       Copyright 2000 by Miquel van Smoorenburg <miquels@cistron.nl>.

       Copyright 2001 by Marco d'Itri <md@linux.it>.

       $Id: perl-nocem.in 8539 2009-06-28 10:01:24Z iulius $

SEE ALSO

       gpgv(1), grephistory(1), inn.conf(5), newsfeeds(5), pgp(1).

INN 2.5.2							    2009-08-16							     PERL-NOCEM(8)