config/pkg.m4

   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@netsplit.com>.
   5 dnl Copyright © 2012-2015 Dan Nicholson <dbn.lists@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