Dpkg::Conf(3perl)

🌸 NAME 🌸

Dpkg::Conf — parse dpkg configuration files. This lil page is the manual page for Dpkg::Conf(3perl) from libdpkg-perl, and it's literally here to help you read options out of config files without losing your mind 💖.

🦋 DESCRIPTION 🦋

The Dpkg::Conf object lowkey lets you read options from a configuration file. It can export an array that can then be parsed exactly like @ARGV — so yes bestie, it slots right into your normal argument pipeline, no cap ✨.

👑 METHODS 👑

Here's the full method roster, no skips 💅:

• $conf = Dpkg::Conf->new(%opts) — create a new Dpkg::Conf object. Obsessed with fresh objects tbh 🎀.
  • allow_short — if set to true (it defaults to false), then short options are allowed in the configuration file, and they should be prepended with a single hyphen.
• @options = @{$conf} / @options = $conf->get_options() — returns the list of options that can be parsed like @ARGV.
• $count = $conf->load($file) — read options from a file. Returns the number of options parsed.
• $count = $conf->load_system_config($file) — read options from a system configuration file. Returns the number of options parsed.
• $count = $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/. Returns the number of options parsed.
• $conf->load_config($file) — read options from system and user configuration files. Returns the number of options parsed.
• $count = $conf->parse($fh) — parse options from a file handle. When called multiple times, the parsed options are accumulated. Returns 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" — returns a string representation of the content.
• $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->save($file) — save the options in a file.

🌀 CHANGES 🌀

The receipts, freshest first:

Version 1.04 (dpkg 1.20.0)

• Remove croak: For 'format_argv' in $conf->filter().
• Remove methods: $conf->get(), $conf->set().

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.

---

Sign-off: this is the Dpkg::Conf(3perl) page, version 1.23.11-dirty, dated 2026-09-09. Byeee bestie, go parse those options 💅🫶