[src/netbsd-1-6]: src/distrib/notes/common Pull up revision 1.49 (requested b...

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

details:   https://anonhg.NetBSD.org/src/rev/76527a522b62
branches:  netbsd-1-6
changeset: 528465:76527a522b62
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sat Jul 20 02:30:03 2002 +0000

description:
Pull up revision 1.49 (requested by scottr in ticket #525):
This is a complete refit of the mac68k documentation.
Of particular note is documentation on the new preferred method of
installation using sysinst, provided (and updated) by Bob Nestor.

diffstat:

 distrib/notes/common/sysinst |  439 ++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 414 insertions(+), 25 deletions(-)

diffs (truncated from 659 to 300 lines):

diff -r 19cc205e6699 -r 76527a522b62 distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Sat Jul 20 02:29:52 2002 +0000
+++ b/distrib/notes/common/sysinst      Sat Jul 20 02:30:03 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysinst,v 1.32.2.11 2002/07/15 17:00:37 thorpej Exp $
+.\"    $NetBSD: sysinst,v 1.32.2.12 2002/07/20 02:30:03 lukem Exp $
 .\"
 .\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -56,10 +56,10 @@
 installation process.
 This document tries to be a good guideline for the installation and as such
 covers many details to be completed.
-Do not let this discourage you, the install program is not hard
+Do not let this discourage you; the install program is not hard
 to use.
 .
-.if !\n[acorn26]:\n[atari]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[walnut]:\n[x68k] \{\
+.if !\n[acorn26]:\n[atari]:\n[mac68k]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[walnut]:\n[x68k] \{\
 .It
 .To 2 "Possible PCMCIA issues"
 .Em Possible Tn PCMCIA Em issues
@@ -258,6 +258,45 @@
 release.
 .\} \" r_i386
 .\} \" !\n[acorn26]:\n[atari]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[walnut]:\n[x68k] \{\
+.if r_mac68k \{\
+.It
+.To 2 "Possible hardware-specific issues"
+.Em Possible hardware-specific issues
+.(bullet
+.It
+.Em SCSI driver problems
+.Pp
+The SCSI driver used in the kernel on many older Macintosh systems is, by
+default, the ncrscsi driver. It contains a recognized but as yet unfixed
+bug that affects some disk drive/controller combinations,
+usually Quantum disks. Under heavy load these systems may hang or corrupt
+the file system; or, you may experience frequent
+.Pa Segmentation fault No and
+.Pa Illegal instruction
+errors that may or may not be consistently repeatable. This latter condition
+is particularly prevalent on systems with minimal RAM installed.
+.Pp
+If either of these problems occur on your system you are advised to use the
+SBC variants of the Kernel and Installation Kernel. However, be aware that
+this issue does not affect e.g. Centris or Quadra systems.
+.Pp
+.It 
+.Em The 68LC040 processor
+.Pp
+.Nx
+has known but unresolved problems running on the 68LC040 processor, the
+variant of the 68040 that does not contain the floating point unit (FPU).
+The kernel is thus forced to emulate the missing operations in software.
+Unfortunately the 68LC040 processor has a design problem that causes
+the emulation to fail intermittently. We hope to provide a solution
+for this issue in a future
+.Nx
+release.
+.Pp
+Software emulation of floating point operations is
+not a problem on the 68020 and 68030 processors.
+.bullet)
+.\}
 .It
 .To 2 General
 .Em General
@@ -277,9 +316,9 @@
 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, by running the
+process again from scratch by running the
 .Pa /sysinst
-program from the command prompt, you do not need to reboot.
+program from the command prompt. It is not necessary to reboot.
 .It
 .To 2 "Quick install"
 .Em Quick install
@@ -287,7 +326,7 @@
 First, let's describe a quick install.
 The other sections of this document go into the installation procedure in more
 detail, but you may find that you do not need this.
-If you want detailed instructions, skip to section 3.
+If you want detailed instructions, skip to the next section.
 This section describes a basic installation, using a CD-ROM install as
 an example.
 .Pp
@@ -299,6 +338,7 @@
 .It
 .ie r_alpha Two floppy disks.
 .el .ie r_i386 Two 1.44 MB 3.5" floppy disks.
+.el .ie r_mac68k The Mac OS Booter application and an Installation Kernel
 .el .ie \n[acorn26]:\n[cats]:\n[macppc]:\n[sparc]:\n[walnut] \{\
 Some form of bootable media, described above.
 .\}
@@ -312,6 +352,12 @@
 .It
 A PC with a 386 or newer processor.
 .\} \" r_i386
