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.