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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
/*
* Copyright (C) 2003 Stefan Westerfeld
*
* This code is based on code from the KDE Libraries
* Copyright (C) 2000 Timo Hummel <[email protected]>
* Tom Braun <[email protected]>
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*
*/
#ifndef __ARTS_CRASHHANDLER_H
#define __ARTS_CRASHHANDLER_H
#include <string>
namespace Arts {
/**
* This class handles segmentation-faults.
* By default it displays a message-box saying the application crashed.
* This default can be overridden by setting a custom crash handler with
* setCrashHandler().
*/
class CrashHandler
{
private: // ;o)
static const char *appName;
static const char *appPath;
static const char *appVersion;
static const char *programName;
static const char *bugAddress;
static const char *crashApp;
public:
/**
* The default crash handler.
* @param signal the signal number
*/
static void defaultCrashHandler (int signal);
/**
* This function type is a pointer to a crash handler function.
* The function's argument is the number of the signal.
*/
typedef void (*HandlerType)(int);
/**
* Install a function to be called in case a SIGSEGV is caught.
* @param handler HandlerType handler can be one of
* @li null in which case signal-catching is disabled
* (by calling signal(SIGSEGV, SIG_DFL))
* @li if handler is omitted the default crash handler is installed.
* @li an user defined function in the form:
* static (if in a class) void myCrashHandler(int);
* @param handler the crash handler
*/
static void setCrashHandler (HandlerType handler = defaultCrashHandler);
/**
* Returns the installed crash handler.
* @return the crash handler
*/
static HandlerType crashHandler() { return _crashHandler; }
/**
* Sets the application @p path which should be passed to
* Dr. Konqi, our nice crash display application.
* @param path the application path.
*/
static void setApplicationPath (const std::string& path) { appPath = strdup(path.c_str()); }
/**
* Sets the application name @p name which should be passed to
* Dr. Konqi, our nice crash display application.
* @param name the name of the application, as shown in Dr. Konqi
*/
static void setApplicationName (const std::string& name) { appName = strdup(name.c_str()); }
/**
* Sets the application version @p name which should be passed to
* Dr. Konqi, our nice crash display application.
* @param name the name of the application, as shown in Dr. Konqi
*/
static void setApplicationVersion (const std::string& name) { appVersion = strdup(name.c_str()); }
/**
* Sets the program name @p name which should be passed to
* Dr. Konqi, our nice crash display application.
* @param name the name of the application, as shown in Dr. Konqi
*/
static void setProgramName (const std::string& name) { programName = strdup(name.c_str()); }
/**
* Sets the bug adress name @p name which should be passed to
* Dr. Konqi, our nice crash display application.
* @param name the name of the application, as shown in Dr. Konqi
*/
static void setBugAddress (const std::string& name) { bugAddress = strdup(name.c_str()); }
/**
* Sets the crash application @p app which will be called to
* handle the crash. To use Dr. Konqi (KDE), pass "drkonqi" here.
* @param app the name of the application that handles the crash
*/
static void setCrashApp (const std::string& app) { crashApp = strdup(app.c_str()); }
protected:
/**
* Pointer to the crash handler.
*/
static HandlerType _crashHandler;
};
}
#endif
|