KCrash 5.109.0
kcrash.h
1/*
2 This file is part of the KDE Libraries
3 SPDX-FileCopyrightText: 2000 Timo Hummel <timo.hummel@sap.com>
4 SPDX-FileCopyrightText: 2000 Tom Braun <braunt@fh-konstanz.de>
5
6 SPDX-License-Identifier: LGPL-2.0-or-later
7*/
8
9#ifndef KCRASH_H
10#define KCRASH_H
11
12#include <kcrash_export.h>
13
14#include <qglobal.h>
15
16class QString;
17
35namespace KCrash
36{
45KCRASH_EXPORT void initialize();
46
56KCRASH_EXPORT void defaultCrashHandler(int signal);
57
62typedef void (*HandlerType)(int);
63
80KCRASH_EXPORT void setCrashHandler(HandlerType handler = defaultCrashHandler);
81
86KCRASH_EXPORT HandlerType crashHandler();
87
95KCRASH_EXPORT void setEmergencySaveFunction(HandlerType saveFunction = nullptr);
96
102
111 4,
113};
117Q_DECLARE_FLAGS(CrashFlags, CrashFlag)
118Q_DECLARE_OPERATORS_FOR_FLAGS(CrashFlags)
119
120
124KCRASH_EXPORT void setFlags(KCrash::CrashFlags flags);
125
142KCRASH_EXPORT void setDrKonqiEnabled(bool enabled);
143
148KCRASH_EXPORT bool isDrKonqiEnabled();
149
155KCRASH_EXPORT void setErrorMessage(const QString &message);
156
157}
158
159#endif
This namespace contains functions to handle crashes.
Definition kcrash.h:36
void setCrashHandler(HandlerType handler=defaultCrashHandler)
Install a function to be called when a crash occurs.
HandlerType crashHandler()
Returns the installed crash handler.
void defaultCrashHandler(int signal)
The default crash handler.
QFlags< CrashFlag > CrashFlags
Stores a combination of #CrashFlag values.
Definition kcrash.h:117
void(* HandlerType)(int)
Typedef for a pointer to a crash handler function.
Definition kcrash.h:62
HandlerType emergencySaveFunction()
Returns the currently set emergency save function.
CrashFlag
Options to determine how the default crash handler should behave.
Definition kcrash.h:107
@ AlwaysDirectly
never try to to start DrKonqi via kdeinit. Use fork() and exec() instead.
Definition kcrash.h:110
@ AutoRestart
autorestart this application. Only sensible for KUniqueApplications.
Definition kcrash.h:112
@ SaferDialog
start DrKonqi without arbitrary disk access
Definition kcrash.h:109
@ KeepFDs
don't close all file descriptors immediately
Definition kcrash.h:108
void initialize()
Initialize KCrash.
void setEmergencySaveFunction(HandlerType saveFunction=nullptr)
Installs a function which should try to save the application's data.