/usr/include/mircore/mir/fatal.h is in libmircore-dev 0.26.3+16.04.20170605-0ubuntu1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /*
* Copyright © 2014 Canonical Ltd.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3 as
* published by the Free Software Foundation.
*
* This program 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* ---
* Fatal error handling - Fatal errors are situations we don't expect to ever
* happen and don't have logic to gracefully recover from. The most useful
* thing you can do in that situation is abort to get a clean core file and
* stack trace to maximize the chances of it being readable.
*
* Author: Daniel van Vugt <daniel.van.vugt@canonical.com>
* Alan Griffiths <alan@octopull.co.uk>
*/
#ifndef MIR_FATAL_H_
#define MIR_FATAL_H_
namespace mir
{
/**
* fatal_error() is strictly for "this should never happen" situations that
* you cannot recover from. By default it points at fatal_error_except().
* Note the reason parameter is a simple char* so its value is clearly visible
* in stack trace output.
* \param [in] reason A printf-style format string.
*/
extern void (*fatal_error)(char const* reason, ...);
/**
* Throws an exception that will typically kill the Mir server and propagate from
* mir::run_mir.
* \param [in] reason A printf-style format string.
*/
void fatal_error_except(char const* reason, ...);
/**
* An alternative to fatal_error_except() that kills the program and dump core
* as cleanly as possible.
* \param [in] reason A printf-style format string.
*/
void fatal_error_abort(char const* reason, ...);
// Utility class to override & restore existing error handler
class FatalErrorStrategy
{
public:
explicit FatalErrorStrategy(void (*fatal_error_handler)(char const* reason, ...)) :
old_fatal_error_handler(fatal_error)
{
fatal_error = fatal_error_handler;
}
~FatalErrorStrategy()
{
fatal_error = old_fatal_error_handler;
}
private:
void (*old_fatal_error_handler)(char const* reason, ...);
FatalErrorStrategy(FatalErrorStrategy const&) = delete;
FatalErrorStrategy& operator=(FatalErrorStrategy const&) = delete;
};
} // namespace mir
#endif // MIR_FATAL_H_
|