386BSD 0.1 development
authorWilliam F. Jolitz <wjolitz@soda.berkeley.edu>
Wed, 8 May 1991 05:43:36 +0000 (21:43 -0800)
committerWilliam F. Jolitz <wjolitz@soda.berkeley.edu>
Wed, 8 May 1991 05:43:36 +0000 (21:43 -0800)
Work on file usr/othersrc/share/doc/smm/01.setup/tahoe/1.t
Work on file usr/othersrc/share/doc/smm/01.setup/tahoe/0.t
Work on file usr/othersrc/share/doc/smm/01.setup/tahoe/2.t
Work on file usr/othersrc/share/doc/smm/01.setup/tahoe/Makefile
Work on file usr/othersrc/share/doc/smm/01.setup/tahoe/a.t
Work on file usr/othersrc/share/doc/smm/01.setup/tahoe/b.t

Co-Authored-By: Lynne Greer Jolitz <ljolitz@cardio.ucsf.edu>
Synthesized-from: 386BSD-0.1

usr/othersrc/share/doc/smm/01.setup/tahoe/0.t [new file with mode: 0644]
usr/othersrc/share/doc/smm/01.setup/tahoe/1.t [new file with mode: 0644]
usr/othersrc/share/doc/smm/01.setup/tahoe/2.t [new file with mode: 0644]
usr/othersrc/share/doc/smm/01.setup/tahoe/Makefile [new file with mode: 0644]
usr/othersrc/share/doc/smm/01.setup/tahoe/a.t [new file with mode: 0644]
usr/othersrc/share/doc/smm/01.setup/tahoe/b.t [new file with mode: 0644]

