WebSVN - Rev 1 - /trunk/share/DebPool/Packages.pm

package DebPool::Packages;

###
#
# DebPool::Packages - Module for handling package metadata
#
# Copyright 2003-2004 Joel Aelwyn. All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
# 1. Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
# 3. Neither the name of the Author nor the names of any contributors
# may be used to endorse or promote products derived from this software
# without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE.
#
# $Id: Packages.pm 70 2006-06-26 20:44:57Z joel $
#
###

# We use 'our', so we must have at least Perl 5.6

require 5.006_000;

# Always good ideas.

use strict;
use warnings;

use POSIX; # WEXITSTATUS
use File::Temp qw(tempfile);

### Module setup

BEGIN {
use Exporter ();
our ($VERSION, @ISA, @EXPORT, @EXPORT_OK, %EXPORT_TAGS);

# Version checking
$VERSION = '0.1.5';

@ISA = qw(Exporter);

@EXPORT = qw(
);

@EXPORT_OK = qw(
&Allow_Version
&Audit_Package
&Generate_List
&Generate_Package
&Generate_Source
&Guess_Section
&Install_List
&Install_Package
&Parse_Changes
&Parse_DSC
&Reject_Package
&Verify_MD5
);

%EXPORT_TAGS = (
'functions' => [qw(&Allow_Version &Audit_Package &Generate_List
&Generate_Package &Generate_Source &Guess_Section
&Install_List &Install_Package &Parse_Changes
&Parse_DSC &Reject_Package &Verify_MD5)],
'vars' => [qw()],
);
}

### Exported package globals

# None

### Non-exported package globals

# Thread-safe? What's that? Package global error value. We don't export
# this directly, because it would conflict with other modules.

our($Error);

# Fields (other than package relationships) from dpkg --info that we
# actually care about in some fashion.

my(@Info_Fields) = (
# 'Package',
'Priority',
'Section',
'Installed-Size',
# 'Maintainer',
'Architecture',
# 'Version',
'Essential',
);

# Package relationship fieldnames.

my(@Relationship_Fields) = (
'Pre-Depends',
'Depends',
'Provides',
'Conflicts',
'Recommends',
'Suggests',
'Enhances',
'Replaces',
);

# Normal fields potentially found in .changes files

my(%Changes_Fields) = (
'Format' => 'string',
'Date' => 'string',
'Source' => 'string',
'Binary' => 'space_array',
'Architecture' => 'space_array',
'Version' => 'string',
'Distribution' => 'space_array',
'Urgency' => 'string',
'Maintainer' => 'string',
'Changed-By' => 'string',
'Closes' => 'space_array',
);

# Normal fields potentially found in .dsc files

my(%DSC_Fields) = (
'Format' => 'string',
'Source' => 'string',
'Version' => 'string',
'Binary' => 'comma_array',
'Maintainer' => 'string',
'Architecture' => 'space_array',
'Standards-Version' => 'string',
'Build-Depends' => 'comma_array',
'Build-Depends-Indep' => 'comma_array',
);

### File lexicals

# None

### Constant functions

# None

### Meaningful functions

# Allow_Version($package, $version, $distribution)
#
# Decide, based on version comparison and config options, whether $version
# is an acceptable version for $package in $distribution. Returns 1 if the
# version is acceptable, 0 if it is not, and undef (and sets $Error) in the
# case of an error.

sub Allow_Version {
use DebPool::Config qw(:vars);
use DebPool::DB qw(:functions);
use DebPool::Logging qw(:functions :facility :level);

my($package, $version, $distribution) = @_;
my($old_version) = Get_Version($distribution, $package, 'meta');

# If we permit rollback, any version is valid.

if ($Options{'rollback'}) {
return 1;
}

# If we don't have an old version, anything is acceptable.

if (!defined($old_version)) {
return 1;
}

my($dpkg_bin) = '/usr/bin/dpkg';
my(@args) = ('--compare-versions', $version, 'gt', $old_version);

my($sysret) = WEXITSTATUS(system($dpkg_bin, @args));

if (0 != $sysret) { # DPKG says no go.
my($msg) = "Version comparison for '$package': proposed version for ";
$msg .= "$distribution ($version) is not greater than current ";
$msg .= "version ($old_version)";
Log_Message($msg, LOG_GENERAL, LOG_DEBUG);

return 0;
}

return 1;
}

# Parse_Changes($changes_filename)
#
# Parses the changes file found at $changes_filename (which should be a
# fully qualified path and filename), and returns a hashref pointing to a
# Changes hash. Returns undef in the case of a failure (and sets $Error).

