# FindCups

Finds the Common UNIX Printing System (CUPS):

    find_package(Cups [<version>] [...])

## Imported Targets

This module provides the following Imported Targets:

`Cups::Cups`

  Added in version 3.15.

  Target encapsulating the CUPS usage requirements, available only if CUPS is found.

## Result Variables

This module defines the following variables:

`Cups_FOUND`

  Added in version 3.3.

  Boolean indicating whether (the requested version of) CUPS was found.

`Cups_VERSION`

  Added in version 4.2.

  The version of CUPS found.

`CUPS_INCLUDE_DIRS`

  Include directories needed for using CUPS.

## Cache Variables

The following cache variables may also be set:

`CUPS_INCLUDE_DIR`

  The directory containing the CUPS headers.

`CUPS_LIBRARIES`

  Libraries needed to link against to use CUPS.

## Hints

This module accepts the following variables:

`CUPS_REQUIRE_IPP_DELETE_ATTRIBUTE`

  Set this variable to `TRUE` to require CUPS version which features the `ippDeleteAttribute()` function (i.e. at least of CUPS `1.1.19`).

## Deprecated Variables

The following variables are provided for backward compatibility:

`CUPS_FOUND`

  Deprecated since version 4.2: Use `Cups_FOUND`, which has the same value.

  Boolean indicating whether (the requested version of) CUPS was found.

`CUPS_VERSION_STRING`

  Deprecated since version 4.2: Superseded by the `Cups_VERSION`.

  The version of CUPS found.

## Examples

Finding CUPS and linking it to a project target:

    find_package(Cups)
    target_link_libraries(project_target PRIVATE Cups::Cups)