libunwind/1.8.0

Manipulate the preserved state of each call-frame and resume the execution at any point.
Recipe info
2024-01-15

Available packages
Linux
Windows
macOS
macOS Apple Silicon

Install
Add the following line to your conanfile.txt:
[requires]
libunwind/1.8.0

Using libunwind

Note

If you are new with Conan, we recommend to read the section how to consume packages.

If you need additional assistance, please ask a question in the Conan Center Index repository.

Simplest use case consuming this recipe and assuming CMake as your local build tool:

[requires]
libunwind/1.8.0
[generators]
CMakeDeps
CMakeToolchain
[layout]
cmake_layout
from conan import ConanFile
from conan.tools.cmake import cmake_layout


class ExampleRecipe(ConanFile):
    settings = "os", "compiler", "build_type", "arch"
    generators = "CMakeDeps", "CMakeToolchain"

    def requirements(self):
        self.requires("libunwind/1.8.0")

    def layout(self):
        cmake_layout(self)

Now, you can run this Conan command to locally install (and build if necessary) this recipe and its dependencies (if any):

$ conan install conanfile.txt --build=missing

Useful information to take into account to consume this library:


These are the main declared targets:

  • CMake package name(s): libunwind
  • CMake target name(s): libunwind::libunwind
  • ptrace => libunwind::ptrace
    setjmp => libunwind::setjmp
    unwind => libunwind::unwind
    generic => libunwind::generic
    coredump => libunwind::coredump
    
  • pkg-config file name(s): libunwind.pc
  • ptrace => libunwind-ptrace.pc
    setjmp => libunwind-setjmp.pc
    unwind => libunwind.pc
    generic => libunwind-generic.pc
    coredump => libunwind-coredump.pc
    

A simple use case using the CMake file name and the global target:

# ...
find_package(libunwind REQUIRED)
# ...
target_link_libraries(YOUR_TARGET libunwind::libunwind)

These are all the available headers. Some of these ones might be non-public; make sure of it by visiting the libunwind homepage listed above:

#include "libunwind-common.h"
#include "libunwind-coredump.h"
#include "libunwind-dynamic.h"
#include "libunwind-ptrace.h"
#include "libunwind-x86_64.h"
#include "libunwind.h"
#include "unwind.h"