'\"macro stdmacro
.if n .pH g1a.buildsys @(#)buildsys	40.10 of 10/10/89
.\" Copyright 1989 AT&T
'\"macro stdmacro
.nr X
.if \nX=0 .ds x} buildsys 1M "Essential Utilities" "\&"
.if \nX=1 .ds x} buildsys 1M "Essential Utilities"
.if \nX=2 .ds x} buildsys 1M "" "\&"
.if \nX=3 .ds x} buildsys "" "" "\&"
.TH \*(x}
.SH NAME
\f4buildsys\f1 \- operating system configuration script
.SH SYNOPSIS
\f4/sbin/buildsys\f1 [\f4-s\f1]
.SH DESCRIPTION
The \f4buildsys\f1 shell script performs the activities necessary
to build a new bootable operating system from single user mode.
\f4buildsys\f1 is executed by the shell script \f4rc6\f1 or during
a powerup if the configuration of a new bootable operating system is
necessary.
The bootable operating system resides in \f4/stand\f1,
and is generally referred to as \f4unix\f1.
.P
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.
.P
\f4buildsys\f1 is not intended to be executed at the user level.
.P
\f4buildsys\f1 performs the following activities:
.RS
.IP \(bu .2i
checks and mounts the file systems listed in \f4/etc/boot_tab\f1 (it
also looks at \f4/etc/vfstab\f1 to do this)
.IP \(bu .2i
runs \f4cunix\f1 to create a new \f4unix\f1
.IP \(bu .2i
unmounts all file systems previously mounted
.IP \(bu .2i
optionally reboots the system;  a reboot is requested if \f4buildsys\f1
was run during a powerup (i.e., the \f4\-s\f1 option was specified);  if
it was run by \f4rc6\f1 (no \f4\-s\f1 option), then
control is returned to \f4rc6\f1
.RE
.P
If an error occurs during the configuration of a new
\f4unix\f1, \f4buildsys\f1 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 \f4unix\f1 to
\f4/stand/unix\f1 that is known to work in order to reboot the system.
Exiting this shell (using \f4ctrl-d\f1 or \f4exit\f1), puts the machine in firmware mode.
The machine can then be rebooted from firmware.
.SH SEE ALSO
\f4cunix\f1(1M),
\f4init\f1(1M),
\f4rc6\f1(1M),
\f4shutdown\f1(1M),
\f4vfstab\f1(4).
.br
\f2System Administrator's Guide\f1