+.if r_mac68k \{\
+.It
+A Macintosh with a 68020 and MMU, 68030 or 68RC040 processor. An FPU is
+not required but will be used if present (but see the note above regarding
+the 68LC040).
+.\}
 .It
 A CD-ROM drive
 .ie \n[acorn26]:\n[atari]:\n[alpha]:\n[cats]:\n[i386]:\n[macppc]:\n[walnut] (SCSI or ATAPI),
@@ -322,6 +368,7 @@
 .if r_atari 4 MB (TT030/Falcon) or 16 Mb (Hades/Milan)
 .if r_cats 8 MB
 .if r_i386 4 MB
+.if r_mac68k 8 MB
 .if r_macppc 8 MB
 .if r_mvme68k 4 MB
 .if r_news68k 4 MB
@@ -337,6 +384,7 @@
 .if r_atari 120
 .if r_cats 200
 .if r_i386 70
+.if r_mac68k 120
 .if r_macppc 200
 .if r_mvme68k 100
 .if r_news68k 100
@@ -395,6 +443,30 @@
 .Dl # Ic "dd if=.../boot1.fs bs=18k of=/dev/rfd0a"
 .Pp
 .\} \" \n[alpha]:\n[i386]:\n[news68k]:\n[newsmips]
+.if r_mac68k \{\
+.It
+The NetBSD Boot Tools folder.
+.(bullet
+Create a Folder on your Mac OS disk for the
+.Nx*M
+components.
+.It
+Copy the Booter application into the newly created Folder. Expand the
+file if necessary to create the Mac OS executable.
+.It
+Copy the Installation Kernels into the newly created Folder. It is not
+necessary to
+.Ic gunzip
+compressed kernel files.
+.It
+Single-click on the Booter application icon then select the "Get Info"
+from the File Menu list.  Increase the memory allocation for the Booter
+to as much as possible for your system.  Having a large number of fonts,
+extensions or sounds installed on your system can cause memory exhaustion
+problems for the Booter if you don't do this.  Also, the extra memory
+is needed by the Booter to expand compressed kernels while booting.
+.bullet)
+.\}
 .It
 The Quick Installation
 .(bullet
@@ -404,6 +476,50 @@
 .Ic sysinst
 main menu.
 .\}
