NAME

AptPkg - interface to libapt-pkg

SYNOPSIS

use AptPkg;

DESCRIPTION

The AptPkg module provides a low-level XS interface to libapt-pkg.

Note that this interface is intended to be internal, and may change, see the AptPkg::Config, AptPkg::System, AptPkg::Version, AptPkg::Cache, Apt::Policy and AptPkg::Source classes for a higher level interface.

AptPkg

The AptPkg package provides the following functions:

_init_config(CONF)
Initialise a Configuration object (pkgInitConfig). See the init method in AptPkg::Config.
_init_system(CONF)
Return a pointer to the system object (pkgInitSystem). See the system method in AptPkg::Config.
_parse_cmdline(CONF, ARG_DEFS, ...)
Constructs a CommandLine instance, invokes the Parse method and returns the remaining arguments. See the parse_cmdline method in AptPkg::Config.

AptPkg::_config

The AptPkg::_config package wraps a Perl class around the Configuration class. It provides an instance of the global _config object, and exposes the following methods:

    Find, FindFile, FindDir, FindB, FindAny, Set, Exists,
    ExistsAny, Tree and Dump.

The functions ReadConfigFile and ReadConfigDir are also provided within the package and may be used as methods.

AptPkg::_config::item

The AptPkg::_config::item package wraps a Perl class around the Configuration::Item class. The AptPkg::_config Tree method returns an instance of this class.

Methods:

    Value, Tag, FullTag, Parent, Child and Next.

AptPkg::System

The AptPkg::System package wraps a Perl class around the pkgSystem class. It provides an instance of the global _system object, and exposes the following methods:

    Label, VS, Lock and UnLock.

AptPkg::Version

The AptPkg::Version package wraps a Perl class around the pkgVersioningSystem class. It exposes the following methods:

    Label, CmpVersion, CmpReleaseVer, CheckDep and UpstreamVersion.

AptPkg::_cache

The AptPkg::_cache package wraps a Perl class around the pkgCacheFile class. It exposes the following methods:

    Open, Close, FindPkg, PkgBegin, FileList, Packages and Policy.

AptPkg::Cache::_package

The AptPkg::Cache::_package package wraps a Perl class around the pkgCache::PkgIterator class. It exposes the following methods:

    Next, Name, Section, VersionList, CurrentVer, RevDependsList,
    ProvidesList, Index, SelectedState, InstState, CurrentState and
    Flags.

AptPkg::Cache::_version

The AptPkg::Cache::_version package wraps a Perl class around the pkgCache::VerIterator class. It exposes the following methods:

    VerStr, Section, Arch, ParentPkg, DependsList, ProvidesList,
    FileList, Index and Priority.

AptPkg::Cache::_depends

The AptPkg::Cache::_depends package wraps a Perl class around the pkgCache::DepIterator class. It exposes the following methods:

    TargetVer, TargetPkg, ParentVer, ParentPkg, Index, CompType and
    DepType.

AptPkg::Cache::_provides

The AptPkg::Cache::_provides package wraps a Perl class around the pkgCache::PrvIterator class. It exposes the following methods:

    Name, ProvideVersion, OwnerVer, OwnerPkg and Index.

AptPkg::Cache::_pkg_file

The AptPkg::Cache::_pkg_file package wraps a Perl class around the pkgCache::PkgFileIterator class. It exposes the following methods:

    FileName, Archive, Component, Version, Origin, Label, Site,
    Architecture, IndexType and Index.

AptPkg::Cache::_ver_file

The AptPkg::Cache::_ver_file package wraps a Perl class around the pkgCache::VerFileIterator class. It exposes the following methods:

    File, Index, Offset and Size.

AptPkg::Cache::_pkg_records

The AptPkg::Cache::_pkg_records package wraps a Perl class around the pkgRecords class. It exposes the following methods:

    Lookup.

AptPkg::_policy

The AptPkg::_policy package wraps a Perl class around the pkgPolicy class. It exposes the following methods:

    GetPriority, GetMatch and GetCandidateVer.

AptPkg::_source_list

The AptPkg::_source_list package wraps a Perl class around the pkgSourceList class. Required as an argument to the AptPkg::_src_records constructor.

AptPkg::_src_records

The AptPkg::_src_records package wraps a Perl class around the pkgSrcRecords class. It exposes the following methods:

    Restart, Find.

Constants

The following APT enumerations are included, used by attributes of AptPkg::Cache.

pkgCache::Dep::DepType

AptPkg::Dep::Depends, AptPkg::Dep::PreDepends, AptPkg::Dep::Suggests, AptPkg::Dep::Recommends, AptPkg::Dep::Conflicts, AptPkg::Dep::Replaces and AptPkg::Dep::Obsoletes.

pkgCache::Dep::DepCompareOp

AptPkg::Dep::Or, AptPkg::Dep::NoOp, AptPkg::Dep::LessEq, AptPkg::Dep::GreaterEq, AptPkg::Dep::Less, AptPkg::Dep::Greater, AptPkg::Dep::Equals and AptPkg::Dep::NotEquals.

pkgCache::State::VerPriority

AptPkg::State::Important, AptPkg::State::Required, AptPkg::State::Standard, AptPkg::State::Optional and AptPkg::State::Extra.

pkgCache::State::PkgSelectedState

AptPkg::State::Unknown, AptPkg::State::Install, AptPkg::State::Hold, AptPkg::State::DeInstall and AptPkg::State::Purge.

pkgCache::State::PkgInstState

AptPkg::State::Ok, AptPkg::State::ReInstReq, AptPkg::State::HoldInst and AptPkg::State::HoldReInstReq.

pkgCache::State::PkgCurrentState

AptPkg::State::NotInstalled, AptPkg::State::UnPacked, AptPkg::State::HalfConfigured, AptPkg::State::HalfInstalled, AptPkg::State::ConfigFiles and AptPkg::State::Installed.

pkgCache::Flag::PkgFlags

AptPkg::Flag::Auto, AptPkg::Flag::Essential and AptPkg::Flag::Important.

SEE ALSO

AptPkg::Config(3pm), AptPkg::System(3pm), AptPkg::Version(3pm), AptPkg::Cache(3pm), AptPkg::Source(3pm).

AUTHOR

Brendan O'Dea <bod@debian.org>