# Changes Hash format:
# {
# 'Architecture' => \@Architectures
# 'Binary' => \@Binaries
# 'Changed-By' => Changed-By
# 'Changes' => \@Changes lines
# 'Closes' => \@Bugs
# 'Description' => Description
# 'Files' => \@\%File Hashes
# 'Date' => RFC 822 timestamp
# 'Distribution' => \@Distributions
# 'Maintainer' => Maintainer
# 'Source' => Source
# 'Urgency' => Urgency
# 'Version' => Version
# }

# File Hash format:
# {
# 'Filename' => Filename (leaf node only)
# 'MD5Sum' => File MD5Sum
# 'Priority' => Requested archive priority
# 'Section' => Requested archive section
# 'Size' => File size (in bytes)
# }

sub Parse_Changes {
use DebPool::GnuPG qw(:functions);
use DebPool::Logging qw(:functions :facility :level);

my($file) = @_;
my(%result);

# Read in the entire Changes file, stripping GPG encoding if we find
# it. It should be small, this is fine.

if (!open(CHANGES, '<', $file)) {
$Error = "Couldn't open changes file '$file': $!";
return undef;
}

my(@changes) = <CHANGES>;
chomp(@changes);
@changes = Strip_GPG(@changes);
close(CHANGES);

# Go through each of the primary fields, stuffing it into the result
# hash if we find it.

my($field);
foreach $field (keys(%Changes_Fields)) {
my(@lines) = grep(/^${field}:\s+/, @changes);
if (-1 == $#lines) { # No match
next;
} elsif (0 < $#lines) { # Multiple matches
Log_Message("Duplicate entries for field '$field'",
LOG_PARSE, LOG_WARNING);
}

$lines[0] =~ s/^${field}:\s+//;

if ('string' eq $Changes_Fields{$field}) {
$result{$field} = $lines[0];
} elsif ('space_array' eq $Changes_Fields{$field}) {
my(@array) = split(/\s+/, $lines[0]);
$result{$field} = \@array;
} elsif ('comma_array' eq $Changes_Fields{$field}) {
my(@array) = split(/\s+,\s+/, $lines[0]);
$result{$field} = \@array;
}
}

# Now that we should have it, check to make sure we have a Format
# header, and that it's format 1.7 (the only thing we grok).

if (!defined($result{'Format'})) {
Log_Message("No Format header found in changes file '$file'",
LOG_PARSE, LOG_ERROR);
$Error = 'No Format header found';
return undef;
} elsif ('1.7' ne $result{'Format'}) {
Log_Message("Unrecognized Format version '$result{'Format'}'",
LOG_PARSE, LOG_ERROR);
$Error = 'Unrecognized Format version';
return undef;
}

# Special case: Description. One-line entry, immediately after a line
# with '^Description:'.

my($count);

for $count (0..$#changes) {
if ($changes[$count] =~ m/^Description:/) {
$result{'Description'} = $changes[$count+1];
}
}

# Special case: Changes. Multi-line entry, starts one line after
# '^Changes:', goes until we hit the Files header.

my($found) = 0;
my(@changelines);

for $count (0..$#changes) {
if ($found) {
if ($changes[$count] =~ m/^Files:/) {
$found = 0;
} else {
push(@changelines, $changes[$count]);
}
} else {
if ($changes[$count] =~ m/^Changes:/) {
$found = 1;
}
}
}

$result{'Changes'} = \@changelines;

# The Files section is a special case. It starts on the line after the
# 'Files:' header, and goes until we hit a blank line, or the end of
# the data.

my(@files);

for $count (0..$#changes) {
if ($found) {
if ($changes[$count] =~ m/^\s*$/) { # Blank line
$found = 0; # No longer in Files
} elsif ($changes[$count] =~ m/\s*([[:xdigit:]]+)\s+(\d+)\s+(\S+)\s+(\S+)\s+(\S+)/) {
my($md5, $size, $sec, $pri, $file) = ($1, $2, $3, $4, $5);
push(@files, {
'Filename' => $file,
'MD5Sum' => $md5,
'Priority' => $pri,
'Section' => $sec,
'Size' => $size,
});
} else { # What's this doing here?
my($msg) = 'Unrecognized data in Files section of changes file';
$msg .= " '$file'";
Log_Message($msg, LOG_PARSE, LOG_WARNING);
}
} else {
if ($changes[$count] =~ m/^Files:/) {
$found = 1;
}
}
}

$result{'Files'} = \@files;

return \%result;
}

# Parse_DSC($dsc_filename)
#
# Parses the dsc file found at $dsc_filename (which should be a fully
# qualified path and filename), and returns a hashref pointing to a DSC
# hash. Returns undef in the case of a failure (and sets $Error).

