reboot(2)

NAME

reboot − boot the system

SYNOPSIS

#include <sys/reboot.h>

int reboot (int howto);

DESCRIPTION

reboot() causes the system to reboot. howto is a mask of reboot options (see <sys/reboot.h>), specified as follows:

RB_AUTOBOOT A file system sync is performed (unless RB_NOSYNC is set) and the processor is rebooted from the default device and file.

RB_HALT The processor is simply halted. A sync of the file system is performed unless the RB_NOSYNC flag is set. RB_HALT should be used with caution.

RB_NOSYNC A sync of the file system is not performed.

Unless the RB_NOSYNC flag has been specified, reboot(2) unmounts all mounted file systems and marks them clean so that it will not be necessary to run fsck(1M) on these file systems when the system reboots.

Only users with appropriate privileges can reboot a machine.

RETURN VALUE

If successful, this call never returns. Otherwise, a −1 is returned and errno is set to indicate the error.

ERRORS

reboot() fails if this condition is encountered:

[EPERM] The effective user ID of the caller is not a user with appropriate privileges.

DEPENDENCIES

The default file and device for RB_AUTOBOOT is /stand/vmunix on the current root device.

AUTHOR

reboot() was developed by HP and the University of California, Berkeley.

Museum

Related Articles