Add cats documentation, still needs lots of work.

7 files changed, 179 insertions, 0 deletions

diff --git a/distrib/notes/cats/contents b/distrib/notes/cats/contents
new file mode 100644
index 00000000000..88e03be95d3
--- /dev/null
+++ b/distrib/notes/cats/contents
@@ -0,0 +1,41 @@
+dnl	$OpenBSD: contents,v 1.1 2004/02/08 00:35:14 drahn Exp $
+TopPart
+
+OpenBSDfloppy
+
+		cdrom{:--:}OSrev.fs	The MACHINE boot and installation
+				image that contains almost all
+				OpenBSD drivers; see below.
+
+OpenBSDdistsets
+
+OpenBSDbsd
+
+OpenBSDrd
+
+OpenBSDcd
+
+As well you may be interested in
+
+.../OSREV/tools/
+		miscellaneous MACHINE installation utilities like
+		rawrite.exe, ntrw.exe, gzip.exe, and pfdisk.exe;
+		see installation section, below.
+
+
+In addition, the "tools/" directory contains some utilities that might be
+useful for the installation.
+
+DistributionDescription(ten)
+
+OpenBSDbase(31.0,90.9,shared)
+
+OpenBSDcomp(17.4,57.6,shared)
+
+OpenBSDetc(1.6,6.0)
+
+OpenBSDgame(2.6,6.0)
+
+OpenBSDman(6.3,22.4)
+
+OpenBSDmisc(2.0,6.5)
diff --git a/distrib/notes/cats/hardware b/distrib/notes/cats/hardware
new file mode 100644
index 00000000000..c4e1e2b5173
--- /dev/null
+++ b/distrib/notes/cats/hardware
@@ -0,0 +1,29 @@
+dnl	$OpenBSD: hardware,v 1.1 2004/02/08 00:35:14 drahn Exp $
+OpenBSD/MACHINE runs on the Chalice/Simtec StrongARM 110 Evaluation Board.
+
+Supported devices {:-include-:}:
+	IDE hard disk controllers
+		Onboard controllers
+
+	AGP/SVGA/VGA Display Adapters
+
+	Serial ports
+		onboard serial (fcom) port.
+
+	Ethernet adapters
+		Novell NE1000, NE2000 
+		Intel i8255x-based (except the i82556) PCI adapters (fxp),
+		including:
+			Intel EtherExpress PRO/10+
+			Intel EtherExpress PRO/100, PRO/100B, and PRO/100+
+			Intel EtherExpress PRO/100+ "Management Adapter"
+			Intel EtherExpress PRO/100 Dual Port
+			Intel PRO/100 VE, PRO/100 VM, and PRO/100 S
+
+	CD-ROM drives
+		Atapi CD-ROM drives
+		Atapi DVD-ROM drives
+		Atapi CD-RW drives
+
+	Keyboards
+		PS/2 keyboards
diff --git a/distrib/notes/cats/install b/distrib/notes/cats/install
new file mode 100644
index 00000000000..bd733c2f7ea
--- /dev/null
+++ b/distrib/notes/cats/install
@@ -0,0 +1,74 @@
+dnl	$OpenBSD: install,v 1.1 2004/02/08 00:35:14 drahn Exp $
+OpenBSDInstallPrelude
+
+If OpenBSD will be sharing the disk with DOS or another operating
+system, you should have already completed the section of these notes
+that instructed you on how to prepare your hard disk.  You should know
+the size of the OpenBSD area of the disk and its offset from the
+beginning of the disk.  You will need this information when setting up
+your OpenBSD partitions. 
+
+There are several ways to install OpenBSD onto a disk.  The easiest way,
+should your computer support it, is to boot off the OpenBSD CD-ROM, or
+off the bootable CD-ROM mini image.
+
+OpenBSDInstallPart2
+
+	XXX 
+	Booting with ABLE
+
+	XXXX
+	Cyclone firmware not supported.
+
+
+OpenBSDBootMsgs
+
+	You will next be asked for your terminal type.  You should just
+	hit return to select the default (vt220).
+
+OpenBSDInstallPart3({:- or "wd0" for IDE drives-:})
+
+	Next you will have to edit or create a disk label for the disk
+	OpenBSD is being installed on.  If there are any existing
+	partitions defined (for any operating system), and a disk label
+	is not found, you will first be given an opportunity to run
+	fdisk and create an OpenBSD partition.
+
+	If fdisk is being invoked on your behalf, it will start by
+	displaying the current partitions defined and then allow you
+	to modify this information, add new partitions and change
+	which partition to boot from by default.  If you make a mistake,
+	you will be allowed to repeat this procedure as necessary to
+	correct this.  Note that you should make OpenBSD be the active
+	partition at least until the install has been completed.
+
+OpenBSDInstallPart4({:- If you have DOS or Linux partitions
+	defined on the disk, these will usually show up as partition
+	'h', 'i' and so on.-:})
+
+	Note that all OpenBSD partitions in the disk label must have an
+	offset that makes it start within the OpenBSD part of the disk,
+	and a size that keeps it inside of that portion of the disk.  This
+	is within the bounds of the 'c' partition if the disk is not being
+	shared with other operating systems, and within the OpenBSD fdisk
+	partition if the disk is being shared.
+
+OpenBSDInstallPart5(wd0)
+
+OpenBSDInstallNet({:-CD-ROM, -:},nofloppy)
+
+OpenBSDFTPInstall
+
+OpenBSDHTTPInstall
+
+OpenBSDTAPEInstall
+
+OpenBSDCDROMInstall
+
+OpenBSDDISKInstall({:-"wdN" or -:},,{:- or Linux-:})
+
+OpenBSDCommonFS
+
+OpenBSDCommonURL
+
+OpenBSDCongratulations
diff --git a/distrib/notes/cats/prep b/distrib/notes/cats/prep
new file mode 100644
index 00000000000..fd778ad089e
--- /dev/null
+++ b/distrib/notes/cats/prep
@@ -0,0 +1,19 @@
+dnl	$OpenBSD: prep,v 1.1 2004/02/08 00:35:14 drahn Exp $
+To be able to boot the OpenBSD/MACHINE installation program, you will
+need to acquire some limited knowledge of ABLE Firmware, the low-level
+process that controls the microprocessor after hardware initialization
+and diagnostics are performed but before control is handed to the
+operating system.
+
+Important ABLE Firmware command examples:
+
+boot (hd0)bsd
+	boot the ELF file 'bsd' from the disk partition idenfied
+	by firmware as hd0.
+
+
+XXX autoboot 
+
+XXX arguments to kernel
+
+XXX bootable partitions
diff --git a/distrib/notes/cats/upgrade b/distrib/notes/cats/upgrade
new file mode 100644
index 00000000000..9ffd4971744
--- /dev/null
+++ b/distrib/notes/cats/upgrade
@@ -0,0 +1 @@
+OpenBSDUpgrade({:-the CD-ROM-:})
diff --git a/distrib/notes/cats/whatis b/distrib/notes/cats/whatis
new file mode 100644
index 00000000000..ede7e06faa9
--- /dev/null
+++ b/distrib/notes/cats/whatis
@@ -0,0 +1,2 @@
+dnl	$OpenBSD: whatis,v 1.1 2004/02/08 00:35:14 drahn Exp $
+For MACHINE, OpenBSD OSREV adds support for CATS StrongARM systems.
diff --git a/distrib/notes/cats/xfer b/distrib/notes/cats/xfer
new file mode 100644
index 00000000000..6929aff13d9
--- /dev/null
+++ b/distrib/notes/cats/xfer
@@ -0,0 +1,13 @@
+dnl	$OpenBSD: xfer,v 1.1 2004/02/08 00:35:14 drahn Exp $
+Installation is supported from several media types, including:
+
+	CDROM
+	FFS partitions
+	FTP
+	HTTP
+
+OpenBSDXferShortPrelude
+
+OpenBSDXferBareTape()
+
+OpenBSDXferFFS