Dpkg::Conf.3perl - Man Page

The Dpkg::Conf object can be used to read options from a configuration file. It can export an array that can then be parsed exactly like @ARGV.

$conf = Dpkg::Conf->new(%opts)

Create a new Dpkg::Conf object.

Options:

allow_short

If set to true (it defaults to false), then short options are allowed in the configuration file, they should be prepended with a single hyphen.

@$conf

@options = $conf->get_options()

Returns the list of options that can be parsed like @ARGV.

$conf->load($file)

Read options from a file. Return the number of options parsed.

$conf->load_system_config($file)

Read options from a system configuration file.

Return the number of options parsed.

$conf->load_user_config($file)

Read options from a user configuration file. It will try to use the XDG directory, either $XDG_CONFIG_HOME/dpkg/ or $HOME/.config/dpkg/.

Return the number of options parsed.

$conf->load_config($file)

Read options from system and user configuration files.

Return the number of options parsed.

$conf->parse($fh)

Parse options from a file handle. When called multiple times, the parsed options are accumulated.

Return the number of options parsed.

$conf->filter(%opts)

Filter the list of configuration options.

Options:

remove

A function returning a boolean, used to decide whether to remove the configuration option, executed as $opts{remove}->($option).

keep

A function returning a boolean, used to decide whether to keep the configuration option, executed as $opts{keep}->($option).

$string = $conf->output([$fh])

Write the options in the given filehandle (if defined) and return a string representation of the content (that would be) written.

"$conf"

Return a string representation of the content.

$conf->save($file)

Save the options in a file.