Debian::Debget (3pm)

\s-1XXX\s0

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 \*(C`die\*(C' 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.

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 \*(C`die\*(C'.

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 \*(C`cmp\*(C' for Debian package version numbers. It is prototyped to take 2 scalar arguments, so it can be used as-is as a \*(C`sort\*(C' 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 \*(C`pool/\*(C' level) in which files for package are stored. package can be either a binary or source package name.

debget\|(1), AptPkg\|(3pm)

Roderick Schertler <[email protected]>