configure.ac: adding logic and options for dtls support

DTLS features are needing external cryptographic libraries for proper
working. There are some possibilities to use existing libraries of that
kind.
Based on discussions on the ML and also the issue tracker on GitHub we
found some consensus to use and support GnuTLS and OpenSSL at least in
the beginning of implementing DTLS support. The added code is using
GnuTLS 3.2.0 and OpenSSL 1.1.0 as required minimum versions.

This commit is adding a new configure option '--enable-dtls' which is
turned on by default to build libcoap by default with DTLS
functionality.
It's adding also two more additional options that let the user decide
which cryptographic library should be used for DTLS support. The two
optional options are '--with-gnutls' and '--with-openssl'.

These two options are optional and a user doesn't need to set any of
them if he doesn't care which library should be used. If these options
are not given the logic will first try to find the GnuTLS library for
usage and if not found do a fallback to OpenSSL.

The following behaviour is now implemented into configure by this commit:

  $ ./configure --disable-dtls
   or
  $ ./configure --enable-dtls=no

   Both options configuring the source to not implement any DTLS
   support.

  $ ./configure     # without additionally options '--with-gnutls' or '--with-openssl'

   The configure script is trying first to find GnuTLS for DTLS.
   If the system hasn't GnuTLS development files the configure script is
   moving over to OpenSSL and try to find the development files of
   OpenSSL. If any files can't be found the script will break with a error
   message.

  $ ./configure --with-gnutls

   The development files for GnuTLS will be explicit searched and used even
   if also OpenSSL is available and usable.

  $ ./configure --with-openssl

   Like before but with the needing for OpenSSL development files. A
   optional availability of GnuTLS on the host will be ignored.
