Crash handling header. More...

Detailed Description

Crash handling header.

Define a core_panic function that allows to stop/reboot the system when an unrecoverable problem has occurred.

Author: Kévin Roussel Kevin.nosp@m..Rou.nosp@m.ssel@.nosp@m.inri.nosp@m.a.fr

Definition in file panic.h.

#include "kernel_defines.h"

Include dependency graph for panic.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

enum	core_panic_t { PANIC_GENERAL_ERROR, PANIC_SOFT_REBOOT, PANIC_HARD_REBOOT, PANIC_ASSERT_FAIL, PANIC_EXPECT_FAIL, PANIC_SSP, PANIC_UNDEFINED }
	Definition of available panic modes. More...

NORETURN void	core_panic (core_panic_t crash_code, const char *message)
	Handle an unrecoverable error by halting or rebooting the system. More...

void	panic_arch (void)
	architecture dependent handling of a panic case More...

Enumeration Type Documentation

◆ core_panic_t

enum core_panic_t

Definition of available panic modes.

Enumerator
PANIC_SSP	stack smashing protector failure

Definition at line 34 of file panic.h.

Function Documentation

◆ core_panic()

NORETURN void core_panic	(	core_panic_t	crash_code,
		const char *	message
	)

Handle an unrecoverable error by halting or rebooting the system.

A numeric code indicating the failure reason can be given as the crash_code parameter.

Detailing the failure is possible using the message parameter. This function should serve a similar purpose as the panic() function of Unix/Linux kernels.

If the DEVELHELP macro is defined, the system will be halted; the system will be rebooted otherwise.

Warning: this function NEVER returns!

Parameters

[in]	crash_code	a unique code for identifying the crash reason
[in]	message	a human readable reason for the crash

Returns: this function never returns

◆ panic_arch()

void panic_arch ( void )

architecture dependent handling of a panic case

This function gives the CPU the possibility to execute architecture dependent code in case of a severe error.