man-pages/man3/Dpkg::Deps::KnownFacts.3perl.html
2021-03-31 01:06:50 +01:00

128 lines
3.2 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of Dpkg::Deps::KnownFacts</TITLE>
</HEAD><BODY>
<H1>Dpkg::Deps::KnownFacts</H1>
Section: libdpkg-perl (3perl)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
Dpkg::Deps::KnownFacts - list of installed real and virtual packages
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>
This object represents a list of installed packages and a list of virtual
packages provided (by the set of installed packages).
<A NAME="lbAD">&nbsp;</A>
<H2>METHODS</H2>
<DL COMPACT>
<DT id="1">$facts = Dpkg::Deps::KnownFacts-&gt;<B>new()</B>;<DD>
Creates a new object.
<DT id="2">$facts-&gt;add_installed_package($package, $version, $arch, $multiarch)<DD>
Records that the given version of the package is installed. If
<TT>$version</TT>/$arch is undefined we know that the package is installed but we
don't know which version/architecture it is. <TT>$multiarch</TT> is the Multi-Arch
field of the package. If <TT>$multiarch</TT> is undef, it will be equivalent to
``Multi-Arch: no''.
<P>
Note that <TT>$multiarch</TT> is only used if <TT>$arch</TT> is provided.
<DT id="3">$facts-&gt;add_provided_package($virtual, $relation, $version, $by)<DD>
Records that the ``$by'' package provides the <TT>$virtual</TT> package. <TT>$relation</TT>
and <TT>$version</TT> correspond to the associated relation given in the Provides
field (if present).
<DT id="4">($check, $param) = $facts-&gt;check_package($package)<DD>
<TT>$check</TT> is one when the package is found. For a real package, <TT>$param</TT>
contains the version. For a virtual package, <TT>$param</TT> contains an array
reference containing the list of packages that provide it (each package is
listed as [ <TT>$provider</TT>, <TT>$relation</TT>, <TT>$version</TT> ]).
<P>
This function is obsolete and should not be used. Dpkg::Deps::KnownFacts
is only meant to be filled with data and then passed to Dpkg::Deps
methods where appropriate, but it should not be directly queried.
<DT id="5">$facts-&gt;<B>evaluate_simple_dep()</B><DD>
This method is private and should not be used except from within Dpkg::Deps.
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>CHANGES</H2>
<A NAME="lbAF">&nbsp;</A>
<H3>Version 1.01 (dpkg 1.16.1)</H3>
New option: Dpkg::Deps::KnownFacts-&gt;<B>add_installed_package()</B> now accepts 2
supplementary parameters ($arch and <TT>$multiarch</TT>).
<P>
Deprecated method: Dpkg::Deps::KnownFacts-&gt;<B>check_package()</B> is obsolete,
it should not have been part of the public <FONT SIZE="-1">API.</FONT>
<A NAME="lbAG">&nbsp;</A>
<H3>Version 1.00 (dpkg 1.15.6)</H3>
Mark the module as public.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="6"><A HREF="#lbAB">NAME</A><DD>
<DT id="7"><A HREF="#lbAC">DESCRIPTION</A><DD>
<DT id="8"><A HREF="#lbAD">METHODS</A><DD>
<DT id="9"><A HREF="#lbAE">CHANGES</A><DD>
<DL>
<DT id="10"><A HREF="#lbAF">Version 1.01 (dpkg 1.16.1)</A><DD>
<DT id="11"><A HREF="#lbAG">Version 1.00 (dpkg 1.15.6)</A><DD>
</DL>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:39 GMT, March 31, 2021
</BODY>
</HTML>