table of contents
PKG.M4(7) | Miscellaneous Information Manual | PKG.M4(7) |
NAME¶
pkg.m4
— autoconf
macros for using pkgconf
SYNOPSIS¶
PKG_PREREQ |
PKG_PROG_PKG_CONFIG |
PKG_CHECK_MODULES |
PKG_CHECK_MODULES_STATIC |
PKG_INSTALLDIR |
PKG_NOARCH_INSTALLDIR |
PKG_CHECK_VAR |
PKG_WITH_MODULES |
PKG_HAVE_WITH_MODULES |
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 overridden 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 overridden 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.
December 5, 2017 | Debian |