1Dpkg::Vendor::Default(3perl)     libdpkg-perl     Dpkg::Vendor::Default(3perl)
2
3
4

NAME

6       Dpkg::Vendor::Default - default vendor class
7

DESCRIPTION

9       A vendor class is used to provide vendor specific behaviour in various
10       places. This is the default class used in case there's none for the
11       current vendor or in case the vendor could not be identified (see
12       Dpkg::Vendor documentation).
13
14       It provides some hooks that are called by various dpkg-* tools.  If you
15       need a new hook, please file a bug against dpkg-dev and explain your
16       need. Note that the hook API has no guarantee to be stable over an
17       extended period of time. If you run an important distribution that
18       makes use of vendor hooks, you'd better submit them for integration so
19       that we avoid breaking your code.
20

METHODS

22       $vendor_obj = Dpkg::Vendor::Default->new()
23           Creates the default vendor object. Can be inherited by all vendor
24           objects if they don't need any specific initialization at object
25           creation time.
26
27       $vendor_obj->run_hook($id, @params)
28           Run the corresponding hook. The parameters are hook-specific. The
29           supported hooks are:
30
31           before-source-build ($srcpkg)
32                   The first parameter is a Dpkg::Source::Package object. The
33                   hook is called just before the execution of
34                   $srcpkg->build().
35
36           package-keyrings ()
37                   The hook is called when dpkg-source is checking a signature
38                   on a source package (since dpkg 1.18.11). It takes no
39                   parameters, but returns a (possibly empty) list of vendor-
40                   specific keyrings.
41
42           archive-keyrings ()
43                   The hook is called when there is a need to check signatures
44                   on artifacts from repositories, for example by a download
45                   method (since dpkg 1.18.11).  It takes no parameters, but
46                   returns a (possibly empty) list of vendor-specific
47                   keyrings.
48
49           archive-keyrings-historic ()
50                   The hook is called when there is a need to check signatures
51                   on artifacts from historic repositories, for example by a
52                   download method (since dpkg 1.18.11). It takes no
53                   parameters, but returns a (possibly empty) list of vendor-
54                   specific keyrings.
55
56           builtin-build-depends ()
57                   The hook is called when dpkg-checkbuilddeps is initializing
58                   the source package build dependencies (since dpkg 1.18.2).
59                   It takes no parameters, but returns a (possibly empty) list
60                   of vendor-specific Build-Depends.
61
62           builtin-build-conflicts ()
63                   The hook is called when dpkg-checkbuilddeps is initializing
64                   the source package build conflicts (since dpkg 1.18.2). It
65                   takes no parameters, but returns a (possibly empty) list of
66                   vendor-specific Build-Conflicts.
67
68           register-custom-fields ()
69                   The hook is called in Dpkg::Control::Fields to register
70                   custom fields.  You should return a list of arrays. Each
71                   array is an operation to perform.  The first item is the
72                   name of the operation and corresponds to a field_* function
73                   provided by Dpkg::Control::Fields. The remaining fields are
74                   the parameters that are passed unchanged to the
75                   corresponding function.
76
77                   Known operations are "register", "insert_after" and
78                   "insert_before".
79
80           post-process-changelog-entry ($fields)
81                   The hook is called in Dpkg::Changelog to post-process a
82                   Dpkg::Changelog::Entry after it has been created and filled
83                   with the appropriate values.
84
85           update-buildflags ($flags)
86                   The hook is called in Dpkg::BuildFlags to allow the vendor
87                   to override the default values set for the various build
88                   flags. $flags is a Dpkg::BuildFlags object.
89
90           builtin-system-build-paths ()
91                   The hook is called by dpkg-genbuildinfo to determine if the
92                   current path should be recorded in the Build-Path field
93                   (since dpkg 1.18.11). It takes no parameters, but returns a
94                   (possibly empty) list of root paths considered acceptable.
95                   As an example, if the list contains "/build/", a Build-Path
96                   field will be created if the current directory is
97                   "/build/dpkg-1.18.0". If the list contains "/", the path
98                   will always be recorded. If the list is empty, the current
99                   path will never be recorded.
100
101           build-tainted-by ()
102                   The hook is called by dpkg-genbuildinfo to determine if the
103                   current system has been tainted in some way that could
104                   affect the resulting build, which will be recorded in the
105                   Build-Tainted-By field (since dpkg 1.19.5). It takes no
106                   parameters, but returns a (possibly empty) list of tainted
107                   reason tags (formed by alphanumeric and dash characters).
108
109           sanitize-environment ()
110                   The hook is called by dpkg-buildpackage to sanitize its
111                   build environment (since dpkg 1.20.0).
112
113           backport-version-regex ()
114                   The hook is called by dpkg-genchanges and dpkg-
115                   mergechangelog to determine the backport version string
116                   that should be specially handled as not an earlier than
117                   version or remapped so that it does not get considered as a
118                   pre-release (since dpkg 1.21.3).  The returned string is a
119                   regex with one capture group for the backport delimiter
120                   string, or undef if there is no regex.
121

CHANGES

123   Version 0.xx
124       This is a private module.
125
126
127
1281.21.8                            2022-06-05      Dpkg::Vendor::Default(3perl)
Impressum