David Leadbeater > Sys-Trace > Sys::Trace::Results

Download:
Sys-Trace-0.03.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Source  

NAME ^

Sys::Trace::Results - Results of a Sys::Trace

DESCRIPTION ^

This object holds the results of a trace performed via Sys::Trace.

METHODS ^

new($trace)

Initialises the object from a given trace. Normally called via the results method of Sys::Trace.

count

Returns the number of calls that are contained within this trace.

calls([$call])

Return a list of all the calls. The system call name will be filtered against $call if provided (either a string or a Regexp reference).

Each element in the list will be a hash reference of the form:

  {
    name     => "/path/to/file",  # filename, if relevant
    call     => "open",           # system call name
    systime  => 0.000012,         # time spent in call
    walltime => 1277664686.665232 # 
    args     => [ ... ]           # arguments
    errno    => "ENOENT"          # errno, if error occurred
    strerror => "No such file or directory", # error string, if returned
    pid      => 1234,             # pid being traced
    return   => -1
  }

files([$path])

Return a list of files that were referenced by the system calls in this trace, optionally filtering on $path.

TODO ^

This is currently very basic, this module should provide the ability to perform analysis.

SEE ALSO ^

Sys::Trace for copyright, etc.

syntax highlighting: