nightmorph 10/07/20 08:29:37
Modified: handbook-sparc.xml hb-install-sparc-bootloader.xml
hb-install-sparc-disk.xml
hb-install-sparc-kernel.xml
hb-install-sparc-medium.xml
Log:
Update the Sparc handbook for the autobuilds. Major version bump for this
release. Fixes bug 260403, bug 292726, and bug 234310.
Revision Changes Path
1.141 xml/htdocs/doc/en/handbook/handbook-sparc.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.141&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.141&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml?r1=1.140&r2=1.141
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v
retrieving revision 1.140
retrieving revision 1.141
diff -u -r1.140 -r1.141
--- handbook-sparc.xml 26 Jan 2009 08:47:04 -0000 1.140
+++ handbook-sparc.xml 20 Jul 2010 08:29:37 -0000 1.141
@@ -1,19 +1,21 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v 1.140
2009/01/26 08:47:04 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v 1.141
2010/07/20 08:29:37 nightmorph Exp $ -->
<book>
<title>Gentoo Linux SPARC Handbook</title>
<values>
<key id="arch">SPARC</key>
- <key id="kernel-name">kernel-2.6.24-gentoo-r5</key>
- <key id="kernel-version">2.6.24-r5</key>
- <key id="online-book">handbook-sparc.xml</key>
- <key id="release-dir">releases/sparc/2008.0/sparc64/</key>
- <key id="stage3">stage3-sparc64-2008.0.tar.bz2</key>
- <key id="profile">default/linux/sparc/2008.0</key>
+ <key id="kernel-name">kernel-2.6.33-gentoo-r2</key>
+ <key id="kernel-version">2.6.33-r2</key>
+ <key id="min-cd-name">install-sparc64-minimal-<release>.iso</key>
+ <key id="min-cd-size">57</key>
+ <key id="profile">default/linux/sparc/10.0</key>
+ <key id="release-dir">releases/sparc/autobuilds/</key>
+ <key id="stage3">stage3-sparc64-<release>.tar.bz2</key>
<key id="CFLAGS">-O2 -mcpu=ultrasparc -pipe</key>
+ <key id="online-book">handbook-sparc.xml</key>
</values>
<author title="Author">
@@ -134,8 +136,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>9.4</version>
-<date>2009-01-26</date>
+<version>10.0</version>
+<date>2010-07-20</date>
<part>
<title>Installing Gentoo</title>
1.22 xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml?rev=1.22&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml?rev=1.22&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml?r1=1.21&r2=1.22
Index: hb-install-sparc-bootloader.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- hb-install-sparc-bootloader.xml 1 Apr 2008 08:53:46 -0000 1.21
+++ hb-install-sparc-bootloader.xml 20 Jul 2010 08:29:37 -0000 1.22
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml,v
1.21 2008/04/01 08:53:46 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml,v
1.22 2010/07/20 08:29:37 nightmorph Exp $ -->
<sections>
-<version>3.0</version>
-<date>2008-04-01</date>
+<version>4.0</version>
+<date>2010-07-20</date>
<section>
<title>Making your Choice</title>
@@ -37,7 +37,7 @@
LOader.
</p>
-<pre caption = "Installing SILO">
+<pre caption="Installing SILO">
# <i>emerge silo</i>
</pre>
@@ -46,7 +46,7 @@
create <path>/etc/silo.conf</path>.
</p>
-<pre caption = "Creating /etc/silo.conf">
+<pre caption="Creating /etc/silo.conf">
# <i>nano -w /etc/silo.conf</i>
</pre>
@@ -56,7 +56,7 @@
<path>kernel-<keyval id="kernel-version"/></path> as kernelimage.
</p>
-<pre caption = "Example /etc/silo.conf">
+<pre caption="Example /etc/silo.conf">
partition = 1 <comment># Boot partition (= root partition)</comment>
root = /dev/sda1 <comment># Root partition</comment>
timeout = 150 <comment># Wait 15 seconds before booting the default
section</comment>
@@ -78,7 +78,7 @@
configuration file to <path>/boot</path> and run <c>/sbin/silo</c>:
</p>
-<pre caption = "Only if /boot and the SILO destination are not on the same
disk">
+<pre caption="Only if /boot and the SILO destination are not on the same disk">
# <i>cp /etc/silo.conf /boot</i>
# <i>/sbin/silo -C /boot/silo.conf</i>
/boot/silo.conf appears to be valid
@@ -88,7 +88,7 @@
Otherwise just run <c>/sbin/silo</c>:
</p>
-<pre caption = "Run silo">
+<pre caption="Run silo">
# <i>/sbin/silo</i>
/etc/silo.conf appears to be valid
</pre>
1.35 xml/htdocs/doc/en/handbook/hb-install-sparc-disk.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-disk.xml?rev=1.35&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-disk.xml?rev=1.35&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-disk.xml?r1=1.34&r2=1.35
Index: hb-install-sparc-disk.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-disk.xml,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- hb-install-sparc-disk.xml 3 Mar 2010 02:58:47 -0000 1.34
+++ hb-install-sparc-disk.xml 20 Jul 2010 08:29:37 -0000 1.35
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-disk.xml,v 1.34
2010/03/03 02:58:47 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-disk.xml,v 1.35
2010/07/20 08:29:37 nightmorph Exp $ -->
<sections>
-<version>5.1</version>
-<date>2008-05-02</date>
+<version>6.0</version>
+<date>2010-07-20</date>
<section>
<title>Introduction to Block Devices</title>
@@ -74,62 +74,62 @@
<th>Description</th>
</tr>
<tr>
- <ti>/dev/sda1</ti>
- <ti>ext3</ti>
- <ti><2 GByte</ti>
- <ti>/</ti>
- <ti>
- Root partition. For SPARC64 systems with older OBP versions, this
- <e>must</e> be less than 2 GBytes in size, and the first partition on the
- disk.
- </ti>
-</tr>
-<tr>
- <ti>/dev/sda2</ti>
- <ti>swap</ti>
- <ti>512 MBytes</ti>
- <ti>none</ti>
- <ti>
- Swap partition. For bootstrap and certain larger compiles, at least 512
- MBytes of RAM (including swap) is required.
- </ti>
-</tr>
-<tr>
- <ti>/dev/sda3</ti>
- <ti>none</ti>
- <ti>Whole disk</ti>
- <ti>none</ti>
- <ti>Whole disk partition. This is required on SPARC systems.</ti>
+ <ti>/dev/sda1</ti>
+ <ti>ext3</ti>
+ <ti><2 GB</ti>
+ <ti>/</ti>
+ <ti>
+ Root partition. For SPARC64 systems with older OBP versions, this
+ <e>must</e> be less than 2 GB in size, and the first partition on the
+ disk.
+ </ti>
+</tr>
+<tr>
+ <ti>/dev/sda2</ti>
+ <ti>swap</ti>
+ <ti>512 MB</ti>
+ <ti>none</ti>
+ <ti>
+ Swap partition. For bootstrap and certain larger compiles, at least 512
+ MB of RAM (including swap) is required.
+ </ti>
+</tr>
+<tr>
+ <ti>/dev/sda3</ti>
+ <ti>none</ti>
+ <ti>Whole disk</ti>
+ <ti>none</ti>
+ <ti>Whole disk partition. This is required on SPARC systems.</ti>
</tr>
<tr>
- <ti>/dev/sda4</ti>
- <ti>ext3</ti>
- <ti>at least 2 GBytes</ti>
- <ti>/usr</ti>
- <ti>
- /usr partition. Applications are installed here. By default this
partition
- is also used for Portage data (which takes around 500 Mbyte excluding
- source code).
- </ti>
+ <ti>/dev/sda4</ti>
+ <ti>ext3</ti>
+ <ti>at least 2 GB</ti>
+ <ti>/usr</ti>
+ <ti>
+ /usr partition. Applications are installed here. By default this partition
+ is also used for Portage data (which takes around 500 MB excluding
+ source code).
+ </ti>
</tr>
<tr>
- <ti>/dev/sda5</ti>
- <ti>ext3</ti>
- <ti>at least 1GByte</ti>
- <ti>/var</ti>
- <ti>
- /var partition. Used for program-generated data. By default Portage uses
- this partition for temporary space whilst compiling. Certain larger
- applications such as Mozilla and OpenOffice.org can require over 1 GByte
- of temporary space here when building.
- </ti>
+ <ti>/dev/sda5</ti>
+ <ti>ext3</ti>
+ <ti>at least 1 GB</ti>
+ <ti>/var</ti>
+ <ti>
+ /var partition. Used for program-generated data. By default Portage uses
+ this partition for temporary space whilst compiling. Certain larger
+ applications such as Mozilla and OpenOffice.org can require over 1 GB
+ of temporary space here when building.
+ </ti>
</tr>
<tr>
- <ti>/dev/sda6</ti>
- <ti>ext3</ti>
- <ti>remaining space</ti>
- <ti>/home</ti>
- <ti>/home partition. Used for users' home directories.</ti>
+ <ti>/dev/sda6</ti>
+ <ti>ext3</ti>
+ <ti>remaining space</ti>
+ <ti>/home</ti>
+ <ti>/home partition. Used for users' home directories.</ti>
</tr>
</table>
@@ -180,7 +180,7 @@
<p>
Change the partition layout as required. Remember to keep the root partition
-entirely within the first 2 GBytes of the disk for older systems. There is also
+entirely within the first 2 GB of the disk for older systems. There is also
a 15-partition limit for SCSI and SATA.
</p>
@@ -228,11 +228,11 @@
<p>
Note the <c>Sun disk label</c> in the output. If this is missing, the disk is
using the DOS-partitioning, not the Sun partitioning. In this case, use
<c>s</c>
-to ensure that the disk has a sun partition table:
+to ensure that the disk has a Sun partition table:
</p>
<pre caption="Creating a Sun Disklabel">
-Command (m for help): s
+Command (m for help): <i>s</i>
Building a new sun disklabel. Changes will remain in memory only,
until you decide to write them. After that, of course, the previous
content won't be recoverable.
@@ -332,8 +332,8 @@
We're ready to create the root partition. To do this, type <c>n</c> to create a
new partition, then type <c>1</c> to create the partition. When prompted for
the first cylinder, hit enter. When prompted for the last cylinder, type
-<c>+512M</c> to create a partition <c>512MBytes</c> in size. Make sure that the
-entire root partition fits within the first 2GBytes of the disk. You can see
+<c>+512M</c> to create a partition <c>512 MB</c> in size. Make sure that the
+entire root partition fits within the first 2 GB of the disk. You can see
output from these steps below:
</p>
@@ -369,7 +369,7 @@
Next, let's create the swap partition. To do this, type <c>n</c> to create a
new
partition, then <c>2</c> to create the second partition, <path>/dev/sda2</path>
in our case. When prompted for the first cylinder, hit enter. When prompted
for
-the last cylinder, type <c>+512M</c> to create a partition 512MB in size.
After
+the last cylinder, type <c>+512M</c> to create a partition 512 MB in size.
After
you've done this, type <c>t</c> to set the partition type, and then type in
<c>82</c> to set the partition type to "Linux Swap". After completing these
steps, typing <c>p</c> should display a partition table that looks similar to
@@ -399,7 +399,7 @@
type <c>n</c> to create a new partition, then type <c>4</c> to create the
third partition, <path>/dev/sda4</path> in our case. When prompted for the
first cylinder, hit enter. When prompted for the last cylinder, enter
-<c>+2048M</c> to create a partition 2 GBytes in size. Repeat this process
+<c>+2048M</c> to create a partition 2 GB in size. Repeat this process
for <path>sda5</path> and <path>sda6</path>, using the desired sizes. Once
you're done, you should see something like this:
</p>
1.39 xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?rev=1.39&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?rev=1.39&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?r1=1.38&r2=1.39
Index: hb-install-sparc-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- hb-install-sparc-kernel.xml 29 Dec 2009 18:56:22 -0000 1.38
+++ hb-install-sparc-kernel.xml 20 Jul 2010 08:29:37 -0000 1.39
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
1.38 2009/12/29 18:56:22 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
1.39 2010/07/20 08:29:37 nightmorph Exp $ -->
<sections>
-<version>9.4</version>
-<date>2009-12-29</date>
+<version>10.0</version>
+<date>2010-07-20</date>
<section>
<title>Timezone</title>
@@ -47,12 +47,12 @@
</p>
<p>
-For sparc-based systems we have <c>gentoo-sources</c> (recommended 2.6 kernel
-sources).
+For <keyval id="arch"/>-based systems we have <c>gentoo-sources</c>
+(kernel source patched for extra features).
</p>
<p>
-In the next example we install <c>gentoo-sources</c>.
+Choose your kernel source and install it using <c>emerge</c>.
</p>
<pre caption="Installing a kernel source">
@@ -215,7 +215,7 @@
</p>
<p>
-If you're using a qla2xxx disk controller, you'll need to be a 2.6.27 kernel or
+If you're using a qla2xxx disk controller, you'll need to use a 2.6.27 kernel
or
newer, and you'll also need to emerge <c>sys-block/qla-fc-firmware</c>. Next,
run <c>make menuconfig</c> and navigate to the Device Drivers section. You'll
need to add support for loading external firmware.
1.50 xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml?rev=1.50&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml?rev=1.50&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml?r1=1.49&r2=1.50
Index: hb-install-sparc-medium.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v
retrieving revision 1.49
retrieving revision 1.50
diff -u -r1.49 -r1.50
--- hb-install-sparc-medium.xml 3 Mar 2010 01:40:45 -0000 1.49
+++ hb-install-sparc-medium.xml 20 Jul 2010 08:29:37 -0000 1.50
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v
1.49 2010/03/03 01:40:45 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v
1.50 2010/07/20 08:29:37 nightmorph Exp $ -->
<sections>
-<version>9.3</version>
-<date>2010-03-02</date>
+<version>10.0</version>
+<date>2010-07-20</date>
<section>
<title>Hardware Requirements</title>
@@ -77,18 +77,16 @@
<p>
All Installation CDs allow you to boot, set up networking, initialize your
-partitions and start installing Gentoo from the Internet. We currently provide
-two Installation CDs which are equally suitable to install Gentoo from, as
long
-as you're planning on performing an Internet-based installation using the
latest
-version of the available packages.
+partitions and start installing Gentoo from the Internet.
</p>
-
-<p>
+<!--
+<impo>
If you wish to install Gentoo without a working Internet connection, please use
the installation instructions described in the <uri
link="2008.0/index.xml">Gentoo 2008.0 Handbooks</uri>.
-</p>
-
+</impo>
+-->
+<!--
<p>
The two Installation CDs that we currently provide are:
</p>
@@ -110,19 +108,20 @@
To help you decide which Installation CD you need, we have written down the
major advantages and disadvantages of each Installation CD.
</p>
-
+-->
</body>
</subsection>
<subsection>
-<title>Gentoo's Minimal Installation CD</title>
+<title>Gentoo Minimal Installation CD</title>
<body>
<p>
-The Minimal Installation CD is called
<c>install-sparc64-minimal-2008.0.iso</c>
-and takes up only 44 MB of diskspace. You can use this Installation CD to
-install Gentoo, but always with a working Internet connection only.
+The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
+takes up only <keyval id="min-cd-size"/> MB of diskspace. You can use this
+Installation CD to install Gentoo, but <e>only</e> with a working Internet
+connection.
</p>
-
+<!--
<table>
<tr>
<th>Minimal Installation CD</th>
@@ -171,7 +170,8 @@
<ti>Huge download</ti>
</tr>
</table>
-
+-->
+<!--
</body>
</subsection>
<subsection>
@@ -191,7 +191,7 @@
If you intend to use the Packages CD to quickly install additional software,
make sure that you use the same subarchitecture as the stage3 tarball you use.
</p>
-
+-->
</body>
</subsection>
<subsection>
@@ -209,6 +209,13 @@
Using a Stage1 or Stage2 Tarball?</uri>
</p>
+<p>
+Stage3 tarballs can be downloaded from <path><keyval
+id="release-dir"/>current-stage3/</path> on any of the <uri
+link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
+on the LiveCD.
+</p>
+
</body>
</subsection>
<subsection>
@@ -244,10 +251,9 @@
</p>
<p>
-You can download any of the Installation CDs (and, if you want to, a Packages
CD
-as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
-Installation CDs are located in the <path><keyval
-id="release-dir"/>installcd</path> directory.
+You can download any of the Installation CDs from one of our <uri
+link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
+the <path><keyval id="release-dir"/>current-iso/</path> directory.
</p>
<p>
@@ -256,9 +262,9 @@
</p>
<p>
-In case you wonder if your downloaded file is corrupted or not, you can check
its
-MD5 checksum and compare it with the MD5 checksum we provide (such as
-<path>install-sparc64-minimal-2008.0.iso.DIGESTS</path>). You can check the
MD5
+In case you wonder if your downloaded file is corrupted or not, you can check
+its MD5 checksum and compare it with the MD5 checksum we provide (such as
+<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
link="http://www.etree.org/md5com.html";>md5sum</uri> for Windows.
</p>
@@ -270,15 +276,18 @@
</p>
<pre caption="Obtaining the public key">
-$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
+$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 2D182910</i>
</pre>
<p>
Now verify the signature:
</p>
-<pre caption="Verify the cryptographic signature">
-$ <i>gpg --verify <signature file> <downloaded iso></i>
+<pre caption="Verify the files">
+<comment>(Verify the cryptographic signature)</comment>
+$ <i>gpg --verify <downloaded iso.DIGESTS.asc></i>
+<comment>(Verify the checksum)</comment>
+$ <i>sha1sum -c <downloaded iso.DIGESTS.asc></i>
</pre>
<p>
