[src/trunk]: src/distrib/notes common/main:

To: source-changes-hg%NetBSD.org@localhost
Subject: [src/trunk]: src/distrib/notes common/main:
From: mbw <mbw%NetBSD.org@localhost>
Date: Fri, 24 Jan 2020 09:37:18 +0000
details:   https://anonhg.NetBSD.org/src/rev/d84cc2b762c3
branches:  trunk
changeset: 513907:d84cc2b762c3
user:      mbw <mbw%NetBSD.org@localhost>
date:      Fri Aug 17 07:04:41 2001 +0000

description:
common/main:
quick start info about bootable CD-R image

common/sysinst:
point to FAQ entry on missing hard drives

macppc/hardware:
fix info on D-Link 530TX (vr) and 530TX+ (rtk)
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
   need to use -current
mention that AirPort/AirMac 802.11b wireless is supported in -current
mention that CPU upgrades are supported

macppc/install:
point to partition numbering explanation in FAQ
fix kernel name on bootable cd-rom and mention case sensitivity

macppc/prep:
mention that people unfamiliar with MacOS should mail the port-macppc
list.
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
   need to use -current
Umax S900 isn't supported by System Disk
describe how to use Disk Copy to create the bootable floppy
point to partition numbering explanation in FAQ
point to ISO mirror site list

diffstat:

 distrib/notes/common/main     |  16 +++++---
 distrib/notes/common/sysinst  |  15 ++++++-
 distrib/notes/macppc/hardware |  29 +++++++++++---
 distrib/notes/macppc/install  |  27 +++++++++----
 distrib/notes/macppc/prep     |  83 +++++++++++++++++++++++++++++++++++++-----
 5 files changed, 136 insertions(+), 34 deletions(-)

diffs (truncated from 341 to 300 lines):

diff -r 22c7d26d90cb -r d84cc2b762c3 distrib/notes/common/main
--- a/distrib/notes/common/main Fri Aug 17 06:39:53 2001 +0000
+++ b/distrib/notes/common/main Fri Aug 17 07:04:41 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: main,v 1.135 2001/08/03 15:08:46 yamt Exp $
+.\"    $NetBSD: main,v 1.136 2001/08/17 07:04:41 mbw Exp $
 .\"
 .\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -265,10 +265,14 @@
 You may need to replace both 9's with your drive's partition number.
 .Pp
 For boot CDs, the command is something like
-.Dq Ic "boot cd:0,OFWBOOT.XCF NETBSD.RAM" .
-You will most likely need to keep
-.Ic OFWBOOT.XCF No and Ic NETBSD.RAM
-capitalized.  You may need to replace
+.Dq Ic "boot cd:,\eofwboot.xcf netbsd.macppc"
+(for Open Firmware 3) or
+.Dq Ic "boot scsi-int/sd@3:0,\eOFWBOOT.XCF NETBSD.MACPPC"
+(for earlier Open Firmware versions).
+You will need to use the correct case for
+.Ic OFWBOOT.XCF No and Ic NETBSD.MACPPC
+depending on how your version of Open Firmware interprets the ISO 
+filesystem.  You may need to replace
 .Ic cd
 with
 .Ic "scsi/sd@3 , scsi-int/sd@3 , scsi-ext/sd@3 , ata/atapi-disk ,"
@@ -277,7 +281,7 @@
 command to confirm that the
 .Nx*M
 kernel is called
-.Pa NETBSD.RAM .
+.Pa NETBSD.MACPPC .
 .\}
 .if r_sparc \{\
 .It
diff -r 22c7d26d90cb -r d84cc2b762c3 distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Fri Aug 17 06:39:53 2001 +0000
+++ b/distrib/notes/common/sysinst      Fri Aug 17 07:04:41 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysinst,v 1.24 2001/06/06 23:12:48 scottr Exp $
+.\"    $NetBSD: sysinst,v 1.25 2001/08/17 07:04:41 mbw Exp $
 .\"
 .\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -442,7 +442,9 @@
 command to boot from your hard drive.
 .\}
 .Nx
-will now boot. If you haven't already done so in sysinst, you should log in as
+will now boot. If you haven't already done so in 
+.Ic sysinst ,
+you should log in as
 .Li root ,
 and set a password for that account. You are also
 advised to edit the file
@@ -820,6 +822,15 @@
 that it does, reply affirmatively. Otherwise, the install
 program will automatically reserve space for bad144 tables.
 .\}
+.if r_macppc \{\
+If 
+.Ic sysinst 
+reports 
+.Dl "I can not find any hard disk for use by NetBSD"
+or the drive you wish to install onto is missing, then you should look at 
+the FAQ entry
+.Lk http://www.netbsd.org/Ports/macppc/faq.html#nodisk 
+.\}
 .\}
 .It
 .Em Partitioning the disk
