NAME¶
pkg.m4 —
autoconf macros for using pkgconf
SYNOPSIS¶
PKG_HAVE_DEFINE_WITH_MODULES |
|
DESCRIPTION¶
pkg.m4 is a collection of autoconf macros which help to
configure compiler and linker flags for development libraries. This allows
build systems to detect other dependencies and use them with the system
toolchain.
AUTOCONF MACROS¶
PKG_PREREQ(MIN-VERSION)¶
Checks that the version of the pkg.m4 autoconf macros in
use is at least MIN-VERSION. This can be used to ensure a particular
pkg.m4 macro will be available.
PKG_PROG_PKG_CONFIG([MIN-VERSION])¶
Checks for an implementation of pkg-config which is at
least MIN-VERSION or newer.
PKG_CHECK_MODULES(VARIABLE-PREFIX, MODULES [,ACTION-IF-FOUND [,ACTION-IF-NOT-FOUND]])¶
PKG_CHECK_MODULES_STATIC(VARIABLE-PREFIX, MODULES [,ACTION-IF-FOUND [,ACTION-IF-NOT-FOUND]])¶
Checks whether a given module set exists, and if so, defines
CFLAGS and LIBS variables
prefixed by VARIABLE-PREFIX with the output from
--cflags and --libs
respectively.
The optional ACTION-IF-FOUND and
ACTION-IF-NOT-FOUND arguments are shell fragments
that should be executed if the module set is found or not found.
If $PKG_CONFIG is not defined, the
PKG_PROG_PKG_CONFIG macro will be executed to locate
a pkg-config implementation.
The PKG_CHECK_MODULES_STATIC macro
provides the same behaviour as PKG_CHECK_MODULES
with static linking enabled via the --static
flag.
PKG_INSTALLDIR(DIRECTORY)¶
Defines the variable $pkgconfigdir as the location where a package should
install pkg-config .pc files.
By default the directory is $libdir/pkgconfig, but the default can
be changed by passing the DIRECTORY parameter.
This value can be overriden with the
--with-pkgconfigdir configure parameter.
PKG_NOARCH_INSTALLDIR(DIRECTORY)¶
Defines the variable $noarch_pkgconfigdir as the location where a package should
install pkg-config .pc files.
By default the directory is $datadir/pkgconfig, but the default
can be changed by passing the DIRECTORY
parameter.
This value can be overriden with the
--with-noarch-pkgconfigdir configure parameter.
PKG_CHECK_VAR(VARIABLE, MODULE, CONFIG-VARIABLE, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])¶
Retrieves the value of the pkg-config variable
CONFIG-VARIABLE from MODULE
and stores it in the VARIABLE variable.
Note that repeated usage of VARIABLE is
not recommended as the check will be skipped if the variable is already
set.
PKG_WITH_MODULES(VARIABLE-PREFIX, MODULES, [ACTION-IF-FOUND],[ACTION-IF-NOT-FOUND], [DESCRIPTION], [DEFAULT])¶
Prepares a "--with-" configure option using the lowercase
VARIABLE-PREFIX name, merging the behaviour of
AC_ARG_WITH and
PKG_CHECK_MODULES in a single macro.
PKG_HAVE_WITH_MODULES(VARIABLE-PREFIX, MODULES, [DESCRIPTION], [DEFAULT])¶
Convenience macro to trigger AM_CONDITIONAL after a
PKG_WITH_MODULES check.
VARIABLE-PREFIX is exported as a make variable.
PKG_HAVE_DEFINE_WITH_MODULES(VARIABLE-PREFIX, MODULES, [DESCRIPTION], [DEFAULT])¶
Convenience macro to trigger AM_CONDITIONAL and
AC_DEFINE after a PKG_WITH_MODULES
check. VARIABLE-PREFIX is exported as a make
variable.
