dpkg::buildoptions(3)
NAME
Dpkg::BuildOptions - parse and update build options
DESCRIPTION
The Dpkg::BuildOptions object can be used to manipulate options stored
in the DEB_BUILD_OPTIONS environment variable.
FUNCTIONS
- my $bo = Dpkg::BuildOptions->new()
- Create a new Dpkg::BuildOptions object. It will be initialized
based on the value of the DEB_BUILD_OPTIONS environment variable. - $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, DEB_BUILD_OPTIONS is assumed. The value set to the
variable is also returned.
AUTHOR
- Raphal Hertzog <hertzog@debian.org>