Debian::Debget.3pm

Langue: en

Version: 2008-12-12 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

Debian::Debget - helper functions used by debget et al

SYNOPSIS

XXX

DESCRIPTION

These are functions used by debget and related scripts, but you can use them, too. I will do everything possible to retain backwards compatibility for the interfaces documented here.

Most of these functions will "die" if they're called in a context (scalar, list) which doesn't match what they expect. This is so that I will be able to change them to return something different in the other context without breaking old code.

IMPORTABLES

binary_package_info package
This function returns some information about a binary package.

If the package isn't found nothing is returned. If it is found, the return value is a data structure like this:

     $r->{$distribution}{$architecture} = $version;
     # $distribution => 'stable', 'experimental', etc.
     # $architecture => 'i386', 'powerpc', etc.
 
 

If something goes seriously wrong binary_package_info will "die".

source_package_info package
This function returns some information about a source package.

If the package isn't found nothing is returned. If it is found, the return value is a data structure like this:

     $r->{$distribution} = [$version, @binary_package_list];
     # $distribution => 'stable', 'experimental', etc.
     # $version      => '123.4-5', etc.
     # @binary_package_list => qw(nethack-common nethack-x11), etc.
 
 
cmp_debian_versions v1, v2
This is like "cmp" for Debian package version numbers. It is prototyped to take 2 scalar arguments, so it can be used as-is as a "sort" comparison function.
upstream_version debian-version
This returns the upstream version extracted from the given debian-version
pool_dir package
This returns the pool directory (starting at the "pool/" level) in which files for package are stored. package can be either a binary or source package name.

SEE ALSO

debget(1), AptPkg(3pm)

AUTHOR

Roderick Schertler <roderick@argon.org>