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¶
Raphaël Hertzog <hertzog@debian.org>