view release on metacpan or  search on metacpan

lib/BuzzSaw/Filter/UserClassifier.pm  view on Meta::CPAN

C<user_is_root> or C<user_is_real>. This module will not affect
whether (or not) the entry is stored into the database. This module is
designed to be used at the end of the filter stack so that it can
process the results of all filters which might set a value for the
C<userid> attribute.

The BuzzSaw project provides a suite of tools for processing log file
entries. Entries in files are parsed and filtered into a set of events
of interest which are stored in a database. A report generation
framework is also available which makes it easy to generate regular
reports regarding the events discovered.

=head1 ATTRIBUTES

=over

=item name

The short name of the module. The default is to use the final part of
the Perl module name lower-cased (e.g. the name of
C<BuzzSaw::Filter::UserClassifier> is C<userclassifier>).

=back

=head1 SUBROUTINES/METHODS

=over

=item ( $accept, @tags ) = $filter->check(\%event,$votes)

This method checks to see if any previous filter in the stack has
requested that the log entry be stored (the C<$votes> counter). If an
entry of interest has a value set for the C<userid> attribute then
this module will classify the type of username (root, nonperson, real,
others) using the L<BuzzSaw::UserClassifier> module. This module will
return a tag with a C<user_is_> prefix, like C<user_is_root> or
C<user_is_real>. This module will not affect whether (or not) the
entry is stored into the database. This module is designed to be used
at the end of the filter stack so that it can process the results of
all filters which might set a value for the C<userid> attribute.

=back

=head1 DEPENDENCIES

This module is powered by L<Moose>. This module implements the
L<BuzzSaw::Filter> Moose role.

=head1 SEE ALSO

L<BuzzSaw>, L<BuzzSaw::Parser>

=head1 PLATFORMS

This is the list of platforms on which we have tested this
software. We expect this software to work on any Unix-like platform
which is supported by Perl.

ScientificLinux6

=head1 BUGS AND LIMITATIONS

Please report any bugs or problems (or praise!) to bugs@lcfg.org,
feedback and patches are also always very welcome.

=head1 AUTHOR

    Stephen Quinney <squinney@inf.ed.ac.uk>

=head1 LICENSE AND COPYRIGHT

    Copyright (C) 2013 University of Edinburgh. All rights reserved.

This library is free software; you can redistribute it and/or modify
it under the terms of the GPL, version 2 or later.

=cut