buildsys(1M)                                                   buildsys(1M)


   NAME
         buildsys - operating system configuration script

   SYNOPSIS
         /sbin/buildsys [-s]

   DESCRIPTION
         The buildsys shell script performs the activities necessary to build
         a new bootable operating system from single user mode.  buildsys is
         executed by the shell script rc6 or during a powerup if the
         configuration of a new bootable operating system is necessary.
         Normally, buildsys will not be called if the file /stand/noautoconfig
         exists.  The bootable operating system resides in /stand, and is
         generally referred to as unix.

         Building a new operating system is usually required by hardware and
         system software changes made to your system.  These changes must be
         incorporated into the bootable operating system so that it has
         complete and correct knowledge of the system configuration.

         buildsys is not intended to be executed at the user level.

         buildsys performs the following activities:

               ⊕ checks and mounts the file systems listed in /etc/boottab
                 (it also looks at /etc/vfstab to do this)

               ⊕ runs cunix to create a new unix

               ⊕ unmounts all file systems previously mounted

               ⊕ optionally reboots the system;  a reboot is requested if
                 buildsys was run during a powerup (i.e., the -s option was
                 specified);  if it was run by rc6 (no -s option), then
                 control is returned to rc6

         If an error occurs during the configuration of a new unix, buildsys
         exits to a shell;  this gives the user a chance to fix any problems
         that might have caused the configuration process to fail, or to copy
         a version of unix to /stand/unix that is known to work in order to
         reboot the system.  Exiting this shell (using ctrl-d or exit), puts
         the machine in firmware mode.  The machine can then be rebooted from
         firmware.

   SEE ALSO
         cunix(1M), init(1M), rc6(1M), shutdown(1M), vfstab(4).
         System Administrator's Guide






   7/91                                                                 Page 1