opensolaris man page for reboot

reboot(3C)						   Standard C Library Functions 						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 con-
       structed 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)

SunOS 5.11							    22 Mar 2004 							reboot(3C)