NAME

       pkgconf — a system for configuring build dependency information

SYNOPSIS

       pkgconf [options] [list of modules]

DESCRIPTION

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

ENVIRONMENT

       PKG_CONFIG_PATH
               List of directories where ‘.pc’ files are looked up.

       PKG_CONFIG_SYSROOT_DIR
               ‘sysroot’ directory, will be prepended to every path  defined  in  PKG_CONFIG_PATH.   Useful  for
               cross compilation.

EXAMPLES

       Displaying the CFLAGS of a package:
             $ pkgconf --cflags foo
             -fPIC -I/usr/include/foo

Debian                                          February 2, 2015                                      PKGCONF(1)