# DSC Hash format:
# {
# 'Format' => Format
# 'Source' => Source
# 'Binary' => \@Binaries
# 'Maintainer' => Maintainer
# 'Architecture' => \@Architectures
# 'Standards-Version' => Standards-Version
# 'Build-Depends' => Build-Depends
# 'Build-Depends-Indep' => Build-Depends-Indep
# 'Files' => \@\%Filehash
# }

# File Hash format:
# {
# 'Filename' => Filename (leaf node only)
# 'MD5Sum' => File MD5Sum
# 'Size' => File size (in bytes)
# }

sub Parse_DSC {
use DebPool::GnuPG qw(:functions);
use DebPool::Logging qw(:functions :facility :level);

my($file) = @_;
my(%result);

# Read in the entire DSC file, stripping GPG encoding if we find it. It
# should be small, this is fine.

if (!open(DSC, '<', $file)) {
$Error = "Couldn't open dsc file '$file': $!";
return undef;
}

my(@dsc) = <DSC>;
chomp(@dsc);
@dsc = Strip_GPG(@dsc);
close(DSC);

# Go through each of the primary fields, stuffing it into the result
# hash if we find it.

my($field);
foreach $field (keys(%DSC_Fields)) {
my(@lines) = grep(/^${field}:\s+/, @dsc);
if (-1 == $#lines) { # No match
next;
} elsif (0 < $#lines) { # Multiple matches
Log_Message("Duplicate entries for field '$field'",
LOG_PARSE, LOG_WARNING);
}

$lines[0] =~ s/^${field}:\s+//;

if ('string' eq $DSC_Fields{$field}) {
$result{$field} = $lines[0];
} elsif ('space_array' eq $DSC_Fields{$field}) {
my(@array) = split(/\s+/, $lines[0]);
$result{$field} = \@array;
} elsif ('comma_array' eq $DSC_Fields{$field}) {
my(@array) = split(/\s+,\s+/, $lines[0]);
$result{$field} = \@array;
}
}

# Now that we should have it, check to make sure we have a Format
# header, and that it's format 1.0 (the only thing we grok).

if (!defined($result{'Format'})) {
Log_Message("No Format header found in dsc file '$file'",
LOG_PARSE, LOG_ERROR);
$Error = 'No Format header found';
return undef;
} elsif ('1.0' ne $result{'Format'}) {
Log_Message("Unrecognized Format version '$result{'Format'}'",
LOG_PARSE, LOG_ERROR);
$Error = 'Unrecognized Format version';
return undef;
}

# The Files section is a special case. It starts on the line after the
# 'Files:' header, and goes until we hit a blank line, or the end of
# the data.

# In fact, it's even more special than that; it includes, first, an entry
# for the DSC file itself...

my($count);
my($found) = 0;
my(@files);

my(@temp) = split(/\//, $file);
my($dsc_leaf) = pop(@temp);

my($cmd_result) = `/usr/bin/md5sum $file`;
$cmd_result =~ m/^([[:xdigit:]]+)\s+/;
my($dsc_md5) = $1;

my(@stat) = stat($file);
if (!@stat) {
$Error = "Couldn't stat DSC file '$file'";
return undef;
}
my($dsc_size) = $stat[7];

push(@files, {
'Filename' => $dsc_leaf,
'MD5Sum' => $dsc_md5,
'Size' => $dsc_size,
});

for $count (0..$#dsc) {
if ($found) {
if ($dsc[$count] =~ m/^\s*$/) { # Blank line
$found = 0; # No longer in Files
} elsif ($dsc[$count] =~ m/\s*([[:xdigit:]]+)\s+(\d+)\s+(\S+)/) {
my($md5, $size, $file) = ($1, $2, $3);
push(@files, {
'Filename' => $file,
'MD5Sum' => $md5,
'Size' => $size,
});
} else { # What's this doing here?
my($msg) = 'Unrecognized data in Files section of dsc file';
$msg .= " '$file'";
Log_Message($msg, LOG_PARSE, LOG_WARNING);
}
} else {
if ($dsc[$count] =~ m/^Files:/) {
$found = 1;
}
}
}

$result{'Files'} = \@files;

return \%result;
}

# Generate_List($distribution, $section, $arch)
#
# Generates a Packages (or Sources) file for the given distribution,
# section, and architecture (with 'source' being a special value for
# Sources). Returns the filename of the generated file on success, or undef
# (and sets $Error) on failure. Note that requests for an 'all' list are
# ignored - however, every non-source arch gets 'all' files.

sub Generate_List {
use DebPool::Config qw(:vars);
use DebPool::DB qw(:functions :vars);
use DebPool::Dirs qw(:functions);

my($distribution, $section, $arch) = @_;

my(%packages);

if ('all' eq $arch) {
$Error = "No point in generating Packages file for binary-all";
return undef;
}

my(@sources) = grep($ComponentDB{$distribution}->{$_} eq $section,
keys(%{$ComponentDB{$distribution}}));

my($tmpfile_handle, $tmpfile_name) = tempfile();

my($source);

# Dump the data from pool/*/*/pkg_ver.{package,source} into the list.

# FIXME: This needs to be refactored. Needs it pretty badly, in fact.

if ('source' eq $arch) {
foreach $source (@sources) {
my($pool) = join('/',
($Options{'pool_dir'}, PoolDir($source, $section), $source));
my($version) = Get_Version($distribution, $source, 'meta');
my($target) = "$pool/${source}_" . Strip_Epoch($version);
$target .= '.source';

# Source files aren't always present.
next if (!open(SRC, '<', "$target"));

print $tmpfile_handle <SRC>;
close(SRC);
}
} else {
foreach $source (@sources) {
my($pool) = join('/',
($Options{'pool_dir'}, PoolDir($source, $section), $source));
my($version) = Get_Version($distribution, $source, 'meta');
my($target) = "$pool/${source}_" . Strip_Epoch($version);
$target .= '.package';

if (!open(PKG, '<', "$target")) {
my($msg) = "Skipping package entry for all packages from ";
$msg .= "${source}: couldn't open '$target' for reading: $!";

Log_Message($msg, LOG_GENERAL, LOG_ERROR);
next;
}

# Playing around with the record separator ($/) to make this
# easier.

my($backup_RS) = $/;
$/ = "";

my(@entries) = <PKG>;
close(PKG);

$/ = $backup_RS;

# Pare it down to the relevant entries, and print those out.

@entries = grep(/\nArchitecture: ($arch|all)\n/, @entries);
print $tmpfile_handle @entries;
}
}

close($tmpfile_handle);

return $tmpfile_name;
}

# Install_Package($changes, $Changes_hashref, $DSC, $DSC_hashref, \@distributions)
#
# Install all of the package files for $Changes_hashref (which should
# be a Parse_Changes result hash) into the pool directory, and install
# the file in $changes to the installed directory. Also generates (and
# installes) .package and .source meta-data files. It also updates the
# Version database for the listed distributions. Returns 1 if successful, 0
# if not (and sets $Error).

sub Install_Package {
use DebPool::Config qw(:vars);
use DebPool::Dirs qw(:functions);
use DebPool::DB qw(:functions :vars);
use DebPool::Util qw(:functions);

my($changes, $chg_hashref, $dsc, $dsc_hashref, $distributions) = @_;

my($incoming_dir) = $Options{'incoming_dir'};
my($installed_dir) = $Options{'installed_dir'};
my($pool_dir) = $Options{'pool_dir'};

my($pkg_name) = $chg_hashref->{'Source'};
my($pkg_ver) = $chg_hashref->{'Version'};

my($guess_section) = Guess_Section($chg_hashref);
my($pkg_dir) = join('/',
($pool_dir, PoolDir($pkg_name, $guess_section), $pkg_name));

# Make sure the package directory exists (and is a directory!)

if (! -e $pkg_dir) {
if (!mkdir($pkg_dir)) {
$Error = "Failed to mkdir '$pkg_dir': $!";
return 0;
}
if (!chmod($Options{'pool_dir_mode'}, $pkg_dir)) {
$Error = "Failed to chmod '$pkg_dir': $!";
return 0;
}
} elsif (! -d $pkg_dir) {
$Error = "Target '$pkg_dir' is not a directory.";
return 0;
}

# Walk the File Hash, trying to install each listed file into the
# pool directory.

my($filehash);

foreach $filehash (@{$chg_hashref->{'Files'}}) {
my($file) = $filehash->{'Filename'};
if (!Move_File("${incoming_dir}/${file}", "${pkg_dir}/${file}",
$Options{'pool_file_mode'})) {
$Error = "Failed to move '${incoming_dir}/${file}' ";
$Error .= "to '${pkg_dir}/${file}': ${DebPool::Util::Error}";
return 0;
}
}

# Generate and install .package and .source metadata files.

my($pkg_file) = Generate_Package($chg_hashref);

if (!defined($pkg_file)) {
$Error = "Failed to generate .package file: $Error";
return undef;
}

my($target) = "$pkg_dir/${pkg_name}_" . Strip_Epoch($pkg_ver) . '.package';

if (!Move_File($pkg_file, $target, $Options{'pool_file_mode'})) {
$Error = "Failed to move '$pkg_file' to '$target': ";
$Error .= $DebPool::Util::Error;
return 0;
}

if (defined($dsc) && defined($dsc_hashref)) {
my($src_file) = Generate_Source($dsc, $dsc_hashref, $chg_hashref);

if (!defined($src_file)) {
$Error = "Failed to generate .source file: $Error";
return undef;
}

$target = "$pkg_dir/${pkg_name}_" . Strip_Epoch($pkg_ver) . '.source';

if (!Move_File($src_file, $target, $Options{'pool_file_mode'})) {
$Error = "Failed to move '$src_file' to '$target': ";
$Error .= $DebPool::Util::Error;
return 0;
}
}

# Finally, try to install the changes file to the installed directory.

if (!Move_File("$incoming_dir/$changes", "$installed_dir/$changes",
$Options{'installed_file_mode'})) {
$Error = "Failed to move '$incoming_dir/$changes' to ";
$Error .= "'$installed_dir/$changes': ${DebPool::Util::Error}";
return 0;
}

# Update the various databases.

my($distribution);

# This whole block is just to calculate the component. What a stupid
# setup - it should be in the changes file. Oh well.

my(@filearray) = @{$chg_hashref->{'Files'}};
my($fileref) = $filearray[0];
my($section) = $fileref->{'Section'};
my($component) = Strip_Subsection($section);

foreach $distribution (@{$distributions}) {
Set_Versions($distribution, $pkg_name, $pkg_ver,
$chg_hashref->{'Files'});
$ComponentDB{$distribution}->{$pkg_name} = $component;
}

return 1;
}

# Reject_Package($changes, $chg_hashref)
#
# Move all of the package files for $chg_hashref (which should be a
# Parse_Changes result hash) into the rejected directory, as well as the
# file in $changes. Returns 1 if successful, 0 if not (and sets $Error).

sub Reject_Package {
use DebPool::Config qw(:vars);
use DebPool::DB qw(:functions);
use DebPool::Util qw(:functions);

my($changes, $chg_hashref) = @_;

my($incoming_dir) = $Options{'incoming_dir'};
my($reject_dir) = $Options{'reject_dir'};
my($reject_file_mode) = $Options{'reject_file_mode'};

# Walk the File Hash, moving each file to the rejected directory.

my($filehash);

foreach $filehash (@{$chg_hashref->{'Files'}}) {
my($file) = $filehash->{'Filename'};
if (!Move_File("$incoming_dir/$file", "$reject_dir/$file",
$reject_file_mode)) {
$Error = "Failed to move '$incoming_dir/$file' ";
$Error .= "to '$reject_dir/$file': ${DebPool::Util::Error}";
return 0;
}
}

# Now move the changes file to the rejected directory, as well.

if (!Move_File("$incoming_dir/$changes", "$reject_dir/$changes",
$reject_file_mode)) {
$Error = "Failed to move '$incoming_dir/$changes' to ";
$Error .= "'$reject_dir/$changes': ${DebPool::Util::Error}";
return 0;
}

return 1;
}

# Verify_MD5($file, $md5)
#
# Verifies the MD5 checksum of $file against $md5. Returns 1 if it matches,
# 0 if it doesn't, and undef (also setting $Error) if an error occurs. This
# routine uses the dpkg md5sum utility, to avoid pulling in a dependancy on
# Digest::MD5.

sub Verify_MD5 {
use DebPool::Logging qw(:functions :facility :level);

my($file, $md5) = @_;

# Read in and mangle the md5 output.

if (! -r $file) { # The file doesn't exist! Will be hard to checksum it...
my($msg) = "MD5 checksum unavailable: file '$file' does not exist!";
Log_Message($msg, LOG_GENERAL, LOG_ERROR);
return 0;
}

my($cmd_result) = `/usr/bin/md5sum $file`;
if (!$cmd_result) { # Failed to run md5sum for some reason
my($msg) = "MD5 checksum unavailable: file '$file'";
Log_Message($msg, LOG_GENERAL, LOG_ERROR);
return 0;
}

$cmd_result =~ m/^([[:xdigit:]]+)\s+/;
my($check_md5) = $1;

if ($md5 ne $check_md5) {
my($msg) = "MD5 checksum failure: file '$file', ";
$msg .= "expected '$md5', got '$check_md5'";
Log_Message($msg, LOG_GENERAL, LOG_ERROR);
return 0;
}

return 1;
}

# Audit_Package($package, $chg_hashref)
#
# Delete a package and changes files for the named (source) package which
# are not referenced by any version currently found in the various release
# databases. Returns the number of files unlinked (which may be 0), or
# undef (and sets $Error) on an error.

sub Audit_Package {
use DebPool::Config qw(:vars);
use DebPool::Dirs qw(:functions);
use DebPool::Logging qw(:functions :facility :level);

my($package, $changes_hashref) = @_;

my($installed_dir) = $Options{'installed_dir'};
my($pool_dir) = $Options{'pool_dir'};

my($section) = Guess_Section($changes_hashref);
my($package_dir) = join('/',
($pool_dir, PoolDir($package, $section), $package));

my(@changes) = grep(/${package}_/, Scan_Changes($installed_dir));

my($pool_scan) = Scan_All($package_dir);
if (!defined($pool_scan)) {
$Error = $DebPool::Dirs::Error;
return undef;
}
my(@pool_files) = @{$pool_scan};

# Go through each file found in the pool directory, and determine its
# version. If it isn't in the current version tables, unlink it.

my($file);
my($unlinked) = 0;
foreach $file (@pool_files) {
my($orig) = 0;
my($deb) = 0;
my($src) = 0;
my($bin_package, $version);

if ($file =~ m/^([^_]+)_([^_]+)\.orig\.tar\.gz$/) { # orig.tar.gz
$bin_package = $1;
$version = $2;
$src = 1;
$orig = 1;
} elsif ($file =~ m/^([^_]+)_([^_]+)\.tar\.gz$/) { # tar.gz
$bin_package = $1;
$version = $2;
$src = 1;
} elsif ($file =~ m/^([^_]+)_([^_]+)\.diff\.gz$/) { # diff.gz
$bin_package = $1;
$version = $2;
$src = 1;
} elsif ($file =~ m/^([^_]+)_([^_]+)\.dsc$/) { # dsc
$bin_package = $1;
$version = $2;
$src = 1;
} elsif ($file =~ m/^([^_]+)_([^_]+)_.+\.deb$/) { # deb
$bin_package = $1;
$version = $2;
$deb = 1;
} elsif ($file =~ m/^([^_]+)_([^_]+)_.+\.udeb$/) { # udeb
$bin_package = $1;
$version = $2;
$deb = 1;
} elsif ($file =~ m/^([^_]+)_([^_]+)\.package$/) { # package metadata
$bin_package = $1;
$version = $2;
} elsif ($file =~ m/^([^_]+)_([^_]+)\.source$/) { # source metadata
$bin_package = $1;
$version = $2;
} else {
Log_Message("Couldn't figure out filetype for '$package_dir/$file'",
LOG_AUDIT, LOG_ERROR);
next;
}

# Skip it if we recognize it as a valid version.

my($matched) = 0;
my($dist);
foreach $dist (@{$Options{'realdists'}}) {
my($ver_pkg);
if ($src) {
$ver_pkg = 'source';
} elsif ($deb) {
$ver_pkg = $bin_package;
} else {
$ver_pkg = 'meta';
}

my($dist_ver) = Get_Version($dist, $package, $ver_pkg);
next if (!defined($dist_ver)); # No version in specified dist
$dist_ver = Strip_Epoch($dist_ver);
if ($orig) { $dist_ver =~ s/-.+$//; }
if ($version eq $dist_ver) { $matched = 1; }
}
next if $matched;

# Otherwise, unlink it.

if (unlink("$package_dir/$file")) {
$unlinked += 1;
Log_Message("Unlinked obsolete pool file '$package_dir/$file'",
LOG_AUDIT, LOG_DEBUG);
} else {
Log_Message("Couldn't obsolete pool file '$package_dir/$file'",
LOG_AUDIT, LOG_ERROR);
}
}

foreach $file (@changes) {
$file =~ m/^[^_]+_([^_]+)_.+$/; # changes
my($version) = $1;

my($matched) = 0;
my($dist);
foreach $dist (@{$Options{'realdists'}}) {
my($dist_ver) = Get_Version($dist, $package, 'meta');
next if (!defined($dist_ver)); # No version in specified dist
$dist_ver = Strip_Epoch($dist_ver);
if ($version eq $dist_ver) { $matched = 1; }
}
next if $matched;

if (unlink("$installed_dir/$file")) {
$unlinked += 1;
Log_Message("Unlinked obsolete changes file " .
"'$installed_dir/$file'", LOG_AUDIT, LOG_DEBUG);
} else {
Log_Message("Couldn't obsolete changes file " .
"'$installed_dir/$file'", LOG_AUDIT, LOG_ERROR);
}
}

return $unlinked;
}

# Generate_Package($chg_hashref)
#
# Generates a .package metadata file (Packages entries for each binary
# package) in the tempfile area, and returns the filename. Returns undef
# (and sets $Error) on failure.

sub Generate_Package {
use DebPool::Config qw(:vars);
use DebPool::Dirs qw(:functions);
use DebPool::Logging qw(:functions :facility :level);

my($changes_data) = @_;
my($source) = $changes_data->{'Source'};
my(@files) = @{$changes_data->{'Files'}};
my($pool_base) = PoolBasePath();

# Grab a temporary file.

my($tmpfile_handle, $tmpfile_name) = tempfile();

my(@packages) = @{$changes_data->{'Binary'}};
my(@architectures) = @{$changes_data->{'Architecture'}};
@architectures = grep(!/source/, @architectures); # Source is on it's own.

my($package, $arch);

foreach $package (@packages) {
foreach $arch (@architectures) {
# Construct a pattern to match the filename and nothing else.
# This used to be an exact match using the source version, but
# Debian's standards are sort of insane, and the version number
# on binary files is not always the same as that on the source
# file (nor is it even something simple like "source version
# without the epoch" -- it is more or less arbitrary, as long
# as it is a well-formed version number).

my($filepat) = "${package}_.*_${arch}\\.deb";
$filepat =~ s/\+/\\\+/;

my($section) = Guess_Section($changes_data);
my($pool) = join('/', (PoolDir($source, $section), $source));

my($marker) = -1;
my($count) = 0;

# Step through each file, match against filename. Save matches
# for later use.

for $count (0..$#files) {
if ($files[$count]->{'Filename'} =~ m/$filepat/) {
$marker = $count;
}
}

# The changes file has a stupid quirk; it puts all binaries from
# a package in the Binary: line, even if they weren't built (for
# example, an Arch: all doc package when doing an arch-only build
# for a port). So if we didn't find a .deb file for it, assume
# that it's one of those, and skip, rather than choking on it.

next if (-1 == $marker);

# Run Dpkg_Info to grab the dpkg --info data on the package.

my($file) = $files[$marker]->{'Filename'};
my($info) = Dpkg_Info("$Options{'pool_dir'}/$pool/$file");

# Dump all of our data into the metadata tempfile.

print $tmpfile_handle "Package: $package\n";

if (defined($info->{'Priority'})) {
print $tmpfile_handle "Priority: $info->{'Priority'}\n";
}

if (defined($info->{'Section'})) {
print $tmpfile_handle "Section: $info->{'Section'}\n";
}

if (defined($info->{'Essential'})) {
print $tmpfile_handle "Essential: $info->{'Essential'}\n";
}

print $tmpfile_handle "Installed-Size: $info->{'Installed-Size'}\n";

print $tmpfile_handle "Maintainer: $changes_data->{'Maintainer'}\n";
print $tmpfile_handle "Architecture: $arch\n";
print $tmpfile_handle "Source: $source\n";
print $tmpfile_handle "Version: $changes_data->{'Version'}\n";

# All of the inter-package relationships go together, and any
# one of them can potentially be empty (and omitted).

my($field);
foreach $field (@Relationship_Fields) {
if (defined($info->{$field})) {
print $tmpfile_handle "${field}: $info->{$field}\n";
}
}

# And now, some stuff we can grab out of the parsed changes
# data far more easily than anywhere else.

print $tmpfile_handle "Filename: $pool_base/$pool/$file\n";

print $tmpfile_handle "Size: $files[$marker]->{'Size'}\n";
print $tmpfile_handle "MD5sum: $files[$marker]->{'MD5Sum'}\n";

print $tmpfile_handle "Description: $info->{'Description'}";
}

print $tmpfile_handle "\n";
}

# All done

close($tmpfile_handle);
return $tmpfile_name;
}

# Generate_Source($dsc, $dsc_hashref, $changes_hashref)
#
# Generates a .source metadata file (Sources entries for the source
# package) in the tempfile area, and returns the filename. Returns undef
# (and sets $Error) on failure.

sub Generate_Source {
use DebPool::Dirs qw(:functions);
use DebPool::Logging qw(:functions :facility :level);

my($dsc, $dsc_data, $changes_data) = @_;
my($source) = $dsc_data->{'Source'};
my(@files) = @{$dsc_data->{'Files'}};

# Figure out the priority and section, using the DSC filename and
# the Changes file data.

my($section, $priority);
my($filehr);
foreach $filehr (@{$changes_data->{'Files'}}) {
if ($filehr->{'Filename'} eq $dsc) {
$section = $filehr->{'Section'};
$priority = $filehr->{'Priority'};
}
}

# Grab a temporary file.

my($tmpfile_handle, $tmpfile_name) = tempfile();

# Dump out various metadata.

print $tmpfile_handle "Package: $source\n";
print $tmpfile_handle "Binary: " . join(', ', @{$dsc_data->{'Binary'}}) . "\n";
print $tmpfile_handle "Version: $dsc_data->{'Version'}\n";
print $tmpfile_handle "Priority: $priority\n";
print $tmpfile_handle "Section: $section\n";
print $tmpfile_handle "Maintainer: $dsc_data->{'Maintainer'}\n";

if (defined($dsc_data->{'Build-Depends'})) {
print $tmpfile_handle 'Build-Depends: ';
print $tmpfile_handle join(', ', @{$dsc_data->{'Build-Depends'}}) . "\n";
}

if (defined($dsc_data->{'Build-Depends-Indep'})) {
print $tmpfile_handle 'Build-Depends-Indep: ';
print $tmpfile_handle join(', ', @{$dsc_data->{'Build-Depends-Indep'}}) . "\n";
}

print $tmpfile_handle 'Architecture: ';
print $tmpfile_handle join(' ', @{$dsc_data->{'Architecture'}}) . "\n";

print $tmpfile_handle "Standards-Version: $dsc_data->{'Standards-Version'}\n";
print $tmpfile_handle "Format: $dsc_data->{'Format'}\n";
print $tmpfile_handle "Directory: " . join('/',
(PoolBasePath(), PoolDir($source, $section), $source)) . "\n";

print $tmpfile_handle "Files:\n";

my($fileref);
foreach $fileref (@files) {
print $tmpfile_handle " $fileref->{'MD5Sum'}";
print $tmpfile_handle " $fileref->{'Size'}";
print $tmpfile_handle " $fileref->{'Filename'}\n";
}

print $tmpfile_handle "\n";

# All done

close($tmpfile_handle);
return $tmpfile_name;
}

# Dpkg_Info($file)
#
# Runs dpkg --info on $file, and returns a hash of relevant information.
#
# Internal support function for Generate_Package.

sub Dpkg_Info {
my($file) = @_;
my(%result);

# Grab the info from dpkg --info.

my(@info) = `/usr/bin/dpkg --info $file`;
my($smashed) = join('', @info);

# Look for each of these fields in the info. All are single line values,
# so the matching is fairly easy.

my($field);

foreach $field (@Info_Fields, @Relationship_Fields) {
if ($smashed =~ m/\n ${field}:\s+(\S.*)\n/) {
$result{$field} = $1;
}
}

# And, finally, grab the description.

my($line);
my($found) = 0;
foreach $line (@info) {
if ($found) {
$line =~ s/^ //;
$result{'Description'} .= $line;
} elsif ($line =~ m/^ Description: (.+)/) {
$result{'Description'} = "$1\n";
$found = 1;
}
}

return \%result;
}

# Install_List($archive, $component, $architecture, $listfile, $gzfile)
#
# Installs a distribution list file (from Generate_List), along with an
# optional gzipped version of the same file (if $gzfile is defined).
# Returns 1 on success, or 0 (and sets $Error) on failure.

sub Install_List {
use DebPool::Config qw(:vars);
use DebPool::Dirs qw(:functions);

my($archive, $component, $architecture, $listfile, $gzfile) = @_;

my($dists_file_mode) = $Options{'dists_file_mode'};
my($inst_file) = "$Options{'dists_dir'}/";
$inst_file .= Archfile($archive, $component, $architecture, 0);

# Now install the file(s) into the appropriate place(s).

if (!Move_File($listfile, $inst_file, $dists_file_mode)) {
$Error = "Couldn't install distribution file '$listfile' ";
$Error .= "to '${inst_file}': ${DebPool::Util::Error}";
return 0;
}

if (defined($gzfile) && !Move_File($gzfile, "${inst_file}.gz",
$dists_file_mode)) {
$Error = "Couldn't install gzipped distribution file '$gzfile' ";
$Error .= "to '${inst_file}.gz': ${DebPool::Util::Error}";
return 0;
}

return 1;
}

# Guess_Section($changes_hashref)
#
# Attempt to guess the freeness section of a package based on the data
# for the first file listed in the changes.

sub Guess_Section {
# Pull out the primary section from the changes data. Note that this is
# a cheap hack, but it is mostly used when needing the pool directory
# section, which is based solely on freeness-sections (main, contrib,
# non-free).

my($changes_hashref) = @_;

my(@changes_files) = @{$changes_hashref->{'Files'}};
return $changes_files[0]->{'Section'};
}

# Strip_Epoch($version)
#
# Strips any epoch data off of the version.

sub Strip_Epoch {
my($version) = @_;

$version =~ s/^[^:]://;
return $version;
}

END {}

1;

__END__

# vim:set tabstop=4 expandtab:

Subversion Repositories

(root)/trunk/share/DebPool/Packages.pm @ 12 - Rev 1