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)