PCONFIG(1)

NAME
pconfig - configuration querying utility

SYNOPSIS

pconfig [-h] [--version] [--debug] [-q] [-v] [--color BOOLEAN] [--config CONFIG_PATH] {classes,describe_class,uncollapsable,dump,configurables,dump-uncollapsed,package,world} ...

BASE OPTIONS

-h, --help
    show this help message and exit

--version
    show this program's version info and exit

--debug
    enable debugging checks

-q, --quiet
    suppress non-error messages

-v, --verbose
    show verbose output

--color BOOLEAN
    enable/disable color support

CONFIG OPTIONS

--config CONFIG_PATH
    use custom config or skip loading system config

SUBCOMMANDS

configuration related subcommands

  pconfig classes - list all classes referenced by the config

  Synopsis

pconfig classes [-h] [--debug] [-q] [-v] [--color BOOLEAN]

  Base Options

-h, --help
    show this help message and exit

--debug
    enable debugging checks

-q, --quiet
    suppress non-error messages

-v, --verbose
    show verbose output

--color BOOLEAN
    enable/disable color support

  pconfig describe_class - describe the arguments a class needs, how to use it in a config

  Synopsis

pconfig describe_class [-h] [--debug] [-q] [-v] [--color BOOLEAN] target_class

  Positional Arguments

target_class
    The class to inspect and output details about

  Base Options

-h, --help
    show this help message and exit

--debug
    enable debugging checks

-q, --quiet
    suppress non-error messages

-v, --verbose
    show verbose output

--color BOOLEAN
    enable/disable color support

  pconfig uncollapsable - show configuration objects that could not be collapsed/instantiated

  Synopsis

pconfig uncollapsable [-h] [--debug] [-q] [-v] [--color BOOLEAN]

  Base Options

-h, --help
    show this help message and exit

--debug
    enable debugging checks

-q, --quiet
    suppress non-error messages

-v, --verbose
    show verbose output

--color BOOLEAN
    enable/disable color support

  pconfig dump - dump the entire configuration

  Synopsis

pconfig dump [-h] [--debug] [-q] [-v] [--color BOOLEAN] [typename]

  Positional Arguments

typename
    if specified, limit output to just config directives of this type (defaults to showing all types)

  Base Options

-h, --help
    show this help message and exit

--debug
    enable debugging checks

-q, --quiet
    suppress non-error messages

-v, --verbose
    show verbose output

--color BOOLEAN
    enable/disable color support

  pconfig configurables - list registered configurables (may not be complete)

  Synopsis

pconfig configurables [-h] [--debug] [-q] [-v] [--color BOOLEAN] [typename]

  Positional Arguments

typename
    if specified, only output configurables of that type; else output all configurables

  Base Options

-h, --help
    show this help message and exit

--debug
    enable debugging checks

-q, --quiet
    suppress non-error messages

-v, --verbose
    show verbose output

--color BOOLEAN
    enable/disable color support

  pconfig dump-uncollapsed - dump the configuration in a raw, uncollapsed form

  Synopsis

pconfig dump-uncollapsed [-h] [--debug] [-q] [-v] [--color BOOLEAN]

  Base Options

-h, --help
    show this help message and exit

--debug
    enable debugging checks

-q, --quiet
    suppress non-error messages

-v, --verbose
    show verbose output

--color BOOLEAN
    enable/disable color support

  pconfig package - invoke a packages custom configuration scripts

  Synopsis

pconfig package [--domain DOMAIN] [-h] [--debug] [-q] [-v] [--color BOOLEAN] query [query ...]

  Positional Arguments

query
    restrictions/atoms; matching installed packages will be configured

  Config Options

--domain DOMAIN
    custom pkgcore domain to use for this operation

  Base Options

-h, --help
    show this help message and exit

--debug
    enable debugging checks

-q, --quiet
    suppress non-error messages

-v, --verbose
    show verbose output

--color BOOLEAN
    enable/disable color support

  pconfig world - inspect and modify the world file

  Synopsis

pconfig world [--domain DOMAIN] [-h] [--debug] [-q] [-v] [--color BOOLEAN] [-l] [-r REMOVE] [-a ADD]

  Config Options

--domain DOMAIN
    custom pkgcore domain to use for this operation

  Base Options

-h, --help
    show this help message and exit

--debug
    enable debugging checks

-q, --quiet
    suppress non-error messages

-v, --verbose
    show verbose output

--color BOOLEAN
    enable/disable color support

  Command Modes

These options are directives for what to do with the world file. You can do multiple operations in a single invocation. For example, you can have --add x11-wm/fluxbox --remove gnome-base/gnome -l to add fluxbox, remove gnome, and list the world file contents all in one call.

-l, --list
    List the current world file contents for this domain.

-r REMOVE, --remove REMOVE
    Remove an entry from the world file. Can be specified multiple times.

-a ADD, --add ADD
    Add an entry to the world file. Can be specified multiple times.

COPYRIGHT
2006-2019, pkgcore contributors