LinuxCommandLibrary

pacconf

Query pacman configuration files

TLDR

Show full parsed pacman configuration

$ pacconf
copy

List configured repositories
$ pacconf --repo-list
copy

Always show directive names even if only one directive is provided
$ pacconf --verbose [directive]
copy

Display only first value of multi-value options
$ pacconf --single
copy

Display help
$ pacconf --help
copy

Display version
$ pacconf --version
copy

SYNOPSIS

pacconf [-s|--show]
pacconf [-f path|--file path]
pacconf [-h|--help]
pacconf [-v|--version]

PARAMETERS

-s, --show
    Displays the currently active pacman configuration, parsed from /etc/pacman.conf and any files included via Include directives. This is the default behavior if no other option like --file is specified.

-f path, --file path
    Specifies an alternative configuration file to parse and display. This allows users to inspect configurations without modifying the live system's /etc/pacman.conf. The output will reflect the parsed content of the specified file, including its Include directives.

-h, --help
    Shows a brief help message and exits.

-v, --version
    Displays version information for pacconf and exits.

DESCRIPTION

pacconf is a utility included with the pacman-contrib package on Arch Linux and its derivatives. Its primary function is to inspect and display the configuration used by the pacman package manager. Unlike directly viewing pacman.conf, pacconf parses the configuration files, including any Include directives, to show the active configuration that pacman would use. This makes it an invaluable tool for troubleshooting pacman behavior, verifying repository setups, or understanding how different configuration snippets are combined.

It can display the live configuration or parse and show the configuration from a specified file, aiding in debugging custom or alternative pacman setups without affecting the live system. It's particularly useful when dealing with complex configurations spread across multiple files.

CAVEATS

pacconf does not modify configuration files; it only reads and displays them.
It relies on the pacman configuration parsing logic, so its output accurately reflects what pacman would see.
pacconf is typically part of the pacman-contrib package, which might need to be installed separately from pacman itself on some systems.

CONFIGURATION PARSING

pacconf is unique in that it performs a full parsing of the configuration, including Include = directives. This means if your pacman.conf includes other files (e.g., for custom repositories or mirror lists), pacconf will resolve and display the final, consolidated configuration as pacman would interpret it, providing a complete and accurate picture of your effective package manager settings.

HISTORY

pacconf is part of the pacman-contrib package, which bundles various helper scripts and utilities for pacman. Its development has generally mirrored the evolution of pacman itself, providing supplementary tools to manage and inspect the package manager's behavior, particularly concerning its configuration files. It has been a stable component for users seeking deeper insight into their pacman setup.

SEE ALSO

pacman(8), pacman.conf(5)

Copied to clipboard