+.ie r_mac68k \{\
+Double-click on the Booter application icon to start executing it.
+From the
+.Ic Options
+pull-down menu, select
+.Ic Monitors ,
+then select
+.Ic Change Monitor Depth
+and make sure B\*&W is highlighted.
+Close the window using the
+.Ic Close No button.
+.It
+From the
+.Ic Options
+pull-down menu select
+.Ic Boot Options .
+This will bring
+up an option panel.  Set the
+.Ic Auto-set GMT Bias
+checkbox in the lower left and then select the
+.Ic Boot from Mac OS
+option at the top of the window. The
+.Ic Set
+button on the right will become active. Use it to locate and
+select the Installation Kernel file appropiate for your hardware. This
+will be either
+.Pa netbsd-GENERIC.gz No or
+.Pa netbsd-GENERICSBC.gz .
+Close the window using the
+.Ic Close
+button.
+.It
+From the
+.Ic Options
+pull-down menu select the
+.Ic Boot Now ,
+or use the Apple-B (Command-B) key combination to start the
+.Nx
+boot process.  Do not move the mouse while the boot operation is in
+progress as this may leave the keyboard locked to
+.Nx .
+.Pp
+The main menu will be displayed.
+.\}
 .el \{\
 Insert the
 .ie r_i386 first
@@ -490,7 +606,7 @@
 .It
 After all the files have been unpacked, go back to
 the main menu and select
-.ie \n[macppc]:\n[pmax]:\n[sgimips]:\n[sparc] \{\
+.ie \n[mac68k]:\n[macppc]:\n[pmax]:\n[sgimips]:\n[sparc] \{\
 .Me reboot.
 .\}
 .el \{\
@@ -540,7 +656,7 @@
 .To 2 "Booting NetBSD"
 .Em Booting NetBSD
 .
-.if !\n[acorn26]:\n[atari]:\n[cats]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[walnut]:\n[x68k] \{\
+.if !\n[acorn26]:\n[atari]:\n[cats]:\n[mac68k]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[walnut]:\n[x68k] \{\
 .(pcmcia
 Unplug your
 .Tn PCMCIA
@@ -548,9 +664,76 @@
 .Nx .
 .pcmcia)
 .\} \" !\n[acorn26]:\n[atari]:\n[cats]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[walnut]:\n[x68k] \{\
-.ie \n[acorn26]:\n[cats]:\n[macppc]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[walnut] \{\
+.ie \n[mac68k] \{\
+.Pp
+Prior to attempting to boot
+.Nx*M
+verify that all the following are done:
+.(bullet
+Enable 32-bit addressing in the Memory Control Panel [1].
+.It
+Disable all forms of virtual memory (the Memory Control Panel, RAM Doubler,
+or other software-based memory enhancement products).
+.It
+Place the system in B\*&W Mode (1-bit color or grayscale) as shown in the
+Monitors Control Panel or in the Monitors options dialog of the Booter. You may
+choose to have the Booter do this for you automatically by selecting
+the appropiate check box and radio button in the
+.Ic Monitors No dialog on the
+.Ic Options No menu .
+.bullet)
 .Pp
-Boot the system as described in the previous section.
+It is probably best to boot your machine with all extensions turned off [1].
+You can do this by booting into Mac OS with the
+.Tn SHIFT No key held down.  You may
+have to restart your Macintosh for changes to take effect before
+proceeding.
+.(tag [1]
+.It [1]
+If your version of the Memory control panel does not have a 32-bit
+addressing mode radio button, this means that your system is already
+32-bit clean and is running in 32-bit addressing mode by default.  If the
+Booter complains that your are not in 32-bit mode, it may be necessary
+for you to press the "Use Defaults" button in the Memory control panel to
+restore 32-bit addressing.  You should probably reboot after doing so.
+If you have an older II-class system (including the II, IIx, IIcx,
+and SE/30), it is necessary to install Connectix's MODE32 to work around
+ROM issues which prevent you from enabling 32-bit addressing. Please see the
+.Nx*M
+FAQ at
+.Lk http://www.netbsd.org/Ports/mac68k/faq/
+for more information.
+.tag)
+.Pp
+Double-click on the
+.Nx*M
+Booter icon to start the application.
+Select
+.Ic Booting
+from the
+.Ic Options
+menu. Select the Kernel Location to be from Mac OS with the filename
+corresponding to the name of the Installation Kernel you are using.
+Typically this will be netbsd-INSTALL.gz.
+.Pp
+If you haven't already put your Macintosh into B\*&W mode, select the
+.Ic Monitor Options No from the
+.Ic Options
+menu and check the box for B\*&W mode.
+.Pp
+Try booting
+.Nx
+by selecting
+.Ic Boot Now No from the
+.Ic Options No menu.
+.Pp
+If the system does not come up, send mail to
+.Mt port-mac68k%netbsd.org@localhost
+describing your software, your hardware, and as complete a description of
+the problem as you can. As an alternative, try using the Traditional
+method of installation described in the next section.