FindGnuTLS
Finds the GNU Transport Layer Security library (GnuTLS):
find_package(GnuTLS [<version>] [...])
The GnuTLS package includes the main libraries (libgnutls and libdane), as well as the optional gnutls-openssl compatibility extra library. They are all distributed as part of the same release. This module checks for the presence of the main libgnutls library and provides usage requirements for integrating GnuTLS into CMake projects.
Imported Targets
This module provides the following Imported Targets:
-
GnuTLS::GnuTLS -
Added in version 3.16.
Target encapsulating the GnuTLS usage requirements, available if GnuTLS is found.
Result Variables
This module defines the following variables:
-
GnuTLS_FOUND -
Added in version 3.3.
Boolean indicating whether (the requested version of) GnuTLS was found.
-
GnuTLS_VERSION -
Added in version 4.2.
The version of GnuTLS found.
-
GNUTLS_INCLUDE_DIRS -
Include directories needed to use GnuTLS.
-
GNUTLS_LIBRARIES -
Libraries needed to link against to use GnuTLS.
-
GNUTLS_DEFINITIONS -
Compiler options required for using GnuTLS.
Cache Variables
The following cache variables may also be set:
-
GNUTLS_INCLUDE_DIR -
The directory containing the
gnutls/gnutls.hheader file. -
GNUTLS_LIBRARY -
The path to the GnuTLS library.
Deprecated Variables
The following variables are provided for backward compatibility:
-
GNUTLS_FOUND -
Deprecated since version 4.2: Use
GnuTLS_FOUND, which has the same value.Boolean indicating whether (the requested version of) GnuTLS was found.
-
GNUTLS_VERSION_STRING -
Deprecated since version 3.16: Use the
GnuTLS_VERSION, which has the same value. -
GNUTLS_VERSION -
Added in version 3.16.
Deprecated since version 4.2: Use the
GnuTLS_VERSION, which has the same value.
Examples
Finding GnuTLS and linking it to a project target:
find_package(GnuTLS) target_link_libraries(project_target PRIVATE GnuTLS::GnuTLS)
© 2000–2026 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/module/FindGnuTLS.html