REBOOT(2)
NAME
reboot − reboot system or halt processor
USAGE
#include <sys/reboot.h>
reboot(howto) int howto;
DESCRIPTION
The reboot call is normally invoked in the event of unrecoverable system failures. The howto parameter is a mask of options passed to the bootstrap program. The bits of howto contain RB_HALT, which causes the processor to halt with no reboot taking place. Currently, the system call interface only permits RB_HALT to be passed to the reboot program.
NOTE: Normally, the reboot call shuts a machine down and then brings it back up automatically. The DOMAIN/IX system reboot call, however, simply shuts the machine down; you must bring the machine back up manually.
RETURN VALUES
If successful, this call never returns. Otherwise, a −1 is returned and an error is returned in the global variable errno.
ERRORS
[EPERM] The caller is not the super-user.