177 lines
5.4 KiB
HTML
177 lines
5.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of Dpkg::Vendor::Default</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>Dpkg::Vendor::Default</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"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
Dpkg::Vendor::Default - default vendor object
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
|
|
|
|
A vendor object is used to provide vendor specific behaviour
|
|
in various places. This is the default object used in case
|
|
there's none for the current vendor or in case the vendor could
|
|
not be identified (see Dpkg::Vendor documentation).
|
|
<P>
|
|
|
|
It provides some hooks that are called by various dpkg-* tools.
|
|
If you need a new hook, please file a bug against dpkg-dev and explain
|
|
your need. Note that the hook <FONT SIZE="-1">API</FONT> has no guarantee to be stable over an
|
|
extended period of time. If you run an important distribution that makes
|
|
use of vendor hooks, you'd better submit them for integration so that
|
|
we avoid breaking your code.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>METHODS</H2>
|
|
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="1">$vendor_obj = Dpkg::Vendor::Default-><B>new()</B><DD>
|
|
|
|
|
|
|
|
|
|
Creates the default vendor object. Can be inherited by all vendor objects
|
|
if they don't need any specific initialization at object creation time.
|
|
<DT id="2">$vendor_obj->run_hook($id, @params)<DD>
|
|
|
|
|
|
|
|
|
|
Run the corresponding hook. The parameters are hook-specific. The
|
|
supported hooks are:
|
|
<DL COMPACT><DT id="3"><DD>
|
|
<DL COMPACT>
|
|
<DT id="4">before-source-build ($srcpkg)<DD>
|
|
|
|
|
|
The first parameter is a Dpkg::Source::Package object. The hook is called
|
|
just before the execution of <TT>$srcpkg</TT>-><B>build()</B>.
|
|
<DT id="5">package-keyrings ()<DD>
|
|
|
|
|
|
The hook is called when dpkg-source is checking a signature on a source
|
|
package (since dpkg 1.18.11). It takes no parameters, but returns a
|
|
(possibly empty) list of vendor-specific keyrings.
|
|
<DT id="6">archive-keyrings ()<DD>
|
|
|
|
|
|
The hook is called when there is a need to check signatures on artifacts
|
|
from repositories, for example by a download method (since dpkg 1.18.11).
|
|
It takes no parameters, but returns a (possibly empty) list of
|
|
vendor-specific keyrings.
|
|
<DT id="7">archive-keyrings-historic ()<DD>
|
|
|
|
|
|
The hook is called when there is a need to check signatures on artifacts
|
|
from historic repositories, for example by a download method
|
|
(since dpkg 1.18.11). It takes no parameters, but returns a (possibly empty)
|
|
list of vendor-specific keyrings.
|
|
<DT id="8">builtin-build-depends ()<DD>
|
|
|
|
|
|
The hook is called when dpkg-checkbuilddeps is initializing the source
|
|
package build dependencies (since dpkg 1.18.2). It takes no parameters,
|
|
but returns a (possibly empty) list of vendor-specific <B>Build-Depends</B>.
|
|
<DT id="9">builtin-build-conflicts ()<DD>
|
|
|
|
|
|
The hook is called when dpkg-checkbuilddeps is initializing the source
|
|
package build conflicts (since dpkg 1.18.2). It takes no parameters,
|
|
but returns a (possibly empty) list of vendor-specific <B>Build-Conflicts</B>.
|
|
<DT id="10">register-custom-fields ()<DD>
|
|
|
|
|
|
The hook is called in Dpkg::Control::Fields to register custom fields.
|
|
You should return a list of arrays. Each array is an operation to perform.
|
|
The first item is the name of the operation and corresponds
|
|
to a field_* function provided by Dpkg::Control::Fields. The remaining
|
|
fields are the parameters that are passed unchanged to the corresponding
|
|
function.
|
|
|
|
|
|
<P>
|
|
|
|
|
|
Known operations are ``register'', ``insert_after'' and ``insert_before''.
|
|
<DT id="11">post-process-changelog-entry ($fields)<DD>
|
|
|
|
|
|
The hook is called in Dpkg::Changelog to post-process a
|
|
Dpkg::Changelog::Entry after it has been created and filled with the
|
|
appropriate values.
|
|
<DT id="12">update-buildflags ($flags)<DD>
|
|
|
|
|
|
The hook is called in Dpkg::BuildFlags to allow the vendor to override
|
|
the default values set for the various build flags. <TT>$flags</TT> is a
|
|
Dpkg::BuildFlags object.
|
|
<DT id="13">builtin-system-build-paths ()<DD>
|
|
|
|
|
|
The hook is called by dpkg-genbuildinfo to determine if the current path
|
|
should be recorded in the <B>Build-Path</B> field (since dpkg 1.18.11). It takes
|
|
no parameters, but returns a (possibly empty) list of root paths considered
|
|
acceptable. As an example, if the list contains ``/build/'', a Build-Path
|
|
field will be created if the current directory is ``/build/dpkg-1.18.0''. If
|
|
the list contains ``/'', the path will always be recorded. If the list is
|
|
empty, the current path will never be recorded.
|
|
<DT id="14">build-tainted-by ()<DD>
|
|
|
|
|
|
The hook is called by dpkg-genbuildinfo to determine if the current system
|
|
has been tainted in some way that could affect the resulting build, which
|
|
will be recorded in the <B>Build-Tainted-By</B> field (since dpkg 1.19.5). It
|
|
takes no parameters, but returns a (possibly empty) list of tainted reason
|
|
tags (formed by alphanumeric and dash characters).
|
|
</DL>
|
|
</DL>
|
|
|
|
<DL COMPACT><DT id="15"><DD>
|
|
</DL>
|
|
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CHANGES</H2>
|
|
|
|
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H3>Version 0.xx</H3>
|
|
|
|
|
|
|
|
This is a private module.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="16"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="17"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="18"><A HREF="#lbAD">METHODS</A><DD>
|
|
<DT id="19"><A HREF="#lbAE">CHANGES</A><DD>
|
|
<DL>
|
|
<DT id="20"><A HREF="#lbAF">Version 0.xx</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>
|