53 lines
1.7 KiB
C++
53 lines
1.7 KiB
C++
// This file is part of the uSTL library, an STL implementation.
|
|
//
|
|
// Copyright (c) 2006 by Mike Sharov <msharov@users.sourceforge.net>
|
|
// This file is free software, distributed under the MIT License.
|
|
|
|
#ifndef BKTRACE_H_63ABB1E4388CEDD975DBE58B57DE474F
|
|
#define BKTRACE_H_63ABB1E4388CEDD975DBE58B57DE474F
|
|
|
|
#include "ulimits.h"
|
|
#include <stdlib.h>
|
|
|
|
namespace ustl {
|
|
|
|
class ostringstream;
|
|
class istream;
|
|
class ostream;
|
|
|
|
/// \class CBacktrace bktrace.h ustl.h
|
|
///
|
|
/// \brief Stores the backtrace from the point of construction.
|
|
///
|
|
/// The backtrace, or callstack, is the listing of functions called to
|
|
/// reach the construction of this object. This is useful for debugging,
|
|
/// to print the location of an error. To get meaningful output you'll
|
|
/// need to use a debug build with symbols and with frame pointers. For
|
|
/// GNU ld you will also need to link with the -rdynamic option to see
|
|
/// actual function names instead of __gxx_personality0+0xF4800.
|
|
///
|
|
class CBacktrace {
|
|
public:
|
|
CBacktrace (void) throw();
|
|
CBacktrace (const CBacktrace& v) throw();
|
|
inline ~CBacktrace (void) throw() { if (m_Symbols) free (m_Symbols); }
|
|
const CBacktrace& operator= (const CBacktrace& v) throw();
|
|
void text_write (ostringstream& os) const;
|
|
void read (istream& is);
|
|
void write (ostream& os) const;
|
|
size_t stream_size (void) const;
|
|
private:
|
|
void GetSymbols (void) throw() DLL_LOCAL;
|
|
private:
|
|
void* m_Addresses [64]; ///< Addresses of each function on the stack.
|
|
char* m_Symbols; ///< Symbols corresponding to each address.
|
|
uint32_t m_nFrames; ///< Number of addresses in m_Addresses.
|
|
uint32_t m_SymbolsSize; ///< Size of m_Symbols.
|
|
};
|
|
|
|
} // namespace ustl
|
|
|
|
ALIGNOF(ustl::CBacktrace, sizeof(void*))
|
|
|
|
#endif
|