1IPC::Run3::ProfReporterU(s3e)r Contributed Perl DocumentaItPiCo:n:Run3::ProfReporter(3)
2
3
4

NAME

6       IPC::Run3::ProfReporter - base class for handling profiling data
7

SYNOPSIS

DESCRIPTION

10       See IPC::Run3::ProfPP and for an example subclass.
11
12       This class just notes and accumulates times; subclasses use methods
13       like "handle_app_call", "handle_run_exit" and "handle_app_exit" to emit
14       reports on it.  The default methods for these handlers are noops.
15
16       If run from the command line, a reporter will be created and run on
17       each logfile given as a command line parameter or on run3.out if none
18       are given.
19
20       This allows reports to be run like:
21
22           perl -MIPC::Run3::ProfPP -e1
23           perl -MIPC::Run3::ProfPP -e1 foo.out bar.out
24
25       Use "-" to read from STDIN (the log file format is meant to be
26       moderately greppable):
27
28           grep "^cvs " run3.out perl -MIPC::Run3::ProfPP -e1 -
29
30       Use --app to show only application level statistics (ie don't emit a
31       report section for each command run).
32

METHODS

34       "IPC::Run3::ProfReporter->new"
35           Returns a new profile reporting object.
36
37       "$reporter->handle_app_call( ... )"
38       "$reporter->handle_app_exit( ... )"
39       "$reporter->handle_run_exit( ... )"
40           These methods are called by the handled events (see below).
41
42       "$reporter->app_call(\@cmd, $time)"
43       "$reporter->app_exit($time)"
44       "$reporter->run_exit(@times)"
45              $self->app_call( $time );
46              my $time = $self->get_app_call_time;
47
48           Sets the time (in floating point seconds) when the application,
49           run3(), or system() was called or exited.  If no time parameter is
50           passed, uses IPC::Run3's time routine.
51
52           Use get_...() to retrieve these values (and _accum values, too).
53           This is a separate method to speed the execution time of the
54           setters just a bit.
55
56       "$reporter->get_run_count()"
57       "$reporter->get_app_call_time()"
58       "$reporter->get_app_exit_time()"
59       "$reporter->get_app_cmd()"
60       "$reporter->get_app_time()"
61       "$reporter->get_app_cumulative_time()"
62       "$reporter->get_run_call_time()"
63       "$reporter->get_run_exit_time()"
64       "$reporter->get_run_time()"
65       "$reporter->get_run_cumulative_time()"
66       "$reporter->get_sys_call_time()"
67       "$reporter->get_sys_exit_time()"
68       "$reporter->get_sys_time()"
69       "$reporter->get_sys_cumulative_time()"
70       "$reporter->get_run_cmd()"
71

LIMITATIONS

74           Copyright 2003, R. Barrie Slaymaker, Jr., All Rights Reserved
75

LICENSE

77       You may use this module under the terms of the BSD, Artistic, or GPL
78       licenses, any version.
79

AUTHOR

81       Barrie Slaymaker <barries@slaysys.com>
82
83
84
85perl v5.30.1                      2020-01-30        IPC::Run3::ProfReporter(3)
Impressum