Scroll to navigation

BOOT(9) Kernel Developer's Manual BOOT(9)

NAME

boot —
halt or reboot the system

SYNOPSIS

#include <sys/types.h>
#include <sys/systm.h>
#include <sys/reboot.h>

void
boot(int howto);

DESCRIPTION

The boot() function handles final system shutdown, and either halts or reboots the system. The exact action to be taken is determined by the flags passed in howto and by whether or not the system has finished autoconfiguration.

If the system has finished autoconfiguration, boot() does the following:

  1. If this is the first invocation of boot() and the RB_NOSYNC flag is not set in howto, syncs and unmounts the system disks by calling vfs_unmountall(9).
  2. Disables interrupts.
  3. If rebooting after a crash (i.e., if RB_DUMP is set in howto, but RB_HALT is not), saves a system crash dump.
  4. Runs any shutdown hooks previously registered.
  5. Prints a message indicating that the system is about to be halted or rebooted.
  6. If RB_HALT is set in howto, halts the system. Otherwise, reboots the system.

If the system has not finished autoconfiguration, boot() runs any shutdown hooks previously registered, prints a message, and halts the system.

SEE ALSO

vfs_unmountall(9)
February 14, 1997 Linux 4.9.0-9-amd64