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