PKG.M4

Section: Environments, Tables, and Troff Macros (7)
Index Return to Main Contents

---

BSD mandoc
 

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_PREREQ 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(MI-VERSION)

Checks that the version of the PKG_PREREQ autoconf macros in use is at least MI-VERSION. This can be used to ensure a particular PKG_PREREQ macro will be available.  

PKG_PROG_PKG_CONFIG([MI-VERSION])

Checks for an implementation of pk-config which is at least MI-VERSION or newer.  

PKG_CHECK_MODULES(VARIABL-PREFIX, MODULES [,ACTIO-I-FOUND [,ACTIO-I-NO-FOUND]])

 

PKG_CHECK_MODULES_STATIC(VARIABL-PREFIX, MODULES [,ACTIO-I-FOUND [,ACTIO-I-NO-FOUND]])

Checks whether a given module set exists, and if so, defines CFLAGS and LIBS variables prefixed by VARIABL-PREFIX with the output from --cflags and --libs respectively.

The optional ACTIO-I-FOUND and ACTIO-I-NO-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 pk-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 pk-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 --wit-pkgconfigdir configure parameter.  

PKG_NOARCH_INSTALLDIR(DIRECTORY)

Defines the variable $noarch_pkgconfigdir as the location where a package should install pk-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 --wit-noarc-pkgconfigdir configure parameter.  

PKG_CHECK_VAR(VARIABLE, MODULE, CONFI-VARIABLE, [ACTIO-I-FOUND], [ACTIO-I-NO-FOUND])

Retrieves the value of the pk-config variable CONFI-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(VARIABL-PREFIX, MODULES, [ACTIO-I-FOUND],[ACTIO-I-NO-FOUND], [DESCRIPTION], [DEFAULT])

Prepares a "-wit-" configure option using the lowercase VARIABL-PREFIX name, merging the behaviour of AC_ARG_WITH and PKG_CHECK_MODULES in a single macro.  

PKG_HAVE_WITH_MODULES(VARIABL-PREFIX, MODULES, [DESCRIPTION], [DEFAULT])

Convenience macro to trigger AM_CONDITIONAL after a PKG_WITH_MODULES check. VARIABL-PREFIX is exported as a make variable.  

PKG_HAVE_DEFINE_WITH_MODULES(VARIABL-PREFIX, MODULES, [DESCRIPTION], [DEFAULT])

Convenience macro to trigger AM_CONDITIONAL and AC_DEFINE after a PKG_WITH_MODULES check. VARIABL-PREFIX is exported as a make variable.

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

AUTOCONF MACROS

PKG_PREREQ(MIN-VERSION)

PKG_PROG_PKG_CONFIG([MIN-VERSION])

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]])

PKG_INSTALLDIR(DIRECTORY)

PKG_NOARCH_INSTALLDIR(DIRECTORY)

PKG_CHECK_VAR(VARIABLE, MODULE, CONFIG-VARIABLE, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])

PKG_WITH_MODULES(VARIABLE-PREFIX, MODULES, [ACTION-IF-FOUND],[ACTION-IF-NOT-FOUND], [DESCRIPTION], [DEFAULT])

PKG_HAVE_WITH_MODULES(VARIABLE-PREFIX, MODULES, [DESCRIPTION], [DEFAULT])

PKG_HAVE_DEFINE_WITH_MODULES(VARIABLE-PREFIX, MODULES, [DESCRIPTION], [DEFAULT])