---
name: "DPKG::Log"
section: "3pm"
platform: "linux"
package: "libdpkg-log-perl"
version: "1.20-2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/DPKG::Log"
---

# DPKG::Log(3pm)

Parse the dpkg log

## NAME

DPKG::Log - Parse the dpkg log

## VERSION

version 1.20

## 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 omitted, 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 overridden 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.