tail head cat sleep
QR code linking to this page

Manual Pages  — PANIC

NAME

panic – bring down system on fatal error

CONTENTS

SYNOPSIS

#include <sys/types.h>
#include <sys/systm.h>
extern char *panicstr;

void
panic(const char *fmt, ...);

void
vpanic(const char *fmt, va_list ap);

KERNEL_PANICKED();

DESCRIPTION

The panic() and vpanic() functions terminate the running system. The message fmt is a printf(3) style format string. The message is printed to the console and panicstr is set pointing to the address of the message text. This can be retrieved from a core dump at a later time.

Upon entering the panic() function the panicking thread disables interrupts and calls critical_enter(9). This prevents the thread from being preempted or interrupted while the system is still in a running state. Next, it will instruct the other CPUs in the system to stop. This synchronizes with other threads to prevent concurrent panic conditions from interfering with one another. In the unlikely event of concurrent panics, only one panicking thread will proceed.

Control will be passed to the kernel debugger via kdb_enter(). This is conditional on a debugger being installed and enabled by the debugger_on_panic variable; see ddb(4) and gdb(4). The debugger may initiate a system reset, or it may eventually return.

Finally, kern_reboot(9) is called to restart the system, and a kernel dump will be requested. If panic() is called recursively (from the disk sync routines, for example), kern_reboot() will be instructed not to sync the disks.

The vpanic() function implements the main body of panic(). It is suitable to be called by functions which perform their own variable-length argument processing. In all other cases, panic() is preferred.

The KERNEL_PANICKED() macro is the preferred way to determine if the system has panicked. It returns a boolean value. Most often this is used to avoid taking an action that cannot possibly succeed in a panic context.

EXECUTION CONTEXT

Once the panic has been initiated, code executing in a panic context is subject to the following restrictions:

RETURN VALUES

The panic() and vpanic() functions do not return.

SEE ALSO

printf(3), ddb(4), gdb(4), KASSERT(9), kern_reboot(9)

PANIC (9) March 17, 2023

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

Unix...best if used before: Tue Jan 19 03:14:08 GMT 2038