SYNOPSIS

[options ] [list of modules ]

DESCRIPTION

is a program which helps to configure compiler and linker flags for development frameworks. This allows build systems to detect other dependencies and use them with the system toolchain.

GENERAL OPTIONS

--version

Display the supported pkg-config version and exit.

--atleast-pkgconfig-version = VERSION

Exit with error if we do not support the requested pkg-config version.

--errors-to-stdout

Print all errors on the main output stream instead of the error output stream.

--silence-errors

Do not display any errors at all.

--list-all

Walk all directories listed in the PKG_CONFIG_PATH environmental variable and display information on packages which have registered information there.

--simulate

Simulates resolving a dependency graph based on the requested modules on the command line. Dumps a series of trees denoting pkgconf's resolver state.

--no-cache

Skip caching packages when they are loaded into the internal resolver. This may result in an alternate dependency graph being computed.

--ignore-conflicts

Ignore `Conflicts' rules in modules.

--env-only

Learn about pkgconf's configuration strictly from environmental variables.

--maximum-traverse-depth = DEPTH

Impose a limit on the allowed depth in the dependency graph. For example, a depth of 2 will restrict the resolver from acting on child dependencies of modules added to the resolver's solution.

--static

Compute a deeper dependency graph and use compiler/linker flags intended for static linking.

MODULE-SPECIFIC OPTIONS

--atleast-version = VERSION

Exit with error if a module's version is less than the specified version.

--exact-version = VERSION

Exit with error if a module's version is not exactly the specified version.

--max-version = VERSION

Exit with error if a module's version is greater than the specified version.

--exists

Exit with a non-zero result if the dependency resolver was able to find all of the requested modules.

--uninstalled

Exit with a non-zero result if the dependency resolver uses an `uninstalled' module as part of it's solution.

--no-uninstalled

Forbids the dependency resolver from considering 'uninstalled' modules as part of a solution.

QUERY-SPECIFIC OPTIONS

--cflags , --cflags-only-I , --cflags-only-other

Display either all CFLAGS, only -I CFLAGS or only CFLAGS that are not -I

--libs , --libs-only-L , --libs-only-l , --libs-only-other

Display either all linker flags, only -L linker flags, only -l linker flags or only linker flags that are not -L or -l

--keep-system-cflags , --keep-system-libs

Keep CFLAGS or linker flag fragments that would be filtered due to being included by default in the compiler.

--define-variable = VARNAME = VALUE

Define VARNAME as VALUE Variables are used in query output, and some modules' results may change based on the presence of a variable definition.

--print-variables

Print all seen variables for a module to the output channel.

--variable = VARNAME

Print the value of VARNAME

--print-requires , --print-requires-private

Print the modules included in either the Requires field or the Requires.private field.

--digraph

Dump the dependency resolver's solution as a graphviz `dot' file. This can be used with graphviz to visualize module interdependencies.

EXAMPLES

Displaying the CFLAGS of a package:

$ pkgconf --cflags foo

-fPIC -I/usr/include/foo