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.

EXAMPLES

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

                                          December 2013                                pkgconf(1)