NAME
    Log::Log4perl::Filter::CallerMatch - Filter Log4perl messages based on
    call frames

VERSION
    version 1.200

DESCRIPTION
    This Log4perl custom filter checks the call stack using caller() and
    filters the subroutine and package using user-provided regular
    expressions. You can specify a specific call frame to test against, or
    have the filter iterate through a range of call frames.

ATTRIBUTES
  StringToMatch
    A perl5 regular expression, matched against the log message.

  AcceptOnMatch
    Defines if the filter is supposed to pass or block the message on a
    match ("true" or "false").

  PackageToMatch
    A perl5 regular expression, matched against the 1st item in the array
    returned by caller() (e.g. "package")

  SubToMatch
    A perl5 regular expression, matched against the 4th item in the array
    returned by caller() (e.g. "subroutine")

  CallFrame
    The call frame to use when requesting information from caller(). (e.g.
    $i in caller($i)

  MinCallFrame
    The first call frame tested against when iterating through a series of
    call frames. Ignored if CallFrame specified.

  MaxCallFrame
    The last call frame tested against when iterating through a series of
    call frames. Ignored if CallFrame specified.

METHODS
  new
    Constructor. Refer to Log::Log4perl::Filter for more information

  ok
    Decides whether log message should be accepted or not. Refer to
    Log::Log4perl::Filter for more information

USAGE
     # log.conf
     log4perl.logger = ALL, A1
     log4perl.appender.A1        = Log::Log4perl::Appender::TestBuffer
     log4perl.appender.A1.Filter = MyFilter
     log4perl.appender.A1.layout = Log::Log4perl::Layout::SimpleLayout

     log4perl.filter.MyFilter                = Log::Log4perl::Filter::CallerMatch
     log4perl.filter.MyFilter.SubToMatch     = WebGUI::Session::ErrorHandler
     log4perl.filter.MyFilter.PackageToMatch = Flux::
     log4perl.filter.MyFilter.StringToMatch  = Operand1

SEE ALSO
    Log::Log4perl::Filter, Log::Log4perl::Filter::StringMatch,
    Log::Log4perl::Filter::LevelMatch, Log::Log4perl::Filter::LevelRange,
    Log::Log4perl::Filter::Boolean

AUTHOR
    Patrick Donelan <pdonelan@cpan.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2010 by Patrick Donelan.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.

