reboot(3)          UNIX System V(BSD Compatibility Package)           reboot(3)


NAME
      reboot - reboot system or halt processor

SYNOPSIS
      cc [ flag. . . ] file . . . -lucb

      #include <sys/reboot.h>

      reboot(howto, [ bootargs ] )
      int howto;
      char *bootargs;

DESCRIPTION
      reboot reboots the system, and is invoked automatically in the event of
      unrecoverable system failures.  howto is a mask of options passed to the
      bootstrap program.  The system call interface permits only RBHALT or
      RBAUTOBOOT 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 instance
      RBAUTOBOOT) is given, the system is rebooted from file /stand/unix.  An
      automatic consistency check of the disks is then normally performed.

      The bits of howto that are used are:

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

      RBASKNAME     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 /stand/unix without asking.

RETURN VALUE
      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.

FILES
      /vmunix

SEE ALSO
      halt(1M) init(1M) reboot(1M)

      intro(1M), crash(1M) in the System Administrator's Reference Manual

NOTES
      Any other howto argument causes /stand/unix to boot.

      Only the super-user may reboot a machine.




10/89                                                                    Page 1