diff --git a/usr/othersrc/share/doc/smm/01.setup/tahoe/0.t b/usr/othersrc/share/doc/smm/01.setup/tahoe/0.t
new file mode 100644 (file)
index 0000000..7672a7a
--- /dev/null
@@ -0,0 +1,103 @@
+.\" Copyright (c) 1988 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)0.t 1.6 (Berkeley) 5/7/91
+.\"
+.nr Th 1               \" Tahoe version
+.ds Th Tahoe
+.ds Ux \s-1UNIX\s0
+.ds Bs \s-1BSD\s0
+.\" Current version:
+.ds 4B 4.3\*(Bs-tahoe
+.\" machine:
+.ds Mc \*(Th
+.ds mC tahoe
+.ds Dk dk
+.ds Dn Eagle
+.ds Pa c
+.ds Ps 4.3\*(Bs-beta
+.ds Vs \s-1VERSA\s0bus
+.ds Vm "\s-1VME\s0 bus
+.de Sm
+\s-1\\$1\s0\\$2
+..
+.bd S B 3
+.EH 'SMM:1-%''Installing and Operating \*(4B \*(Ux on the \*(Th'
+.OH 'Installing and Operating \*(4B \*(Ux on the \*(Th''SMM:1-%'
+.TL
+Installing and Operating \*(4B \*(Ux* on the \*(Th
+.br
+July 14, 1988
+.AU
+Samuel J. Leffler
+.AU
+Keith Bostic
+.AU
+Michael J. Karels
+.AU
+Marshall Kirk McKusick
+.AI
+Computer Systems Research Group
+Department of Electrical Engineering and Computer Science
+University of California, Berkeley
+Berkeley, California  94720
+(415) 642-7780
+.de IR
+\\fI\\$1\|\\fP\\$2
+..
+.de UX
+\*(Ux\\$1
+..
+.AB
+.PP
+.FS
+*\*(Ux is a register trademark of AT&T in the USA and other countries.
+.FE
+This document contains instructions for the
+installation and operation of the
+\*(4B release of
+.UX
+as distributed by The University of California at Berkeley
+for the \*(Th (CCI Power 6/32 and similar machines).
+.PP
+It discusses procedures for installing \*(Ux on a new machine,
+and for upgrading an existing 4.2\*(Bs \*(Th \*(Ux system to the new release.
+An explanation of how to lay out file systems on available disks,
+how to set up terminal lines and user accounts,
+and how to do system-specific tailoring is provided.
+A description of how to install and configure the networking
+facilities included with \*(4B is included.
+Finally, the document details system operation procedures:
+shutdown and startup,
+hardware error reporting and diagnosis, file system backup procedures,
+resource control, performance monitoring, and procedures for recompiling
+and reinstalling system software.
+.AE
diff --git a/usr/othersrc/share/doc/smm/01.setup/tahoe/1.t b/usr/othersrc/share/doc/smm/01.setup/tahoe/1.t
new file mode 100644 (file)
index 0000000..bf3db47
--- /dev/null
@@ -0,0 +1,398 @@
+.\" Copyright (c) 1988 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)1.t 1.6 (Berkeley) 5/7/91
+.\"
+.ds lq ``
+.ds rq ''
+.ds LH "Installing/Operating \*(4B
+.ds RH Introduction
+.ds CF \*(DY
+.LP
+.nr H1 1
+.bp
+.LG
+.B
+.ce
+1. INTRODUCTION
+.sp 2
+.R
+.NL
+.PP
+This document explains how to install the Berkeley
+version of \*(Ux for the \*(Th on your system.  While this is the first
+release from Berkeley for the \*(Th, the version of
+.UX
+distributed by Computer Consoles Inc. (CCI) was derived from 4.2BSD.
+Consequently, the filesystem
+format is compatible and it will only be necessary for you to perform
+a full bootstrap procedure if you are installing the release on a new
+machine.
+The System V \*(Ux systems distributed by CCI, Unisys (Sperry) and Harris
+are also derived from 4.2BSD, but only the network and filesystem
+remain compatible with \*(4B.
+The object file formats are completely different in the System V
+releases.
+Thus, the most straightforward procedure for upgrading a System V
+system is to perform a full bootstrap.
+.PP
+The full bootstrap procedure
+is outlined in chapter 2; the process includes booting standalone
+utilities from tape to format a disk, if necessary, and then copying
+a small root filesystem image onto a swap area.  This filesystem is
+then booted and used to extract a dump of a standard root filesystem.
+Finally, that root filesystem is booted, and the remainder of the system
+binaries and sources are read from the archives on the tape(s).
+.PP
+The technique for upgrading a 4.2 or beta-release 4.3BSD system is described
+in chapter 3 of this document.
+As \*(4B is completely compatible with the beta release,
+and sufficiently compatible with the vendor-supplied 4.2BSD releases,
+the upgrade procedure involves extracting a new set of system binaries
+onto new root and /usr filesystems.
+The sources are then extracted, and local configuration files are merged
+into the new system.  User filesystems may be upgraded in place.
+All 4.3BSD-beta binaries may be used with \*(4B in the course
+of the conversion.
+It is desirable to recompile local sources after the conversion,
+as the compilers have had many fixes installed.
+However, due to significant incompatibilities between
+the vendor-derived versions of 4.2BSD and the Berkeley \*(4B release, many
+4.2BSD binary images will not function properly.  For such programs it
+will be both necessary and desirable to recompile this software after
+the conversion.  Consult section 3 for a description of the differences
+between \*(4B and the previous vendor-supplied systems for the \*(Th.
+.NH 2
+Hardware supported
+.PP
+This distribution can be booted on a CCI Power 6/32, Harris HCX-7,
+Unisys (Sperry) 7000/40, or ICL Clan 7 with any disks supported on the \*(Vs
+disk controllers sold by these vendors (SMD/E or VDDC).
+The new CCI SMD/E controller with working scatter-gather I/O
+is supported as well.
+In particular, the following drives are supported:
+.DS
+.TS
+l l.
+FUJITSU 160M   CDC 9766 300M
+FUJITSU 330M   CDC 340M
+FUJITSU 2351 Eagle     CDC 515M
+Maxtor 340M
+.TE
+.DE
+The distribution can also be booted on a Harris HCX-9
+using any disk on the HDC disk controller on the \*(Vm,
+although the \*(Vm tapes are not currently supported.
+.PP
+The only tape drives supported by this distribution are 9-track tape drives
+attached to the Ciprico Tapemaster tape controller.
+.NH 2
+Distribution format
+.PP
+The distribution comes in two formats:
+.DS
+(3)\0\0 1600bpi  2400'  9-track magnetic tapes, or
+(1)\0\0 6250bpi  2400'  9-track magnetic tape
+.DE
+Installation from scratch on any machine requires a tape unit.  If your
+machine is currently running 4.2 or 4.3BSD-beta and has a network connection
+to a 4.2 or 4.3BSD machine with a tape drive, it is a simple matter to
+install the software from a remote tape drive.
+.PP
+If you have the facilities, we \fBstrongly\fP recommend copying the
+magnetic tape(s) in the distribution kit to guard against disaster.
+The tapes contain some 1024-byte records followed by many
+10240-byte records.  There are interspersed tape marks;
+end-of-tape is signaled by a double end-of-file.  The first file
+on the tape is a very small file system containing
+preliminary bootstrapping programs.  This is followed by a binary image
+of an approximately 2 megabyte ``mini root'' file system.  Following
+the mini root file is a full dump of the root file system
+(see \fIdump\fP\|(8)*).
+.FS
+\ * References of the form \fIX\fP(Y) mean the entry named
+\fIX\fP in section Y of the
+.UX
+programmer's manual.
+.FE
+Additional files on the tape(s)
+contain tape archive images of the system binaries and sources (see
+\fItar\fP\|(1)).  See Appendix A for a description of the contents
+and format of the tape(s).
+One file contains software
+contributed by the user community; refer to the accompanying
+documentation for a description of its contents and an
+explanation of how it should be installed.
+.NH 2
+Hardware terminology
+.PP
+This section gives a short discussion of hardware terminology
+to help you get your bearings. 
+.PP
+The Power 6/32 (and most related machines being shipped) use a \*(Vs
+for all I/O peripherals.
+The console processor used for bootstrap and
+diagnostic purposes is also located on the \*(Vs.
+The Harris HCX-9 uses a \*(Vm instead of a \(*Vs; however, the architecture
+is completely analogous, and the following discussion applies with the
+exception of the name of the bus and the name of the disk controller.
+The device naming
+conventions described here apply to the console processor; under \*(Ux
+device naming is considerably simpler.
+.PP
+The \*(Vs is a 32-bit bus that supports devices which
+use 16-bit, 24-bit, or 32-bit addresses (or some combination).
+The type of each address placed on the \*(Vs is indicated
+by an accompanying \fIaddress modifier\fP.  In addition to the
+width of the
+address present on the bus, \*(Vs address modifiers
+may be used to indicate the privileges of the requesting
+program (.e.g the program is executing in supervisory mode).
+The 6/32's \*(Vs adapter accepts device requests with either
+16, 24, or 32-bit address modifiers.
+16-bit addresses are used to access control registers
+for \*(Vs devices.
+24-bit addresses are used to access up to one megabyte of \*(Vs
+local memory or device shared memory
+as well as the first 15Mb of main memory.
+24-bit addresses are used for DMA by some peripherals,
+interpreting the address
+as an absolute physical address in referencing main memory.
+Other devices use 32-bit addressing, allowing them to access all
+of main memory.
+This means that the address space for 24-bit devices overlaps
+that of 32-bit devices.
+Devices which do not support full 32-bit
+addressing can be difficult to work with as their limited addressing
+restricts the placement of I/O buffers in main memory.  Unfortunately,
+because the \*(Vs has had limited acceptance, there are
+very few good \*(Vs device controllers available; this has
+resulted in several non-\*(Vs devices being attached to the
+\*(Vs through bus-adapter cards.  Devices of this sort often
+support only 20-bit or 24-bit addressing.
+.PP
+From the \*(Th side of the \*(Vs adaptor,
+the three address spaces are mapped so as to avoid
+overlaps.  Physical addresses in the range 0xffff0000 to 0xfffffff are
+used to access \*(Vs devices which use 16-bit addresses.  References
+to this region of the \*(Th address space result in a \*(Vs
+transfer with a 16-bit address generated from the lower order 16
+bits of the memory address and a ``short addressing non-privileged I/O
+access'' address modifier (0x10).  Addresses in the range 0xff000000 to
+0xffff0000 are used to access 24-bit \*(Vs devices, generating a 24-bit
+address and a ``standard addressing non-privileged data access''
+address modifier (0x01).
+Within this range, addresses from 0xfff00000 to 0xffff0000 refer
+to \*(Vs local memory used by devices (such as the VIOC)
+for shared communication areas.
+Finally, any other address in the
+the primary I/O adapter space, 0xc0000000 to 0xff000000, generates
+a 32-bit \*(Vs address with an ``extended addressing non-privileged
+data access'' address modifier (0xf1).  Note, however, that 32-bit
+addresses generated by references to this region result in a \*(Vs
+address with bits 31-30 set to 0.  Thus, for example, a reference to
+a device located at 0xfe000000 would result in a \*(Vs transfer
+with the address set to 0x3e000000.  A complete list of the characteristics
+of the devices supported in the system may be found in Appendix A.
+.PP
+The console processor on most \*(Vs machines has a set of names for devices:
+.DS
+.TS
+l l.
+FUJITSU 160M disk drives       fsd
+FUJITSU 330M disk drives       fuj
+FUJITSU 450M disk drives       egl**
+CDC 300M disk drives   smd
+CDC 340M disk drives   xfd
+CDC 515M disk drives   xsd
+MXD Maxtor 340M disk drives    mxd
+Cipher tape drives     cyp
+.TE
+.FS
+**\|Eagle drives are not supported by the console processor on all tahoe
+machines.
+.FE
+.DE
+Devices are fully specified to the console processor with:
+.DS
+xxx(y,z)
+.DE
+where \fIxxx\fP is one of the above names (e.g. \fIxfd\fP).
+The value \fIy\fP specifies a controller to use and also
+the device; it is computed as
+.DS
+8 * \fIcontroller\fP + \fIdevice\fP
+.DE
+Thus, controller 0 (by convention the controller located at \*(Vs
+address 0xfff2400), drive 0 would have a \fIy\fP value of 0
+while controller 1 (address of 0xfff2800) drive 0 would have a \fIy\fP
+value of 4*.
+.FS
+*\|Note that this means you can not reference drives 4-15 on a
+controller; as a result we expect the console interface to
+change soon.
+.FE
+The \fIz\fP value is interpreted differently for tapes and disks;
+for disks it is a disk block, and for tapes it is a file number
+on the tape.
+.PP
+The HCX-9 uses different controllers and terminology:
+.DS
+.TS
+l l.
+disks on HDC controller        dsk
+Xylogics tapes ???
+.TE
+.DE
+Devices are fully specified to the console processor with:
+.DS
+xxx(x,y,z)
+.DE
+where \fIxxx\fP is one of the above names (e.g. \fIdsk\fP).
+The value \fIy\fP specifies the device unit number.
+Thus, controller 0 (by convention the controller located at \*(Vs
+address 0xfff2400), drive 0 would have a \fIy\fP value of 0
+while controller 1 (address of 0xfff2800) drive 0 would have a \fIy\fP
+value of 4*.
+The \fIz\fP value is interpreted as on the other systems.
+.PP
+The console processor has the notion of a \fIdefault device\fP
+to use with file related commands.  The default device is specified
+according to the form shown above.  Further, the console processor,
+by default, interprets certain system files on the default disk to discover
+information about disk drives in the system.  As
+.UX
+device names are decidedly different from the names used by the
+console processor this can lead to serious confusion.  We will
+return to this problem later in section 4; for now you should
+simply be aware of the difference in naming conventions.
+.NH 2
+\*(Ux device naming
+.PP
+\*(Ux has a set of names for devices which are different
+from the CCI names for the devices, viz.:
+.DS
+.TS
+l l.
+\*(Vs (SMD/E, VDDC) disk drives        dk
+\*(Vm (HDC) disk drives        hd
+Cipher tape drives     cy
+.TE
+.DE
+.PP
+The standalone system, used to bootstrap the full \*(Ux system,
+uses device names of the form:
+.DS
+xx(c,d,p)
+.DE
+where \fIxx\fP is the device type, normally \fIdk\fP or \fIcy\fP.  The
+value \fIc\fP specifies the controller to use, and \fId\fP specifies
+the device.  The \fIp\fP value is interpreted differently for tapes
+and disks: for disks it is a disk \fIpartition\fP (in the range 0-7),
+and for tapes it is a file number offset on the tape.  Thus, partition
+1 of a ``dk'' type disk drive on controller vd0 at drive 0 would be
+``dk(0,0,1)''.  Normally the controller will be controller 0; it
+may therefore be omitted from the device specification, and most of
+the examples in this document reflect this.  When not running
+standalone, this partition would normally be available as ``/dev/dk0b''.
+Here the prefix ``/dev'' is the name of the directory where all
+``special files'' normally live, the ``dk'' serves the obvious purpose,
+the ``0'' identifies this as a partition of dk drive number ``0'' and
+the ``b'' identifies this as the second partition.
+.PP
+In all simple cases, where only a single controller is present, a drive
+with unit number 0 (determined by its unit plug on the front of the drive)
+will be called unit 0 in its \*(Ux file name.  This is not, however, strictly
+necessary, since the system has a level of indirection in this naming.
+If there are multiple controllers, the disk unit numbers will normally
+be counted sequentially across controllers.  This can be taken
+advantage of to make the system less dependent on the interconnect
+topology, and to make reconfiguration after hardware failure extremely
+easy.
+.PP
+Each \*(Ux physical disk is divided into at most 8 logical disk partitions,
+each of which may occupy any consecutive cylinder range on the physical
+device.  The cylinders occupied by the 8 partitions for each drive type
+are specified initially in the disk description file /etc/disktab
+(c.f. \fIdisktab\fP(5)).  The partition information and description of the
+drive geometry are written in the first sector of each disk with the
+\fIdisklabel\|\fP(8) program.  Each partition may be used for either a
+raw data area such as a paging area or to store a \*(Ux file system.
+It is conventional for the first partition on a disk to be used
+to store a root file system, from which \*(Ux may be bootstrapped.
+The second partition is traditionally used as a paging area, and the
+rest of the disk is divided into spaces for additional ``mounted
+file systems'' by use of one or more additional partitions.
+.PP
+Returning to the discussion of the standalone system, we recall
+that tapes also took three integer parameters.  In the normal case
+where the Cipher tape drive is unit 0 on the first controller
+(the only unit supported by the standalone utilities), the
+files on the tape have names ``cy(0,0,0)'' (or just ``cy(0,0)'',
+``cy(0,1)'', etc.
+Here ``file'' means a tape file containing a single data stream
+terminated by a tape mark.*
+.FS
+* Note that while a tape file consists of a single data stream,
+the distribution tape(s) have data structures in these files.
+Although the tape(s) contain only a few tape files, they comprise
+several thousand \*(Ux files.
+.FE
+.NH 2
+\*(Ux devices: block and raw
+.PP
+\*(Ux makes a distinction between ``block'' and ``raw'' (character)
+devices.  Each disk has a block device interface where
+the system makes the device byte addressable and you can write
+a single byte in the middle of the disk.  The system will read
+out the data from the disk sector, insert the byte you gave it
+and put the modified data back.  The disks with the names
+``/dev/xx0[a-h]'', etc., are block devices.
+There are also raw devices available.
+These have names like ``/dev/rxx0[a-h]'', the
+``r'' here standing for ``raw''.
+Raw devices bypass the buffer cache and use DMA directly to/from
+the program's I/O buffers;
+they are normally restricted to full-sector transfers.
+In the bootstrap procedures we
+will often suggest using the raw devices, because these tend
+to work faster.
+Raw devices are used when making new filesystems,
+when checking unmounted filesystems,
+or for copying quiescent filesystems.
+The block devices are used to mount file systems,
+or when operating on a mounted filesystem such as the root.
+.PP
+You should be aware that it is sometimes important whether to use
+the character device (for efficiency) or not (because it wouldn't
+work, e.g. to write a single byte in the middle of a sector).
+Don't change the instructions by using the wrong type of device
+indiscriminately.
diff --git a/usr/othersrc/share/doc/smm/01.setup/tahoe/2.t b/usr/othersrc/share/doc/smm/01.setup/tahoe/2.t
new file mode 100644 (file)
index 0000000..38b6990
--- /dev/null
@@ -0,0 +1,597 @@
+.\" Copyright (c) 1988 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)2.t 1.8 (Berkeley) 5/7/91
+.\"
+.ds lq ``
+.ds rq ''
+.ds LH "Installing/Operating \*(4B
+.ds RH Bootstrapping
+.ds CF \*(DY
+.bp
+.nr H1 2
+.nr H2 0
+.bp
+.LG
+.B
+.ce
+2. BOOTSTRAP PROCEDURE
+.sp 2
+.R
+.NL
+.PP
+This section explains the bootstrap procedure that can be used
+to get the kernel supplied with this distribution running on your machine.
+If you are not currently running 4.2BSD you will
+have to do a full bootstrap.
+Chapter 3 describes how to upgrade a 4.2BSD system.
+An understanding of the operations used in a full bootstrap
+is very helpful in performing an upgrade as well.
+In either case, it is highly desirable to read and understand
+the remainder of this document before proceeding.
+.NH 2
+Booting from tape
+.PP
+The tape bootstrap procedure used to create a
+working system involves the following major
+steps:
+.IP 1)
+Format a disk pack with the \fIvdformat\fP program, if necessary.
+.IP 2)
+Copy a ``mini root'' file system from the
+tape onto the swap area of the disk.
+.IP 3)
+Boot the UNIX system on the ``mini root.''
+.IP 4)
+Restore the full root file system using \fIrestore\fP\|(8).
+.IP 5)
+Reboot the completed root file system.
+.IP 6)
+Label the disks with the \fIdisklabel\fP\|(8) program.
+.IP 7)
+Build and restore the /usr file system from tape
+with \fItar\fP\|(1).
+.IP 8)
+Extract the system and utility files and contributed software
+as desired.
+.PP
+The following sections describe the above steps in detail.  In these
+sections references to disk drives are of the form \fIxx\fP\|(\fId\fP,
+\fIp\fP) and references to files on tape drives are of the form
+\fIxx\fP\|(\fIc\fP,\fId\fP, \fIp\fP)
+where \fIxx\fP are device types described in section 1.4,
+\fIc\fP is the (optional) controller unit number,
+\fId\fP is the drive unit number, and \fIp\fP is a disk partition
+or tape file offset numbers as described in section 1.4.
+For the sake of simplicity, all disk examples will use the disk type
+``dk'' and all tape examples will similarly use ``cy'';
+the examples assume drive 0, partition 0.
+Commands you
+are expected to type are shown in italics, while that information
+printed by the system is shown emboldened.
+.PP
+If you encounter problems while following the instructions in
+this part of the document, refer to Appendix B for help in
+troubleshooting.
+.NH 3
+Step 1: formatting the disk
+.PP
+All disks used with \*(4B should be formatted to insure
+the proper handling of physically corrupted disk sectors.
+The
+.I vdformat
+program included in the distribution, or a vendor supplied
+formatting program, may be used to format disks if this has not
+already been done.  The \fIvdformat\fP program is capable of formatting
+any of the disk drives listed in section 1.1, when booting from tape;
+when booting from disk, it supports any drive listed in
+\fI/etc/disktab\fP.
+.PP
+To load the \fIvdformat\fP program, perform the following steps.
+.DS
+.TS
+lw(2i) l.
+(machine powered up)
+\fBMIB POC\fP
+\fBType '#' to cancel boot\fP
+\fI#\fP        (cancel automatic reboot)
+\fBCP [a10.h0]#>\fP\fI\|h\fP   (halt the cpu)
+\fB#>\|\fP\fIfd cyp(0,0)\fP    (make cypher default device)
+\fB#>\|\fP\fIp23 3.\fP \fB00000000\fP  (set boot flags)
+\fB#>\|\fP\fIy.\fP     (initialize the machine)
+\fB#>\|\fP\fIfb\fP     (boot machine)
+\fBcyp(0,0)/etc/fstab\fP
+\fBCP cold boot\fP
+\fB4 way interleave set\fP
+\fBCPU memory test\fP
+\fBECC CPU memory test\fP
+\fBcyp(0,0)/.\fP
+\fBCPU POC1\fP
+\fBcyp(0,0)/poc1\fP
+\fBCPU POC2\fP
+\fBcyp(0,0)/poc2\fP
+\fBFPP POC\fR  (only if floating point processor present)
+\fBcyp(0,0)/fppoc\fP
+\fBFPP WCS\fR  (only if floating point processor present)
+\fBcyp(0,0)/fppwcs\fP
+\fBBOOT SYSTEM cyp(0,0)/boot\fP
+
+\fBBoot\fP
+\fB:\fIcy(0,0)stand/vdformat\fR        (load and run from first tape file)
+\fB52224+17408+1177716 start 0x1000\fP
+\fBVDFORMAT     Berkeley Version 1.6\fP
+.TE
+
+\fBcontroller 0: smd\fP
+\fBcontroller 1: smd-e\fP
+
+\fBType `Help' for help, `Start' to execute operations.\fP
+
+\fBvdformat>\fP
+.DE
+.PP
+The \fIvdformat\fP program should now be running and awaiting your input.
+If you made a mistake loading the program off the tape
+you should get either the ``:'' prompt again (from the
+boot program) or the ``#>'' prompt from the console
+processor.  In either case you can retype the appropriate
+command to try again.
+If something else happened, you may have a bad distribution
+tape, or your hardware may be broken; refer to
+Appendix B for help in troubleshooting.
+.PP
+\fIVdformat\fP will create sector headers and verify
+the integrity of each sector formatted.  
+The program starts up by identifying the disk controllers
+installed in the machine.  Old VDDC controllers which 
+support only SMD drives are indicated
+as ``smd'' while newer controllers capable of supporting both
+SMD and extended-SMD drives are tagged as ``smd-e''. 
+\fIVdformat\fP
+will prompt for the information required as shown below.
+If you err in answering questions,
+``Delete'' or backspace erase the last character typed, and ``^U'' erases
+the current input line.  At any point you can ask for
+assistance by typing ``help''; \fIvdformat\fP will list
+the possible answers to the current question.
+.DS
+\fBvdformat>\fP\|\fIformat\fP
+  \fBFormat on which controllers?\fP\|\fI1\fP
+    \fBDrives on controller 1?\fP\|\fI0\fP
+      \fBNumber of patterns to use while verifying?\fP\|\fI1\fP
+      \fBDrive type for controller 1, drive 0?\fP\|\fIegl\fP
+        \fBModule serial number for controller 1, drive 0?\fP\|\fI1\fP
+\fBvdformat>\fP\|\fIlist\fP
+  \fBThe following operations will occur when Start is issued:\fP
+    \fBFormat: Controller 1, drive 0, type EGL.\fP
+\fBvdformat>\fP\|\fIstart\fP
+\fBStarting format on controller 1, drive 0, type EGL.\fP
+(\fIbad sectors will be indicated\fP)
+\fBvdformat>\fP
+.DE
+Once the root device has been formatted, \fIvdformat\fP
+will prompt for another command.
+Return to the bootstrap by typing
+.DS
+\fBvdformat>\fP\|\fIexit\fP
+.DE
+or halt the machine by
+typing ``~h''.
+.DS
+\fBvdformat>\fP \fI~h\fP
+\fB#>\|\fP
+.DE
+.PP
+It may be necessary to format other drives before constructing
+file systems on them; this can be done at a later time with the
+steps just performed, or \fIvdformat\fP may be brought in
+off a disk drive as described in \(sc6.1.
+.NH 3
+Step 2: copying the mini-root file system
+.PP
+The second step is to run a simple program, \fIcopy\fP, to copy a
+small root file system into the \fBsecond\fP partition of the disk.  (Note
+that the disk partitions used by \*(4B may not correspond to those
+used by vendor supplied software.)  This file system will serve as the
+base for creating the actual root file system to be restored.  The
+generic version of the operating system maintained on the ``mini-root''
+file system understands that it should not swap on top of itself, thereby
+allowing double use of the disk partition.  Disk 0 is normally used for
+this operation; this is reflected in the example procedure.  Another disk
+may be substituted if necessary, although several modifications will
+be necessary to create special files for the alternate disk.  \fICopy\fP
+is loaded just as the \fIvdformat\fP program was loaded; if you don't
+have the bootstrap running, repeat the previous instructions until you
+see the prompt from boot (a colon), and then:
+.DS
+.TS
+lw(2i) l.
+\fB:\|\fP\fIcy(0,0)copy\fP     (load and run copy program)
+\fBFrom:\fP \fIcy(0,1)\fP      (tape drive unit 0, second tape file)
+\fBTo:\fP \fIdk(0,1)\fP        (disk drive unit 0, second disk partition)
+\fBCopy completed: 205 records copied\fP
+\fBBoot\fP
+\fB:\fP
+.TE
+.DE
+As before, `delete' or backspace erase characters and `^U' erases lines.
+.NH 3
+Step 3: booting from the mini-root file system
+.PP
+You now have the minimal set of tools necessary to create a
+root file system and restore the file system contents from tape.
+To access this file system load the bootstrap program
+and boot the version of unix that has been placed in the
+``mini-root.''
+As before, load the bootstrap if you do not already have
+it running.  At the colon prompt:
+.DS
+.TS
+lw(2i) l.
+\fB: \fP\fIdk(0,1)vmunix\fP    (get \fIvmunix\fP from disk drive 0, second partition)
+.TE
+.DE
+The standalone boot program should then read the system from
+the mini root file system you just created, and the system should boot:
+.DS
+.B
+271944+78848+92812 start 0x12e8
+4.3 BSD #1: Sat Jun  4 17:11:42 PDT 1988
+       (karels@okeeffe.Berkeley.EDU:/usr/src/sys/GENERIC)
+real mem  = xxx
+avail mem = ###
+using ### buffers containing ### bytes of memory
+(... information about available devices ...)
+root device? 
+.R
+.DE
+.PP
+The first three numbers are printed out by the bootstrap programs and
+are the sizes of different parts of the system (text, initialized and
+uninitialized data).  The system also allocates several system data
+structures after it starts running.  The sizes of these structures are
+based on the amount of available memory and the maximum count of active
+users expected, as declared in a system configuration description.  This
+will be discussed later.
+.PP
+UNIX itself then runs for the first time and begins by printing out a banner
+identifying the release and
+version of the system that is in use and the date that it was compiled.  
+.PP
+Next the
+.I mem
+messages give the
+amount of real (physical) memory and the
+memory available to user programs
+in bytes.
+For example, if your machine has 16Mb bytes of memory, then
+\fBxxx\fP will be 16777216.
+.PP
+The messages that come out next show what devices were found on
+the current processor.  These messages are described in
+\fIautoconf\fP\|(4).
+The distributed system may not have
+found all the communications devices you have (VIOC's or MPCC's),
+or all the mass storage peripherals you have, especially
+if you have more than
+two of anything.  You will correct this when you create
+a description of your machine from which to configure a site-dependent
+version of UNIX.
+The messages printed at boot here contain much of the information
+that will be used in creating the configuration.
+In a correctly configured system most of the information
+present in the configuration description
+is printed out at boot time as the system verifies that each device
+is present.
+.PP
+The \*(lqroot device?\*(rq prompt was printed by the system 
+to ask you for the name of the root file system to use.
+This happens because the distribution system is a \fIgeneric\fP
+system, i.e. it can be bootstrapped on a Tahoe cpu with its root device
+and paging area on any available disk drive.  You should respond to the
+root device question with ``dk0*''.  This response supplies two pieces
+of information: first, ``dk0'' shows that the disk it is running on is
+drive 0 of type ``dk'', and, secondly, the \*(lq*\*(rq shows that the
+system is running \*(lqatop\*(rq the paging area.  The latter is
+extremely important, otherwise the system will attempt to page on top
+of itself and chaos will ensue.  You will later build a system tailored
+to your configuration that will not ask this question when it is
+bootstrapped.
+.DS
+\fBroot device?\fP \fIdk0*\fP
+WARNING: preposterous time in file system \-\- CHECK AND RESET THE DATE!
+\fBerase ^?, kill ^U, intr ^C\fP
+\fB#\fP
+.DE
+.PP
+The \*(lqerase ...\*(rq message is part of the /.profile
+that was executed by the root shell when it started.  This message
+is present to inform you as to what values the character erase,
+line erase, and interrupt characters have been set.
+.NH 3
+Step 4: restoring the root file system
+.PP
+UNIX is now running,
+and the \fIUNIX Programmer's manual\fP applies.  The ``#'' is the prompt
+from the Bourne shell, and lets you know that you are the super-user,
+whose login name is \*(lqroot\*(rq.
+.PP
+To complete installation of the bootstrap system one step remains: the
+root file system must be created.  If the root file system is to reside
+on a disk other than unit 0, you will have to create the necessary special
+files in /dev and use the appropriate value in the following example
+procedures.
+.PP
+For example, if the root must be placed on dk1, you should
+create /dev/rdk1a and /dev/dk1a using the MAKEDEV script in /dev
+as follows:
+.DS
+\fB#\fP\|\fIcd /dev; MAKEDEV dk1\fP
+.DE
+.PP
+To actually create the root file system the shell script \*(lqxtr\*(rq
+should be run:
+.DS
+\fB#\fP\|\fIdisk=dk0 tape=cy xtr\fP
+(Note, ``dk0'' specifies both the disk type and the unit number.  Modify
+as necessary.)
+.DE
+.PP
+This will generate many messages regarding the construction
+of the file system and the restoration of the tape contents,
+but should eventually stop with the message:
+.DS
+ ...
+\fBRoot filesystem extracted\fP
+\fB#\fP
+.DE
+.NH 3
+Step 5: rebooting the completed root file system
+.PP
+With the above work completed, all that is left is to reboot:
+.DS
+.ta 3.5i
+\fB#\|\fP\fIsync\fP    (synchronize file system state)
+\fB#\|\fP\fI~h\fP      (halt cpu)
+\fB#>\|\fP\fIy.\fP     (initialize machine)
+\fB#>\|\fP\fIp23 2.\fP (set boot flags)
+\fB#>\|\fP\fIfr boot\fP
+\fB\&...(boot program is eventually loaded)...\fP
+\fBBoot\fP
+\fB:\fP \fIdk(0,0)vmunix\fP    (\fIvmunix\fP from disk drive 0, partition 0)
+(Modify unit number as necessary.)
+.B
+.nf
+271944+78848+92812 start 0x12e8
+4.3 BSD #1: Sat Jun  4 17:11:42 PDT 1988
+        (karels@okeeffe.Berkeley.EDU:/usr/src/sys/GENERIC)
+real mem  = ###
+avail mem = ###
+using ### buffers containing ### bytes of memory
+(... information about available devices ...)
+root on dk0
+WARNING: preposterous time in file system -- CHECK AND RESET THE DATE!
+erase ^?, kill ^U, intr ^C
+#
+.fi
+.DE
+.R
+.PP
+If the root device selected by the kernel is not correct, it is necessary
+to reboot again using the option to ask for the root device.  On the Tahoe
+use ``\fIp23 3.\fP''.  At the prompt from the bootstrap, use the same
+disk driver unit specification as used above: ``\fIdk(0,0)vmunix\fP''.
+Then, to the question ``root device?,'' respond with ``\fIdk0\fP''.
+See section 6.1 and appendix C if the system does not reboot properly.
+.PP
+The system is now running single user on the installed root file system.
+The next section tells how to complete the installation of distributed
+software on the /usr file system.
+.NH 3
+Step 6: placing labels on the disks
+.PP
+\*(4B uses disk labels in the first sector of each disk to contain
+information about the geometry of the drive and the partition layout.
+This information is written with \fIdisklabel\fP\|(8).
+Note that recent CCI releases, and apparently Harris releases,
+may use a different form of disk label, also in the first sector.
+As the formats of these labels are incompatible,
+skip this step if your machine is using disk labels already.
+Recent firmware for the console processor (CP) may use these labels,
+and thus the labels must be retained.
+Eventually, it will be possible to use both formats simultaneously.
+You may wish to experiment on a spare disk once the system is running.
+.PP
+For each disk that you wish to label, run the following command:
+.DS
+\fB#\|\fP\fIdisklabel  -rw  dk\fP\fB#\fP  \fBtype\fP  \fI"optional_pack_name"\fP
+.DE
+The \fB#\fP is the unit number; the \fBtype\fP is the CCI disk device
+name as listed in section 1.4 or any other name listed in /etc/disktab.
+The optional information may contain any descriptive name for the
+contents of a disk, and may be up to 16 characters long.  This procedure
+will place the label on the disk using the information found in /etc/disktab
+for the disk type named.  The default disk partitions in \*(4B are the mostly
+the same as those in the CCI 1.21 release, except for CDC 340Mb xfd drives;
+see section 4.2 for details.  If you have changed the disk partition sizes,
+you may wish to add entries for the modified configuration in /etc/disktab
+before labeling the affected disks.
+.PP
+Note that the partition sizes and sectors per track in /etc/disktab
+are now specified in sectors, not units of kilobytes as in the vendors'
+4.2BSD and System V systems.
+For most SMD disks, the sector size is 512 bytes, and is listed explicitly.
+ESDI disks on a Power 6/32SX use a sector size of 1024 bytes.
+.NH 3
+Step 7: setting up the /usr file system
+.PP
+The next thing to do is to extract the rest of the data from
+the tape.
+You might wish to review the disk configuration information in section
+4.2 before continuing; the partitions used below are those most appropriate
+in size.
+.PP
+For the Cipher tape drive, execute the following commands:
+.DS
+\fB#\fP \fIcd /dev; MAKEDEV cy0\fP
+.DE
+Then perform the following:
+.br
+.ne 5
+.sp
+.DS
+.TS
+lw(2i) l.
+\fB#\fP \fIdate yymmddhhmm\fP  (set date, see \fIdate\fP\|(1))
+\&....
+\fB#\fP \fIpasswd root\fP      (set password for super-user)
+\fBNew password:\fP    (password will not echo)
+\fBRetype new password:\fP
+\fB#\fP \fIhostname mysitename\fP      (set your hostname)
+\fB#\fP \fInewfs dk#c\fP       (create empty user file system)
+(\fIdk\fP is the disk type, \fI#\fP is the unit number, \fIc\fP
+is the partition; this takes a few minutes)
+\fB#\fP \fImount /dev/dk#c /usr\fP     (mount the usr file system)
+\fB#\fP \fIcd /usr\fP  (make /usr the current directory)
+\fB#\fP \fImt -t /dev/rmt12 fsf\fP     (space to end of previous tape file)
+\fB#\fP \fItar xbpf 40 /dev/rmt12\fP   (extract all of usr except usr/src)
+(this takes about 15-20 minutes)
+.TE
+.DE
+If no disk label has been installed on the disk, the \fInewfs\fP
+command will require a third argument to specify the disk type,
+using one of the names in /etc/disktab.
+If the tape had been rewound or positioned incorrectly before the \fItar\fP,
+it may be repositioned by the following commands.
+.DS
+\fB#\fP \fImt -t /dev/rmt12 rew\fP
+\fB#\fP \fImt -t /dev/rmt12 fsf 3\fP
+.DE
+The data on the fourth tape file has now been extracted.
+If you are using 1600bpi tapes, the first reel of the
+distribution is no longer needed; you should now mount the second
+reel instead.  The installation procedure continues from this
+point on the 6250bpi tape.
+.DS
+.TS
+lw(2i) l.
+\fB#\fP \fImkdir src\fP        (make directory for source)
+\fB#\fP \fIcd src\fP   (make source directory the current directory)
+\fB#\fP \fImt -t /dev/rmt12 fsf\fP     (space to end of previous tape file)
+\fB#\fP \fItar xpbf 40 /dev/rmt12\fP   (extract the system source)
+(this takes about 5-10 minutes)
+\fB#\fP \fIcd /\fP     (change directory, back to the root)
+\fB#\fP \fIchmod 755  /usr/src\fP
+\fB#\fP \fIumount /dev/dk#c\fP (unmount /usr)
+.TE
+.DE
+.PP
+You can check the consistency of the /usr file system by doing
+.DS
+\fB#\fP \fIfsck /dev/rdk#c\fP
+.DE
+The output from
+.I fsck
+should look something like:
+.DS
+.B
+** /dev/rdk#c
+** Last Mounted on /usr
+** Phase 1 - Check Blocks and Sizes
+** Phase 2 - Check Pathnames
+** Phase 3 - Check Connectivity
+** Phase 4 - Check Reference Counts
+** Phase 5 - Check Cyl groups
+671 files, 3497 used, 137067 free (75 frags, 34248 blocks)
+.R
+.DE
+.PP
+If there are inconsistencies in the file system, you may be prompted
+to apply corrective action; see the \fIfsck\fP(8) or \fIFsck -- The UNIX
+File System Check Program\fP for more details.
+.PP
+To use the /usr file system, you should now remount it with:
+.DS
+\fB#\fP \fI/etc/mount /dev/dk#c /usr\fP
+.DE
+.PP
+If you are using 1600bpi tapes, the second reel of the
+distribution is no longer needed; you should now mount the third
+reel instead.  The installation procedure continues from this
+point on the 6250bpi tape.
+.DS
+\fB#\fP \fImkdir /usr/src/sys\fP
+\fB#\fP \fIchmod 755 /usr/src/sys\fP
+\fB#\fP \fIcd /usr/src/sys\fP
+\fB#\fP \fImt -t /dev/rmt12 fsf\fP
+\fB#\fP \fItar xpbf 40 /dev/rmt12\fP
+.DE
+.PP
+There is one additional tape file on the distribution tape(s)
+which has not been installed to this point; it contains user
+contributed software in \fItar\fP\|(1) format.  As distributed,
+the user contributed software should be placed in /usr/src/new.
+.DS
+\fB#\fP \fImkdir /usr/src/new\fP
+\fB#\fP \fIchmod 755 /usr/src/new\fP
+\fB#\fP \fIcd /usr/src/new\fP
+\fB#\fP \fImt -t /dev/rmt12 fsf\fP
+\fB#\fP \fItar xpbf 40 /dev/rmt12\fP
+.DE
+Several of the directories for large contributed software subsystems
+have been placed in a single archive file and compressed due to space
+constraints within the distribution.
+.NH 2
+Additional conversion information
+.PP
+After setting up the new \*(4B filesystems, you may restore the user
+files that were saved on tape before beginning the conversion.
+Note that the \*(4B \fIrestore\fP program does its work on a mounted
+file system using normal system operations.  This means that file
+system dumps may be restored even if the characteristics of the file
+system changed.  To restore a dump tape for, say, the /a file system
+something like the following would be used:
+.DS
+\fB#\fP \fImkdir /a\fP
+\fB#\fP \fInewfs dk#c\fI
+\fB#\fP \fImount /dev/dk#c /a\fP
+\fB#\fP \fIcd /a\fP
+\fB#\fP \fIrestore r\fP
+.DE
+.PP
+If \fItar\fP images were written instead of doing a dump, you should
+be sure to use its `-p' option when reading the files back.  No matter
+how you restore a file system, be sure to unmount it and and check its
+integrity with \fIfsck\fP(8) when the job is complete.
+
+
+
+
diff --git a/usr/othersrc/share/doc/smm/01.setup/tahoe/Makefile b/usr/othersrc/share/doc/smm/01.setup/tahoe/Makefile
new file mode 100644 (file)
index 0000000..8cebdfb
--- /dev/null
@@ -0,0 +1,24 @@
+#      @(#)Makefile    1.3 (Berkeley) 5/7/91
+
+PRINTER=-Plz
+TROFF= ditroff ${PRINTER}
+EQN=   deqn ${PRINTER}
+TBL=   dtbl ${PRINTER}
+LPR=   lpr ${PRINTER}
+
+CSRC=  ../common/3.t ../common/4.t ../common/5.t ../common/6.t 
+SRC=   0.t 1.t 2.t ${CSRC} a.t b.t
+
+setup.out: ${SRC}
+       ${EQN} ${SRC} | ${TBL} | ${TROFF} -t -ms ${PAGES} > setup.out
+
+setup: setup.out
+       ${LPR} setup.out
+
+clean:
+       rm -f setup.out ?.t.spell errs Errs
+
+spell: ${SRC}
+       @for i in ${SRC}; do \
+               echo $$i; spell $$i | sort | comm -23 - spell.ok > $$i.spell; \
+       done
diff --git a/usr/othersrc/share/doc/smm/01.setup/tahoe/a.t b/usr/othersrc/share/doc/smm/01.setup/tahoe/a.t
new file mode 100644 (file)
index 0000000..a202c2a
--- /dev/null
@@ -0,0 +1,481 @@
+.\" Copyright (c) 1988 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)a.t 1.6 (Berkeley) 5/7/91
+.\"
+.de IR
+\fI\\$1\fP\|\\$2
+..
+.ds LH "Installing/Operating \*(4B
+.nr H1 6
+.nr H2 0
+.ds RH "Appendix A \- bootstrap details
+.ds CF \*(DY
+.bp
+.LG
+.B
+.ce
+APPENDIX A \- BOOTSTRAP DETAILS
+.sp 2
+.R
+.NL
+.PP
+This appendix contains pertinent files and numbers regarding the
+bootstrapping procedure for \*(4B.  You should never have to
+look at this appendix.  However, if there are problems in installing
+the distribution on your machine, the material contained here may
+prove useful.
+.SH
+Contents of the distribution tape(s)
+.PP
+The distribution normally consists of three 1600bpi 2400' magnetic
+tapes or one 6250bpi 2400' magnetic tape.
+The layout of the 1600bpi tapes is listed below.  The 6250bpi
+tape is in the same order, but on a single tape.
+The first tape contains the following files on it:
+.DS
+.TS
+l l l l.
+Tape file      Block size      Records*        Contents
+_
+one    1024    600     file system containing \fIboot\fP, \fIvdformat\fP, and \fIcopy\fP
+two    10240   205     ``mini root'' file system
+three  10240   578     \fIdump\fP\|(8) of distribution root file system
+four   20480   1489    \fItar\fP\|(1) image of binaries and libraries in /usr
+.TE
+.DE
+The second tape contains the following file:
+.DS
+.TS
+l l l l.
+Tape file      Block size      # Records       Contents
+_
+one    20480   1911    \fItar\fP\|(1) image of /usr/src
+.\"three       580     \fItar\fP\|(1) image of /usr/lib/vfont
+.TE
+.DE
+The third tape contains the following files:
+.DS
+.TS
+l l l l.
+Tape file      Block size      # Records       Contents
+_
+one    20480   415     \fItar\fP\|(1) image of /sys, including GENERIC system
+two    20480   1577    \fItar\fP\|(1) image of user contributed software
+.\"two 250     \fItar\fP\|(1) image of /usr/ingres
+.TE
+.DE
+.KS
+.PP
+The distribution tape is made with the shell scripts located
+in the directory /sys/tahoedist.  To build a distribution tape
+one must first create a mini root file system with the \fIbuildmini\fP
+shell script, and a boot file system with the \fIbuildboot\fP
+shell script.
+.de DS
+.ne 2i
+.nf
+.in .5i
+..
+.de DE
+.fi
+.in
+..
+.DS
+#!/bin/sh -
+#
+# Copyright (c) 1988 Regents of the University of California.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms are permitted
+# provided that the above copyright notice and this paragraph are
+# duplicated in all such forms and that any documentation,
+# advertising materials, and other materials related to such
+# distribution and use acknowledge that the software was developed
+# by the University of California, Berkeley.  The name of the
+# University may not be used to endorse or promote products derived
+# from this software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+#
+#      @(#)buildboot   1.4 (Berkeley) 7/29/88
+#
+boot=dk2b
+boottype=xfd
+bootmnt=/tmp/mini
+DISTROOT=/nbsd
+
+date
+umount /dev/${boot}
+newfs -s 1200 ${boot} ${boottype}
+fsck /dev/r${boot}
+mount /dev/${boot} ${bootmnt}
+cp $DISTROOT/stand/copy ${bootmnt}
+#cp $DISTROOT/stand/vdformat ${bootmnt}
+cp $DISTROOT/boot ${bootmnt}
+cp $DISTROOT/wcs ${bootmnt}
+cp $DISTROOT/fppwcs ${bootmnt}
+#cp $DISTROOT/poc ${bootmnt}
+#cp $DISTROOT/poc1 ${bootmnt}
+#cp $DISTROOT/poc2 ${bootmnt}
+#cp $DISTROOT/fppoc ${bootmnt}
+sync
+umount /dev/${boot}
+fsck /dev/${boot}
+date
+.DE
+.KE
+.DS
+#!/bin/sh -
+#
+# Copyright (c) 1988 Regents of the University of California.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms are permitted
+# provided that the above copyright notice and this paragraph are
+# duplicated in all such forms and that any documentation,
+# advertising materials, and other materials related to such
+# distribution and use acknowledge that the software was developed
+# by the University of California, Berkeley.  The name of the
+# University may not be used to endorse or promote products derived
+# from this software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+#
+#      @(#)buildmini   1.5 (Berkeley) 7/28/88
+#
+dist=/sys/tahoedist
+miniroot=dk4a
+minimnt=/tmp/mini
+#
+date
+umount /dev/${miniroot}
+newfs -s 4096 ${miniroot}
+fsck /dev/r${miniroot}
+mount /dev/${miniroot} ${minimnt}
+cd ${minimnt}; sh ${dist}/get
+cd ${dist}; sync
+umount /dev/${miniroot}
+fsck /dev/${miniroot}
+date
+.DE
+.PP
+.DS
+The \fIbuildmini\fP script uses the \fIget\fP script to build the file system.
+
+#!/bin/sh -
+#
+# Copyright (c) 1988 Regents of the University of California.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms are permitted
+# provided that the above copyright notice and this paragraph are
+# duplicated in all such forms and that any documentation,
+# advertising materials, and other materials related to such
+# distribution and use acknowledge that the software was developed
+# by the University of California, Berkeley.  The name of the
+# University may not be used to endorse or promote products derived
+# from this software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+#
+#      @(#)get 1.5 (Berkeley) 7/7/88
+#
+# Shell script to build a mini-root file system in preparation for building
+# a distribution tape.  The file system created here is image copied onto
+# tape, then image copied onto disk as the "first" step in a cold boot of
+# 4.3BSD systems.
+#
+DISTROOT=/nbsd
+#
+if [ `pwd` = '/' ]
+then
+       echo You just '(almost)' destroyed the root
+       exit
+fi
+
+# copy in kernel
+cp $DISTROOT/sys/GENERIC/vmunix .
+
+# create necessary directories
+DIRLIST="bin dev etc a tmp stand"
+rm -rf $DIRLIST
+mkdir $DIRLIST
+
+# copy in files from /etc
+ETCFILE="disklabel disktab fsck ifconfig init mknod mount newfs restore \e
+       rrestore umount"
+for i in $ETCFILE; do
+       cp $DISTROOT/etc/$i etc/$i
+done
+
+# copy in files from /bin
+BINFILE="[ awk cat cp dd echo ed expr ls make mkdir mt mv rcp rm sh stty \e
+       sync"
+for i in $BINFILE; do
+       cp $DISTROOT/bin/$i bin/$i
+done
+ln bin/stty bin/STTY
+
+# copy in files from /stand
+STANDFILE="copy vdformat"
+for i in $STANDFILE; do
+       cp $DISTROOT/stand/$i stand/$i
+done
+
+# copy in files from /
+#DOTFILE=".profile boot fppoc fppwcs poc poc1 poc2 wcs"
+DOTFILE=".profile boot wcs"
+for i in $DOTFILE; do
+       cp $DISTROOT/$i $i
+done
+
+# initialize /dev
+cp $DISTROOT/dev/MAKEDEV dev/MAKEDEV
+chmod +x dev/MAKEDEV
+cp /dev/null dev/MAKEDEV.local
+(cd dev; ./MAKEDEV std dk0; ./MAKEDEV cy0; mv rmt12 cy0; rm *mt*)
+
+# initialize /etc/passwd
+cat >etc/passwd <<EOF
+root::0:10::/:/bin/sh
+EOF
+
+# initialize /etc/group
+cat >etc/group <<EOF
+wheel:*:0:
+staff:*:10:
+EOF
+
+# initialize /etc/fstab
+cat >etc/fstab <<EOF
+/dev/xfd0a:/a:xx:1:1
+/dev/dk0a:/a:xx:1:1
+EOF
+
+# create xtr script
+cat >xtr <<'EOF'
+#!/bin/sh -e
+: ${disk?'Usage: disk=xx0 tape=yy xtr'}
+: ${tape?'Usage: disk=xx0 tape=yy xtr'}
+echo 'Build root file system'
+newfs ${disk}a
+sync
+echo 'Check the file system'
+fsck /dev/r${disk}a
+mount /dev/${disk}a /a
+cd /a
+echo 'Rewind tape'
+mt -f /dev/${tape}0 rew
+echo 'Restore the dump image of the root'
+restore rsf 3 /dev/${tape}0
+cd /
+sync
+umount /dev/${disk}a
+sync
+fsck /dev/r${disk}a
+echo 'Root filesystem extracted'
+EOF
+
+# make xtr script executable
+chmod +x xtr
+
+sync
+.DE
+.DS
+Once a mini root file system is constructed, the \fImaketape\fP script makes a distribution tape.
+
+#!/bin/sh -
+#
+# Copyright (c) 1988 Regents of the University of California.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms are permitted
+# provided that the above copyright notice and this paragraph are
+# duplicated in all such forms and that any documentation,
+# advertising materials, and other materials related to such
+# distribution and use acknowledge that the software was developed
+# by the University of California, Berkeley.  The name of the
+# University may not be used to endorse or promote products derived
+# from this software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+#
+#      @(#)maketape    5.5 (Berkeley) 7/29/88
+#
+
+# maketape [ 6250 | 1600 [ tapename [ remotetapemachine ] ] ]
+miniroot=dk4a
+bootroot=dk2b
+nbsd=dk1a
+nbsdusr=dk2c
+tape=/dev/rmt20
+type=6250
+block=40
+tflag=cbf
+bprog="/usr/local/20b 20480"
+
+if [ $# -gt 0 ]; then type=$1; fi
+if [ $# -gt 1 ]; then tape=$2; fi
+tartape=$tape
+if [ $# -gt 2 ]; then remote=$3; tartape='-'; fi
+
+$remote mt -t ${tape} rew
+date
+umount /dev/$nbsdusr
+umount /dev/$nbsd
+mount -r /dev/$nbsd /nbsd
+mount -r /dev/$nbsdusr /nbsd/usr
+cd /nbsd
+sync
+
+if [ $type = '1600a' ]
+then
+       type=1600
+fi
+
+echo "Add image of bootstrap file system"
+eval dd if=/dev/r${bootroot} count=600 bs=1024 conv=sync ${remote+"| rsh"} \e
+       ${remote-"of=$tape"} ${remote+'/usr/local/20b 1024 ">" $tape'}
+
+echo "Add image of mini-root file system"
+eval dd if=/dev/r${miniroot} count=205 bs=10240 conv=sync ${remote+"| rsh"} \e
+       ${remote-"of=$tape"} ${remote+'/usr/local/20b ">" $tape'}
+
+echo "Add full dump of real file system"
+/etc/${remote+r}dump 0uf $remote${remote+:}${tape} /nbsd
+echo "Add tar image of /usr"
+cd /nbsd/usr; eval tar ${tflag} ${block} ${tartape} adm bin dict doc games \e
+       guest hosts include lib local man msgs new \e
+       preserve pub spool tmp ucb \e
+               ${remote+'| $remote ${bprog} ">" $tape'}
+if [ ${type} != '6250' ]
+then
+       echo "Done, rewinding first tape"
+       $remote mt -t ${tape} rew &
+       echo "Mount second tape and hit return when ready"
+       echo "(or type name of next tape drive)"
+       read x
+       if [ "$x" != "" ]
+       then    tape=$x
+       fi
+fi
+
+: tape2:
+echo "Add user source code"
+cd /nbsd/usr/src; eval tar ${tflag} ${block} ${tartape} Makefile bin cci \e
+       etc games include lib local man old ucb undoc usr.bin usr.lib \e
+       ${remote+'| $remote ${bprog} ">" $tape'}
+
+#echo "Add varian fonts"
+#cd /usr/lib/vfont; eval tar ${tflag} ${block} ${tartape} . \e
+#      ${remote+'| $remote ${bprog} ">" $tape'}
+if [ ${type} != '6250' ]
+then
+       echo "Done, rewinding second tape"
+       $remote mt -t ${tape} rew &
+       echo "Mount third tape and hit return when ready"
+       echo "(or type name of next tape drive)"
+       read x
+       if [ "$x" != "" ]
+       then    tape=$x
+       fi
+fi
+
+: tape3:
+echo "Add tar image of system sources"
+cd /nbsd/sys; eval tar ${tflag} ${block} ${tartape} . \e
+       ${remote+'| $remote ${bprog} ">" $tape'}
+
+echo "Add user contributed software"
+# standard (always uncompressed) directories:
+new="README Makefile B X ansi apl bib courier cpm dipress dsh \e
+       enet help hyper jove kermit mkmf news notes nntp np100 \e
+       patch pathalias rcs rn spms sunrpc tac tools umodem xns"
+uncompress="emacs icon mh mmdf sumacc pup"
+compress="emacs.tar.Z icon.tar.Z mh.tar.Z mmdf.tar.Z sumacc.tar.Z pup.tar.Z"
+cd /nbsd/usr/src/new; eval tar ${tflag} ${block} ${tartape} ${new} \e
+       ${compress} ${remote+'| $remote ${bprog} ">" $tape'}
+
+#echo "Add ingres source"
+#cd /nbsd/usr/ingres; eval tar ${tflag} ${block} ${tartape} . \e
+#      ${remote+'| $remote ${bprog} ">" $tape'}
+
+echo "Done, rewinding tape"
+$remote mt -t ${tape} rew &
+.DE
+.SH
+Control status register addresses
+.PP
+The distribution uses standalone device drivers
+that presume the location of a VERSAbus device's control status
+register (CSR).
+The following table summarizes these values.
+.DS
+.TS
+l l l.
+Device name    Controller      CSR address (hex)
+_
+dk     CCI VDDC or SMDE        ffff2000, ffff2100, ffff2200, ..., ffff2700
+cy     Cipher  ffff4000
+.TE
+.DE
+.SH
+Generic system control status register addresses
+.PP
+The 
+.I generic
+version of the operating system supplied with the distribution
+contains the VERSAbus devices listed below. 
+These devices will be recognized
+if the appropriate control status registers respond at any of the
+listed VERSAbus addresses.
+.DS
+.TS
+l l l.
+Device name    Controller      CSR addresses (hex)
+_
+dk     CCI VDDC or SMDE        ffff2000, ffff2100, ..., ffff2700
+cy     Cipher  ffff4000, ffff6000
+vx     CCI VIOC        fffe0000, fffe4000, ..., fffbc000
+ace    ACC Ethernet    ffff0000, ffff0100
+enp    CMC Ethernet    fff41000, fff61000
+dr     IKON DR11W      ffff7000
+ik     IKON DR11W w/ E&S PS300 ffff8000
+.TE
+.DE
+If devices other than the above are located at any 
+of the addresses listed, the system may not bootstrap
+properly.
diff --git a/usr/othersrc/share/doc/smm/01.setup/tahoe/b.t b/usr/othersrc/share/doc/smm/01.setup/tahoe/b.t
new file mode 100644 (file)
index 0000000..11aa172
--- /dev/null
@@ -0,0 +1,139 @@
+.\" Copyright (c) 1988 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)b.t 1.5 (Berkeley) 5/7/91
+.\"
+.de IR
+\fI\\$1\fP\|\\$2
+..
+.ds LH "Installing/Operating \*(4B
+.nr H1 6
+.nr H2 0
+.ds RH "Appendix B \- installation troubleshooting
+.ds CF \*(DY
+.bp
+.LG
+.B
+.ce
+APPENDIX B \- INSTALLATION TROUBLESHOOTING
+.sp 2
+.R
+.NL
+.PP
+This appendix lists and explains certain problems
+that might be encountered while trying to install the \*(4B
+distribution.  The information provided here is
+limited to the early steps in the installation process;
+i.e. up to the point where the root file system is installed.
+If you have a problem installing
+the release consult this section before contacting our group.
+.SH
+\fBBooting the generic system\fP
+.LP
+\fIcopy does not copy 205 records\fP
+.LP
+If a tape read error occurred,
+clean your tape drive heads.  If a disk write error occurred,
+the disk formatting may have failed.  If the disk pack is
+removable, try another one.  If you are currently running
+UNIX, you can reboot your old system and use \fIdd\fP to
+copy the mini-root file system into a disk partition
+(assuming the destination is not in use by the running
+system).
+.LP
+\fIboot prints ``not a directory''\fP
+.LP
+The
+.I boot
+program was unable to find the requested program because
+it encountered something other than a directory while
+searching the file system.
+This usually suggests that
+no file system is present on the disk partition supplied,
+or the file system has been corrupted.  First check to
+make sure you typed the correct line to boot.  If this
+is the case and you are booting from the mini-root file
+system, the mini-root was probably not copied correctly off the
+tape (perhaps it was not placed in the correct disk partition).
+Try reinstalling the mini-root file system or, if trying
+to boot the true root file system, try booting from the
+mini-root file system and run \fIfsck\fP on the restored
+root file system to insure its integrity.  Finally, as
+a last resort, copy the \fIboot\fP program from the 
+mini-root file system to the newly installed root file system.
+.LP
+\fIboot prints ``bad format''\fP
+.LP
+The program you requested 
+.I boot
+to load did not have a valid magic number in its header.  This should
+never happen on a distribution system.  If you were trying to boot off
+the root file system, reboot the system on the mini-root file system
+and look at the program on the root file system.  Try copying the copy
+of vmunix on the mini-root to the root file system also.
+.LP
+\fIboot prints ``read short''\fP
+.LP
+The file header for the program contained a size larger
+than the actual size of the file located on disk.  This
+is probably the result of file system corruption (or a 
+disk I/O error).  Try booting again or creating a new
+copy of the program to be loaded (see above).
+.LP
+This section contains common problems encountered when booting
+the generic version of the system.
+.LP
+\fIsystem panics with ``panic: iinit''\fP
+.LP
+This occurred because the system was unable to mount
+the root file system.
+The root file system supplied at the ``root device?''
+prompt was probably incorrect.  Remember that when running on the
+mini-root file system, this question must be answered
+with something of the form \fIxx#\fP*, where \fIxx\fP is one of the
+disk types listed in section 1.4, and \fI#\fP is the unit number.
+If the answer had been ``dk0'', the system would have used the ``a''
+partition on unit 0 of the ``dk'' drive, where presumably no file
+system exists.
+.LP
+Alternatively, the file system on which you were trying
+to run is corrupted.  Try
+reinstalling the appropriate file system.
+.LP
+\fIsystem crashes during autoconfiguration\fP
+.LP
+This is almost always caused by an
+unsupported  device being present at a
+location where a supported device was expected.
+You must disable the device in some way, either
+by pulling it off the bus, or by moving the location
+of the console status register (consult Appendix A
+for a complete list of VERSAbus CSR's used in the generic system).