Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NoCeM(3)	      User Contributed Perl Documentation	      NoCeM(3)

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.24.1			  2006-06-23			      NoCeM(3)

NAME | SYNOPSIS | DESCRIPTION | USAGE | NOTES | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=News::Article::NoCeM&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help