/usr/share/perl5/Test/Valgrind/Parser.pm is in libtest-valgrind-perl 1.18-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 | package Test::Valgrind::Parser;
use strict;
use warnings;
=head1 NAME
Test::Valgrind::Parser - Base class for Test::Valgrind parsers.
=head1 VERSION
Version 1.18
=cut
our $VERSION = '1.18';
=head1 DESCRIPTION
This class is the base for L<Test::Valgrind> parsers.
=cut
use base qw<Test::Valgrind::Component Test::Valgrind::Carp>;
=head1 METHODS
=head2 C<new>
my $tvp = Test::Valgrind::Parser->new;
The parser constructor, called without arguments.
Defaults to L<Test::Valgrind::Component/new>.
=head2 C<start>
$tvp->start($session);
Called when the C<$session> starts.
Defaults to set L<Test::Valgrind::Component/started>.
=head2 C<args>
my @args = $tvp->args($session, $fh);
Returns the list of parser-specific arguments that are to be passed to the C<valgrind> process spawned by the session C<$session> and whose output will be captured by the filehandle C<$fh>.
Defaults to the empty list.
=cut
sub args { }
=head2 C<parse>
my $aborted = $tvp->parse($session, $fh);
Parses the output of the C<valgrind> process attached to the session C<$session> received through the filehandle C<$fh>.
Returns true when the output indicates that C<valgrind> has aborted.
This method must be implemented when subclassing.
=cut
sub parse;
=head2 C<finish>
$tvp->finish($session);
Called when the C<$session> finishes.
Defaults to clear L<Test::Valgrind::Component/started>.
=head1 SEE ALSO
L<Test::Valgrind>, L<Test::Valgrind::Component>, L<Test::Valgrind::Session>.
=head1 AUTHOR
Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.
You can contact me by mail or on C<irc.perl.org> (vincent).
=head1 BUGS
Please report any bugs or feature requests to C<bug-test-valgrind at rt.cpan.org>, or through the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Valgrind>.
I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
=head1 SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Test::Valgrind::Parser
=head1 COPYRIGHT & LICENSE
Copyright 2009,2010,2011,2013,2015 Vincent Pit, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
=cut
1; # End of Test::Valgrind::Parser
|