Author: ken
Date: 2006-06-08 11:40:02 -0600 (Thu, 08 Jun 2006)
New Revision: 1743
Added:
trunk/BOOK/appendices/ppc/
trunk/BOOK/appendices/ppc/macmiscellany.xml
Modified:
trunk/BOOK/appendices/acronymlist.xml
trunk/BOOK/appendices/dependencies/ppc.xml
trunk/BOOK/general.ent
trunk/BOOK/introduction/ppc/changelog.xml
trunk/BOOK/introduction/ppc64/changelog.xml
trunk/BOOK/ppc-index.xml
trunk/BOOK/ppc64-index.xml
Log:
Add appendix to mention OF and Mac issues, so that builders can make sensible
choices.
Modified: trunk/BOOK/appendices/acronymlist.xml
===================================================================
--- trunk/BOOK/appendices/acronymlist.xml 2006-06-07 23:57:39 UTC (rev
1742)
+++ trunk/BOOK/appendices/acronymlist.xml 2006-06-08 17:40:02 UTC (rev
1743)
@@ -65,6 +65,13 @@
</varlistentry>
<varlistentry>
+ <term><emphasis role="bold">bless</emphasis></term>
+ <listitem>
+ <para>manipulate a filesystem so that OF will boot from it</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><emphasis role="bold">BLFS</emphasis></term>
<listitem>
<para>Beyond Linux From Scratch</para>
Modified: trunk/BOOK/appendices/dependencies/ppc.xml
===================================================================
--- trunk/BOOK/appendices/dependencies/ppc.xml 2006-06-07 23:57:39 UTC (rev
1742)
+++ trunk/BOOK/appendices/dependencies/ppc.xml 2006-06-08 17:40:02 UTC (rev
1743)
@@ -11,7 +11,7 @@
<title>PowerPC Dependencies</title>
- <para>This page contains dependency information for packages specific to
Sparc.</para>
+ <para>This page contains dependency information for packages specific to
ppc.</para>
<!-- Begin hfsutils dependency info -->
<bridgehead renderas="sect2" id="hfsutils-dep">hfsutils</bridgehead>
Added: trunk/BOOK/appendices/ppc/macmiscellany.xml
===================================================================
--- trunk/BOOK/appendices/ppc/macmiscellany.xml (rev 0)
+++ trunk/BOOK/appendices/ppc/macmiscellany.xml 2006-06-08 17:40:02 UTC (rev
1743)
@@ -0,0 +1,135 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"; [
+ <!ENTITY % general-entities SYSTEM "../../general.ent">
+ %general-entities;
+]>
+
+<appendix id="appendixe" xreflabel="Appendix E">
+ <?dbhtml dir="appendices"?>
+ <?dbhtml filename="macmiscellany.html"?>
+
+ <title>Open Firmware and Mac issues.</title>
+
+ <para>This appendix documents some of the features of ppc macintoshes,
+ and in particular the requirements of coexisting with Mac OS's (OSX or
+ the old OS9). It is only relevant to NewWorld hardware.</para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><emphasis role="bold">Open Firmware and blessed
partitions</emphasis></term>
+ <listitem>
+ <para>The Open Firmware (OF) is the code in ROM or nvram which controls
+ how the machine boots. If booting automatically, it will boot from the
+ first valid blessed partition it finds (this is a simplification,
+ but it is adequate for normal purposes).</para>
+
+ <para>It can only read apple filesystems (hfs, hfs+, or hfsx depending
+ on the version of the firmware). For disks under linux, the blessing
+ is done by ybin when it installs yaboot (the loader) and
yaboot.conf.</para>
+
+ <para>Mac OS's have a tendency to look at other hfs{,+,x} filesystems
+ on the disk, and unbless them if they do not match their expectations.
+ Unblessing makes them unbootable. Fortunately, a filesystem of type
+ <literal>Apple_Bootstrap</literal> can be read as hfs by the OF, but
will
+ be ignored by Mac OS.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><emphasis role="bold">Partitioning</emphasis></term>
+ <listitem>
+ <para>Macintoshes use their own partition format - this means that other
+ machines are unlikely to be able to read or write to macintosh
partitions
+ (in particular, fdisk does not understand them). The format allows a
large
+ number of individual partitions, and the native Mac tools have a
tendency
+ to insert small "filler" partitions between the real partitions. Under
+ linux, using more than 15 partitions can be problematic (shortage of
device
+ nodes), so the normal approach is to use the Mac tools to create an area
+ of freespace at the <emphasis>front</emphasis> of the disk, then put the
+ Mac OS partition(s) after it and (re-)install the Mac OS. The
+ freespace can then be partitioned using <command>parted</command> or the
+ older <command>mac-fdisk</command>.</para>
+
+ <warning>
+ <para>The Macintosh resizing and partitioning tools are destructive and
will
+ delete all data when a partition is resized.</para>
+ </warning>
+
+ <para>For the Linux partitions, you will need a bootstrap partition -
this
+ can normally be a mere 800KB in size (the smallest hfs partition
available)
+ although the Fedora installer has been known to insist on 800MB. This
has
+ to be in front of the Mac OS partition. The bootstrap is
+ <emphasis>never</emphasis> mounted as a regular partition and should not
+ be confused with a <literal>/boot</literal> partition. Other partitions
+ are as normal (at least one rootfs, perhaps swap, perhaps
others).</para>
+
+ <para>If you follow this advice, partition 1 will be the apple partition
+ map, partition 2 will be the bootstrap at the start of the disk, the
+ linux partitions will follow, and then the mac partition(s) - under OSX
+ the first mac partition will be number 3, under OS9 it would have a
higher
+ number.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><emphasis role="bold">OSX or OF upgrades</emphasis></term>
+ <listitem>
+ <para>If the machine is dual-booted with OSX, the mac kernel or the OF
+ will probably be upgraded at some point. This appears to either unbless
+ the bootstrap, or else just point the OF boot device to the mac
partition
+ - so, the linux system will no longer be bootable.</para>
+
+ <para>Therefore, you will need to know which partition contains the
bootstrap
+ so that you can boot it from OF (on an apple keyboard, hold down
+ option-command-o-f (that is, alt-apple-o-f) while booting then enter a
+ command like:</para>
+
+<screen><userinput role="nodump">boot hd:2,yaboot</userinput></screen>
+
+ <para>This will allow you to select a linux boot, and from there you
+ will have to rerun <command>ybin</command>.</para>
+
+ <para>The "OS chooser" menu that yaboot typically loads is stored in the
+ OF and will not be available after a Mac kernel or firmware upgrade
until
+ <command>ybin</command> has been rerun.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><emphasis role="bold">Yaboot's requirements</emphasis></term>
+ <listitem>
+ <para>Yaboot is the boot loader for linux, sometimes referred to as
+ the second stage loader. It reads the yaboot.conf file on the bootstrap
+ partition to find which linux system(s) should be available, and
+ attempts to load the required kernel.</para>
+
+ <para>The bootstrap man page warns that the path to the kernel should
+ contain no more than one directory for reliability.</para>
+
+ <para>Yaboot has to be able to understand the filesystem, so that it
+ can find the kernel. It understands hfs (not useful for linux, it is
+ not case-sensitive), ext2 (and therefore it can read ext3), reiser3,
+ and xfs. If you want to use a different type of filesystem for '/'
+ you will have to create a separate boot partition with a supported
+ filesystem, and use that to hold the kernels.</para>
+
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><emphasis role="bold">Requirements if starting from
OSX</emphasis></term>
+ <listitem>
+ <para>Older versions of OSX (panther, leopard) can write to ext2
+ filesystems using version 1.3 of ext2fsx. The upgrade to tiger broke
+ this, and version 1.4 of ext2fsx only supports reading. Users of
+ current OSX will therefore have to find some other way of creating
+ a suitable filesystem and populating it, such as a Live CD or rescue CD.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+</appendix>
Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent 2006-06-07 23:57:39 UTC (rev 1742)
+++ trunk/BOOK/general.ent 2006-06-08 17:40:02 UTC (rev 1743)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!ENTITY version "SVN-20060607">
+<!ENTITY version "SVN-20060608">
<!ENTITY version-x86 "&version;-x86">
<!ENTITY version-x86_64 "&version;-x86_64-Multilib">
<!ENTITY version-x86_64-64 "&version;-x86_64-Pure64">
@@ -15,7 +15,7 @@
<!ENTITY version-mips64-64 "&version;-MIPS64-Pure64">
<!ENTITY version-alpha "&version;-ALPHA">
-<!ENTITY releasedate "June 7, 2006">
+<!ENTITY releasedate "June 8, 2006">
<!ENTITY milestone "0.1">
<!ENTITY generic-version "svn"> <!-- Use "svn", "testing", or "x.y[-pre{x}]"
-->
Modified: trunk/BOOK/introduction/ppc/changelog.xml
===================================================================
--- trunk/BOOK/introduction/ppc/changelog.xml 2006-06-07 23:57:39 UTC (rev
1742)
+++ trunk/BOOK/introduction/ppc/changelog.xml 2006-06-08 17:40:02 UTC (rev
1743)
@@ -34,6 +34,15 @@
-->
<listitem>
+ <para>June 8, 2006</para>
+ <itemizedlist>
+ <listitem>
+ <para>[ken] - Add an appendix to discuss OF and Mac issues.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para>May 10, 2006</para>
<itemizedlist>
<listitem>
Modified: trunk/BOOK/introduction/ppc64/changelog.xml
===================================================================
--- trunk/BOOK/introduction/ppc64/changelog.xml 2006-06-07 23:57:39 UTC (rev
1742)
+++ trunk/BOOK/introduction/ppc64/changelog.xml 2006-06-08 17:40:02 UTC (rev
1743)
@@ -34,6 +34,15 @@
-->
<listitem>
+ <para>June 8, 2006</para>
+ <itemizedlist>
+ <listitem>
+ <para>[ken] - Add an appendix to discuss OF and Mac issues.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para>May 31, 2006</para>
<itemizedlist>
<listitem>
Modified: trunk/BOOK/ppc-index.xml
===================================================================
--- trunk/BOOK/ppc-index.xml 2006-06-07 23:57:39 UTC (rev 1742)
+++ trunk/BOOK/ppc-index.xml 2006-06-08 17:40:02 UTC (rev 1743)
@@ -75,6 +75,7 @@
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
href="appendices/acknowledgments.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
href="appendices/dependencies/common.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
href="appendices/dependencies/ppc.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
href="appendices/ppc/macmiscellany.xml"/>
</part>
Modified: trunk/BOOK/ppc64-index.xml
===================================================================
--- trunk/BOOK/ppc64-index.xml 2006-06-07 23:57:39 UTC (rev 1742)
+++ trunk/BOOK/ppc64-index.xml 2006-06-08 17:40:02 UTC (rev 1743)
@@ -75,6 +75,7 @@
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
href="appendices/acknowledgments.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
href="appendices/dependencies/common.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
href="appendices/dependencies/ppc.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
href="appendices/ppc/macmiscellany.xml"/>
</part>
--
http://linuxfromscratch.org/mailman/listinfo/cross-lfs
FAQ: http://www.linuxfromscratch.org/faq/
Unsubscribe: See the above information page
