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, Policy, MultiArchCache
    and NativeArch.

AptPkg::Cache::_package

The AptPkg::Cache::_package package wraps a Perl class around the pkgCache::PkgIterator class. It exposes the following methods:
    Next, Name, FullName, Arch, 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, MultiArch, Arch, ParentPkg, DescriptionList,
    TranslatedDescription, 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::_description

The AptPkg::Cache::_description package wraps a Perl class around the pkgCache::DescIterator class. It exposes the following methods:
    LanguageCode, md5 and FileList.

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,
    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::_desc_file

The AptPkg::Cache::_desc_file package wraps a Perl class around the pkgCache::DescFileIterator class. It exposes the following methods:
    File

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 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::Version::VerMultiArch
"AptPkg::Version::No", "AptPkg::Version::All", "AptPkg::Version::Foreign", "AptPkg::Version::Same", "AptPkg::Version::Allowed", "AptPkg::Version::AllForeign" and "AptPkg::Version::AllAllowed".
pkgCache::Dep::DepType
"AptPkg::Dep::Depends", "AptPkg::Dep::PreDepends", "AptPkg::Dep::Suggests", "AptPkg::Dep::Recommends", "AptPkg::Dep::Conflicts", "AptPkg::Dep::Replaces", "AptPkg::Dep::Obsoletes" "AptPkg::Dep::DpkgBreaks" and "AptPkg::Dep::Enhances".
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", "AptPkg::State::Installed", "AptPkg::State::TriggersAwaited" and "AptPkg::State::TriggersPending".
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 <[email protected]>