diff -r 22c7d26d90cb -r d84cc2b762c3 distrib/notes/macppc/hardware
--- a/distrib/notes/macppc/hardware     Fri Aug 17 06:39:53 2001 +0000
+++ b/distrib/notes/macppc/hardware     Fri Aug 17 07:04:41 2001 +0000
@@ -1,4 +1,4 @@
-.\"$NetBSD: hardware,v 1.19 2001/07/23 02:52:03 mbw Exp $
+.\"$NetBSD: hardware,v 1.20 2001/08/17 07:04:42 mbw Exp $
 .
 Currently,
 .Nx*M
@@ -119,9 +119,12 @@
 (Digital Audio), and G4 Cube)
 .bullet)
 .(Note
-There have been some reports that PowerBook G4 (Titanium) models that have
-BootROM version 4.1.8 do not boot
-.Nx No .
+The PowerBook (FireWire) and PowerBook G4 (Titanium) models that have
+BootROM version 4.1.8 are not supported by \*V.
+You will need to use a kernel from the -current branch of
+.Nx .
+See
+.Lk http://www.netbsd.org/Documentation/kernel
 .Note)
 .(Note
 Some iMac (Bondi Blue) and PowerMacintosh G3 (Blue and
@@ -170,6 +173,13 @@
 .
 .Ss2 Supported devices
 .(bullet -offset indent
+CPU upgrades
+.(bullet -compact
+Most CPU upgrades are supported.  Some older models will not automatically
+enable the L2 cache on a G3 or G4 processor.  See the FAQ entry
+.Lk http://www.netbsd.org/Ports/macppc/faq.html#cpu-upgrade
+.bullet)
+.It
 Ethernet
 .(bullet -compact
 On-board 79C950-based MACE Ethernet interface
@@ -208,6 +218,9 @@
 VIA Technologies VT86C926
 .Pq Em ne
 .It
+D-Link DFE-530TX+
+.Pq Em rtk
+.It
 RealTek 8139
 .Pq Em rtk
 .It
@@ -218,7 +231,7 @@
 .Pq Em tlp
 .It
 D-Link DFE-530TX
-.Pq Em rtk
+.Pq Em vr
 .It
 Many other PCI and Cardbus Ethernet interfaces, such as
 Tulip-compatible
@@ -441,7 +454,11 @@
 .Note)
 .Pp
 .It
-AirPort
+AirPort/AirMac 802.11b wireless interface
+.(Note
+This interface is supported in the -current branch of
+.Nx .
+.Note)
 .It
 On-board video capture
 .bullet)
diff -r 22c7d26d90cb -r d84cc2b762c3 distrib/notes/macppc/install
--- a/distrib/notes/macppc/install      Fri Aug 17 06:39:53 2001 +0000
+++ b/distrib/notes/macppc/install      Fri Aug 17 07:04:41 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.15 2001/07/05 05:03:02 mbw Exp $
+.\"    $NetBSD: install,v 1.16 2001/08/17 07:04:42 mbw Exp $
 .
 .Ss2 Booting the installer
 .
@@ -174,9 +174,14 @@
 .Pp
 Another thing to note is that you
 .Em must
-use capital letters when specifying the filename to load.
+use the same case when specifying the filename to load that Open Firmware 
+uses.
 Also, keep in mind what format your CD-R has to be for your version of
-Open Firmware (pure ISO versus hybrid ISO/HFS) before giving up.
+Open Firmware (pure ISO versus hybrid ISO/HFS) before giving up.  The
+official bootable
+.Nx \*V 
+CD-ROM image is magically able to boot all Open Firmware versions.  Don't 
+ask how.
 .Pp
 You may be able to get a directory listing of the files on your CD-ROM
 disk with the following command (where
@@ -189,12 +194,12 @@
 Here are some examples of what you might use to boot from CD-ROM (Apple
 usually sets their CD-ROM drives to SCSI ID 3):
 .Pp
-.Dl 0 > Ic "boot scsi-int/sd@3:0,OFWBOOT.XCF NETBSD.RAM"
-.Dl 0 > Ic "boot scsi/sd@3:0,OFWBOOT.XCF NETBSD.RAM"
-.Dl 0 > Ic "boot scsi-ext/sd@3:0,OFWBOOT.XCF NETBSD.RAM"
-.Dl 0 > Ic "boot ata/atapi-disk:0,OFWBOOT.XCF NETBSD.RAM"
-.Dl 0 > Ic "boot ide1/disk@0:0,OFWBOOT.XCF NETBSD.RAM"
-.Dl 0 > Ic "boot cd:0,OFWBOOT.XCF NETBSD.RAM"
+.Dl 0 > Ic "boot scsi-int/sd@3:0,OFWBOOT.XCF NETBSD.MACPPC"
+.Dl 0 > Ic "boot scsi/sd@3:0,OFWBOOT.XCF NETBSD.MACPPC"
+.Dl 0 > Ic "boot scsi-ext/sd@3:0,OFWBOOT.XCF NETBSD.MACPPC"
+.Dl 0 > Ic "boot ata/atapi-disk:0,OFWBOOT.XCF NETBSD.MACPPC"
+.Dl 0 > Ic "boot ide1/disk@0:0,OFWBOOT.XCF NETBSD.MACPPC"
+.Dl 0 > Ic "boot cd:0,ofwboot.xcf netbsd.macppc"
 .It
 .Em "IDE or SCSI drive with a"
 .Sq "partition zero"
@@ -240,6 +245,10 @@
 drive:
 .Dl % Ic "sudo pdisk /dev/disk0 -dump"
 .Pp
+If you are confused by the various partition numbering schemes, see the 
+explanation in the FAQ
+.Lk http://www.netbsd.org/Ports/macppc/faq.html#partitions
+.Pp
 You may be able to get a directory listing of the files on your hard
 drive with the following command (where
 .Pa hd-devalias
diff -r 22c7d26d90cb -r d84cc2b762c3 distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Fri Aug 17 06:39:53 2001 +0000
+++ b/distrib/notes/macppc/prep Fri Aug 17 07:04:41 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.21 2001/07/24 17:57:45 nra Exp $
+.\"    $NetBSD: prep,v 1.22 2001/08/17 07:04:42 mbw Exp $
 .
 .Ss2 Prepare yourself
 .
@@ -17,6 +17,23 @@
 everything works easier than you expected.  Also, forget everything you've
 been told about installing 
 .Nx*M No Ns .
+That's right, flush your knowledge cache -- some of it is almost 
+certainly dirty.
+.Pp
+Some of this document assumes familiarity with 
+.Tn MacOS ,
+e.g. how to download BinHex files and extract things with StuffIt 
+Expander.  If you've never heard of those terms before, it is possible to 
+install
+.Nx*M
+without booting or knowing how to use
+.Tn MacOS ,
+but depending on your model it may be almost as painful as learning a 
+little
+.Tn MacOS .
+If you 
+.Em really
+want to bypass it, you should mail port-macppc%netbsd.org@localhost for guidance.
 .Pp
 It's done printing?  Fine, now get a dark writing implement.
 .Pp
@@ -126,13 +143,16 @@
 recommend not doing this.
 .Note)
 .(Note
-The most recent BootROMs available (4.1.7 and 4.1.8) as of May 2001 are
-known to have some problems.  Some PowerBook G4 users find they are
-unable to boot 
-.Nx
-after upgrading, and some PowerMacintosh users find that their third-party 
+The most recent BootROMs available (4.1.7 and 4.1.8) as of August 2001 are
+known to have some problems.  
+Some PowerMacintosh users find that their third-party 
 RAM has been disabled.  See the discussion at
 .Lk http://www.macfixit.com/archives/april.01.a.shtml#firm-04-07
+.Pp
+The PowerBook (FireWire) and PowerBook G4 
+(Titanium) models with BootROM 4.1.8 are not supported in this release.  
+If your system has this BootROM, you must use a kernel from the -current
+branch.
 .Note)
 .Pp
 .
@@ -245,6 +265,8 @@
 PowerComputing PowerBase,
 .br
 Umax Apus 2000, Apus 3000, C500, and C600
+.br
+Umax S900
 .Pp
 For every other model, download System Disk from Apple's site:
 .Lk ftp://ftp.apple.com/developer/macosxserver/utilities/SystemDisk2.3.1.smi.bin
@@ -800,6 +822,9 @@
 .
 (All Open Firmware versions)
 .Pp
+This section gives a quick description of the various media that can be 
+used by Open Firmware to load the bootloader.
+.Pp
 .(bullet -offset indent
 .
 .Em "Partition zero"
@@ -1017,6 +1042,10 @@
 .Em Dq "Re-install sets" 
 .Em "option.  More information is provided below on this process."
 .Pp
+There are several contradictory partition numbering schemes.  You may want 
+to look at the explanation in the FAQ.
+.Lk http://www.netbsd.org/Ports/macppc/faq.html#partitions
+.Pp
 Unfortunately, the partitioning tools for
 .Nx
 are not advanced enough to create HFS or HFS+ file systems or a 
@@ -1209,6 +1238,37 @@
 .Em "From a MacOS machine"
 .Pp
 Get
+.Ic DiskCopy
+6.3.3 from 
+.Lk http://downloAd.info.apple.com/Apple_Support_Area/Apple_Software_Updates/English-North_American/Macintosh/Utilities/Disk_Copy/Disk_Copy_6.3.3.smi.bin
+.Pp
+If you are running a
+.Tn MacOS
+version prior to 9.0, get
+.Lk ftp://ftp.netbsd.org/pub/NetBSD/arch/macppc/macos-utils/MakeDiskCopyFloppyType.hqx
+and un-BinHex it.  Then, drag the 
+.Pa boot.fs
+file onto this application, which will change the type and creator to
Prev by Date: [src/trunk]: src/share/man/man9 put back a sentence that was accidentally rem...
Next by Date: [src/trunk]: src/etc/etc.sparc64 don't clobber INSTALLATION_DIRS, just add to...
Previous by Thread: [src/trunk]: src/share/man/man9 put back a sentence that was accidentally rem...
Next by Thread: [src/trunk]: src/etc/etc.sparc64 don't clobber INSTALLATION_DIRS, just add to...
Indexes:
Home | Main Index | Thread Index | Old Index