dpkg::buildflags(3) [linux 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 directives stored in the environment. See dpkg-buildflags(1) for details.

       $bf->load_config()
	   Call successively load_system_config(), load_user_config() and load_environment_config() to update the default build flags defined by
	   the vendor.

       $bf->set($flag, $value, $source)
	   Update the build flag $flag with value $value and record its origin as $source.

       $bf->append($flag, $value, $source)
	   Append the options listed in $value to the current value of the flag $flag.	Record its origin as $source.

       $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_origin($flag)
	   Return the origin associated to the flag. It might be undef if the flag doesn't exist.

       $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.

AUTHOR

       Raphael Hertzog <hertzog@debian.org>

1.16.0.3							    2012-04-17						       Dpkg::BuildFlags(3)

Dpkg::BuildOptions(3)						   libdpkg-perl 					     Dpkg::BuildOptions(3)

NAME

       Dpkg::BuildOptions - parse and update build options

DESCRIPTION

       The Dpkg::BuildOptions object can be used to manipulate options stored in environment variables like DEB_BUILD_OPTIONS and
       DEB_BUILD_MAINT_OPTIONS.

FUNCTIONS

       my $bo = Dpkg::BuildOptions->new(%opts)
	   Create a new Dpkg::BuildOptions object. It will be initialized based on the value of the environment variable named $opts{'envvar'} (or
	   DEB_BUILD_OPTIONS if that option is not set).

       $bo->reset()
	   Reset the object to not have any option (it's empty).

       $bo->merge($content, $source)
	   Merge the options set in $content and record that they come from the source $source. $source is mainly used in warning messages
	   currently to indicate where invalid options have been detected.

	   $content is a space separated list of options with optional assigned values like "nocheck parallel=2".

       $bo->set($option, $value, [$source])
	   Store the given option in the objet with the given value. It's legitimate for a value to be undefined if the option is a simple boolean
	   (its presence means true, its absence means false). The $source is optional and indicates where the option comes from.

	   The known options have their values checked for sanity. Options without values have their value removed and options with invalid values
	   are discarded.

       $bo->get($option)
	   Return the value associated to the option. It might be undef even if the option exists. You might want to check with $bo->has($option)
	   to verify if the option is stored in the object.

       $bo->has($option)
	   Returns a boolean indicating whether the option is stored in the object.

       $string = $bo->output($fh)
	   Return a string representation of the build options suitable to be assigned to an environment variable. Can optionnaly output that
	   string to the given filehandle.

       $bo->export([$var])
	   Export the build options to the given environment variable. If omitted, the environment variable defined at creation time is assumed.
	   The value set to the variable is also returned.

CHANGES

   Version 1.01
       Enable to use another environment variable instead of DEB_BUILD_OPTIONS.  Thus add support for the "envvar" option at creation time.

AUTHOR

       Raphael Hertzog <hertzog@debian.org>

1.16.15 							    2014-06-05						     Dpkg::BuildOptions(3)