---
name: "IPC::Run3::ProfReporter"
section: "3pm"
platform: "linux"
package: "perl-ipc-run3"
version: "0.049-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/IPC::Run3::ProfReporter"
---

# IPC::Run3::ProfReporter(3pm)

base class for handling profiling data

## NAME

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

## SYNOPSIS

## DESCRIPTION

See IPC::Run3::ProfPP and for an example subclass.

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.

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.

This allows reports to be run like:

```
    perl -MIPC::Run3::ProfPP -e1
    perl -MIPC::Run3::ProfPP -e1 foo.out bar.out
```

Use "-" to read from STDIN (the log file format is meant to be moderately greppable):

```
    grep "^cvs " run3.out perl -MIPC::Run3::ProfPP -e1 -
```

Use --app to show only application level statistics (ie don't emit a report section for each command run).

## METHODS

- "IPC::Run3::ProfReporter-\>new"

  Returns a new profile reporting object.

- "$reporter-\>handle\_app\_call( ... )"

  - "$reporter-\>handle\_app\_exit( ... )"

  - "$reporter-\>handle\_run\_exit( ... )"

  These methods are called by the handled events (see below).

- "$reporter-\>app\_call(\\@cmd, $time)"

  - "$reporter-\>app\_exit($time)"

  - "$reporter-\>run\_exit(@times)"

  ```
     $self->app_call( $time );
     my $time = $self->get_app_call_time;
  ```

  Sets the time (in floating point seconds) when the application, **run3()**, or **system()** was called or exited.  If no time parameter is passed, uses IPC::Run3's time routine.

  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.

- "$reporter-\>get\_run\_count()"

  - "$reporter-\>get\_app\_call\_time()"

  - "$reporter-\>get\_app\_exit\_time()"

  - "$reporter-\>get\_app\_cmd()"

  - "$reporter-\>get\_app\_time()"

  - "$reporter-\>get\_app\_cumulative\_time()"

  - "$reporter-\>get\_run\_call\_time()"

  - "$reporter-\>get\_run\_exit\_time()"

  - "$reporter-\>get\_run\_time()"

  - "$reporter-\>get\_run\_cumulative\_time()"

  - "$reporter-\>get\_sys\_call\_time()"

  - "$reporter-\>get\_sys\_exit\_time()"

  - "$reporter-\>get\_sys\_time()"

  - "$reporter-\>get\_sys\_cumulative\_time()"

  - "$reporter-\>get\_run\_cmd()"

  ## LIMITATIONS

## COPYRIGHT

```
    Copyright 2003, R. Barrie Slaymaker, Jr., All Rights Reserved
```

## LICENSE

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

## AUTHOR

Barrie Slaymaker \<barries@slaysys.com\>