NAME

DPKG::Log - Parse the dpkg log

SYNOPSIS

use DPKG::Log;

my $dpkg_log = DPKG::Log->new('filename' => 'dpkg.log', 'parse' => 1);

DESCRIPTION

This module is used to parse a logfile and store each line as a DPKG::Log::Entry object.

METHODS

$dpkg_log = DPKG::Log->new()

$dpkg_log = DPKG::Log->new('filename' => 'dpkg.log')

$dpkg_log = DPKG::Log->new('filename' => 'dpkg.log', 'parse' => 1 )

Returns a new DPKG::Log object. If parse is set to a true value the logfile specified by filename is parsed at the end of the object initialisation. Otherwise the parse routine has to be called. Filename parameter can be ommitted, it defaults to /var/log/dpkg.log.

Optionally its possible to specify from or to arguments as timestamps in the standard dpkg.log format or as DateTime objects. This will limit the entries which will be stored in the object to entries in the given timerange. Note that, if this is not what you want, you may ommit these attributes and can use filter_by_time() instead.

By default the module will assume that those timestamps are in the local timezone as determined by DateTime::TimeZone. This can be overriden by giving the argument time_zone which takes a timezone string (e.g. 'Europe/Berlin') or a DateTime::TimeZone object. Additionally its possible to override the timestamp_pattern by specifying timestamp_format. This has to be a valid pattern for DateTime::Format::Strptime.

$dpkg_log->filename

$dpkg_log->filename('newfilename.log')

Get or set the filename of the dpkg logfile.

$dpkg_log->parse

$dpkg_log->parse('time_zone' => 'Europe/Berlin')

$dpkg_log->parse('time_zone' => $dt_tz )

Call the parser.

The time_zone parameter is optional and specifies in which time zone the dpkg log timestamps are. If its omitted it will use the default local time zone. Its possible to specify either a DateTime::TimeZone object or a string.

@entries = $dpkg_log->entries;

@entries = $dpkg_log->entries('from' => '2010-01-01.10:00:00', to => '2010-01-02 24:00:00')

Return all entries or all entries in a given timerange.

from and to are optional arguments, specifying a date before (from) and after (to) which entries aren't returned. If only to is specified all entries from the beginning of the log are read. If only from is specified all entries till the end of the log are read.

$entry = $dpkg_log->next_entry;

Return the next entry.

@entries = $dpkg_log->filter_by_time(from => ts, to => ts)

@entries = $dpkg_log->filter_by_time(from => ts)

@entries = $dpkg_log->filter_by_time(to => ts)

@entries = $dpkg_log->filter_by_time(from => ts, to => ts, entry_ref => $entry_ref)

Filter entries by given from - to range. See the explanations for the new sub for the arguments.

If entry_ref is given and an array reference its used instead of $self->{entries} as input source for the entries which are to be filtered.

($from, $to) = $dpkg_log->get_datetime_info()

Returns the from and to timestamps of the logfile or (if from/to values are set) the values set during object initialisation.

SEE ALSO

DPKG::Log::Entry, DateTime, DateTime::TimeZone

AUTHOR

Patrick Schoenfeld <schoenfeld@debian.org>.

COPYRIGHT AND LICENSE

Copyright (C) 2011 Patrick Schoenfeld <schoenfeld@debian.org>

This library is free software. You can redistribute it and/or modify it under the same terms as perl itself.