Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
reboot(2)		      System Calls Manual		     reboot(2)

       reboot -	reboot system or halt processor

       #include	<sys/reboot.h>

       int howto;

       howto   The howto argument is a mask of options passed to the bootstrap

	       The bits	of howto are:

		      the processor is simply halted; no reboot	 takes	place.
		      RB_HALT should be	used with caution.

		      Interpreted  by the bootstrap program itself, causing it
		      to inquire as to what file should	be booted.   Normally,
		      the system is booted from	the file "xx(0,0)vmunix" with-
		      out asking.

		      Normally,	the reboot  procedure  involves	 an  automatic
		      disk  consistency	 check and then	multi-user operations.
		      RB_SINGLE	prevents the consistency check,	rather	simply
		      booting  the system with a single-user shell on the con-
		      sole.  RB_SINGLE is interpreted by the  init(8)  program
		      in  the  newly booted system.  This switch is not	avail-
		      able from	the system call	interface.

	       Only the	superuser may a	machine.

       The system call reboots the system, and is invoked automatically	in the
       event of	unrecoverable system failures.	The system call	interface per-
       mits only RB_HALT or RB_AUTOBOOT	to be passed to	 the  reboot  program;
       the other flags are used	in scripts stored on the console storage media
       or used in manual bootstrap procedures.	When  none  of	these  options
       (for  example,  RB_AUTOBOOT) is given, the system is rebooted from file
       in the root file	system of unit 0 of a disk chosen in a	processor-spe-
       cific  way.   Normally,	an automatic consistency check of the disks is
       then performed.

Return Values
       If successful, this call	never returns.	Otherwise, a -1	 is  returned,
       and an error is stored in the global variable errno.

       The call	fails under the	following condition:

       [EPERM]	      The caller is not	the superuser.

See Also
       crash(8v), halt(8), init(8), reboot(8)


Name | Syntax | Arguments | Description | Return Values | Diagnostics | See Also

Want to link to this manual page? Use this URL:

home | help