Log Analysis Functions

The second group of functions is used for log analysis:

• klogger_open_log(text_log_filename)
  Opens the file text_log_filename for analysis. Returns a handle to the open log, or the undefined value if the open failed (the handle can only be used with the following functions).

• klogger_next_event(log_handle)
  Given a handle to an open log, return the next event in the log. The return value is a Perl reference to a Hash containing the next event in the log (as depicted in the textual file format). When reaching the end of the log the undefined value is returned.

• klogger_get_processes(log_handle)
  Returns a reference to a Hash containing the data about the running processes, indexed by the processes pids.

• klogger_close_log(log_handle)
  Close the open log associated with the given handle.

Using the log analysis functions, analysis scripts can be built around the code depicted in Algorithm 1.