.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "DPKG::Log::Entry 3pm" .TH DPKG::Log::Entry 3pm "2011-02-23" "perl v5.10.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" DPKG::Log::Entry \- Describe a log entry in a dpkg.log .SH "VERSION" .IX Header "VERSION" version 1.20 .SH "SYNOPSIS" .IX Header "SYNOPSIS" use DPKG::Log::Entry; .PP \&\f(CW$dpkg_log_entry\fR = DPKG::Log::Entry\->new( line => \f(CW$line\fR, \f(CW$lineno\fR => 1) .PP \&\f(CW$dpkg_log_entry\fR\->timestamp($dt); .PP \&\f(CW$dpkg_log_entry\fR\->associated_package(\*(L"foo\*(R"); .SH "DESCRIPTION" .IX Header "DESCRIPTION" This module is used to describe one line in a dpkg log by parameterizing every line into generic parameters like .IP "\(bu" 3 Type of log entry (startup\-, status\-, action-lines) .IP "\(bu" 3 Timestamp .IP "\(bu" 3 Subject of log entry (e.g. package, packages or archives) .IP "\(bu" 3 Package name (if log entry refers to a package subject) .PP and so on. .PP The various parameters are described below together with the various methods to access or modify them. .SH "METHODS" .IX Header "METHODS" .ie n .IP "$dpkg_log_entry = \s-1PACKAGE\-\s0>new( 'line' => $line, 'lineno' => $lineno )" 4 .el .IP "\f(CW$dpkg_log_entry\fR = \s-1PACKAGE\-\s0>new( 'line' => \f(CW$line\fR, 'lineno' => \f(CW$lineno\fR )" 4 .IX Item "$dpkg_log_entry = PACKAGE->new( 'line' => $line, 'lineno' => $lineno )" Returns a new DPKG::Log::Entry object. The arguments \fBline\fR and \fBlineno\fR are mandatore. They store the complete line as stored in the log and the line number. .Sp Additionally its possible to specify every attribute the object can store, as 'key' => 'value' pairs. .SH "ATTRIBUTES" .IX Header "ATTRIBUTES" .ie n .IP "$dpkg_log_entry\->\fIline()\fR / line" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIline()\fR / line" 4 .IX Item "$dpkg_log_entry->line() / line" Return the full log line. This attribute is set on object initialization. .ie n .IP "$dpkg_log_entry\->\fIlineno()\fR / lineno" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIlineno()\fR / lineno" 4 .IX Item "$dpkg_log_entry->lineno() / lineno" Return the line number of this entry. This attribute is set on object initialization. .ie n .IP "$dpkg_log_entry\->\fItimestamp()\fR / timestamp" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fItimestamp()\fR / timestamp" 4 .IX Item "$dpkg_log_entry->timestamp() / timestamp" Get or set the timestamp of this object. Should be a DateTime object. .ie n .IP "$dpkg_log_entry\->\fItype()\fR / type" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fItype()\fR / type" 4 .IX Item "$dpkg_log_entry->type() / type" Get or set the type of this entry. Specifies weither this is a startup, status or action line. .ie n .IP "$dpkg_log_entry\->\fIassociated_package()\fR / associated_package" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIassociated_package()\fR / associated_package" 4 .IX Item "$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. .ie n .IP "$dpkg_log_entry\->\fIaction()\fR / action" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIaction()\fR / action" 4 .IX Item "$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. .ie n .IP "$dpkg_log_entry\->\fIstatus()\fR / status" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIstatus()\fR / status" 4 .IX Item "$dpkg_log_entry->status() / status" Get or set the status of the package this entry refers to. .ie n .IP "$dpkg_log_entry\->\fIsubject()\fR / subject" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIsubject()\fR / subject" 4 .IX Item "$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'. .ie n .IP "$dpkg_log_entry\->\fIinstalled_version()\fR / installed_version" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIinstalled_version()\fR / installed_version" 4 .IX Item "$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 \*(L"\*(R" (or similar) if action is 'install', old version in case of an upgrade. .ie n .IP "$dpkg_log_entry\->\fIavailable_version()\fR / available_version" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIavailable_version()\fR / available_version" 4 .IX Item "$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. .ie n .IP "$dpkg_log_entry\->\fIconffile()\fR / conffile" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIconffile()\fR / conffile" 4 .IX Item "$dpkg_log_entry->conffile() / conffile" Get or set a conffile for a line indicating a conffile change. .ie n .IP "$dpkg_log_entry\->\fIdecision()\fR / decision" 4 .el .IP "\f(CW$dpkg_log_entry\fR\->\fIdecision()\fR / decision" 4 .IX Item "$dpkg_log_entry->decision() / decision" Gets or defines the decision for a line indicating a conffile change. .SH "SEE ALSO" .IX Header "SEE ALSO" DateTime .SH "AUTHOR" .IX Header "AUTHOR" Patrick Schoenfeld . .SH "COPYRIGHT AND LICENSE" .IX Header "COPYRIGHT AND LICENSE" Copyright (C) 2011 Patrick Schoenfeld .PP This library is free software. You can redistribute it and/or modify it under the same terms as perl itself.