FindLTTngUST — CMake 4.4.20260621-gcc70e9e-dirty Documentation

# FindLTTngUST

Added in version 3.6.

Finds the LTTng (Linux Trace Toolkit: next generation) user space tracing library (LTTng-UST):

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

## Imported Targets

This module provides the following Imported Targets:

`LTTng::UST`

  Target providing the LTTng-UST library usage requirements. This target is available only when LTTng-UST is found.

## Result Variables

This module defines the following variables:

`LTTngUST_FOUND`

  Boolean indicating whether the (requested version of) LTTng-UST library was found.

`LTTngUST_VERSION`

  Added in version 4.2.

  The LTTng-UST version.

`LTTNGUST_HAS_TRACEF`

  `TRUE` if the `tracef()` API is available in the system's LTTng-UST.

`LTTNGUST_HAS_TRACELOG`

  `TRUE` if the `tracelog()` API is available in the system's LTTng-UST.

## Cache Variables

The following cache variables may also be set:

`LTTNGUST_INCLUDE_DIRS`

  The LTTng-UST include directories.

`LTTNGUST_LIBRARIES`

  The libraries needed to use LTTng-UST.

## Deprecated Variables

The following variables are provided for backward compatibility:

`LTTNGUST_FOUND`

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

  Boolean indicating whether the (requested version of) LTTng-UST library was found.

`LTTNGUST_VERSION_STRING`

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

  The LTTng-UST version.

## Examples

Finding the LTTng-UST library and linking it to a project target:

    find_package(LTTugNST)
    target_link_libraries(project_target PRIVATE LTTng::UST)