reboot(2)                                                         reboot(2)




 NAME    [Toc]    [Back]
      reboot - boot the system

 SYNOPSIS    [Toc]    [Back]
      #include <sys/reboot.h>

      int reboot (int howto);

 DESCRIPTION    [Toc]    [Back]
      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_RECONFIG         On systems with cellular architecture, all
                               cells in the partition are rebooted in order
                               to reconfigure the stable complex
                               configuration data.  On systems with noncellular
 architecture, the default is
                               RB_AUTOBOOT.  A sync of the file system is
                               performed unless the RB_NOSYNC flag is set.

           RB_NORECONFIGBOOT   Shut down the system firmware to a "ready to
                               reconfigure" state and do not reboot.  This
                               option can be used only in combination with
                               RB_RECONFIG.

           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    [Toc]    [Back]
      If successful, this call never returns.  Otherwise, a -1 is returned
      and errno is set to indicate the error.

 ERRORS    [Toc]    [Back]
      reboot() fails if this condition is encountered:





 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 reboot(2)                                                         reboot(2)




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

 DEPENDENCIES    [Toc]    [Back]
      The default file and device for RB_AUTOBOOT is /stand/vmunix on the
      current root device.

 AUTHOR    [Toc]    [Back]
      reboot() was developed by HP and the University of California,
      Berkeley.

 SEE ALSO    [Toc]    [Back]
      reboot(1M).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003