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

Re: [patch] powerpc dbootstrap documentation.

On Sat, Aug 26, 2000 at 07:10:20PM -0400, Adam Di Carlo wrote:
> Daniel Jacobowitz <dan@debian.org> writes:
> > Actually, ethan, let's wait on this patch a few days - until I get
> > yaboot 0.7 -packaged-.
> > 
> > It'll be real soon, I promise.
> Ok, can someone resend or else apply this patch when it's time?
> BTW, I've just today added some stuff about invoking openfirmware and
> using of to boot from the net .. TFTP installation is very very nice
> and it's a shame our documentation for it isn't better.
> -- 
> .....Adam Di Carlo....adam@onShore.com.....<URL:http://www.onShore.com/>

i am resending the patch to dbootstrap.sgml to document the bootstrap
installation procedure for NewWorld powermacs, the new procedure is
slightly less painful (especially for SCSI or slave IDE installs)
given the advancments in the newer ybin utility (now packaged). 

I am still hoping for dbootstrap to get a NewWorld compatible `Make
bootable from the hard disk' function but for now this patch makes
things accurate for now.   

I also added at least one link to mac-fdisk-basics.txt but im not sure
exactly the right way to include that document, i think it would be
helpful to have in the debian install docs.  you can find it at:


Ethan Benson
Index: dbootstrap.sgml
RCS file: /cvs/debian-boot/boot-floppies/documentation/en/dbootstrap.sgml,v
retrieving revision 1.44
diff -u -r1.44 dbootstrap.sgml
--- dbootstrap.sgml	2000/10/25 17:10:58	1.44
+++ dbootstrap.sgml	2000/11/10 14:28:40
@@ -192,7 +192,9 @@
 <![ %mac-fdisk.txt [ <tag><prgn>mac-fdisk</prgn><item> Mac-aware
 version of <prgn>fdisk</prgn>; read the <url id="mac-fdisk.txt"
-name="mac-fdisk manual page">. ]]>
+name="mac-fdisk manual page">.  Also read the <url
+id="mac-fdisk-tutorial.txt" name="mac-fdisk-tutorial"> for more
+help. ]]>
 <![ %pmac-fdisk.txt [ <tag><prgn>pmac-fdisk</prgn><item> PowerMac-aware
 version of <prgn>fdisk</prgn>, also used by BVM and Motorola VMEbus systems; 
@@ -734,9 +736,13 @@
 To setup <prgn>yaboot</prgn> you need to know the following:
-   <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>.
@@ -751,7 +757,7 @@
 IDE hard disk, in which case your OpenFirmware device path is `hd:'
-mkofboot --boot /dev/hda2 -m /target/etc/ofboot.b --root /dev/hda3 --partition 3
+mkofboot --boot /dev/hda2 -m /target/usr/lib/yaboot/ofboot --root /dev/hda3 --partition 3
 where "/dev/hda2" is the bootstrap partition, "/dev/hda3" is your root
@@ -763,29 +769,26 @@
 following steps:
-  <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:
-boot /pci@80000000/pci-bridge@d/ADPT,2930CU@2/@1:2,\\yaboot
-  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:
-mkofboot --boot /dev/sda2 -m /target/etc/ofboot.b --root /dev/sda3 \
+ofpath /dev/sda
+mkofboot --boot /dev/sda2 -m /target/usr/lib/yaboot/ofboot --root /dev/sda3 \
    --partition 3 --device /pci@80000000/pci-bridge@d/ADPT,2930CU@2/@1:
+or a simpler method:
+mkofboot --boot /dev/sda2 -m /target/usr/lib/yaboot/ofboot --root /dev/sda3 \
+   --partition 3 --device `ofpath /dev/sda`
+<<<<<<< dbootstrap.sgml
+Your disk should now be bootable.  OpenFirmware's settings should also
+be set to boot &debian, see the ybin documentation for info on setting
+up a boot menu if desired.
 Your disk should now be bootable.  On G4 machines and iBooks, you can
 hold down the option key and get a graphical screen with a button for
 each bootable OS, &debian; will be a button with a penguin icon.  For
@@ -794,6 +797,7 @@
 Reseting OpenFirmware on G3 or G4 hardware will cause it to boot
 &debian; by default. (If you have a SCSI disk this may not work and you
 will have to enter OpenFirmware and set the boot device yourself).
+>>>>>>> 1.44
 After you have booted successfully for the first time you will need to
 create a permanent <file>/etc/yaboot.conf</file> file. This is the default
@@ -807,8 +811,14 @@
+## Comment out if you have a newworld compatible nvsetenv (ybin can
+## likely detect the incompatible version) when commented out ybin
+## will update the boot-device variable in OpenFirmware to the
+## bootstrap partition.  
@@ -827,25 +837,39 @@
    <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.
+   <item>Comment out the `nonvram' line so ybin will ensure OpenFirmware is
+   configured to boot from the bootstrap partition.
-      <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>/usr/lib/yaboot/ofboot</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,
+/usr/lib/yaboot/ofboot (formally /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: pgplzS5sMjaOy.pgp
Description: PGP signature

Reply to: