Home | History | Annotate | Line # | Download | only in config
      1 # pkg.m4 - Macros to locate and utilise pkg-config.   -*- Autoconf -*-
      2 # serial 12 (pkg-config-0.29.2)
      3 
      4 dnl Copyright  2004 Scott James Remnant <scott (a] netsplit.com>.
      5 dnl Copyright  2012-2015 Dan Nicholson <dbn.lists (a] gmail.com>
      6 dnl
      7 dnl This program is free software; you can redistribute it and/or modify
      8 dnl it under the terms of the GNU General Public License as published by
      9 dnl the Free Software Foundation; either version 2 of the License, or
     10 dnl (at your option) any later version.
     11 dnl
     12 dnl This program is distributed in the hope that it will be useful, but
     13 dnl WITHOUT ANY WARRANTY; without even the implied warranty of
     14 dnl MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
     15 dnl General Public License for more details.
     16 dnl
     17 dnl You should have received a copy of the GNU General Public License
     18 dnl along with this program; if not, write to the Free Software
     19 dnl Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
     20 dnl 02111-1307, USA.
     21 dnl
     22 dnl As a special exception to the GNU General Public License, if you
     23 dnl distribute this file as part of a program that contains a
     24 dnl configuration script generated by Autoconf, you may include it under
     25 dnl the same distribution terms that you use for the rest of that
     26 dnl program.
     27 
     28 dnl PKG_PREREQ(MIN-VERSION)
     29 dnl -----------------------
     30 dnl Since: 0.29
     31 dnl
     32 dnl Verify that the version of the pkg-config macros are at least
     33 dnl MIN-VERSION. Unlike PKG_PROG_PKG_CONFIG, which checks the user's
     34 dnl installed version of pkg-config, this checks the developer's version
     35 dnl of pkg.m4 when generating configure.
     36 dnl
     37 dnl To ensure that this macro is defined, also add:
     38 dnl m4_ifndef([PKG_PREREQ],
     39 dnl     [m4_fatal([must install pkg-config 0.29 or later before running autoconf/autogen])])
     40 dnl
     41 dnl See the "Since" comment for each macro you use to see what version
     42 dnl of the macros you require.
     43 m4_defun([PKG_PREREQ],
     44 [m4_define([PKG_MACROS_VERSION], [0.29.2])
     45 m4_if(m4_version_compare(PKG_MACROS_VERSION, [$1]), -1,
     46     [m4_fatal([pkg.m4 version $1 or higher is required but ]PKG_MACROS_VERSION[ found])])
     47 ])dnl PKG_PREREQ
     48 
     49 dnl PKG_PROG_PKG_CONFIG([MIN-VERSION])
     50 dnl ----------------------------------
     51 dnl Since: 0.16
     52 dnl
     53 dnl Search for the pkg-config tool and set the PKG_CONFIG variable to
     54 dnl first found in the path. Checks that the version of pkg-config found
     55 dnl is at least MIN-VERSION. If MIN-VERSION is not specified, 0.9.0 is
     56 dnl used since that's the first version where most current features of
     57 dnl pkg-config existed.
     58 AC_DEFUN([PKG_PROG_PKG_CONFIG],
     59 [m4_pattern_forbid([^_?PKG_[A-Z_]+$])
     60 m4_pattern_allow([^PKG_CONFIG(_(PATH|LIBDIR|SYSROOT_DIR|ALLOW_SYSTEM_(CFLAGS|LIBS)))?$])
     61 m4_pattern_allow([^PKG_CONFIG_(DISABLE_UNINSTALLED|TOP_BUILD_DIR|DEBUG_SPEW)$])
     62 AC_ARG_VAR([PKG_CONFIG], [path to pkg-config utility])
     63 AC_ARG_VAR([PKG_CONFIG_PATH], [directories to add to pkg-config's search path])
     64 AC_ARG_VAR([PKG_CONFIG_LIBDIR], [path overriding pkg-config's built-in search path])
     65 
     66 if test "x$ac_cv_env_PKG_CONFIG_set" != "xset"; then
     67 	AC_PATH_TOOL([PKG_CONFIG], [pkg-config])
     68 fi
     69 if test -n "$PKG_CONFIG"; then
     70 	_pkg_min_version=m4_default([$1], [0.9.0])
     71 	AC_MSG_CHECKING([pkg-config is at least version $_pkg_min_version])
     72 	if $PKG_CONFIG --atleast-pkgconfig-version $_pkg_min_version; then
     73 		AC_MSG_RESULT([yes])
     74 	else
     75 		AC_MSG_RESULT([no])
     76 		PKG_CONFIG=""
     77 	fi
     78 fi[]dnl
     79 ])dnl PKG_PROG_PKG_CONFIG
     80 
     81 dnl PKG_CHECK_EXISTS(MODULES, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])
     82 dnl -------------------------------------------------------------------
     83 dnl Since: 0.18
     84 dnl
     85 dnl Check to see whether a particular set of modules exists. Similar to
     86 dnl PKG_CHECK_MODULES(), but does not set variables or print errors.
     87 dnl
     88 dnl Please remember that m4 expands AC_REQUIRE([PKG_PROG_PKG_CONFIG])
     89 dnl only at the first occurence in configure.ac, so if the first place
     90 dnl it's called might be skipped (such as if it is within an "if", you
     91 dnl have to call PKG_CHECK_EXISTS manually
     92 AC_DEFUN([PKG_CHECK_EXISTS],
     93 [AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl
     94 if test -n "$PKG_CONFIG" && \
     95     AC_RUN_LOG([$PKG_CONFIG --exists --print-errors "$1"]); then
     96   m4_default([$2], [:])
     97 m4_ifvaln([$3], [else
     98   $3])dnl
     99 fi])
    100 
    101 dnl _PKG_CONFIG([VARIABLE], [COMMAND], [MODULES])
    102 dnl ---------------------------------------------
    103 dnl Internal wrapper calling pkg-config via PKG_CONFIG and setting
    104 dnl pkg_failed based on the result.
    105 m4_define([_PKG_CONFIG],
    106 [if test -n "$$1"; then
    107     pkg_cv_[]$1="$$1"
    108  elif test -n "$PKG_CONFIG"; then
    109     PKG_CHECK_EXISTS([$3],
    110                      [pkg_cv_[]$1=`$PKG_CONFIG --[]$2 "$3" 2>/dev/null`
    111 		      test "x$?" != "x0" && pkg_failed=yes ],
    112 		     [pkg_failed=yes])
    113  else
    114     pkg_failed=untried
    115 fi[]dnl
    116 ])dnl _PKG_CONFIG
    117 
    118 dnl _PKG_SHORT_ERRORS_SUPPORTED
    119 dnl ---------------------------
    120 dnl Internal check to see if pkg-config supports short errors.
    121 AC_DEFUN([_PKG_SHORT_ERRORS_SUPPORTED],
    122 [AC_REQUIRE([PKG_PROG_PKG_CONFIG])
    123 if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
    124         _pkg_short_errors_supported=yes
    125 else
    126         _pkg_short_errors_supported=no
    127 fi[]dnl
    128 ])dnl _PKG_SHORT_ERRORS_SUPPORTED
    129 
    130 
    131 dnl PKG_CHECK_MODULES(VARIABLE-PREFIX, MODULES, [ACTION-IF-FOUND],
    132 dnl   [ACTION-IF-NOT-FOUND])
    133 dnl --------------------------------------------------------------
    134 dnl Since: 0.4.0
    135 dnl
    136 dnl Note that if there is a possibility the first call to
    137 dnl PKG_CHECK_MODULES might not happen, you should be sure to include an
    138 dnl explicit call to PKG_PROG_PKG_CONFIG in your configure.ac
    139 AC_DEFUN([PKG_CHECK_MODULES],
    140 [AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl
    141 AC_ARG_VAR([$1][_CFLAGS], [C compiler flags for $1, overriding pkg-config])dnl
    142 AC_ARG_VAR([$1][_LIBS], [linker flags for $1, overriding pkg-config])dnl
    143 
    144 pkg_failed=no
    145 AC_MSG_CHECKING([for $2])
    146 
    147 _PKG_CONFIG([$1][_CFLAGS], [cflags], [$2])
    148 _PKG_CONFIG([$1][_LIBS], [libs], [$2])
    149 
    150 dnl Check whether $pkg_cv_[]$1[]_LIBS works.
    151 if test $pkg_failed = no; then
    152   pkg_save_LDFLAGS="$LDFLAGS"
    153   LDFLAGS="$LDFLAGS $pkg_cv_[]$1[]_LIBS"
    154   AC_TRY_LINK([],[], [], [pkg_failed=yes])
    155   LDFLAGS=$pkg_save_LDFLAGS
    156 fi
    157 
    158 m4_define([_PKG_TEXT], [Alternatively, you may set the environment variables $1[]_CFLAGS
    159 and $1[]_LIBS to avoid the need to call pkg-config.
    160 See the pkg-config man page for more details.])
    161 
    162 if test $pkg_failed = yes; then
    163         AC_MSG_RESULT([no])
    164         _PKG_SHORT_ERRORS_SUPPORTED
    165         if test $_pkg_short_errors_supported = yes; then
    166 	        $1[]_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "$2" 2>&1`
    167         else
    168 	        $1[]_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "$2" 2>&1`
    169         fi
    170 	# Put the nasty error message in config.log where it belongs
    171 	echo "$$1[]_PKG_ERRORS" >&AS_MESSAGE_LOG_FD
    172 
    173 	m4_default([$4], [AC_MSG_ERROR(
    174 [Package requirements ($2) were not met:
    175 
    176 $$1_PKG_ERRORS
    177 
    178 Consider adjusting the PKG_CONFIG_PATH environment variable if you
    179 installed software in a non-standard prefix.
    180 
    181 _PKG_TEXT])[]dnl
    182         ])
    183 elif test $pkg_failed = untried; then
    184         AC_MSG_RESULT([no])
    185 	m4_default([$4], [AC_MSG_FAILURE(
    186 [The pkg-config script could not be found or is too old.  Make sure it
    187 is in your PATH or set the PKG_CONFIG environment variable to the full
    188 path to pkg-config.
    189 
    190 _PKG_TEXT
    191 
    192 To get pkg-config, see <http://pkg-config.freedesktop.org/>.])[]dnl
    193         ])
    194 else
    195 	$1[]_CFLAGS=$pkg_cv_[]$1[]_CFLAGS
    196 	$1[]_LIBS=$pkg_cv_[]$1[]_LIBS
    197         AC_MSG_RESULT([yes])
    198 	$3
    199 fi[]dnl
    200 ])dnl PKG_CHECK_MODULES
    201 
    202 
    203 dnl PKG_CHECK_MODULES_STATIC(VARIABLE-PREFIX, MODULES, [ACTION-IF-FOUND],
    204 dnl   [ACTION-IF-NOT-FOUND])
    205 dnl ---------------------------------------------------------------------
    206 dnl Since: 0.29
    207 dnl
    208 dnl Checks for existence of MODULES and gathers its build flags with
    209 dnl static libraries enabled. Sets VARIABLE-PREFIX_CFLAGS from --cflags
    210 dnl and VARIABLE-PREFIX_LIBS from --libs.
    211 dnl
    212 dnl Note that if there is a possibility the first call to
    213 dnl PKG_CHECK_MODULES_STATIC might not happen, you should be sure to
    214 dnl include an explicit call to PKG_PROG_PKG_CONFIG in your
    215 dnl configure.ac.
    216 AC_DEFUN([PKG_CHECK_MODULES_STATIC],
    217 [AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl
    218 _save_PKG_CONFIG=$PKG_CONFIG
    219 PKG_CONFIG="$PKG_CONFIG --static"
    220 PKG_CHECK_MODULES($@)
    221 PKG_CONFIG=$_save_PKG_CONFIG[]dnl
    222 ])dnl PKG_CHECK_MODULES_STATIC
    223 
    224 
    225 dnl PKG_INSTALLDIR([DIRECTORY])
    226 dnl -------------------------
    227 dnl Since: 0.27
    228 dnl
    229 dnl Substitutes the variable pkgconfigdir as the location where a module
    230 dnl should install pkg-config .pc files. By default the directory is
    231 dnl $libdir/pkgconfig, but the default can be changed by passing
    232 dnl DIRECTORY. The user can override through the --with-pkgconfigdir
    233 dnl parameter.
    234 AC_DEFUN([PKG_INSTALLDIR],
    235 [m4_pushdef([pkg_default], [m4_default([$1], ['${libdir}/pkgconfig'])])
    236 m4_pushdef([pkg_description],
    237     [pkg-config installation directory @<:@]pkg_default[@:>@])
    238 AC_ARG_WITH([pkgconfigdir],
    239     [AS_HELP_STRING([--with-pkgconfigdir], pkg_description)],,
    240     [with_pkgconfigdir=]pkg_default)
    241 AC_SUBST([pkgconfigdir], [$with_pkgconfigdir])
    242 m4_popdef([pkg_default])
    243 m4_popdef([pkg_description])
    244 ])dnl PKG_INSTALLDIR
    245 
    246 
    247 dnl PKG_NOARCH_INSTALLDIR([DIRECTORY])
    248 dnl --------------------------------
    249 dnl Since: 0.27
    250 dnl
    251 dnl Substitutes the variable noarch_pkgconfigdir as the location where a
    252 dnl module should install arch-independent pkg-config .pc files. By
    253 dnl default the directory is $datadir/pkgconfig, but the default can be
    254 dnl changed by passing DIRECTORY. The user can override through the
    255 dnl --with-noarch-pkgconfigdir parameter.
    256 AC_DEFUN([PKG_NOARCH_INSTALLDIR],
    257 [m4_pushdef([pkg_default], [m4_default([$1], ['${datadir}/pkgconfig'])])
    258 m4_pushdef([pkg_description],
    259     [pkg-config arch-independent installation directory @<:@]pkg_default[@:>@])
    260 AC_ARG_WITH([noarch-pkgconfigdir],
    261     [AS_HELP_STRING([--with-noarch-pkgconfigdir], pkg_description)],,
    262     [with_noarch_pkgconfigdir=]pkg_default)
    263 AC_SUBST([noarch_pkgconfigdir], [$with_noarch_pkgconfigdir])
    264 m4_popdef([pkg_default])
    265 m4_popdef([pkg_description])
    266 ])dnl PKG_NOARCH_INSTALLDIR
    267 
    268 
    269 dnl PKG_CHECK_VAR(VARIABLE, MODULE, CONFIG-VARIABLE,
    270 dnl [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])
    271 dnl -------------------------------------------
    272 dnl Since: 0.28
    273 dnl
    274 dnl Retrieves the value of the pkg-config variable for the given module.
    275 AC_DEFUN([PKG_CHECK_VAR],
    276 [AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl
    277 AC_ARG_VAR([$1], [value of $3 for $2, overriding pkg-config])dnl
    278 
    279 _PKG_CONFIG([$1], [variable="][$3]["], [$2])
    280 AS_VAR_COPY([$1], [pkg_cv_][$1])
    281 
    282 AS_VAR_IF([$1], [""], [$5], [$4])dnl
    283 ])dnl PKG_CHECK_VAR
    284