FindGnuTLS — CMake 4.1.4 Documentation

# FindGnuTLS

Finds the GNU Transport Layer Security library (GnuTLS). 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`

  Boolean indicating whether the (requested version of) GnuTLS is found. For backward compatibility, the `GNUTLS_FOUND` variable is also set to the same value.

`GNUTLS_VERSION`

  Added in version 3.16.

  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.h` header file.

`GNUTLS_LIBRARY`

  The path to the GnuTLS library.

## Deprecated Variables

These variables are provided for backward compatibility:

`GNUTLS_VERSION_STRING`

  Deprecated since version 3.16: Superseded by `GNUTLS_VERSION`.

  The version of GnuTLS found.

## Examples

Finding GnuTLS and linking it to a project target:

    find_package(GnuTLS)
    target_link_libraries(project_target PRIVATE GnuTLS::GnuTLS)