DPKG::Log::Entry(3pm)					User Contributed Perl Documentation				     DPKG::Log::Entry(3pm)

NAME

       DPKG::Log::Entry - Describe a log entry in a dpkg.log

VERSION

       version 1.20

SYNOPSIS

       use DPKG::Log::Entry;

       $dpkg_log_entry = DPKG::Log::Entry->new( line => $line, $lineno => 1)

       $dpkg_log_entry->timestamp($dt);

       $dpkg_log_entry->associated_package("foo");

DESCRIPTION

       This module is used to describe one line in a dpkg log by parameterizing every line into generic parameters like

       o  Type of log entry (startup-, status-, action-lines)

       o  Timestamp

       o  Subject of log entry (e.g. package, packages or archives)

       o  Package name (if log entry refers to a package subject)

       and so on.

       The various parameters are described below together with the various methods to access or modify them.

METHODS

       $dpkg_log_entry = PACKAGE->new( 'line' => $line, 'lineno' => $lineno )
	   Returns a new DPKG::Log::Entry object.  The arguments line and lineno are mandatore. They store the complete line as stored in the log
	   and the line number.

	   Additionally its possible to specify every attribute the object can store, as 'key' => 'value' pairs.

ATTRIBUTES

       $dpkg_log_entry->line() / line
	   Return the full log line. This attribute is set on object initialization.

       $dpkg_log_entry->lineno() / lineno
	   Return the line number of this entry. This attribute is set on object initialization.

       $dpkg_log_entry->timestamp() / timestamp
	   Get or set the timestamp of this object. Should be a DateTime object.

       $dpkg_log_entry->type() / type
	   Get or set the type of this entry. Specifies weither this is a startup, status or action line.

       $dpkg_log_entry->associated_package() / associated_package
	   Get or set the associated_package of this entry. This is for lines that are associated to a certain package like in action or status
	   lines. Its usually unset for startup and status lines.

       $dpkg_log_entry->action() / action
	   Get or set the action of this entry. This is for lines that have a certain action, like in startup-lines (unpack, configure) or action
	   lines (install, remove).  It is usally unset for status lines.

       $dpkg_log_entry->status() / status
	   Get or set the status of the package this entry refers to.

       $dpkg_log_entry->subject() / subject
	   Gets or Defines the subject of the entry. For startup lines this is usually 'archives' or 'packages' for all other lines its 'package'.

       $dpkg_log_entry->installed_version() / installed_version
	   Gets or Defines the installed_version of the package this entry refers to.  It refers to the current installed version of the package
	   depending on the current status. Is "<none>" (or similar) if action is 'install', old version in case of an upgrade.

       $dpkg_log_entry->available_version() / available_version
	   Gets or Defines the available_version of the package this entry refers to.  It refers to the currently available version of the package
	   depending on the current status. Is different from installed_version if the action is install or upgrade.

       $dpkg_log_entry->conffile() / conffile
	   Get or set a conffile for a line indicating a conffile change.

       $dpkg_log_entry->decision() / decision
	   Gets or defines the decision for a line indicating a conffile change.

SEE ALSO

       DateTime

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.

perl v5.10.1							    2011-02-23						     DPKG::Log::Entry(3pm)