Initial commit of visual studio 9 git build superproject.
[git-build-vc9.git] / curl / docs / libcurl / libcurl.m4
blobf54a5f2d13e65745324377f7f335c8284783ebb6
1 # LIBCURL_CHECK_CONFIG ([DEFAULT-ACTION], [MINIMUM-VERSION],
2 #                       [ACTION-IF-YES], [ACTION-IF-NO])
3 # ----------------------------------------------------------
4 #      David Shaw <dshaw@jabberwocky.com>   May-09-2006
6 # Checks for libcurl.  DEFAULT-ACTION is the string yes or no to
7 # specify whether to default to --with-libcurl or --without-libcurl.
8 # If not supplied, DEFAULT-ACTION is yes.  MINIMUM-VERSION is the
9 # minimum version of libcurl to accept.  Pass the version as a regular
10 # version number like 7.10.1. If not supplied, any version is
11 # accepted.  ACTION-IF-YES is a list of shell commands to run if
12 # libcurl was successfully found and passed the various tests.
13 # ACTION-IF-NO is a list of shell commands that are run otherwise.
14 # Note that using --without-libcurl does run ACTION-IF-NO.
16 # This macro #defines HAVE_LIBCURL if a working libcurl setup is
17 # found, and sets @LIBCURL@ and @LIBCURL_CPPFLAGS@ to the necessary
18 # values.  Other useful defines are LIBCURL_FEATURE_xxx where xxx are
19 # the various features supported by libcurl, and LIBCURL_PROTOCOL_yyy
20 # where yyy are the various protocols supported by libcurl.  Both xxx
21 # and yyy are capitalized.  See the list of AH_TEMPLATEs at the top of
22 # the macro for the complete list of possible defines.  Shell
23 # variables $libcurl_feature_xxx and $libcurl_protocol_yyy are also
24 # defined to 'yes' for those features and protocols that were found.
25 # Note that xxx and yyy keep the same capitalization as in the
26 # curl-config list (e.g. it's "HTTP" and not "http").
28 # Users may override the detected values by doing something like:
29 # LIBCURL="-lcurl" LIBCURL_CPPFLAGS="-I/usr/myinclude" ./configure
31 # For the sake of sanity, this macro assumes that any libcurl that is
32 # found is after version 7.7.2, the first version that included the
33 # curl-config script.  Note that it is very important for people
34 # packaging binary versions of libcurl to include this script!
35 # Without curl-config, we can only guess what protocols are available,
36 # or use curl_version_info to figure it out at runtime.
38 AC_DEFUN([LIBCURL_CHECK_CONFIG],
40   AH_TEMPLATE([LIBCURL_FEATURE_SSL],[Defined if libcurl supports SSL])
41   AH_TEMPLATE([LIBCURL_FEATURE_KRB4],[Defined if libcurl supports KRB4])
42   AH_TEMPLATE([LIBCURL_FEATURE_IPV6],[Defined if libcurl supports IPv6])
43   AH_TEMPLATE([LIBCURL_FEATURE_LIBZ],[Defined if libcurl supports libz])
44   AH_TEMPLATE([LIBCURL_FEATURE_ASYNCHDNS],[Defined if libcurl supports AsynchDNS])
45   AH_TEMPLATE([LIBCURL_FEATURE_IDN],[Defined if libcurl supports IDN])
46   AH_TEMPLATE([LIBCURL_FEATURE_SSPI],[Defined if libcurl supports SSPI])
47   AH_TEMPLATE([LIBCURL_FEATURE_NTLM],[Defined if libcurl supports NTLM])
49   AH_TEMPLATE([LIBCURL_PROTOCOL_HTTP],[Defined if libcurl supports HTTP])
50   AH_TEMPLATE([LIBCURL_PROTOCOL_HTTPS],[Defined if libcurl supports HTTPS])
51   AH_TEMPLATE([LIBCURL_PROTOCOL_FTP],[Defined if libcurl supports FTP])
52   AH_TEMPLATE([LIBCURL_PROTOCOL_FTPS],[Defined if libcurl supports FTPS])
53   AH_TEMPLATE([LIBCURL_PROTOCOL_FILE],[Defined if libcurl supports FILE])
54   AH_TEMPLATE([LIBCURL_PROTOCOL_TELNET],[Defined if libcurl supports TELNET])
55   AH_TEMPLATE([LIBCURL_PROTOCOL_LDAP],[Defined if libcurl supports LDAP])
56   AH_TEMPLATE([LIBCURL_PROTOCOL_DICT],[Defined if libcurl supports DICT])
57   AH_TEMPLATE([LIBCURL_PROTOCOL_TFTP],[Defined if libcurl supports TFTP])
59   AC_ARG_WITH(libcurl,
60      AC_HELP_STRING([--with-libcurl=DIR],[look for the curl library in DIR]),
61      [_libcurl_with=$withval],[_libcurl_with=ifelse([$1],,[yes],[$1])])
63   if test "$_libcurl_with" != "no" ; then
65      AC_PROG_AWK
67      _libcurl_version_parse="eval $AWK '{split(\$NF,A,\".\"); X=256*256*A[[1]]+256*A[[2]]+A[[3]]; print X;}'"
69      _libcurl_try_link=yes
71      if test -d "$_libcurl_with" ; then
72         LIBCURL_CPPFLAGS="-I$withval/include"
73         _libcurl_ldflags="-L$withval/lib"
74         AC_PATH_PROG([_libcurl_config],[curl-config],["$withval/bin"],
75                      ["$withval/bin"])
76      else
77         AC_PATH_PROG([_libcurl_config],[curl-config])
78      fi
80      if test x$_libcurl_config != "x" ; then
81         AC_CACHE_CHECK([for the version of libcurl],
82            [libcurl_cv_lib_curl_version],
83            [libcurl_cv_lib_curl_version=`$_libcurl_config --version | $AWK '{print $[]2}'`])
85         _libcurl_version=`echo $libcurl_cv_lib_curl_version | $_libcurl_version_parse`
86         _libcurl_wanted=`echo ifelse([$2],,[0],[$2]) | $_libcurl_version_parse`
88         if test $_libcurl_wanted -gt 0 ; then
89            AC_CACHE_CHECK([for libcurl >= version $2],
90               [libcurl_cv_lib_version_ok],
91               [
92               if test $_libcurl_version -ge $_libcurl_wanted ; then
93                  libcurl_cv_lib_version_ok=yes
94               else
95                  libcurl_cv_lib_version_ok=no
96               fi
97               ])
98         fi
100         if test $_libcurl_wanted -eq 0 || test x$libcurl_cv_lib_version_ok = xyes ; then
101            if test x"$LIBCURL_CPPFLAGS" = "x" ; then
102               LIBCURL_CPPFLAGS=`$_libcurl_config --cflags`
103            fi
104            if test x"$LIBCURL" = "x" ; then
105               LIBCURL=`$_libcurl_config --libs`
107               # This is so silly, but Apple actually has a bug in their
108               # curl-config script.  Fixed in Tiger, but there are still
109               # lots of Panther installs around.
110               case "${host}" in
111                  powerpc-apple-darwin7*)
112                     LIBCURL=`echo $LIBCURL | sed -e 's|-arch i386||g'`
113                  ;;
114               esac
115            fi
117            # All curl-config scripts support --feature
118            _libcurl_features=`$_libcurl_config --feature`
120            # Is it modern enough to have --protocols? (7.12.4)
121            if test $_libcurl_version -ge 461828 ; then
122               _libcurl_protocols=`$_libcurl_config --protocols`
123            fi
124         else
125            _libcurl_try_link=no
126         fi
128         unset _libcurl_wanted
129      fi
131      if test $_libcurl_try_link = yes ; then
133         # we didn't find curl-config, so let's see if the user-supplied
134         # link line (or failing that, "-lcurl") is enough.
135         LIBCURL=${LIBCURL-"$_libcurl_ldflags -lcurl"}
137         AC_CACHE_CHECK([whether libcurl is usable],
138            [libcurl_cv_lib_curl_usable],
139            [
140            _libcurl_save_cppflags=$CPPFLAGS
141            CPPFLAGS="$LIBCURL_CPPFLAGS $CPPFLAGS"
142            _libcurl_save_libs=$LIBS
143            LIBS="$LIBCURL $LIBS"
145            AC_LINK_IFELSE(AC_LANG_PROGRAM([#include <curl/curl.h>],[
146 /* Try and use a few common options to force a failure if we are
147    missing symbols or can't link. */
148 int x;
149 curl_easy_setopt(NULL,CURLOPT_URL,NULL);
150 x=CURL_ERROR_SIZE;
151 x=CURLOPT_WRITEFUNCTION;
152 x=CURLOPT_FILE;
153 x=CURLOPT_ERRORBUFFER;
154 x=CURLOPT_STDERR;
155 x=CURLOPT_VERBOSE;
156 ]),libcurl_cv_lib_curl_usable=yes,libcurl_cv_lib_curl_usable=no)
158            CPPFLAGS=$_libcurl_save_cppflags
159            LIBS=$_libcurl_save_libs
160            unset _libcurl_save_cppflags
161            unset _libcurl_save_libs
162            ])
164         if test $libcurl_cv_lib_curl_usable = yes ; then
166            # Does curl_free() exist in this version of libcurl?
167            # If not, fake it with free()
169            _libcurl_save_cppflags=$CPPFLAGS
170            CPPFLAGS="$CPPFLAGS $LIBCURL_CPPFLAGS"
171            _libcurl_save_libs=$LIBS
172            LIBS="$LIBS $LIBCURL"
174            AC_CHECK_FUNC(curl_free,,
175               AC_DEFINE(curl_free,free,
176                 [Define curl_free() as free() if our version of curl lacks curl_free.]))
178            CPPFLAGS=$_libcurl_save_cppflags
179            LIBS=$_libcurl_save_libs
180            unset _libcurl_save_cppflags
181            unset _libcurl_save_libs
183            AC_DEFINE(HAVE_LIBCURL,1,
184              [Define to 1 if you have a functional curl library.])
185            AC_SUBST(LIBCURL_CPPFLAGS)
186            AC_SUBST(LIBCURL)
188            for _libcurl_feature in $_libcurl_features ; do
189               AC_DEFINE_UNQUOTED(AS_TR_CPP(libcurl_feature_$_libcurl_feature),[1])
190               eval AS_TR_SH(libcurl_feature_$_libcurl_feature)=yes
191            done
193            if test "x$_libcurl_protocols" = "x" ; then
195               # We don't have --protocols, so just assume that all
196               # protocols are available
197               _libcurl_protocols="HTTP FTP FILE TELNET LDAP DICT"
199               if test x$libcurl_feature_SSL = xyes ; then
200                  _libcurl_protocols="$_libcurl_protocols HTTPS"
202                  # FTPS wasn't standards-compliant until version
203                  # 7.11.0
204                  if test $_libcurl_version -ge 461568; then
205                     _libcurl_protocols="$_libcurl_protocols FTPS"
206                  fi
207               fi
208            fi
210            for _libcurl_protocol in $_libcurl_protocols ; do
211               AC_DEFINE_UNQUOTED(AS_TR_CPP(libcurl_protocol_$_libcurl_protocol),[1])
212               eval AS_TR_SH(libcurl_protocol_$_libcurl_protocol)=yes
213            done
214         else
215            unset LIBCURL
216            unset LIBCURL_CPPFLAGS
217         fi
218      fi
220      unset _libcurl_try_link
221      unset _libcurl_version_parse
222      unset _libcurl_config
223      unset _libcurl_feature
224      unset _libcurl_features
225      unset _libcurl_protocol
226      unset _libcurl_protocols
227      unset _libcurl_version
228      unset _libcurl_ldflags
229   fi
231   if test x$_libcurl_with = xno || test x$libcurl_cv_lib_curl_usable != xyes ; then
232      # This is the IF-NO path
233      ifelse([$4],,:,[$4])
234   else
235      # This is the IF-YES path
236      ifelse([$3],,:,[$3])
237   fi
239   unset _libcurl_with
240 ])dnl