Dpkg::Vendor::Default(3) libdpkg-perl Dpkg::Vendor::Default(3)NAME
Dpkg::Vendor::Default - default vendor object
DESCRIPTION
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).
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 API has no guaranty to be stable over an extended period. 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.
FUNCTIONS
$vendor_obj = Dpkg::Vendor::Default->new()
Creates the default vendor object. Can be inherited by all vendor objects if they don't need any specific initialization at object
creation time.
$vendor_obj->run_hook($id, @params)
Run the corresponding hook. The parameters are hook-specific. The supported hooks are:
before-source-build ($srcpkg)
The first parameter is a Dpkg::Source::Package object. The hook is called just before the execution of $srcpkg->build().
keyrings ()
The hook is called when dpkg-source is checking a signature on a source package. It takes no parameters, but returns a
(possibly empty) list of vendor-specific keyrings.
register-custom-fields ()
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.
Known operations are "register", "insert_after" and "insert_before".
post-process-changelog-entry ($fields)
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.
update-buildflags ($flags)
The hook is called in Dpkg::BuildFlags to allow the vendor to override the default values set for the various build flags.
$flags is a Dpkg::BuildFlags object.
1.16.0.3 2012-04-17 Dpkg::Vendor::Default(3)
Check Out this Related Man Page
Dpkg::BuildFlags(3) libdpkg-perl Dpkg::BuildFlags(3)NAME
Dpkg::BuildFlags - query build flags
DESCRIPTION
The Dpkg::BuildFlags object is used by dpkg-buildflags and can be used to query the same information.
FUNCTIONS
my $bf = Dpkg::BuildFlags->new()
Create a new Dpkg::BuildFlags object. It will be initialized based on the value of several configuration files and environment
variables.
$bf->load_vendor_defaults()
Reset the flags stored to the default set provided by the vendor.
$bf->load_system_config()
Update flags from the system configuration.
$bf->load_user_config()
Update flags from the user configuration.
$bf->load_environment_config()
Update flags based on user directives stored in the environment. See dpkg-buildflags(1) for details.
$bf->load_maintainer_config()
Update flags based on maintainer directives stored in the environment. See dpkg-buildflags(1) for details.
$bf->load_config()
Call successively load_system_config(), load_user_config(), load_environment_config() and load_maintainer_config() to update the
default build flags defined by the vendor.
$bf->set($flag, $value, $source, $maint)
Update the build flag $flag with value $value and record its origin as $source (if defined). Record it as maintainer modified if $maint
is defined and true.
$bf->set_feature($area, $feature, $enabled)
Update the boolean state of whether a specific feature within a known feature area has been enabled. The only currently known feature
area is "hardening".
$bf->strip($flag, $value, $source, $maint)
Update the build flag $flag by stripping the flags listed in $value and record its origin as $source (if defined). Record it as
maintainer modified if $maint is defined and true.
$bf->append($flag, $value, $source, $maint)
Append the options listed in $value to the current value of the flag $flag. Record its origin as $source (if defined). Record it as
maintainer modified if $maint is defined and true.
$bf->prepend($flag, $value, $source, $maint)
Prepend the options listed in $value to the current value of the flag $flag. Record its origin as $source (if defined). Record it as
maintainer modified if $maint is defined and true.
$bf->update_from_conffile($file, $source)
Update the current build flags based on the configuration directives contained in $file. See dpkg-buildflags(1) for the format of the
directives.
$source is the origin recorded for any build flag set or modified.
$bf->get($flag)
Return the value associated to the flag. It might be undef if the flag doesn't exist.
$bf->get_feature_areas()
Return the feature areas (i.e. the area values has_features will return true for).
$bf->get_features($area)
Return, for the given area, a hash with keys as feature names, and values as booleans indicating whether the feature is enabled or not.
$bf->get_origin($flag)
Return the origin associated to the flag. It might be undef if the flag doesn't exist.
$bf->is_maintainer_modified($flag)
Return true if the flag is modified by the maintainer.
$bf->has_features($area)
Returns true if the given area of features is known, and false otherwise. The only currently recognized area is "hardening".
$bf->has($option)
Returns a boolean indicating whether the flags exists in the object.
my @flags = $bf->list()
Returns the list of flags stored in the object.
CHANGES
Version 1.01
New method: $bf->prepend() very similar to append(). Implement support of the prepend operation everywhere.
New method: $bf->load_maintainer_config() that update the build flags based on the package maintainer directives.
Version 1.02
New methods: $bf->get_features(), $bf->has_features(), $bf->set_feature().
Version 1.03
New method: $bf->get_feature_areas() to list possible values for $bf->get_features.
New method $bf->is_maintainer_modified() and new optional parameter to $bf->set(), $bf->append(), $bf->prepend(), $bf->strip().
AUTHOR
Raphael Hertzog <hertzog@debian.org>
1.16.15 2014-06-05 Dpkg::BuildFlags(3)