[MAN] Dpkg::Conf

Content-type: text/html; charset=UTF-8

Dpkg::Conf

Section: libdpkg-perl (3perl)
Updated: 2022-05-25
Index Return to Main Contents

---

 

NAME

Dpkg::Conf - parse dpkg configuration files  

DESCRIPTION

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.  

METHODS

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

Create a new Dpkg::Conf object. Some options can be set through %opts: if allow_short evaluates 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.

get()

set()

Obsolete functions, use get_options() instead. They will croak.

$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 options, either removing or keeping all those that return true when $opts{remove}->($option) or $opts{keep}->($option) is called.

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

 

CHANGES

 

Version 1.03 (dpkg 1.18.8)

Obsolete option: 'format_argv' in $conf->filter().

Obsolete methods: $conf->get(), $conf->set().

New methods: $conf->load_system_config(), $conf->load_system_user(), $conf->load_config().  

Version 1.02 (dpkg 1.18.5)

New option: Accept new option 'format_argv' in $conf->filter().

New methods: $conf->get(), $conf->set().  

Version 1.01 (dpkg 1.15.8)

New method: $conf->filter()  

Version 1.00 (dpkg 1.15.6)

Mark the module as public.

---

 

Index

NAME

DESCRIPTION

METHODS

CHANGES

Version 1.03 (dpkg 1.18.8)

Version 1.02 (dpkg 1.18.5)

Version 1.01 (dpkg 1.15.8)

Version 1.00 (dpkg 1.15.6)

---

This document was created by man2html, using the manual pages.
Time: 04:45:45 GMT, September 16, 2022