NAME

buildsys − operating system configuration script

SYNOPSIS

/sbin/buildsys [-m] [−s ] [−u]

DESCRIPTION

The buildsys shell script performs the activities necessary to build a new bootable operating system from single user mode.  buildsys is executed during a powerup if the reconfiguration of a new bootable operating system is necessary.  The bootable operating system resides in /stand and is generally referred to as unix. If -m option is specified, buildsys builds the minimal unix (mUNIX), which resides in /stand, instead of 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 performs the following activities:

checks and mounts the file systems necessary to execute cunix

optionally saves the current bootable unix (or mUNIX, if -m flag specified) (see NOTES below)

updates boot modules with current master file contents (unless -u flag specified)

runs cunix to create a new unix (or mUNIX, if -m specified)

unmounts all file systems previously mounted

optionally reboots the system; a reboot is requested if buildsys was run during a powerup, that is, the −s option was specified. 

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. 

NOTES

If the kernel debugger module, KDB, is listed in the system file, buildsys will automatically run dbsym(1M) and dbcmd(1M).  These programs will load the kernel symbols and macros into the new kernel so they will be accessible to the debugger. 

buildsys overwrites /stand/unix or /stand/mUNIX.  To prevent loss of the bootable unix corresponding to a crash dump when an autoconfigure runs during a crash recovery, or to save a copy of a pristine mUNIX, a procedure to save the current bootable unix or mUNIX may be enabled by editing /sbin/buildsys and following the instructions contained therein. 

SEE ALSO

crashconf(1M), cunix(1M), dbcmd(1M), dbsym(1M), init(1M), kdb(1M), mkboot(1M), rc6(1M), shutdown(1M), vfstab(4).