File: CrashHandler.h

package info (click to toggle)
spring 104.0%2Bdfsg-3
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 47,512 kB
  • sloc: cpp: 391,093; ansic: 79,943; python: 12,356; java: 12,201; awk: 5,889; sh: 1,826; xml: 655; makefile: 486; perl: 405; php: 211; objc: 194; sed: 2
file content (35 lines) | stat: -rw-r--r-- 1,219 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
/* This file is part of the Spring engine (GPL v2 or later), see LICENSE.html */

#ifndef _CRASH_HANDLER_H_
#define _CRASH_HANDLER_H_

#include <string.h>
#include "Threading.h"
#include "System/Log/Level.h"

namespace CrashHandler {
	void Install();
	void Remove();

	void Stacktrace(Threading::NativeThreadHandle thread, const std::string& threadName, const int logLevel = LOG_LEVEL_ERROR);
	void PrepareStacktrace(const int logLevel = LOG_LEVEL_ERROR);
	void CleanupStacktrace(const int logLevel = LOG_LEVEL_ERROR);
	
#ifndef WIN32
	/*
	 * The following method breaks the Stacktrace() interface, but it is unavoidable since we need to provide the
	 *   ucontext_t parameter to thread_unwind (and hence to libunwind) in order to work with the foreign thread.
	 * The ucontext_t structure is embeded within Threading::ThreadControls under Linux.
	 *
	 * Imho this is a better solution than adding yet another optional parameter to the Stacktrace interface because
	 *   the parameter is specific to the needs of one platform.
	 */
	void SuspendedStacktrace(Threading::ThreadControls* ctls, const std::string& threadName);
#else
	bool InitImageHlpDll();
#endif

	void OutputStacktrace();
}

#endif // _CRASH_HANDLER_H_