{"id":7446,"date":"2022-12-20T19:38:08","date_gmt":"2022-12-20T22:38:08","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/ipcrun3profreporter-man3\/"},"modified":"2022-12-20T19:38:08","modified_gmt":"2022-12-20T22:38:08","slug":"ipcrun3profreporter-man3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/ipcrun3profreporter-man3\/","title":{"rendered":"IPC::Run3::ProfReporter (man3)"},"content":{"rendered":"

IPC::Run3::ProfReporter<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
METHODS<\/a>
LIMITATIONS<\/a>
COPYRIGHT<\/a>
LICENSE<\/a>
AUTHOR<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

IPC::Run3::ProfReporter \u2212 base class for handling profiling data<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

DESCRIPTION <\/a> <\/h2>\n

See IPC::Run3::ProfPP and for an example subclass.<\/p>\n

This class just notes and accumulates times; subclasses use methods like “handle_app_call”, “handle_run_exit” and “handle_app_exit” to emit reports on it. The default methods for these handlers are noops.<\/p>\n

If run from the command line, a reporter will be created and run on each logfile given as a command line parameter or on run3.out if none are given.<\/p>\n

This allows reports to be run like:<\/p>\n

perl \u2212MIPC::Run3::ProfPP \u2212e1
perl \u2212MIPC::Run3::ProfPP \u2212e1 foo.out bar.out<\/p>\n

Use “\u2212” to read from STDIN<\/small> (the log file format is meant to be moderately greppable):<\/p>\n

grep “^cvs ” run3.out perl \u2212MIPC::Run3::ProfPP \u2212e1 \u2212<\/p>\n

Use \u2212\u2212app to show only application level statistics (ie don\u2019t emit a report section for each command run).<\/p>\n

METHODS <\/a> <\/h2>\n

“IPC::Run3::ProfReporter\u2212>new”<\/p>\n

Returns a new profile reporting object.<\/p>\n

“$reporter\u2212>handle_app_call( … )”
“$reporter\u2212>handle_app_exit( … )”
“$reporter\u2212>handle_run_exit( … )”<\/p>\n

These methods are called by the handled events (see below).<\/p>\n

“$reporter\u2212>app_call(@cmd, $time)”
“$reporter\u2212>app_exit($time)”
“$reporter\u2212>run_exit(@times)”<\/p>\n

$self\u2212>app_call( $time );
my $time = $self\u2212>get_app_call_time;<\/p>\n

Sets the time (in floating point seconds) when the application, run3()<\/b>, or system()<\/b> was called or exited. If no time parameter is passed, uses IPC::Run3\u2019s time routine.<\/p>\n

Use get_…() to retrieve these values (and _accum values, too). This is a separate method to speed the execution time of the setters just a bit.<\/p>\n

“$reporter\u2212>get_run_count()”
“$reporter\u2212>get_app_call_time()”
“$reporter\u2212>get_app_exit_time()”
“$reporter\u2212>get_app_cmd()”
“$reporter\u2212>get_app_time()”
“$reporter\u2212>get_app_cumulative_time()”
“$reporter\u2212>get_run_call_time()”
“$reporter\u2212>get_run_exit_time()”
“$reporter\u2212>get_run_time()”
“$reporter\u2212>get_run_cumulative_time()”
“$reporter\u2212>get_sys_call_time()”
“$reporter\u2212>get_sys_exit_time()”
“$reporter\u2212>get_sys_time()”
“$reporter\u2212>get_sys_cumulative_time()”
“$reporter\u2212>get_run_cmd()”<\/p>\n

LIMITATIONS <\/a> <\/h2>\n

COPYRIGHT <\/a> <\/h2>\n

Copyright 2003, R. Barrie Slaymaker, Jr., All Rights Reserved<\/p>\n

LICENSE <\/a> <\/h2>\n

You may use this module under the terms of the BSD,<\/small> Artistic, or GPL<\/small> licenses, any version.<\/p>\n

AUTHOR <\/a> <\/h2>\n

Barrie Slaymaker <\/p>\n

\n","protected":false},"excerpt":{"rendered":"

IPC::Run3::ProfReporter \u2212 base class for handling profiling data <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[3758,3007],"class_list":["post-7446","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-ipcrun3profreporter","tag-man3"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7446","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=7446"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7446\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=7446"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=7446"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=7446"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}