[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[patch] powerpc dbootstrap documentation.



I have updated the installation manual to reflect improvments in ybin
(part of the yaboot bootloader package) the /boot/ofboot.b file is no
longer a conffile, it is a static file that is dynamically configured
by ybin when setting up the bootstrap partition.  There are also new
dual boot options which are far easier for the user to configure, this
has been documented here as well.  These changes reflect what will be
version 0.7-0.19 of the yaboot package (Dan Jacobowitz maintains
this.).  Provided yaboot 0.7-0.19 goes into potato r1 this patch
should be applied to the boot floppies for r1 as well.  CVS patch is enclosed.

Also there seems to be no documentation for mac-fdisk, i have written
a plain text tutorial of this utility (its not a man page but its
rather helpful) it can be found at
http://www.alaska.net/~erbenson/doc/mac-fdisk-basics.txt.  if someone
would like to add this to the debian install docs.

(please CC any replies i am not subscribed to this list)

-- 
Ethan Benson
http://www.alaska.net/~erbenson/
Index: documentation/en/dbootstrap.sgml
===================================================================
RCS file: /cvs/debian-boot/boot-floppies/documentation/en/dbootstrap.sgml,v
retrieving revision 1.34
diff -u -r1.34 dbootstrap.sgml
--- documentation/en/dbootstrap.sgml	2000/08/25 06:58:25	1.34
+++ documentation/en/dbootstrap.sgml	2000/08/26 09:16:56
@@ -704,9 +704,13 @@
       <p>
 To setup <prgn>yaboot</prgn> you need to know the following:
 <enumlist>
-   <item>The OpenFirmware device path to the disk on which you installed
-   &debian;. If you are installing onto the standard internal IDE hard
-   disk then this device path will be simply `hd:'.
+   <item>The OpenFirmware device path to the disk on which you
+   installed &debian;. If you are installing onto the standard
+   internal IDE hard disk then this device path will be simply `hd:'.
+   You can find the OpenFirmware device path to your disk by running
+   the command <example>ofpath /dev/sda</example> where
+   <file>/dev/sda</file> is the device you installed on (not the
+   partition)
 
    <item>The device node of your bootstrap partition (that you created when
    partitioning the disk), e.g. <file>/dev/hda2</file>.
@@ -721,7 +725,7 @@
 IDE hard disk, in which case your OpenFirmware device path is `hd:'
 
 <example>
-mkofboot --boot /dev/hda2 -m /target/etc/ofboot.b --root /dev/hda3 --partition 3
+mkofboot --boot /dev/hda2 -m /target/boot/ofboot.b --root /dev/hda3 --partition 3
 </example>
 
 where "/dev/hda2" is the bootstrap partition, "/dev/hda3" is your root
@@ -733,27 +737,19 @@
 following steps:
 
 <enumlist>
-  <item>Edit <file>/etc/ofboot.b</file> replacing `hd' in the line
-  `boot hd:\\yaboot' with the full OpenFirmware path to your disk with
-  the partition number of your bootstrap partition after the `:'.
-  For example:
+  <item>add "--device <var>path</var>" to the <prgn>mkofboot</prgn>
+  command above. Use ofpath to find the correct device path, For example:
 
 <example>
-boot /pci@80000000/pci-bridge@d/ADPT,2930CU@2/@1:2,\\yaboot
-</example>
-
-  where the number "1" is the SCSI ID of the disk, and the number "2" is
-  the partition number of your bootstrap partition.  See the
-  <url id="&url-powerpc-yaboot-faq;" name="yaboot FAQ"> for information on
-  finding the OpenFirmware device paths.
-
-  <item>add "--device <var>ofpath</var>" to the <prgn>mkofboot</prgn>
-  command above. For example:
-
-<example>
-mkofboot --boot /dev/sda2 -m /target/etc/ofboot.b --root /dev/sda3 \
+ofpath /dev/sda
+/pci@80000000/pci-bridge@d/ADPT,2930CU@2/@1:
+mkofboot --boot /dev/sda2 -m /target/boot/ofboot.b --root /dev/sda3 \
    --partition 3 --device /pci@80000000/pci-bridge@d/ADPT,2930CU@2/@1:
 </example>
+or a simpler method:
+<example>
+mkofboot --boot /dev/sda2 -m /target/boot/ofboot.b --root /dev/sda3 \
+   --partition 3 --device `ofpath /dev/sda`
 </enumlist>
       <p>
 Your disk should now be bootable.  On G4 machines and iBooks, you can
@@ -798,24 +794,35 @@
    <item>Change the `root=' line to have the same value you used for the
    --root switch to <prgn>mkofboot</prgn>. This is your root partition.
 </enumlist>
-      <p>
-Edit or replace <file>/etc/ofboot.b</file> to suit your system. The
-default version will work if you are using the internal IDE hard disk,
-otherwise edit it as you did when installing the system.  If you are dual
-booting with MacOS you may want to replace it with one of the files from
-<file>/usr/share/doc/yaboot/examples/</file>, such as
-<file>menu_ofboot.b</file> that will allow you to hold down the spacebar
-key to boot the alternate OS. For more information, see the README files
-located there.
-      <p>
+    <p>
+If you need to dual boot MacOS, simply add the line
+<example>macos=/dev/hda12</example> to <file>/etc/yaboot.conf</file>.
+If you also wish to boot MacOSX add the line
+<example>macosx=/dev/hda13</example> to <file>/etc/yaboot.conf</file>.
+You can have one or both (or niether) of these options at the same
+time.  When either macos= or macosx= is defined a real menu of choices
+will be displayed at boot, if no choice is made after 10 seconds
+Debian will be booted by default.  If you wish to change the default
+OS add the line <example>defaultos=macos</example> or
+<example>defaultos=macosx<example> to <file>/etc/yaboot.conf<file>.
+The timeout to booting the default OS can be changed by adding
+<example>delay=5</example> where <example>5</example> is the number of
+seconds you want the menu to wait for a choice.
+    <p>
 Run the <prgn>ybin</prgn> command, which will update the bootstrap
 partition with the current <file>/etc/yaboot.conf</file> configuration
-and <file>/etc/ofboot.b</file> first stage loader. Use the <prgn>ybin</prgn>
-command any time you make changes to <file>/etc/yaboot.conf</file> or
-<file>ofboot.b</file> files. Also, run it every time the
+and <file>/boot/ofboot.b</file> first stage loader. Use the
+<prgn>ybin</prgn> command any time you make changes to
+<file>/etc/yaboot.conf</file>. Also, run it every time the
 <package>yaboot</package> package is upgraded so the upgraded
-<prgn>yaboot</prgn> binary will be activated.
-]]>
+<prgn>yaboot</prgn> binary will be activated.  ]]>  
+    <p>
+IMPORTANT: Unlike previous versions of the yaboot package,
+/boot/ofboot.b should NOT be edited, it is automatically configured
+based on configuration options in <file>/etc/yaboot.conf</file>.
+<pgrn>ybin</prgn> will use the <prgn>ofpath</prgn> utility to find out
+the correct OpenFirmware device paths to be encoded into the ofboot.b
+first stage loader.
 
 <![ %arm [ <![ %FIXME [ <p><em>FIXME: about the boot manager?</em> ]]> ]]>
 

Attachment: pgpnGuNrxephV.pgp
Description: PGP signature


Reply to: