PKG.M4(7) Miscellaneous Information Manual PKG.M4(7)

# [NAME](#NAME)

`pkg.m4` — autoconf macros for using pkgconf

# [SYNOPSIS](#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](#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](#AUTOCONF_MACROS)

## [PKG\_PREREQ(MIN-VERSION)](#PKG_PREREQ%28MIN-VERSION%29)

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\])](#PKG_PROG_PKG_CONFIG%28_MIN-VERSION_%29)

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%28VARIABLE-PREFIX,_MODULES__,ACTION-IF-FOUND__,ACTION-IF-NOT-FOUND__%29)

## [PKG\_CHECK\_MODULES\_STATIC(VARIABLE-PREFIX, MODULES \[,ACTION-IF-FOUND \[,ACTION-IF-NOT-FOUND\]\])](#PKG_CHECK_MODULES_STATIC%28VARIABLE-PREFIX,_MODULES__,ACTION-IF-FOUND__,ACTION-IF-NOT-FOUND__%29)

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)](#PKG_INSTALLDIR%28DIRECTORY%29)

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)](#PKG_NOARCH_INSTALLDIR%28DIRECTORY%29)

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\])](#PKG_CHECK_VAR%28VARIABLE,_MODULE,_CONFIG-VARIABLE,__ACTION-IF-FOUND_,__ACTION-IF-NOT-FOUND_%29)

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\])](#PKG_WITH_MODULES%28VARIABLE-PREFIX,_MODULES,__ACTION-IF-FOUND_,_ACTION-IF-NOT-FOUND_,__DESCRIPTION_,__DEFAULT_%29)

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\])](#PKG_HAVE_WITH_MODULES%28VARIABLE-PREFIX,_MODULES,__DESCRIPTION_,__DEFAULT_%29)

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\])](#PKG_HAVE_DEFINE_WITH_MODULES%28VARIABLE-PREFIX,_MODULES,__DESCRIPTION_,__DEFAULT_%29)

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 Linux 4.19.0-gvisor

---

Document: pkg.m4(7) from pkgconf 3.0.7-r0 (Chainguard OS)
Source: https://github.com/pkgconf/pkgconf