Introduction

Boost.Call_stack is a collection of utilities to collect runtime call stacks and display them in a human-readable form. Output in a wide character format is not directly supported.

Broadly, the library contains:

A call stack capture wrapper.
Tools for symbol resolution with various degrees of detail.
Formatters to display above information in a human-readable form.

Building Boost.Call_stack

Boost.Call_stack is a header only library. Include your Boost header directory in your compiler include path, as well as the path to the Boost.Call_stack headers.

Compilers and platforms

Boost.Call_stack is C++98 code. It is known to work with:

Visual C++ 7.1 (2003) and later (verified on Windows 7 64 bits Intel).
- I386
- AMD64
- IA64
GCC 4.7 and later (verified on Debian 32 and 64 bits Intel).
- x86
- x86_64

Dependencies

All Platforms

Boost (verified with version 1.51):
- Boost.Array
- Boost.Config
- Boost.Date_Time
- Boost.Move
- Boost.Smart_ptr
- Boost.StaticAssert
- Boost.Test
- Boost.Thread
- Boost.TypeTraits
- Boost.Utility
- Boost.Filesystem
- Boost.System

Platform specific

Windows
- Links with DbgHelp.dll. Version 5.1 or later required, YMMV depending on the library version.
GCC
- Links with libbfd by default. Optional.
- Links with libdl.

Define BOOST_CALL_STACK_NO_OPTIONAL_LIBS to cut dependencies on libraries that are not installed by default on the platform (the optional libraries). This could affect the level of detail of the functionality of this library. By default, optional libraries are used and linked with.

For instance, this will cut the dependency on libbfd on GCC platforms - as a consequence some symbols will not resolve properly, nor would line numbers be available.