News::Scan::Poster(3pm) User Contributed Perl Documentation News::Scan::Poster(3pm)NAME
News::Scan::Poster - keep track of posters to a newsgroup
SYNOPSIS
use News::Scan::Poster;
my $poster = News::Scan::Poster->new($news_scan_article_obj);
DESCRIPTION
This module provides a class whose objects can be used to keep track of cumulative statistics for posters to a Usenet newsgroup such as
header volume or signature lines.
CONSTRUCTOR
new ( ARTICLE )
"ARTICLE" should be a "News::Scan::Article" object or inherit from the "News::Scan::Article" class.
"new" performs some initialization and returns a "News::Scan::Poster" object.
METHODS
address ( [ ADDRESS ] )
Returns the address of this poster represented as a "Mail::Internet" object.
If present, "ADDRESS" tells the object that the "Mail::Internet" object in "ADDRESS" is its address. idea.
attrib ( [ ATTRIBUTION ] )
Returns some nice attribution for this poster.
If present, "ATTRIBUTION" tells the object how it shall identify itself when asked.
message_ids ( [ MESSAGE-ID ] )
Returns a list of Message-IDs attributed to this poster.
If present, "MESSAGE-ID" is added to this list of this poster's articles.
volume
Returns the volume in bytes of the traffic generated by this poster.
articles
Returns the number of articles attributed to this poster.
posted_to
Returns a hash whose keys are newsgroup names and whose values are the number of times this poster has crossposted to the group of
interest and the corresponding newsgroup.
crossposts
Returns the total number of crossposts this poster has sent through the group of interest.
header_volume
Returns the volume in bytes generated by this poster's headers.
header_lines
Returns the number of header lines generated by this poster.
body_volume
Returns the volume in bytes generated by this poster's message bodies.
body_lines
Returns the number of body lines generated by this poster.
orig_volume
Returns the volume in bytes of original content generated by this poster.
orig_lines
Returns the number of original lines generated by this poster.
sig_volume
Returns the volume in bytes generated by this poster's signatures.
sig_lines
Returns the number of signature lines generated by this poster.
SEE ALSO
News::Scan, Mail::Address, News::Scan::Article
AUTHOR
Greg Bacon <gbacon@cs.uah.edu>
COPYRIGHT
Copyright (c) 1997 Greg Bacon. All Rights Reserved. This library is free software. You may distribute and/or modify it under the same
terms as Perl itself.
perl v5.10.1 2000-04-13 News::Scan::Poster(3pm)
Check Out this Related 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)