Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2017
 
 

reboot(3C)

Name

reboot - reboot system or halt processor

Synopsis

#include <sys/reboot.h>

int reboot(int howto, char *bootargs);

Description

The reboot() function reboots the system. The howto argument specifies the behavior of the system while rebooting and is a mask constructed by a bitwise-inclusive-OR of flags from the following list:

RB_AUTOBOOT

The machine is rebooted from the root filesystem on the default boot device. This is the default behavior. See boot(1M) and kernel(1M).

RB_HALT

The processor is simply halted; no reboot takes place. This option should be used with caution.

RB_ASKNAME

Interpreted by the bootstrap program and kernel, causing the user to be asked for pathnames during the bootstrap.

RB_DUMP

The system is forced to panic immediately without any further processing and a crash dump is written to the dump device (see dumpadm(1M)) before rebooting.

Any other howto argument causes the kernel file to boot.

The interpretation of the bootargs argument is platform-dependent.

Return Values

Upon successful completion, reboot() never returns. Otherwise, −1 is returned and errno is set to indicate the error.

Errors

The reboot() function will fail if:

EPERM

The {PRIV_SYS_CONFIG} privilege is not asserted in the effective set of the calling process.

See Also

Intro(1M), boot(1M), dumpadm(1M), halt(1M), init(1M), kernel(1M), reboot(1M), uadmin(2)