# FindCURL

Find the native CURL headers and libraries.

Added in version 3.14: This module accept optional COMPONENTS to check supported features and protocols:

    PROTOCOLS: ICT FILE FTP FTPS GOPHER HTTP HTTPS IMAP IMAPS LDAP LDAPS POP3
               POP3S RTMP RTSP SCP SFTP SMB SMBS SMTP SMTPS TELNET TFTP
    FEATURES:  SSL IPv6 UnixSockets libz AsynchDNS IDN GSS-API PSL SPNEGO
               Kerberos NTLM NTLM_WB TLS-SRP HTTP2 HTTPS-proxy

## Imported Targets

Added in version 3.12.

This module defines `IMPORTED` target `CURL::libcurl`, if curl has been found.

## Result Variables

This module defines the following variables:

`CURL_FOUND`

  "True" if `curl` found.

`CURL_INCLUDE_DIRS`

  where to find `curl`/`curl.h`, etc.

`CURL_LIBRARIES`

  List of libraries when using `curl`.

`CURL_VERSION`

  Added in version 4.0.

  The version of `curl` found. This supersedes `CURL_VERSION_STRING`.

`CURL_VERSION_STRING`

  The version of `curl` found. Superseded by `CURL_VERSION`.

Added in version 3.13: Debug and Release variants are found separately.

## CURL CMake

Added in version 3.17.

If CURL was built using the CMake buildsystem then it provides its own `CURLConfig.cmake` file for use with the `find_package()` command's config mode. This module looks for this file and, if found, returns its results with no further action.

Set `CURL_NO_CURL_CMAKE` to `ON` to disable this search.

## Hints

`CURL_USE_STATIC_LIBS`

> Added in version 3.28.

> Set to `TRUE` to use static libraries.

> This is meaningful only when CURL is not found via its CMake Package Configuration file.