This is an effort to make libunwind available through the conan Package Manager.
NOTE: This repository only contains the source code of the conan package recipe. This is not the original libunwind source code and this repository is not maintained by the libunwind developer(s). The original source code is downloaded automatically from the official libunwind website during the package build process. Please visit libunwind's website at http://www.nongnu.org/libunwind.
Recipes and binary packages built from this repository are hosted at the Ocean Conan Package Repository. To use the repository, add it to your conan remotes like this:
conan remote add ocean-conan https://api.bintray.com/conan/marcokoch/ocean-conan
The packages are available in two channels:
libunwind/1.2.1@marcokoch/stable:
This channel contains the latest stable package release, built
from the v1.2.1-1 tag in this repository.
Note that 'stable' refers to the packaging only. The package is always built
from stable releases of libunwind.
libunwind/1.2.1@marcokoch/testing:
This channel provides recent development builds from the v1.2.1
branch of this repository.
Feedback on these builds is highly welcome.
They may be buggy, though.
To use libunwind in your project,
use the following lines in your conanfile.txt:
[requires]
libunwind/1.2.1@marcokoch/stable
Or in your conanfile.py:
class MyProject(ConanFile):
requires = "libunwind/1.2.1@marcokoch/stable"
There are binary packages available for the following configurations:
| Operating System | Architectures | Compilers | build_type |
shared |
|---|---|---|---|---|
| Linux | i686, x86_64 | GCC 5.2, 5.3, 5.4, 6.3 | "Debug", "Release" | True, False |
| Linux | i686, x86_64 | Clang 3.8, 3.9, 4.0 | "Debug", "Release" | True, False |
This recipe should build for all platforms that are supported by both libunwind and conan. At the moment, these are:
- Linux (x86)
- Linux (x86_64)
- Linux (ARM)
- Linux (PPC64)
- MIPS
- FreeBSD (x86)
- FreeBSD (x86_64)
If a package build breaks for any of those platforms, please report a bug on the issue tracker.
NOTE: Unfortunately, there is no support for Windows and/or OS X at the moment.
Packages from this recipe can both be compiled and used with
- GCC versions 5.1, 5.2, 5.3, 5.4, 6.1, 6.2, 6.3, 7.1
- Clang versions 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 4.0, 5.0
The package supports the following options:
| Option | Possible Values | Default | Description | Equivalent libunwind configure script option |
|---|---|---|---|---|
shared |
True, False |
False |
Build shared libraries | --enable-shared |
enable_coredump |
True, False |
False |
Include the unwind-coredump library | --enable-coredump |
enable_ptrace |
True, False |
False |
Include the unwind-ptrace library | --enable-ptrace |
enable_setjmp |
True, False |
False |
Include the unwind-setjmp library | --enable-setjmp |
enable_cxx_exceptions |
True, False |
False |
Use libunwind to handle C++ exceptions | --enable-cxx-exceptions |
enable_debugframe |
True, False |
False |
Load the ".debug_frame" section if available | --enable-debugframe |
enable_block_signals |
True, False |
False |
Block signals before performing mutext operations | --enable-block-signals |
enable_conservative_checks |
True, False |
False |
Validate all memory addresses before use | --enable-conservative-checks |
enable_msabi_support |
True, False |
False |
Enable support for Microsoft ABI extensions | --enable-msabi-support |
enable_minidebuginfo |
True, False |
False |
Enable support for LZMA-compressed symbol tables | --enable-minidebuginfo |
This package recipe is provided under the 3-Clause BSD license. See file LICENSE for further information.
The original libunwind project is provided under the MIT license. Please see https://github.com/libunwind/libunwind/blob/v1.2-stable/LICENSE.
Feedback and pull requests are highly appreciated. If you have any questions, feel free to ask in the issue tracker.
To contribute to the original libunwind project, please interact with the official GitHub mirror at https://github.com/libunwind/libunwind.