[src/trunk]: src/distrib/notes/cats First attempt at cats notes.

[skrll <skrll%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/141f9234ae0f
branches:  trunk
changeset: 524920:141f9234ae0f
user:      skrll <skrll%NetBSD.org@localhost>
date:      Tue Apr 02 11:36:34 2002 +0000

description:
First attempt at cats notes.

diffstat:

 distrib/notes/cats/Makefile |    3 +
 distrib/notes/cats/hardware |  166 ++++++++++++
 distrib/notes/cats/install  |  563 ++++++++++++++++++++++++++++++++++++++++++++
 distrib/notes/cats/legal    |   10 +
 distrib/notes/cats/prep     |   25 +
 distrib/notes/cats/upgrade  |   29 ++
 distrib/notes/cats/whatis   |   19 +
 distrib/notes/cats/xfer     |    3 +
 8 files changed, 818 insertions(+), 0 deletions(-)

diffs (truncated from 850 to 300 lines):

diff -r 1d1f2f54909f -r 141f9234ae0f distrib/notes/cats/Makefile
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/cats/Makefile       Tue Apr 02 11:36:34 2002 +0000
@@ -0,0 +1,3 @@
+#      $NetBSD: Makefile,v 1.1 2002/04/02 11:36:34 skrll Exp $
+
+.include <bsd.man.mk>
diff -r 1d1f2f54909f -r 141f9234ae0f distrib/notes/cats/hardware
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/cats/hardware       Tue Apr 02 11:36:34 2002 +0000
@@ -0,0 +1,166 @@
+.\"    $NetBSD: hardware,v 1.1 2002/04/02 11:36:34 skrll Exp $
+.\"
+.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by
+.\"
+.\" 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 NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
+.\"
+.
+.Nx*M
+\*V runs on a Chalice CATS systems from and Intel EBSA boards.
+The minimal configuration is said to
+require 8 MB of RAM and 50 MB of disk space, though we do not know of anyone
+running with a system quite this minimal today. To install the entire
+system requires much more disk space (the unpacked binary distribution,
+without sources, requires at least 65 MB without counting space needed for
+swap space, etc), and to run X or compile the system, more RAM is
+recommended. (8 MB of RAM will actually allow you to run X and/or compile,
+but it won't be speedy. Note that until you have around 16 MB of RAM,
+getting more RAM is more important than getting a faster CPU.)
+.
+.Ss2 Supported Chalice CATS devices
+.(bullet -offset indent -compact
+ALI M1543 southbridge inc PS/2 keyboard & mouse, ide, serial
+.It
+Parallel, USB and ISA bus
+.It
+RTC
+.bullet)
+.
+.Ss2 Supported Intel EBSA285 & Chalice CATS PCI devices
+.(bullet -offset indent
+PCI - PCI bridges
+.(bullet -compact
+DC21150
+.It
+DC21152
+.It
+DC21153
+.It
+DC21154
+.It
+Hint HB1
+.bullet)
+.It
+Digital DC21x4x-based PCI Ethernet adapters
+.(bullet -compact
+Cogent EM1X0, EM960 (a.k.a. Adaptec ANA-69XX)
+.It
+Cogent EM964 [b]
+.It
+Cogent EM4XX [b]
+.It
+Compex Readylink PCI
+.It
+DANPEX EN-9400P3
+.It
+Digital Celebris GL, GLST on-board ethernet
+.It
+.Tn DEC
+.Pq Tn Digital
+PCI Ethernet/Fast Ethernet adapters (all)
+.It
+JCIS Condor JC1260
+.It
+Linksys PCI Fast Ethernet
+.It
+SMC EtherPower 10, 10/100 (PCI only!)
+.It
+SMC EtherPower
+.It
+SVEC
+.It
+PN0455
+.It
+SVEC FD1000-TP
+.It
+Znyx ZX34X
+.bullet)
+.It
+Qlogic ISP [12]0x0 SCSI/FibreChannel boards
+.It
+Adaptec AHA-2910, 2915, 2920, and 2930C adapters
+.It
+Adaptec AHA-2x4x[U][2][W] cards and onboard PCI designs using the AIC-7770,
+AIC-7850, AIC-7860, AIC-7870, AIC-7880 and AIC-789x chipsets
+.It
+Adaptec AHA-394x[U][W] cards [b]
+.It
+Adaptec AHA-3950U2 cards
+.It
+Adaptec AHA-3960, 19160 and 29160 Ultra-160 adapters
+.It
+NE2000 PCI ethernet adapters
+.It
+Universal Serial Bus
+.(bullet -compact
+UHCI host controllers
+.It
+OHCI host controllers
+.It
+Hubs
+.It
+Keyboards using the boot protocol
+.It
+Mice
+.It
+Printers
+.It
+Generic support for HID devices
+.bullet)
+.It
+Video cards
+.(bullet -compact
+Diamond Stealth 3D 2000 Pro
+.It
+ATI Charger 4MB
+.It
+STB Velocity 128
+.It
+Cirrus Logic 5446
+.It
+IGS 2010
+.It
+IGS 5000
+.It
+S3 based interfaces
+.bullet)
+.bullet)
+.Pp
+Drivers for hardware marked with
+.Dq [*]
+are
+.Em not
+present in installation kernels.
+.Pp
+Other PCI devices may be supported by Intel EBSA285 & Chalice CATS but
+have not been tested.
diff -r 1d1f2f54909f -r 141f9234ae0f distrib/notes/cats/install
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/cats/install        Tue Apr 02 11:36:34 2002 +0000
@@ -0,0 +1,563 @@
+.\"
+.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by
+.\"
+.\" 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 NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
+.\"
+Installing
+.Nx
+is a relatively complex process, but if you have
+this document in hand and are careful to read and remember the
+information which is presented to you by the install program, it
+shouldn't be too much trouble.
+.Pp
+Before you begin, you should know the geometry of your hard disk, i.e.
+the sector size (note that sector sizes other than 512 bytes are not
+currently supported), the number of sectors per track, the number of
+tracks per cylinder (also known as the number of heads), and the
+number of cylinders on the disk. The
+.Nx
+kernel will try to
+discover these parameters on its own, and if it can it will print them
+at boot time. If possible, you should use the parameters it prints.
+.\" (You might not be able to because you're sharing your disk with
+.\" another operating system, or because your disk is old enough that the
+.\" kernel can't figure out its geometry.)
+.Pp
+You should now be ready to install
+.Nx .
+It might be handy for you
+to have a pencil, some paper, and a calculator handy.
+.Pp
+The following is a walk-through of the steps you will take while
+getting
+.Nx
+installed on your hard disk. If any question has a
+default answer, it will be displayed in brackets
+.Pq Dq []
+after the
+question. If you wish to stop the installation, you may press
+.Key CONTROL-C
+at any time, but if you do, you'll have to begin the installation
+process again from scratch.
+.Pp
+Boot your machine using the installation kernel for your
+platform. (Instructions for doing this on your platform can be
+found in the preparation section of this document.)
+.Pp
+If this doesn't work, ensure that you're using the correct
+kernel for your hardware.
+.Pp
+Depending upon your platform and the method of loading the,
+it may take a while to load the kernel.
+.Pp
+You will then be presented with the
+.Nx
+kernel boot
+messages. You will want to read them, to determine your
+disk's name and geometry. Its name will be something like
+.Li sd0
+or
+.Li wd0
+and the geometry will be printed on a line that
+begins with its name. As mentioned above, you will need your
+disk's geometry when creating
+.Nx 's
+partitions. You will
+also need to know the name, to tell the install tools what
+disk to install on.
+.Pp
+While booting, you will probably see several warnings. You
+should be warned that no swap space is present, and that
+.Xr init 8
+cannot find
+.Pa /etc/rc.
+Do not be alarmed, these are
+completely normal. When you reach the prompt asking you for a
+shell name, just press
+.Key RETURN .
+.Pp
+You will be asked if you wish to install or upgrade your
+system or go to a shell prompt. Enter
+.Ic install .
+.Pp
+You will be presented with a welcome message and a prompt,
+asking if you wish to proceed with the installation process.
+If you wish to proceed, enter
+.Sq Ic y
+and press
+.Key RETURN .
+.Pp