FindBacktrace — CMake 3.31.1 Documentation

# FindBacktrace

Find provider for backtrace(3).

Checks if OS supports `backtrace(3)` via either `libc` or custom library. This module defines the following variables:

`Backtrace_HEADER`

  The header file needed for `backtrace(3)`. Cached. Could be forcibly set by user.

`Backtrace_INCLUDE_DIRS`

  The include directories needed to use `backtrace(3)` header.

`Backtrace_LIBRARIES`

  The libraries (linker flags) needed to use `backtrace(3)`, if any.

`Backtrace_FOUND`

  Is set if and only if `backtrace(3)` support detected.

The following cache variables are also available to set or use:

`Backtrace_LIBRARY`

  The external library providing backtrace, if any.

`Backtrace_INCLUDE_DIR`

  The directory holding the `backtrace(3)` header.

Typical usage is to generate of header file using `configure_file()` with the contents like the following:

    #cmakedefine01 Backtrace_FOUND
    #if Backtrace_FOUND
    # include <${Backtrace_HEADER}>
    #endif

And then reference that generated header file in actual source.

## Imported Targets

Added in version 3.30.

This module defines the following `IMPORTED` targets:

`Backtrace::Backtrace`

  An interface library providing usage requirements for the found components.