This commit is contained in:
Carsten Schoenert committed 2017-06-30 20:24:50 +02:00
1 parent 4cef54f151
commit 4bbf6b8a08
1 file changed
+128
+128
View File
@@ -237,6 +237,134 @@ AM_CONDITIONAL([HAVE_DOXYGEN],
[test -n "$DOXYGEN"])AM_COND_IF([HAVE_DOXYGEN],
[AC_CONFIG_FILES([doc/Doxyfile])])
# configure options
# __dtls__
# The Datagram Transport Layer Security (DTLS) feature needs cryptographic
# functions.
# We currently support the GnuTLS and OpenSSL library. The user can preselect
# the cryptographic library that should be used by adding '--with-gnutls' or
# '--with-openssl'.
# If the user isn't using a selection we first search for GnuTLS and fallback
# to OpenSSL if the GnuTLS library couldn't be found.
gnutls_version_required=3.2.0
openssl_version_required=1.1.0
AC_ARG_ENABLE([dtls],
[AS_HELP_STRING([--enable-dtls],
[Enable building with DTLS support [default=yes]])],
[build_dtls="$enableval"],
[build_dtls="yes"])
AC_ARG_WITH([gnutls],
[AS_HELP_STRING([--with-gnutls],
[Use GnuTLS for DTLS functions])],
[with_gnutls="yes"],
[with_gnutls="no"])
AC_ARG_WITH([openssl],
[AS_HELP_STRING([--with-openssl],
[Use OpenSSL for DTLS functions])],
[with_openssl="yes"],
[with_openssl="no"])
#AC_ARG_WITH([tinydtls],
# [AS_HELP_STRING([--with-tinydtls],
# [Use TinyDTLS for DTLS functions])],
# [with_tinydtls="yes"],
# [with_tinydtls="no"])
if test "x$with_gnutls" = "xyes" -o "x$with_openssl" = "xyes"; then
if test "x$build_dtls" = "x"; then
# Give a advice that '--with_gnutls' or '--with_openssl' was used but
# DTLS support isn't configured.
AC_MSG_NOTICE([==> Using the configure options '--with-gnutls' or '--with-openssl' without '--enable-dtls' is useles and will be ignored.])
fi
fi
# O.K. the user hasn't de-selected DTLS
if test "x$build_dtls" = "xyes"; then
# The user can't select multiple crypto libraries.
if test "x$with_gnutls" = "xyes" -a "x$with_openssl" = "xyes"; then
AC_MSG_ERROR([==> You can't use the options '--with-gnutls' and '--with-openssl' at the same time while '--enable-dtls' is selected!
==> Please note, the option '--enable-dtls' is turned on by default if not explicitly disabled!])
fi
# Check for all possible usable and supported SSL crypto libraries
# GnuTLS
PKG_CHECK_MODULES([GnuTLS],
[gnutls],
[have_gnutls="yes"],
[have_gnutls="no"])
# OpenSSL
PKG_CHECK_MODULES([OpenSSL],
[openssl],
[have_openssl="yes"],
[have_openssl="no"])
# TinyDTLS ?
# TBD ?
# The user wants to use explicit GnuTLS if '--with-gnutls' was set.
if test "x$with_gnutls" = "xyes"; then
# Some more sanity checking.
if test "x$have_gnutls" != "xyes"; then
AC_MSG_ERROR([==> You want to build libcoap with DTLS support by the GnuTLS library but pkg-config file 'gnutls.pc' could not be found!
Install the package(s) containing the development files for GnuTLS,
or use '--with_openssl' or disable the DTLS support using '--disable-dtls'.])
fi
AC_MSG_NOTICE([The use of GnuTLS was explicit requested due configure option '--with-gnutls'!])
# check for valid GnuTLS version
gnutls_version=`pkg-config --modversion gnutls`
AX_CHECK_GNUTLS_VERSION
have_openssl="no" # don't confuse AC_MSG_RESULT at the end of the script
fi
# The user wants to use explicit OpenSSL if '--with-openssl was set'.
if test "x$with_openssl" = "xyes"; then
# Some more sanity checking.
if test "x$have_openssl" != "xyes"; then
AC_MSG_ERROR([==> You want to build libcoap with DTLS support by the OpenSSL library but pkg-config file 'openssl.pc' could not be found!
Install the package(s) containing the development files for OpenSSL,
or use '--with_gnutls' or disable the DTLS support using '--disable-dtls'.])
fi
AC_MSG_NOTICE([The use of OpenSSL was explicit requested due configure option '--with-openssl'!])
# check for valid OpenSSL version
openssl_version=`pkg-config --modversion openssl`
AX_CHECK_OPENSSL_VERSION
have_gnutls="no" # don't confuse AC_MSG_RESULT at the end of the script
fi
# The user hasn't requested the use of a specific cryptographic library
# we try first GnuTLS for usability ...
if test "x$have_gnutls" = "xyes" -a "x$with_gnutls" = "xno"; then
gnutls_version=`pkg-config --modversion gnutls`
AX_CHECK_GNUTLS_VERSION
AC_MSG_NOTICE([Using autoselected library GnuTLS for DTLS support!])
with_gnutls_auto="yes"
have_openssl="no" # don't confuse AC_MSG_RESULT at the end of the script
fi
# ... and if not found check OpenSSL is suitable.
if test "x$have_openssl" = "xyes" -a "x$with_openssl" = "xno" -a "x$with_gnutls_auto" = "x"; then
openssl_version=`pkg-config --modversion openssl`
AX_CHECK_OPENSSL_VERSION
AC_MSG_NOTICE([Using autoselected library OpenSSL for DTLS support!])
with_openssl_auto="yes"
have_gnutls="no" # don't confuse AC_MSG_RESULT at the end of the script
fi
# Giving out a error message if we haven't found at least one crypto library.
if test "x$have_gnutls" = "xno" -a "x$have_openssl" = "xno"; then
AC_MSG_ERROR([==> Option '--enable-dtls' is set but one of the needed cryptographic library GnuTLS nor OpenSSL could be found!
Install at least on of the package(s) containing the development files for GnuTLS (>= $gnutls_version_required) or OpenSSL(>= $openssl_version_required)
or disable the DTLS support using '--disable-dtls'.])
fi
fi
# configure options
# __tests__
AC_ARG_ENABLE([tests],