reboot

Purpose

     Restarts the current virtual machine.

Syntax

       int reboot (dev)                          int reboot ((char *) 0)
       char *dev;
                                                 int reboot (""VRM"")
     Description

     The  reboot system  call restarts  (re-IPLs) the  current
     virtual machine from the  block special file specified by
     the dev parameter.   If the dev parameter is  0, the root
     device is assumed.  The reboot is automatic and brings up
     /unix in the normal, nonmaintenance mode.

     If  the dev  parameter is  the character  string" "VRM"",
     then Virtual Resource Manager is also restarted.

     The  effective user  ID of  the calling  process must  be
     superuser for this call to complete.

     Warning:  The reboot system call  does not perform a sync
     operation or write pending  output to disk.  File systems
     may  be  damaged  if  reboot  is  invoked  without  first
     ensuring that all disk output has completed.

     Return Value

     Upon successful  completion, the reboot system  call does
     not return.  If the reboot  system call fails, a value of
     -1 is returned and errno is set to indicate the error.

     Diagnostics

     The reboot system  call fails if one or more  of the fol-
     lowing are true:

     EPERM      The effective  user ID of the  calling process
                is not superuser.

     ENOENT     The specified special file does not exist.

     ENOTBLK    The dev  parameter does  not point to  a block
                device file.

     ENXIO      The device  associated with the  dev parameter
                does not exist or is a remote file.

     EFAULT     The dev parameter &pointsout..

     Related Information

     In this book:  "iplvm, waitvm" and "sync."

     The  shutdown command  in AIX  Operating System  Commands
     Reference.