* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-07-28 14:33 Sven Vermeulen
0 siblings, 0 replies; 25+ messages in thread
From: Sven Vermeulen @ 2005-07-28 14:33 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/07/28 14:33:44
Modified: xml/htdocs/doc/en/handbook/draft/2005.1 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-ppc64.xml
handbook-sparc.xml handbook-x86.xml
Log:
#100253 - Comment out agriffis
Revision Changes Path
1.3 +5 -4 xml/htdocs/doc/en/handbook/draft/2005.1/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-alpha.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-alpha.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-alpha.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-alpha.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-alpha.xml 5 Jul 2005 08:47:53 -0000 1.2
+++ handbook-alpha.xml 28 Jul 2005 14:33:44 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-alpha.xml,v 1.2 2005/07/05 08:47:53 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-alpha.xml,v 1.3 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2005.1 Alpha Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.3 +5 -4 xml/htdocs/doc/en/handbook/draft/2005.1/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-amd64.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-amd64.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-amd64.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-amd64.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-amd64.xml 5 Jul 2005 08:47:53 -0000 1.2
+++ handbook-amd64.xml 28 Jul 2005 14:33:44 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-amd64.xml,v 1.2 2005/07/05 08:47:53 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-amd64.xml,v 1.3 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2005.1 AMD64 Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.6 +5 -4 xml/htdocs/doc/en/handbook/draft/2005.1/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-hppa.xml?rev=1.6&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-hppa.xml?rev=1.6&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-hppa.xml.diff?r1=1.5&r2=1.6&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-hppa.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- handbook-hppa.xml 5 Jul 2005 09:42:24 -0000 1.5
+++ handbook-hppa.xml 28 Jul 2005 14:33:44 -0000 1.6
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-hppa.xml,v 1.5 2005/07/05 09:42:24 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-hppa.xml,v 1.6 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2005.1 HPPA Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.3 +5 -4 xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-ppc.xml 5 Jul 2005 08:47:53 -0000 1.2
+++ handbook-ppc.xml 28 Jul 2005 14:33:44 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc.xml,v 1.2 2005/07/05 08:47:53 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc.xml,v 1.3 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2005.1 PPC Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.4 +5 -4 xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc64.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc64.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc64.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc64.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-ppc64.xml 5 Jul 2005 09:42:24 -0000 1.3
+++ handbook-ppc64.xml 28 Jul 2005 14:33:44 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc64.xml,v 1.3 2005/07/05 09:42:24 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-ppc64.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux 2005.1 PPC64 Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.3 +5 -4 xml/htdocs/doc/en/handbook/draft/2005.1/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-sparc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-sparc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-sparc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-sparc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-sparc.xml 5 Jul 2005 08:47:53 -0000 1.2
+++ handbook-sparc.xml 28 Jul 2005 14:33:44 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-sparc.xml,v 1.2 2005/07/05 08:47:53 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-sparc.xml,v 1.3 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2005.1 SPARC Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.3 +5 -4 xml/htdocs/doc/en/handbook/draft/2005.1/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-x86.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-x86.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-x86.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-x86.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-x86.xml 5 Jul 2005 08:47:53 -0000 1.2
+++ handbook-x86.xml 28 Jul 2005 14:33:44 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-x86.xml,v 1.2 2005/07/05 08:47:53 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/handbook-x86.xml,v 1.3 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2005.1 x86 Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-07-28 14:33 Sven Vermeulen
0 siblings, 0 replies; 25+ messages in thread
From: Sven Vermeulen @ 2005-07-28 14:33 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/07/28 14:33:44
Modified: xml/htdocs/doc/en/handbook/2004.2 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-mips.xml handbook-ppc.xml
handbook-sparc.xml handbook-x86.xml
Log:
#100253 - Comment out agriffis
Revision Changes Path
1.2 +5 -4 xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-alpha.xml 15 Nov 2004 12:43:54 -0000 1.1
+++ handbook-alpha.xml 28 Jul 2005 14:33:44 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml,v 1.1 2004/11/15 12:43:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux/Alpha Handbook</title>
@@ -23,10 +23,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.2 +5 -4 xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-amd64.xml 15 Nov 2004 12:43:54 -0000 1.1
+++ handbook-amd64.xml 28 Jul 2005 14:33:44 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml,v 1.1 2004/11/15 12:43:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux/AMD64 Handbook</title>
@@ -23,10 +23,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.2 +5 -4 xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-hppa.xml 15 Nov 2004 12:43:54 -0000 1.1
+++ handbook-hppa.xml 28 Jul 2005 14:33:44 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml,v 1.1 2004/11/15 12:43:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux/HPPA Handbook</title>
@@ -23,10 +23,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.2 +5 -4 xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-mips.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-mips.xml 15 Nov 2004 12:43:54 -0000 1.1
+++ handbook-mips.xml 28 Jul 2005 14:33:44 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml,v 1.1 2004/11/15 12:43:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-mips.xml">
<title>Gentoo Linux/MIPS Handbook</title>
@@ -23,10 +23,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.2 +5 -4 xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-ppc.xml 15 Nov 2004 12:43:54 -0000 1.1
+++ handbook-ppc.xml 28 Jul 2005 14:33:44 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml,v 1.1 2004/11/15 12:43:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux/PPC Handbook</title>
@@ -23,10 +23,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.2 +5 -4 xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-sparc.xml 15 Nov 2004 12:43:54 -0000 1.1
+++ handbook-sparc.xml 28 Jul 2005 14:33:44 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml,v 1.1 2004/11/15 12:43:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux/SPARC Handbook</title>
@@ -23,10 +23,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.2 +5 -4 xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-x86.xml 15 Nov 2004 12:43:54 -0000 1.1
+++ handbook-x86.xml 28 Jul 2005 14:33:44 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml,v 1.1 2004/11/15 12:43:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux/x86 Handbook</title>
@@ -23,10 +23,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-07-28 14:33 Sven Vermeulen
0 siblings, 0 replies; 25+ messages in thread
From: Sven Vermeulen @ 2005-07-28 14:33 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/07/28 14:33:44
Modified: xml/htdocs/doc/en/handbook handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-mips.xml handbook-ppc.xml
handbook-ppc64.xml handbook-sparc.xml
handbook-x86.xml
Log:
#100253 - Comment out agriffis
Revision Changes Path
1.116 +5 -4 xml/htdocs/doc/en/handbook/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.116&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.116&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml.diff?r1=1.115&r2=1.116&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v
retrieving revision 1.115
retrieving revision 1.116
diff -u -r1.115 -r1.116
--- handbook-alpha.xml 9 Jun 2005 07:33:58 -0000 1.115
+++ handbook-alpha.xml 28 Jul 2005 14:33:43 -0000 1.116
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.115 2005/06/09 07:33:58 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.116 2005/07/28 14:33:43 swift Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux Alpha Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.124 +5 -4 xml/htdocs/doc/en/handbook/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.124&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.124&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml.diff?r1=1.123&r2=1.124&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v
retrieving revision 1.123
retrieving revision 1.124
diff -u -r1.123 -r1.124
--- handbook-amd64.xml 9 Jun 2005 07:33:58 -0000 1.123
+++ handbook-amd64.xml 28 Jul 2005 14:33:43 -0000 1.124
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.123 2005/06/09 07:33:58 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.124 2005/07/28 14:33:43 swift Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux AMD64 Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.113 +5 -4 xml/htdocs/doc/en/handbook/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.113&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.113&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml.diff?r1=1.112&r2=1.113&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v
retrieving revision 1.112
retrieving revision 1.113
diff -u -r1.112 -r1.113
--- handbook-hppa.xml 9 Jun 2005 07:33:59 -0000 1.112
+++ handbook-hppa.xml 28 Jul 2005 14:33:43 -0000 1.113
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.112 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.113 2005/07/28 14:33:43 swift Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux HPPA Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.103 +5 -4 xml/htdocs/doc/en/handbook/handbook-mips.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.103&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.103&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml.diff?r1=1.102&r2=1.103&cvsroot=gentoo
Index: handbook-mips.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v
retrieving revision 1.102
retrieving revision 1.103
diff -u -r1.102 -r1.103
--- handbook-mips.xml 9 Jun 2005 07:33:59 -0000 1.102
+++ handbook-mips.xml 28 Jul 2005 14:33:43 -0000 1.103
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.102 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.103 2005/07/28 14:33:43 swift Exp $ -->
<book link="handbook-mips.xml">
<title>Gentoo Linux/MIPS Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.133 +5 -4 xml/htdocs/doc/en/handbook/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.133&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.133&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml.diff?r1=1.132&r2=1.133&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v
retrieving revision 1.132
retrieving revision 1.133
diff -u -r1.132 -r1.133
--- handbook-ppc.xml 9 Jun 2005 07:33:59 -0000 1.132
+++ handbook-ppc.xml 28 Jul 2005 14:33:43 -0000 1.133
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.132 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.133 2005/07/28 14:33:43 swift Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux PPC Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.55 +5 -4 xml/htdocs/doc/en/handbook/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.55&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.55&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml.diff?r1=1.54&r2=1.55&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v
retrieving revision 1.54
retrieving revision 1.55
diff -u -r1.54 -r1.55
--- handbook-ppc64.xml 9 Jun 2005 07:33:59 -0000 1.54
+++ handbook-ppc64.xml 28 Jul 2005 14:33:43 -0000 1.55
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.54 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.55 2005/07/28 14:33:43 swift Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux PPC64 Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.116 +5 -4 xml/htdocs/doc/en/handbook/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.116&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.116&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml.diff?r1=1.115&r2=1.116&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v
retrieving revision 1.115
retrieving revision 1.116
diff -u -r1.115 -r1.116
--- handbook-sparc.xml 9 Jun 2005 07:33:59 -0000 1.115
+++ handbook-sparc.xml 28 Jul 2005 14:33:43 -0000 1.116
@@ -1,7 +1,7 @@
<?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.115 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v 1.116 2005/07/28 14:33:43 swift Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux SPARC Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.143 +5 -4 xml/htdocs/doc/en/handbook/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.143&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.143&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml.diff?r1=1.142&r2=1.143&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v
retrieving revision 1.142
retrieving revision 1.143
diff -u -r1.142 -r1.143
--- handbook-x86.xml 9 Jun 2005 07:33:59 -0000 1.142
+++ handbook-x86.xml 28 Jul 2005 14:33:43 -0000 1.143
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.142 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.143 2005/07/28 14:33:43 swift Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux x86 Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-07-28 14:33 Sven Vermeulen
0 siblings, 0 replies; 25+ messages in thread
From: Sven Vermeulen @ 2005-07-28 14:33 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/07/28 14:33:44
Modified: xml/htdocs/doc/en/handbook/2005.0 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-sparc.xml
handbook-x86.xml
Log:
#100253 - Comment out agriffis
Revision Changes Path
1.4 +5 -4 xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-alpha.xml 9 Jun 2005 07:33:59 -0000 1.3
+++ handbook-alpha.xml 28 Jul 2005 14:33:44 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml,v 1.3 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2005.0 Alpha Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.4 +5 -4 xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-amd64.xml 9 Jun 2005 07:33:59 -0000 1.3
+++ handbook-amd64.xml 28 Jul 2005 14:33:44 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml,v 1.3 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2005.0 AMD64 Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.4 +5 -4 xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-hppa.xml 9 Jun 2005 07:33:59 -0000 1.3
+++ handbook-hppa.xml 28 Jul 2005 14:33:44 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml,v 1.3 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2005.0 HPPA Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.4 +5 -4 xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-ppc.xml 9 Jun 2005 07:33:59 -0000 1.3
+++ handbook-ppc.xml 28 Jul 2005 14:33:44 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml,v 1.3 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2005.0 PPC Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.4 +5 -4 xml/htdocs/doc/en/handbook/2005.0/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-sparc.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-sparc.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-sparc.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-sparc.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-sparc.xml 9 Jun 2005 07:33:59 -0000 1.3
+++ handbook-sparc.xml 28 Jul 2005 14:33:44 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-sparc.xml,v 1.3 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-sparc.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2005.0 SPARC Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
1.4 +5 -4 xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-x86.xml 9 Jun 2005 07:33:59 -0000 1.3
+++ handbook-x86.xml 28 Jul 2005 14:33:44 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml,v 1.3 2005/06/09 07:33:59 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2005.0 x86 Handbook</title>
@@ -26,10 +26,11 @@
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
+</author><!-- Does not want to be listed on the rendered page
+<author title="Gentoo Developer">
+ Aron Griffis
</author>
-<author title="Gentoo Alpha Developer">
- <mail link="agriffis@gentoo.org">Aron Griffis</mail>
-</author>
+-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-08-08 13:16 swift
0 siblings, 0 replies; 25+ messages in thread
From: swift @ 2005-08-08 13:16 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/08/08 13:16:10
Added: xml/htdocs/doc/en/handbook/2005.1 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-sparc.xml
handbook-x86.xml hb-install-about.xml
hb-install-alpha-bootloader.xml
hb-install-alpha-disk.xml
hb-install-alpha-kernel.xml
hb-install-alpha-medium.xml
hb-install-amd64-bootloader.xml
hb-install-amd64-disk.xml
hb-install-amd64-kernel.xml
hb-install-amd64-medium.xml hb-install-config.xml
hb-install-finalise.xml
hb-install-hppa-bootloader.xml
hb-install-hppa-disk.xml hb-install-hppa-kernel.xml
hb-install-hppa-medium.xml hb-install-network.xml
hb-install-next.xml hb-install-ppc-bootloader.xml
hb-install-ppc-disk.xml hb-install-ppc-kernel.xml
hb-install-ppc-medium.xml
hb-install-sparc-bootloader.xml
hb-install-sparc-disk.xml
hb-install-sparc-kernel.xml
hb-install-sparc-medium.xml hb-install-stage.xml
hb-install-system.xml hb-install-tools.xml
hb-install-x86-bootloader.xml
hb-install-x86-disk.xml hb-install-x86-kernel.xml
hb-install-x86-medium.xml index.xml
Log:
Adding 2005.0 (yes, .0) as a plain copy (makes it easier for translators to update
Revision Changes Path
1.1 xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v 1.1 2005/08/08 13:16:09 swift Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2005.0 Alpha Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
information.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
<version>4.1</version>
<date>2005-06-09</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-alpha-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-alpha-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-alpha-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
1.1 xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v 1.1 2005/08/08 13:16:09 swift Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2005.0 AMD64 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
information.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
<version>4.1</version>
<date>2005-06-09</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-amd64-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-amd64-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-amd64-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
1.1 xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2005.0 HPPA Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
information.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
<version>4.1</version>
<date>2005-06-09</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-hppa-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-hppa-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
Gentoo installs work through so-called stage-files. In this chapter we
describe how you extract a stage-file and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-hppa-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
1.1 xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2005.0 PPC Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<author title="Editor">
<mail link="sejo@gentoo.org">Jochen Maes </mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
information.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
<version>4.1</version>
<date>2005-06-09</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-ppc-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-ppc-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-ppc-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
1.1 xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2005.0 SPARC Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
information.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
<version>4.1</version>
<date>2005-06-09</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-sparc-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-sparc-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-sparc-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
1.1 xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2005.0 x86 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
information.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
<version>4.1</version>
<date>2005-06-09</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-x86-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-x86-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and
how to configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and
modify the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-x86-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-about.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.1</version>
<date>2005-03-28</date>
<section>
<title>Introduction</title>
<subsection>
<title>Welcome!</title>
<body>
<p>
First of all, <e>welcome</e> to Gentoo. You are about to enter the world
of choices and performance. Gentoo is all about choices. When
installing Gentoo, this is made clear to you several times -- you can
choose how much you want to compile yourself, how to install Gentoo,
what system logger you want, etc.
</p>
<p>
Gentoo is a fast, modern metadistribution with a clean and flexible
design. Gentoo is built around free software and doesn't hide from its
users what is beneath the hood. Portage, the package maintenance system
which Gentoo uses, is written in Python, meaning you can easily view and
modify the source code. Gentoo's packaging system uses source code
(although support for precompiled packages is included too) and
configuring Gentoo happens through regular textfiles. In other words,
openness everywhere.
</p>
<p>
It is very important that you understand that <e>choices</e> are what
makes Gentoo run. We try not to force you onto anything you don't like.
If you feel like we do, please <uri
link="http://bugs.gentoo.org">bugreport</uri> it.
</p>
</body>
</subsection>
<subsection>
<title>How is the Installation Structured?</title>
<body>
<p>
The Gentoo Installation can be seen as a 10-step procedure,
corresponding to chapters 2 - 11. Every step results in
a certain state:
</p>
<ul>
<li>
After step 1, you are in a working environment ready to install Gentoo
</li>
<li>
After step 2, your internet connection is prepared in case you need it (this
is however optional)
</li>
<li>
After step 3, your hard disks are initialized to house your Gentoo
installation
</li>
<li>
After step 4, your installation environment is prepared and you are
ready to chroot into the new environment
</li>
<li>
After step 5, core packages, which are the same on all Gentoo
installations, are installed
</li>
<li>
After step 6, you have compiled your Linux kernel
</li>
<li>
After step 7, you have written most of your Gentoo system
configuration files
</li>
<li>
After step 8, necessary system tools (which you can choose from a nice
list) are installed
</li>
<li>
After step 9, your choice of bootloader has been installed and
configured and you are logged in into your new Gentoo installation
</li>
<li>
After step 10, your Gentoo Linux environment is ready to be explored
</li>
</ul>
<p>
When you are given a certain choice, we try our best to explain what the pros
and cons are. We will continue then with a default
choice, identified by "Default: " in the title. The other
possibilities are marked by "Alternative: ". Do <e>not</e>
think that the default is what we recommend. It is however what we
believe most users will use.
</p>
<p>
Sometimes you can pursue an optional step. Such steps are marked as
"Optional: " and are therefore not needed to install Gentoo.
However, some optional steps are dependant on a previous decision you
made. We will inform you when this happens, both when you make the
decision, and right before the optional step is described.
</p>
</body>
</subsection>
<subsection>
<title>What are my Options?</title>
<body>
<p>
You can install Gentoo in many different ways. You can download and install from
one of our Installation CDs, from an existing distribution,
from a bootable CD (such as Knoppix), from a netbooted environment, from a
rescue floppy, etc.
</p>
<p>
This document covers the installation using the Universal Installation CD, a
bootable CD that contains everything you need to get Gentoo Linux up and
running. You can optionally use one of our Package CDs as well to install a
complete system in a matter of minutes after having installed the Gentoo base
system.
</p>
<p>
This installation approach however does not immediately use the latest version
of the available packages; if you want this you should check out the
Installation Instructions inside our <uri
link="/doc/en/handbook/index.xml">Gentoo Linux Handbooks</uri>.
</p>
<p>
For help on the other installation approaches,
please read our <uri link="/doc/en/altinstall.xml">Alternative Installation
Guide</uri>. We also provide a <uri
link="/doc/en/gentoo-x86-tipsntricks.xml">Gentoo Installation Tips &
Tricks</uri> document that might be useful to read as well. If you feel that
the current installation instructions are too elaborate, feel free to use our
Quick Installation Guide available from our <uri
link="/doc/en/index.xml">Documentation Resources</uri> if your architecture
has such a document available.
</p>
</body>
</subsection>
<subsection>
<title>Troubles?</title>
<body>
<p>
If you find a problem in the installation (or in the installation
documentation), please check the errata from our <uri
link="/proj/en/releng/">Gentoo Release Engineering Project</uri>,
visit our <uri link="http://bugs.gentoo.org">bugtracking
system</uri> and check if the bug is known. If not, please create a bugreport
for it so we can take care of it. Do not be afraid of the developers who are
assigned to (your) bugs -- they generally don't eat people.
</p>
<p>
Note though that, although the document you are now reading is
architecture-specific, it will contain references to other architectures as
well. This is due to the fact that large parts of the Gentoo Handbook use source
code that is common for all architectures (to avoid duplication of efforts and
starvation of development resources). We will try to keep this to a minimum
to avoid confusion.
</p>
<p>
If you are uncertain if the problem is a user-problem (some error you
made despite having read the documentation carefully) or a
software-problem (some error we made despite having tested the
installation/documentation carefully) you are free to join #gentoo on
irc.freenode.net. Of course, you are welcome otherwise too :)
</p>
<p>
If you have a question regarding Gentoo, check out our <uri
link="/doc/en/faq.xml">Frequently Asked
Questions</uri>, available from the <uri
link="/doc/en/">Gentoo Documentation</uri>. You can
also view the <uri
link="http://forums.gentoo.org/viewforum.php?f=40">FAQs</uri> on our
<uri link="http://forums.gentoo.org">forums</uri>. If you can't find the answer
there ask on #gentoo, our IRC-channel on irc.freenode.net. Yes, several of
us are freaks who sit on IRC :-)
</p>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.1</version>
<date>2005-03-29</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
<p>
Several bootloaders exist for Linux/Alpha. You must choose one of the supported
bootloaders, not all. You have the choice between <uri link="#aboot">aBoot</uri>
and <uri link="#milo">MILO</uri>.
</p>
</body>
</subsection>
</section>
<section id="aboot">
<title>Default: Using aboot</title>
<body>
<p>
We first install aboot on our system. Of course we use <c>emerge</c> to
do so:
</p>
<pre caption = "Installing aboot">
# <i>emerge --usepkg aboot</i>
</pre>
<p>
The next step is to make our bootdisk bootable. This will start
<c>aboot</c> when you boot your system. We make our bootdisk bootable by
writing the <c>aboot</c> bootloader to the start of the disk.
</p>
<pre caption = "Making your bootdisk bootable">
# <i>swriteboot -f3 /dev/sda /boot/bootlx</i>
# <i>abootconf /dev/sda 2</i>
</pre>
<note>
If you use a different partitioning scheme than the one we use
throughout this chapter, you have to change the commands accordingly.
Please read the appropriate manual pages (<c>man 8 swriteboot</c> and
<c>man 8 abootconf</c>). Also, if your root filesystem uses the JFS filesystem,
make sure to pass the <c>ro</c> kernel option so that it can replay its log
before it gets mounted read-write.
</note>
<p>
Additionally, you can make Gentoo boot automatically by setting up the
aboot configuration file and some SRM variables. You can try setting
these variables from Linux, but it may be easier to do so from the SRM
console itself.
</p>
<pre caption = "Automatically booting Gentoo">
# <i>echo '0:2/boot/vmlinux.gz root=/dev/sda2' > /etc/aboot.conf</i>
# <i>cd /proc/srm_environment/named_variables</i>
# <i>echo -n 0 > boot_osflags</i>
# <i>echo -n '' > boot_file</i>
# <i>echo -n 'BOOT' > auto_action</i>
# <i>echo -n 'dkc100' > bootdef_dev</i>
<comment>(Substitute dkc100 with whatever your boot device is)</comment>
</pre>
<p>
If you need to get into the SRM console again in the future (to recover
your Gentoo install, play with some variables, or whatever), just hit
CTRL+C to abort the automatic loading process.
</p>
<p>
If you're installing using a serial console, don't forget to include
the serial console boot flag in <path>aboot.conf</path>. See
<path>/etc/aboot.conf.example</path> for some further information.
</p>
<p>
Aboot is now configured and ready to use. Continue with <uri
link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="milo">
<title>Alternative: Using MILO</title>
<body>
<p>
Before continuing, you should decide on how to use MILO. In this
section, we will assume that you want to make a MILO boot floppy. If you
are going to boot from an MS-DOS partition on your hard disk, you should
amend the commands appropriately.
</p>
<p>
To install MILO, we use <c>emerge</c>.
</p>
<pre caption = "Installing MILO">
# <i>emerge --usepkg milo</i>
</pre>
<p>
After MILO has been installed, the MILO images should be in
<path>/opt/milo</path>. The commands below make a bootfloppy for use
with MILO. Remember to use the correct image for your Alpha-system.
</p>
<pre caption = "Installing MILO on a floppy">
<comment>(First insert a blank floppy)</comment>
# <i>fdformat /dev/fd0</i>
# <i>mformat a:</i>
# <i>mcopy /opt/milo/milo-2.2-18-gentoo-ruffian a:\milo</i>
# <i>mcopy /opt/milo/linload.exe a:\lilnload.exe</i>
<comment>(Only if you have a Ruffian:</comment>
# <i>mcopy /opt/milo/ldmilo.exe a:\ldmilo.exe</i>
<comment>)</comment>
# <i>echo -ne '\125\252' | dd of=/dev/fd0 bs=1 seek=510 count=2</i>
</pre>
<p>
Your MILO boot floppy is now ready to boot Gentoo Linux. You may need to
set environment variables in your ARCS Firmware to get MILO to start;
this is all explained in the <uri
link="http://tldp.org/HOWTO/MILO-HOWTO/">MILO-HOWTO</uri> with some examples
on common systems, and examples of the commands to use in interactive mode.
</p>
<p>
Not reading the <uri link="http://tldp.org/HOWTO/MILO-HOWTO/">MILO-HOWTO</uri>
is a <e>bad</e> idea.
</p>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2005.1/hb-install-alpha-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-08-02</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first SCSI HD in a Linux system, namely
<path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On Alpha systems,
these are called <e>slices</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
As an example we use the following slice layout:
</p>
<table>
<tr>
<th>Slice</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Swap slice</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Root slice</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Full disk (required)</ti>
</tr>
</table>
<p>
If you are interested in knowing how big a partition should be, or even how
many partitions (or volumes) you need, read on. Otherwise continue now with
<uri link="#fdisk_SRM">Using fdisk to Partition your Disk (SRM only)</uri>
or <uri link="#fdisk_ARC">Using fdisk to Partition your Disk (ARC/AlphaBIOS
only)</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another.
</p>
</body>
</subsection>
</section>
<section id="fdisk_SRM">
<title>Using fdisk to Partition your Disk (SRM only)</title>
<subsection>
<body>
<p>
The following parts explain how to create the example slice layout described
previously, namely:
</p>
<table>
<tr>
<th>Slice</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Swap slice</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Root slice</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Full disk (required)</ti>
</tr>
</table>
<p>
Change your slice layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Identifying Available Disks</title>
<body>
<p>
To figure out what disks you have running, use the following commands:
</p>
<pre caption="Identifying available disks">
# <i>dmesg | grep 'drive$'</i> <comment>(For IDE disks)</comment>
# <i>dmesg | grep 'scsi'</i> <comment>(For SCSI disks)</comment>
</pre>
<p>
>From this output you should be able to see what disks were detected and their
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.6</version>
<date>2005-07-04</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then make a
symlink to <path>/etc/localtime</path> using <c>ln</c>:
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For alpha-based systems we have <c>vanilla-sources</c> (the default 2.6 kernel source).
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>.
</p>
<p>
In the next example we install the <c>vanilla-sources</c>.
Of course substitute with your choice of sources, this is merely an example:
</p>
<pre caption="Installing a kernel source">
# <i>emerge vanilla-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source:
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.11.2
</pre>
<p>
If this isn't the case (i.e. the symlink points to a different kernel source)
change the symlink before you continue:
</p>
<pre caption="Changing the kernel source symlink">
# <i>rm /usr/src/linux</i>
# <i>cd /usr/src</i>
# <i>ln -s linux-2.6.11.2 linux</i>
</pre>
<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as it is
the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. You can run <c>lsmod</c> to see what kernel
modules the Installation CD uses (it might provide you with a nice hint on
what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc
file system</c>, (<c>/dev file system</c> + <c>Automatically mount at boot</c> only for 2.4 kernel):
</p>
<pre caption="Selecting necessary file systems">
<comment>(With a 2.4.x kernel)</comment>
File systems --->
[*] Virtual memory file system support (former shm fs)
[*] /proc file system support
[*] /dev file system support (EXPERIMENTAL)
[*] Automatically mount at boot
[ ] /dev/pts file system for Unix98 PTYs
<comment>(With a 2.6.x kernel)</comment>
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
[ ] /dev file system support (OBSOLETE)
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
<comment>(With a 2.4.x kernel)</comment>
Network device support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
<comment>(With a 2.6.x kernel)</comment>
Device Drivers --->
Networking support --->
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.3</version>
<date>2005-08-01</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>
Please check with the <uri
link="http://www.alphalinux.org/faq/FAQ-5.html">Alpha/Linux FAQ</uri>
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- Copy/paste from the hb-install-x86-medium.xml file but no Universal
Installation CD.
Also s/x86/alpha -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
A stage file is a tarball (compressed archive) that contains a minimal
environment.
</p>
<ul>
<li>
A stage1 file contains nothing more than a compiler, Portage (Gentoo's
software management system) and a couple of packages on which the compiler
or Portage depends.
</li>
<li>
A stage2 file contains a so-called bootstrapped system, a minimal
environment from which one can start building all other necessary
applications that make a Gentoo environment complete.
</li>
<li>
A stage3 file contains a prebuilt minimal system which is almost fully
deployable. It only lacks a few applications where you, the Gentoo user,
needs to choose which one you want to install.
</li>
</ul>
<p>
We will opt for a stage3 installation throughout this document. If you want to
perform a Gentoo installation using the stage1 or stage2 files, please use the
installation instructions in the <uri
link="/doc/en/handbook/handbook-alpha.xml">Gentoo Handbook</uri>. They do
require a working Internet connection though.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is no Installation CD but an additional
resource that you can exploit during the installation of your Gentoo system. It
contains prebuilt packages (the so-called GRP set) that allows you to easily
and quickly install additional applications (such as OpenOffice.org, KDE,
GNOME, ...) immediately after the Gentoo installation and right before you
update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
the <path>releases/alpha/2005.0/installcd</path> directory;
the Package CD is located in the <path>releases/alpha/2005.0/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find so-called ISO-files. Those are full CD
images which you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.6</version>
<date>2005-06-10</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Framebuffer</title>
<body>
<!--
Verbatim copy from x86 bootloader framebuffer explanation, minus the section on
vesafb-tng
-->
<p>
<e>If</e> you have configured your kernel with framebuffer support (or you used
<c>genkernel</c>'s default kernel configuration), you can activate it by adding
a <c>vga</c> and/or a <c>video</c> statement to your bootloader configuration
file.
</p>
<p>
64-bit systems must use the the <c>vesafb</c> driver, and so will need to set
the <c>vga</c> statement. The <c>vga</c> statement controls the resolution and
color depth of your framebuffer screen for <c>vesafb</c>. As stated in
<path>/usr/src/linux/Documentation/fb/vesafb.txt</path> (which gets installed
when you install a kernel source package), you need to pass the VESA number
corresponding to the requested resolution and color depth to it.
</p>
<p>
The following table lists the available resolutions and colordepths and matches
those against the value that you need to pass on to the <c>vga</c> statement.
</p>
<table>
<tr>
<ti></ti>
<th>640x480</th>
<th>800x600</th>
<th>1024x768</th>
<th>1280x1024</th>
</tr>
<tr>
<th>256</th>
<ti>0x301</ti>
<ti>0x303</ti>
<ti>0x305</ti>
<ti>0x307</ti>
</tr>
<tr>
<th>32k</th>
<ti>0x310</ti>
<ti>0x313</ti>
<ti>0x316</ti>
<ti>0x319</ti>
</tr>
<tr>
<th>64k</th>
<ti>0x311</ti>
<ti>0x314</ti>
<ti>0x317</ti>
<ti>0x31A</ti>
</tr>
<tr>
<th>16M</th>
<ti>0x312</ti>
<ti>0x315</ti>
<ti>0x318</ti>
<ti>0x31B</ti>
</tr>
</table>
<p>
The <c>video</c> statement controls framebuffer display options. It needs to be
given the framebuffer driver (<c>vesafb</c> for 2.6 kernels, or <c>vesa</c> for
2.4 kernels) followed by the control statements you wish to enable. All
variables are listed in <path>/usr/src/linux/Documentation/fb/vesafb.txt</path>,
but we'll inform you about three most-used options:
</p>
<table>
<tr>
<th>Control</th>
<th>Description</th>
</tr>
<tr>
<ti>ywrap</ti>
<ti>
Assume that the graphical card can wrap around its memory (i.e. continue at
the beginning when it has approached the end)
</ti>
</tr>
<tr>
<ti>mtrr</ti>
<ti>
Setup MTRR registers
</ti>
</tr>
</table>
<p>
The result of those two statements could be something like <c>vga=0x318
video=vesafb:mtrr,ywrap</c> or <c>video=vesafb:mtrr,ywrap,1024x768-32@85</c>.
Remember (or write down) this setting; you will need it shortly.
</p>
<p>
Now continue by installing GRUB.
</p>
</body>
</subsection>
</section>
<section>
<title>Using GRUB</title>
<subsection>
<title>Understanding GRUB's terminology</title>
<body>
<p>
The most critical part of understanding GRUB is getting comfortable with
how GRUB refers to hard drives and partitions. Your Linux partition
<path>/dev/hda1</path> will most likely be called <path>(hd0,0)</path> under
GRUB. Notice the parenthesis around the <path>hd0,0</path> - they are required.
</p>
<p>
Hard drives count from zero rather than "a" and partitions start at zero
rather than one. Be aware too that with the hd devices, only hard drives are
counted, not atapi-ide devices such as cdrom players and burners. Also, the
same construct is used with scsi drives. (Normally they get higher numbers
than ide drives except when the bios is configured to boot from scsi devices.)
When you ask the BIOS to boot from a different hard disk (for instance your
primary slave), <e>that</e> harddisk is seen as <path>hd0</path>.
</p>
<p>
Assuming you have a hard drive on <path>/dev/hda</path>, a cdrom player on
<path>/dev/hdb</path>, a burner on <path>/dev/hdc</path>, a second hard drive
on <path>/dev/hdd</path> and no SCSI hard drive, <path>/dev/hdd7</path> gets
translated to <path>(hd1,6)</path>. It might sound tricky and tricky it is
indeed, but as we will see, GRUB offers a tab completion mechanism
that comes handy for those of you having a lot of hard drives and
partitions and who are a little lost in the GRUB numbering scheme.
</p>
<p>
Having gotten the feel for that, it is time to install GRUB.
</p>
</body>
</subsection>
<subsection>
<title>Installing GRUB</title>
<body>
<p>
To install GRUB, let's first emerge it.
</p>
<pre caption = "Installing GRUB">
# <i>emerge grub</i>
</pre>
<p>
Although GRUB is now installed, we still need to write up a
configuration file for it and install GRUB in the MBR so that GRUB
automatically boots your newly created kernel. Create
<path>/boot/grub/grub.conf</path> with <c>nano</c> (or, if applicable, another
editor):
</p>
<pre caption = "Creating /boot/grub/grub.conf">
# <i>nano -w /boot/grub/grub.conf</i>
</pre>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2005.1/hb-install-amd64-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-08-02</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI drives, then your first hard
drive would be <path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions and Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On amd64 systems,
these are called <e>partitions</e>.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Partitions are divided in three types:
<e>primary</e>, <e>extended</e> and <e>logical</e>.
</p>
<p>
A <e>primary</e> partition is a partition which has its information stored in
the MBR (master boot record). As an MBR is very small (512 bytes) only four
primary partitions can be defined (for instance, <path>/dev/hda1</path> to
<path>/dev/hda4</path>).
</p>
<p>
An <e>extended</e> partition is a special primary partition (meaning the
extended partition must be one of the four possible primary partitions) which
contains more partitions. Such a partition didn't exist originally, but as
four partitions were too few, it was brought to life to extend the formatting
scheme without losing backward compatibility.
</p>
<p>
A <e>logical</e> partition is a partition inside the extended partition. Their
definitions aren't placed inside the MBR, but are declared inside the extended
partition.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>ext2</ti>
<ti>32M</ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>ext3</ti>
<ti>Rest of the disk</ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
If you are interested in knowing how big a partition (or logical
volume) should be, or even how many partitions (or volumes) you need, read on.
Otherwise continue with <uri link="#fdisk">Using fdisk to Partition your
Disk</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
<p>
As an example partitioning, we show you one for a 20GB disk, used as a
demonstration laptop (containing webserver, mailserver, gnome, ...):
</p>
<pre caption="Filesystem usage example">
Filesystem Type Size Used Avail Use% Mounted on
/dev/hda5 ext3 509M 132M 351M 28% /
/dev/hda2 ext3 5.0G 3.0G 1.8G 63% /home
/dev/hda7 ext3 7.9G 6.2G 1.3G 83% /usr
/dev/hda8 ext3 1011M 483M 477M 51% /opt
/dev/hda9 ext3 2.0G 607M 1.3G 32% /var
/dev/hda1 ext2 51M 17M 31M 36% /boot
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.8</version>
<date>2005-07-04</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then make a
symlink to <path>/etc/localtime</path> using <c>ln</c>:
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For AMD64-based systems we have <c>gentoo-sources</c> (kernel v2.6 source
patched with amd64 specific fixes for stability, performance and hardware
support).
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>.
</p>
<note>
Running <c>emerge gentoo-sources</c> will fail due to a bug with the Universal
Installation CD. Please make sure you run <c>emerge
=gentoo-sources-2.6.11-r1</c> instead. This has no further effect on your
environment as Portage will automatically download a more recent kernel source
when updating your system (after the installation).
</note>
<pre caption="Installing a kernel source">
# <i>echo "=sys-kernel/gentoo-sources-2.6.11-r1 ~amd64" >> /etc/portage/package.keywords</i>
# <i>emerge =gentoo-sources-2.6.11-r1</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source:
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.11-gentoo-r1
</pre>
<p>
If this isn't the case (i.e. the symlink points to a different kernel source)
change the symlink before you continue:
</p>
<pre caption="Changing the kernel source symlink">
# <i>rm /usr/src/linux</i>
# <i>cd /usr/src</i>
# <i>ln -s linux-2.6.11-gentoo-r1 linux</i>
</pre>
<p>
Now it is time to configure and compile your kernel source.
You can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
file system</c>. Do <e>not</e> select <c>/dev file system</c> since 2005.0/AMD64
uses <c>udev</c> by default.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
<*> /proc file system support
< > /dev file system support (OBSOLETE)
<*> Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking Support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.21</version>
<date>2005-05-06</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>Any AMD64 CPU *</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<note>
* Intel processors with EM64T extensions <e>might</e> work as well, but are
untested.
</note>
<p>
You should check the <uri link="http://amd64.gentoo.org">Gentoo
AMD64 Project Page</uri> before proceeding.
</p>
</body>
</subsection>
</section>
<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/amd64/) -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
stage file is a tarball (compressed archive) that contains a minimal
environment.
</p>
<ul>
<li>
A stage1 file contains nothing more than a compiler, Portage (Gentoo's
software management system) and a couple of packages on which the
compiler or Portage depends.
</li>
<li>
A stage2 file contains a so-called bootstrapped system, a minimal
environment from which one can start building all other necessary
applications that make a Gentoo environment complete.
</li>
<li>
A stage3 file contains a prebuilt minimal system which is almost fully
deployable. It only lacks a few applications where you, the Gentoo user,
needs to choose which one you want to install.
</li>
</ul>
<p>
We will opt for a stage3 installation throughout this document. If you want to
perform a Gentoo installation using the stage1 or stage2 files, please use the
installation instructions in the <uri
link="/doc/en/handbook/handbook-amd64.xml">Gentoo Handbook</uri>. They do
require a working Internet connection though.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is no Installation CD but an additional
resource that you can exploit during the installation of your Gentoo system. It
contains prebuilt packages (the so-called GRP set) that allows you to easily
and quickly install additional applications (such as OpenOffice.org, KDE,
GNOME, ...) immediately after the Gentoo installation and right before you
update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
the <path>releases/amd64/2005.0/installcd</path> directory;
the Package CD is located in the <path>releases/amd64/2005.0/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find so-called ISO-files. Those are full CD
images which you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-config.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-05-23</date>
<section>
<title>Filesystem Information</title>
<subsection>
<title>What is fstab?</title>
<body>
<p>
Under Linux, all partitions used by the system must be listed in
<path>/etc/fstab</path>. This file contains the mountpoints of those partitions
(where they are seen in the file system structure), how they should be mounted
and with what special options (automatically or not, whether users can mount
them or not, etc.)
</p>
</body>
</subsection>
<subsection>
<title>Creating /etc/fstab</title>
<body>
<p>
<path>/etc/fstab</path> uses a special syntax. Every line consists of six
fields, separated by whitespace (space(s), tabs or a mixture). Each field has
its own meaning:
</p>
<ul>
<li>
The first field shows the <b>partition</b> described (the path to the device
file)
</li>
<li>
The second field shows the <b>mountpoint</b> at which the partition should be
mounted
</li>
<li>
The third field shows the <b>filesystem</b> used by the partition
</li>
<li>
The fourth field shows the <b>mountoptions</b> used by <c>mount</c> when it
wants to mount the partition. As every filesystem has its own mountoptions,
you are encouraged to read the mount man page (<c>man mount</c>) for a full
listing. Multiple mountoptions are comma-separated.
</li>
<li>
The fifth field is used by <c>dump</c> to determine if the partition needs to
be <b>dump</b>ed or not. You can generally leave this as <c>0</c> (zero).
</li>
<li>
The sixth field is used by <c>fsck</c> to determine the order in which
filesystems should be <b>check</b>ed if the system wasn't shut down properly.
The root filesystem should have <c>1</c> while the rest should have <c>2</c>
(or <c>0</c> if a filesystem check isn't necessary).
</li>
</ul>
<p>
The default <path>/etc/fstab</path> file provided by Gentoo <e>is no valid fstab
file</e>, so start <c>nano</c> (or your favorite editor) to create your
<path>/etc/fstab</path>:
</p>
<pre caption="Opening /etc/fstab">
# <i>nano -w /etc/fstab</i>
</pre>
<p>
Let us take a look at how we write down the options for the <path>/boot</path>
partition. This is just an example, so if your architecture doesn't require a
<path>/boot</path> partition (such as <b>PPC</b>), don't copy it verbatim.
</p>
<p>
In our default x86 partitioning example <path>/boot</path> is the
<path>/dev/hda1</path> partition, with <c>ext2</c> as filesystem.
It needs to be checked during boot, so we would write down:
</p>
<pre caption="An example /boot line for /etc/fstab">
/dev/hda1 /boot ext2 defaults 1 2
</pre>
<p>
Some users don't want their <path>/boot</path> partition to be mounted
automatically to improve their system's security. Those people should
substitute <c>defaults</c> with <c>noauto</c>. This does mean that you need to
manually mount this partition every time you want to use it.
</p>
<p>
Now, to improve performance, most users would want to add the <c>noatime</c>
option as mountoption, which results in a faster system since access times
aren't registered (you don't need those generally anyway):
</p>
<pre caption="An improved /boot line for /etc/fstab">
/dev/hda1 /boot ext2 defaults,noatime 1 2
</pre>
<p>
If we continue with this, we would end up with the following three lines (for
<path>/boot</path>, <path>/</path> and the swap partition):
</p>
<pre caption="Three /etc/fstab lines">
/dev/hda1 /boot ext2 defaults,noatime 1 2
/dev/hda2 none swap sw 0 0
/dev/hda3 / ext3 noatime 0 1
</pre>
<p>
To finish up, you should add a rule for <path>/proc</path>, <c>tmpfs</c>
(required) and for your CD-ROM drive (and of course, if you have other
partitions or drives, for those too):
</p>
<pre caption="A full /etc/fstab example">
/dev/hda1 /boot ext2 defaults,noatime 1 2
/dev/hda2 none swap sw 0 0
/dev/hda3 / ext3 noatime 0 1
none /proc proc defaults 0 0
none /dev/shm tmpfs nodev,nosuid,noexec 0 0
/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
</pre>
<p>
<c>auto</c> makes <c>mount</c> guess for the filesystem (recommended for
removable media as they can be created with one of many filesystems) and
<c>user</c> makes it possible for non-root users to mount the CD.
</p>
<p>
Now use the above example to create your <path>/etc/fstab</path>. If you are a
<b>SPARC</b>-user, you should add the following line to your
<path>/etc/fstab</path>
too:
</p>
<pre caption="Adding openprom filesystem to /etc/fstab">
none /proc/openprom openpromfs defaults 0 0
</pre>
<p>
Double-check your <path>/etc/fstab</path>, save and quit to continue.
</p>
</body>
</subsection>
</section>
<section>
<title>Networking Information</title>
<subsection>
<title>Hostname, Domainname etc.</title>
<body>
<p>
One of the choices the user has to make is name his/her PC. This seems to be
quite easy, but <e>lots</e> of users are having difficulties finding the
appropriate name for their Linux-pc. To speed things up, know that any name you
choose can be changed afterwards. For all we care, you can just call your system
<c>tux</c> and domain <c>homenetwork</c>.
</p>
<p>
We use these values in the next examples. First we set the hostname:
</p>
<pre caption="Setting the hostname">
# <i>echo tux > /etc/hostname</i>
</pre>
<p>
Second we set the domainname:
</p>
<pre caption="Setting the domainname">
# <i>echo homenetwork > /etc/dnsdomainname</i>
</pre>
<p>
If you have a NIS domain (if you don't know what that is, then you don't have
one), you need to define that one too:
</p>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-finalise.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.00</version>
<date>2005-03-21</date>
<section>
<title>User Administration</title>
<subsection>
<title>Adding a User for Daily Use</title>
<body>
<p>
Working as root on a Unix/Linux system is <e>dangerous</e> and should be avoided
as much as possible. Therefore it is <e>strongly</e> recommended to add a user
for day-to-day use.
</p>
<p>
The groups the user is member of define what activities the user can perform.
The following table lists a number of important groups you might wish to use:
</p>
<table>
<tr>
<th>Group</th>
<th>Description</th>
</tr>
<tr>
<ti>audio</ti>
<ti>be able to access the audio devices</ti>
</tr>
<tr>
<ti>cdrom</ti>
<ti>be able to directly access optical devices</ti>
</tr>
<tr>
<ti>floppy</ti>
<ti>be able to directly access floppy devices</ti>
</tr>
<tr>
<ti>games</ti>
<ti>be able to play games</ti>
</tr>
<tr>
<ti>usb</ti>
<ti>be able to access USB devices</ti>
</tr>
<tr>
<ti>video</ti>
<ti>
be able to access video capturing hardware and doing hardware
acceleration
</ti>
</tr>
<tr>
<ti>wheel</ti>
<ti>be able to use <c>su</c></ti>
</tr>
</table>
<p>
For instance, to create a user called <c>john</c> who is member of the
<c>wheel</c>, <c>users</c> and <c>audio</c> groups, log in as root first
(only root can create users) and run <c>useradd</c>:
</p>
<pre caption="Adding a user for day-to-day use">
Login: <i>root</i>
Password: <comment>(Your root password)</comment>
# <i>useradd -m -G users,wheel,audio -s /bin/bash john</i>
# <i>passwd john</i>
Password: <comment>(Enter the password for john)</comment>
Re-enter password: <comment>(Re-enter the password to verify)</comment>
</pre>
<p>
If a user ever needs to perform some task as root, they can use <c>su -</c>
to temporarily receive root privileges. Another way is to use the <c>sudo</c>
package which is, if correctly configured, very secure.
</p>
</body>
</subsection>
</section>
<section>
<title>Optional: Install GRP Packages</title>
<body>
<impo>
This part is for GRP users only. Other users should skip this part and continue
with <uri link="?part=1&chap=12">Where to go from here?</uri>.
</impo>
<p>
Now that your system is booted, log on as the user you created (for instance,
<c>john</c>) and use <c>su -</c> to gain root privileges:
</p>
<pre caption="Gaining root privileges">
$ <i>su -</i>
Password: <comment>(Enter your root password)</comment>
</pre>
<p>
Now we need to change the Portage configuration to look for the prebuilt
binaries from the second CD (Gentoo Packages CD). First mount this CD:
</p>
<pre caption="Mount the Packages CD">
<comment>(Put the Gentoo Packages CD in the CD tray)</comment>
# <i>mount /mnt/cdrom</i>
</pre>
<p>
Now configure Portage to use <path>/mnt/cdrom</path> for its prebuilt packages:
</p>
<pre caption="Configuring Portage to use /mnt/cdrom">
# <i>ls /mnt/cdrom</i>
<comment>(If there is a /mnt/cdrom/packages directory:)</comment>
# <i>export PKGDIR="/mnt/cdrom/packages"</i>
<comment>(Otherwise:)</comment>
# <i>export PKGDIR="/mnt/cdrom"</i>
</pre>
<p>
Now install the packages you want. The Packages CD contains several prebuilt
binaries, for instance KDE:
</p>
<pre caption="Installing KDE">
# <i>emerge --usepkg kde</i>
</pre>
<p>
Be sure to install the binaries now. When you do an <c>emerge --sync</c> to
update Portage (as you will learn later), the prebuilt binaries might not match
against the ebuilds in your updated Portage. You can try to circumvent this by
using <c>emerge --usepkgonly</c> instead of <c>emerge --usepkg</c>.
</p>
<p>
Congratulations, your system is now fully equipped! Continue with <uri
link="?part=1&chap=12">Where to go from here?</uri> to learn more about
Gentoo.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.00</version>
<date>2004-09-24</date>
<section>
<title>Installing PALO</title>
<body>
<p>
On the PA-RISC platform, the boot loader is called palo. You can find
the configuration file in <path>/etc/palo.conf</path>. Here is a sample
configuration:
</p>
<pre caption = "/etc/palo.conf example">
--commandline=2/vmlinux root=/dev/sdb2 HOME=/
--recoverykernel=/vmlinux.old
--init-partitioned=/dev/sdb
</pre>
<p>
The first line tells palo the location of the kernel and which boot
parameters it must use. <c>2/vmlinux</c> means the kernel named <c>/vmlinux</c>
resides on the second partition. Beware, the path to the kernel is
relative to the partition, not to the root of your filesystem.
</p>
<p>
The second line indicates which recovery kernel to use. If it is your
first install and you do not have a recovery kernel, please comment this
out. The third line indicates on which disk palo will reside.
</p>
<p>
When configuration is done, just run <c>palo</c>.
</p>
<pre caption = "Applying the PALO configuration">
# <i>palo</i>
</pre>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2005.1/hb-install-hppa-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-08-02</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first SCSI HD in a Linux system, namely
<path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions and Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On most systems,
these are called <e>partitions</e>. Other architectures use a similar technique,
called <e>slices</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
</body>
</subsection>
</section>
<section>
<title>Using fdisk on HPPA to Partition your Disk</title>
<body>
<p>
Use <c>fdisk</c> to create the partitions you want:
</p>
<pre caption="Partitioning the disk">
# <i>fdisk /dev/sda</i>
</pre>
<p>
HPPA machines use the PC standard DOS partition tables. To create a new
DOS partition table, simply use the <c>o</c> command.
</p>
<pre caption="Creating a DOS partition table">
# <i>fdisk /dev/sda</i>
Command (m for help): <i>o</i>
Building a new DOS disklabel.
</pre>
<p>
PALO (the HPPA bootloader) needs a special partition to work. You have
to create a partition of at least 16MB at the beginning of your disk.
The partition type must be of type <e>f0</e> (Linux/PA-RISC boot).
</p>
<impo>
If you ignore this and continue without a special PALO partition, your system
will stop loving you and fail to start. Also, if your disk is larger than 2GB,
make sure that the boot partition is in the first 2GB of your disk. PALO is
unable to read a kernel after the 2GB limit.
</impo>
<pre caption="A simple default partition schema">
# <i>cat /etc/fstab</i>
/dev/sda2 /boot ext3 noauto,noatime 1 1
/dev/sda3 none swap sw 0 0
/dev/sda4 / ext3 noatime 0 0
# <i>fdisk /dev/sda</i>
Command (m for help): <i>p</i>
Disk /dev/sda: 4294 MB, 4294816768 bytes
133 heads, 62 sectors/track, 1017 cylinders
Units = cylinders of 8246 * 512 = 4221952 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 8 32953 f0 Linux/PA-RISC boot
/dev/sda2 9 20 49476 83 Linux
/dev/sda3 21 70 206150 82 Linux swap
/dev/sda4 71 1017 3904481 83 Linux
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available. Ext2, ext3, XFS and reiserfs are found stable on
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.3</version>
<date>2005-06-09</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then make a
symlink to <path>/etc/localtime</path> using <c>ln</c>:
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For HPPA we have <c>hppa-sources</c>. Default these sources are based on
the 2.6 kernel sources. If you want to install a 2.4 kernel, you will need
to install Gentoo from a working Internet connection as we do not supply those
sources on our Installation CD. Continue by installing the kernel source:
</p>
<pre caption="Installing a kernel source">
# <i>emerge hppa-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source:
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.10_p11
</pre>
<p>
If this isn't the case (i.e. the symlink points to a different kernel source)
change the symlink before you continue:
</p>
<pre caption="Changing the kernel source symlink">
# <i>rm /usr/src/linux</i>
# <i>cd /usr/src</i>
# <i>ln -s linux-2.6.10_p11 linux</i>
</pre>
<p>
Now it is time to configure and compile your kernel source. All architectures
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc
file system</c>, <c>/dev file system</c> + <c>Automatically mount at boot</c>:
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
[*] /dev file system support (OBSOLETE)
[*] Automatically mount at boot
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-05-24</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<p>
A list of supported hardware can be found on the
<uri link="http://www.pateam.org/list.html">PA Team website</uri>.
You may find additional information about your box in the <uri
link="http://hwdb.parisc-linux.org">Parisc-Linux Hardware Database</uri>.
</p>
<table>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- Copy/paste from hb-install-x86-medium.xml -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
stage file is a tarball (compressed archive) that contains a minimal
environment.
</p>
<ul>
<li>
A stage1 file contains nothing more than a compiler, Portage (Gentoo's
software management system) and a couple of packages on which the
compiler or Portage depends.
</li>
<li>
A stage2 file contains a so-called bootstrapped system, a minimal
environment from which one can start building all other necessary
applications that make a Gentoo environment complete.
</li>
<li>
A stage3 file contains a prebuilt minimal system which is almost fully
deployable. It only lacks a few applications where you, the Gentoo user,
needs to choose which one you want to install.
</li>
</ul>
<p>
We will opt for a stage3 installation throughout this document. If you want to
perform a Gentoo installation using the stage1 or stage2 files, please use the
installation instructions in the <uri
link="/doc/en/handbook/handbook-hppa.xml">Gentoo Handbook</uri>. They do
require a working Internet connection though.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is no Installation CD but an additional
resource that you can exploit during the installation of your Gentoo system. It
contains prebuilt packages (the so-called GRP set) that allows you to easily
and quickly install additional applications (such as OpenOffice.org, KDE,
GNOME, ...) immediately after the Gentoo installation and right before you
update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
the <path>releases/hppa/2005.0/installcd</path> directory;
the Package CD is located in the <path>releases/hppa/2005.0/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find so-called ISO-files. Those are full CD
images which you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-network.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.1</version>
<date>2005-07-28</date>
<section>
<title>Do you need Networking?</title>
<subsection>
<title>Who can do without?</title>
<body>
<p>
Generally, you don't need a working network connection to install Gentoo using
the Universal Installation CD. However, there are some circumstances where you
do want to have a working Internet connection:
</p>
<ul>
<li>
The stage3 files that are stored in the Universal Installation CD do not
match your architecture and you need to download the correct stage3 file
</li>
<li>
You need to install a specific networking application that will allow you to
connect to the Internet which isn't available on the Universal Installation
CD but is supported by the Installation CD (i.e. you can connect to the
Internet using the Installation CD but the necessary sources are not
available on the Installation CD)
</li>
<li>
You want remote assistance during the installation (using SSH or through
direct conversations using IRC)
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Do I need Networking?</title>
<body>
<p>
To find out if the stage3 file for your architecture is available, take a look
inside <path>/mnt/cdrom/stages</path> and check if one of the available stages
matches your architecture. If not, you can still opt for a stage3 file of an
architecture compatible with yours.
</p>
<p>
If you on the other hand want to use a stage3 file optimized for your
architecture and the stage3 file of your choice is not available, then you will
need networking to download the appropriate stage3 file.
</p>
<p>
So, if you don't need networking, you can skip the rest of this chapter and
continue with <uri link="?part=1&chap=4">Preparing the Disks</uri>.
Otherwise, continue with the networking configuration sections below.
</p>
</body>
</subsection>
</section>
<section>
<title>Automatic Network Detection</title>
<subsection>
<title>Maybe it just works?</title>
<body>
<p>
If your system is plugged into an Ethernet network with a DHCP server, it is
very likely that your networking configuration has already been set up
automatically for you. If so, you should be able to take advantage of the many
included network-aware commands on the Installation CD such as <c>ssh</c>,
<c>scp</c>, <c>ping</c>, <c>irssi</c>, <c>wget</c> and <c>links</c>, among
others.
</p>
<p>
If networking has been configured for you, the <c>/sbin/ifconfig</c> command
should list some network interfaces besides lo, such as eth0:
</p>
<pre caption="/sbin/ifconfig for a working network configuration">
# <i>/sbin/ifconfig</i>
<comment>(...)</comment>
eth0 Link encap:Ethernet HWaddr 00:50:BA:8F:61:7A
inet addr:192.168.0.2 Bcast:192.168.0.255 Mask:255.255.255.0
inet6 addr: fe80::50:ba8f:617a/10 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:1498792 errors:0 dropped:0 overruns:0 frame:0
TX packets:1284980 errors:0 dropped:0 overruns:0 carrier:0
collisions:1984 txqueuelen:100
RX bytes:485691215 (463.1 Mb) TX bytes:123951388 (118.2 Mb)
Interrupt:11 Base address:0xe800
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Configure Proxy</title>
<body>
<p>
If you access the Internet through a proxy, you might need to set up proxy
information during the installation. It is very easy to define a proxy: you just
need to define a variable which contains the proxy server information.
</p>
<p>
In most cases, you can just define the variables using the server hostname. As
an example, we assume the proxy is called <e>proxy.gentoo.org</e> and the port
is 8080.
</p>
<pre caption="Defining proxy servers">
<comment>(If the proxy filters HTTP traffic)</comment>
# <i>export http_proxy="http://proxy.gentoo.org:8080"</i>
<comment>(If the proxy filters FTP traffic)</comment>
# <i>export ftp_proxy="ftp://proxy.gentoo.org:8080"</i>
<comment>(If the proxy filters RSYNC traffic)</comment>
# <i>export RSYNC_PROXY="proxy.gentoo.org:8080"</i>
</pre>
<p>
If your proxy requires a username and password, you should use the following
syntax for the variable:
</p>
<pre caption="Adding username/password to the proxy variable">
http://<i>username</i>:<i>password</i>@proxy.gentoo.org:8080
</pre>
</body>
</subsection>
<subsection>
<title>Testing the Network</title>
<body>
<p>
You may want to try pinging your ISP's DNS server (found in
<path>/etc/resolv.conf</path>) and a Web site of choice, just to make sure
that your packets are reaching the net, DNS name resolution is working
correctly, etc..
</p>
<pre caption="Further network testing">
# <i>ping -c 3 www.yahoo.com</i>
</pre>
<p>
Are you able to use your network? If so, you can skip the rest of this
section and continue with <uri link="?part=1&chap=4">Preparing the
Disks</uri>. If not, bad luck, you'll have to work on it a bit more.
</p>
</body>
</subsection>
</section>
<section>
<title>Automatic Network Configuration</title>
<subsection>
<body>
<p>
If the network doesn't work immediately, some installation media allow you to
use <c>net-setup</c> (for regular or wireless networks), <c>adsl-setup</c>
(for ADSL-users) or <c>pptp</c> (for PPTP-users - only available on x86).
</p>
<p>
If your installation medium does not contain any of these tools or your network
doesn't function yet, continue with <uri link="#doc_chap4">Manual Network
Configuration</uri>.
</p>
<ul>
<li>
Regular Ethernet users should continue with <uri
link="#net-setup">Default: Using net-setup</uri>
</li>
<li>
ADSL users should continue with <uri link="#rp-pppoe">Alternative:
Using RP-PPPoE</uri>
</li>
<li>
PPTP users should continue with <uri link="#pptp">Alternative:
Using PPTP</uri> (x86 only)
</li>
</ul>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-next.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-06-09</date>
<section>
<title>Documentation</title>
<subsection>
<body>
<p>
Congratulations! You now have a working Gentoo system. But where to go from
here? What are your options now? What to explore first? Gentoo provides its
users with lots of possibilities, and therefore lots of documented (and less
documented) features.
</p>
<p>
You should definitely take a look at the next part of the Gentoo Handbook
entitled <uri link="?part=2&chap=0">Working with Gentoo</uri> which explains
how to keep your software up to date, how to install more software, what USE
flags are, how the Gentoo Init system works, etc.
</p>
<p>
If you are interested in optimizing your system for desktop-use, or you want to
learn how to configure your system to be a full working desktop system, consult
our extensive <uri link="/doc/en/index.xml?catid=desktop">Gentoo Desktop
Documentation Resources</uri>.
</p>
<p>
We also have a <uri link="/doc/en/security/">Gentoo Security Handbook</uri>
which is worth reading.
</p>
<p>
For a full listing of all our available documentation check out our <uri
link="/doc/en/index.xml">Documentation Resources</uri> page.
</p>
</body>
</subsection>
</section>
<section>
<title>Gentoo Online</title>
<body>
<p>
You are of course always welcome on our <uri
link="http://forums.gentoo.org">Gentoo Forums</uri> or on one of our many
<uri link="/main/en/irc.xml">Gentoo IRC channels</uri>.
</p>
<p>
We also have several <uri
link="/main/en/lists.xml">mailinglists</uri> open to all
our users. Information on how to join is contained in that page.
</p>
<p>
We'll shut up now and let you enjoy your installation :)
</p>
</body>
</section>
<section>
<title>Gentoo Changes since 2005.0</title>
<subsection>
<title>Changes?</title>
<body>
<p>
Gentoo is a fast-moving target. The following sections describe important
changes that affect a Gentoo installation. We only list those that have anything
in common with the installation, not with package changes that did not occur
during the installation.
</p>
<p>
The following changes need to happen right after having updated your system (and
before rebooting):
</p>
<ul>
<li>
The <c>baselayout</c> package has received major updates, including on the
<uri link="?part=4">Gentoo Network Configuration</uri> aspect. The changes
include a new syntax for the <path>/etc/conf.d/net</path> file although the
old syntax is still supported. You are advised to change to the new one in
time.
</li>
</ul>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.00</version>
<date>2005-03-19</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>. But before you start, consider
your options...
</p>
<p>
Several bootloaders exist for Linux/PPC. We have <uri link="#yaboot">yaboot</uri>
(for NewWorld Apple and IBM machines) and <uri link="#bootx">BootX</uri> (for
OldWorld Apple and IBM machines). The Pegasos does not require a bootloader, but
we included the <uri link="#bootcreator">BootCreator</uri> for creating a
SmartFirmware bootmenu.
</p>
</body>
</subsection>
</section>
<section id="yaboot">
<title>Default: Using yaboot</title>
<subsection>
<title>Introduction</title>
<body>
<impo>
yaboot can only be used on NewWorld Apple and IBM systems!
</impo>
<p>
First we have to create the <path>/dev</path> files in our new home, which is
needed during the bootloader installation. This could be done by "bind"-mapping
the <path>/dev</path>-filesystem from the Installation CD:
</p>
<pre caption="Bind-mounting the /dev-filesystem">
# <i>exit </i> # this will exit the chroot
# <i>mount -o bind /dev /mnt/gentoo/dev</i>
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>/usr/sbin/env-update && source /etc/profile </i>
</pre>
<p>
There are two ways to configure yaboot for your system. You can use the
included <c>yabootconfig</c> to automatically set up yaboot. If
for some reason you do not want to run <c>yabootconfig</c> to
automatically set up <path>/etc/yaboot.conf</path> or you are installing Gentoo
on a G5 (on which <c>yabootconfig</c> does not always work), you can just edit
the sample file already installed on your system.
</p>
<ul>
<li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li>
<li>
<uri link="#manual_yaboot">Alternative: Manual yaboot Configuration</uri>
</li>
</ul>
</body>
</subsection>
<subsection id="yabootconfig">
<title>Default: Using yabootconfig</title>
<body>
<p>
<c>yabootconfig</c> will auto-detect the partitions on your machine and will
set up dual and triple boot combinations with Linux, Mac OS, and Mac OS X.
</p>
<p>
To use <c>yabootconfig</c>, your drive must have an Apple_Bootstrap partition,
and <path>/etc/fstab</path> must be configured with your Linux partitions. Both
of these should have been done already in the steps above. To start, ensure that
you have the latest <c>yaboot</c> installed.
</p>
<pre caption = "Installing yaboot with GRP">
# <i>emerge --usepkg --update yaboot</i>
</pre>
<p>
Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. The
program will run and it will confirm the location of the bootstrap partition.
Type <c>Y</c> if it is correct. If not, double check <path>/etc/fstab</path>.
yabootconfig will then scan your system setup, create
<path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for you. <c>mkofboot</c>
is used to format the Apple_Bootstrap partition, and install the yaboot
configuration file into it. After this enter the chroot again.
</p>
<pre caption="enter chroot">
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>/usr/sbin/env-update && source /etc/profile</i>
</pre>
<p>
You might want to verify the contents of <path>/etc/yaboot.conf</path>. If you
make changes to <path>/etc/yaboot.conf</path> (like setting the default/boot
OS), make sure to rerun <c>ybin -v</c> to apply changes to the Apple_Bootstrap
partition.
</p>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
<subsection id="manual_yaboot">
<title>Alternative: Manual yaboot Configuration</title>
<body>
<p>
First make sure you have the latest <c>yaboot</c> installed on your
system:
</p>
<pre caption = "Installing yaboot">
# <i>emerge --usepkg --update yaboot</i>
</pre>
<p>
Below you find a completed <path>yaboot.conf</path> file. Alter it at
will. G5 users should be aware that their disks are Serial ATA disks which are
seen as SCSI disks by the Linux kernel (so substitute <path>/dev/hda</path> with
<path>/dev/sda</path>).
</p>
<pre caption = "/etc/yaboot.conf">
<comment>## /etc/yaboot.conf
##
## run: "man yaboot.conf" for details. Do not make changes until you have!!
## see also: /usr/share/doc/yaboot/examples for example configurations.
##
## For a dual-boot menu, add one or more of:
## bsd=/dev/hdaX, macos=/dev/hdaY, macosx=/dev/hdaZ
## our bootstrap partition:</comment>
boot=/dev/hda2
<comment>## ofboot is the openfirmware way to specify the bootstrap partition.
## If this isn't defined, yaboot fails on the G5 and some G4s (unless
## you pass the necessary arguments to the mkofboot/ybin program).
## hd:X means /dev/sdaX (or /dev/hdaX).
##
## G5 users should uncomment this line!!
#ofboot=hd:2
## hd: is open firmware speak for hda</comment>
device=hd:
delay=5
defaultos=macosx
timeout=30
install=/usr/lib/yaboot/yaboot
magicboot=/usr/lib/yaboot/ofboot
<comment>#################
## This section can be duplicated if you have more than one kernel or set of
## boot options - replace 2.6.9 with your kernel-version
#################</comment>
image=/boot/kernel-2.6.9
label=Linux
root=/dev/hda3
partition=3
sysmap=/boot/System.map-2.6.9
read-only
<comment>##################
## G5 users and some G4 users should set
## macos=hd:13
## macosx=hd:12
## instead of the example values.</comment>
macos=/dev/hda13
macosx=/dev/hda12
enablecdboot
enableofboot
</pre>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2005.1/hb-install-ppc-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-08-02</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI or SATA drives, then your first
hard drive would be <path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions and Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On most systems,
these are called <e>partitions</e>. Other architectures use a similar technique,
called <e>slices</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition NewWorld</th>
<th>Partition OldWorld</th>
<th>Partition Pegasos</th>
<th>Partition RS/6000</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti><path>/dev/hda1</path></ti>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti>(Partition Map)</ti>
<ti>32k</ti>
<ti>Apple_partition_map</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>(Not needed)</ti>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti>(bootstrap)</ti>
<ti>800k</ti>
<ti>Apple_Bootstrap</ti>
</tr>
<tr>
<ti>(Not applicable</ti>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti><path>/dev/sda1</path></ti>
<ti>(PReP Boot)</ti>
<ti>800k</ti>
<ti>Type 0x41</ti>
</tr>
<tr>
<ti>(Not needed)</ti>
<ti>(Not needed)</ti>
<ti><path>/dev/hda1</path></ti>
<ti>(Not needed)</ti>
<ti>ext2</ti>
<ti>32MB</ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti><path>/dev/hda2</path></ti>
<ti><path>/dev/hda2</path></ti>
<ti><path>/dev/sda2</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition, Type 0x82</ti>
</tr>
<tr>
<ti><path>/dev/hda4</path></ti>
<ti><path>/dev/hda3</path></ti>
<ti><path>/dev/hda3</path></ti>
<ti><path>/dev/sda3</path></ti>
<ti>ext3, xfs</ti>
<ti>Rest of the disk</ti>
<ti>Root partition, Type 0x83</ti>
</tr>
</table>
<note>
There are some partitions named like this: <path>Apple_Driver43,
Apple_Driver_ATA, Apple_FWDriver, Apple_Driver_IOKit, Apple_Patches</path>. If
you are not planning to use MacOS 9 you can delete them, because MacOS X and
Linux don't need them. You might have to use <c>parted</c> in order to delete
them, as mac-fdisk can't delete them yet.
</note>
<warn>
<c>parted</c> is able to resize partitions. On the Installation CD there
are patches included to resize HFS+ filesystem. Unfortunately it is not
possible to resize HFS+ journaled filesystems, even if the journaling has been
switchedoff in Mac OS X. Everything you do with resizing in parted you do it
on your own risk! Be sure to have a backup of your data!
</warn>
<p>
If you are interested in knowing how big a partition should be, or even how many
partitions you need, read on. Otherwise continue now with <uri
link="#fdisk">Default: Using mac-fdisk (Apple/IBM) to Partition your Disk</uri>
or <uri link="#parted">Alternative: Using parted (especially Pegasos) to
Partition your Disk</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your <path>/var</path>
should be separate as all mails are stored inside <path>/var</path>. A good
choice of filesystem will then maximise your performance. Gameservers will have
a separate <path>/opt</path> as most gaming servers are installed there. The
reason is similar for <path>/home</path>: security and backups. You will
definitely want to keep <path>/usr</path> big: not only will it contain the
majority of applications, the Portage tree alone takes around 500 Mbyte
excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.9</version>
<date>2005-07-04</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then make a
symlink to <path>/etc/localtime</path> using <c>ln</c>:
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For PPC you can choose between <c>vanilla-sources</c> and
<c>gentoo-sources</c> (both 2.6 kernels). The latter is available when you
perform a networkless installation. Beside those there is a special
kernel-2.6-patchset for the Pegasos: <c>pegasos-sources</c>. So let's
continue with <c>emerge</c>'ing the kernel sources:
</p>
<pre caption="Installing a kernel source">
# <i>emerge gentoo-sources</i>
</pre>
<note>
The PowerPC sources are based on a 2.6.10-kernel with security patches from
2.6.11 backported. As the time of the release the 2.6.11 kernel produced
several problems on different PowerPC machines.
</note>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. We will assume the kernel
source installed is <c>gentoo-sources-2.6.10-r8</c>:
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 22 Mar 18 16:23 /usr/src/linux -> linux-2.6.10-gentoo-r8
</pre>
<p>
If the symlink doesn't point to the kernel source of your choice (note that
<c>linux-2.6.10-gentoo-r8</c> is merely an example) you should change it to the
right kernel:
</p>
<pre caption="Changing the kernel source symlink">
# <i>rm /usr/src/linux</i>
# <i>cd /usr/src</i>
# <i>ln -s linux-2.6.10-gentoo-r8 linux</i>
</pre>
<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>/proc file system</c> and
<c>Virtual memory</c>. Do <e>not</e> select the <c>/dev file system</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
[ ] /dev file system support (OBSOLETE)
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.01</version>
<date>2005-05-06</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>NewWorld machines</th>
<ti>
Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
PowerBook, Xserver, PowerMac, Genesi's Pegasos II
</ti>
</tr>
<tr>
<th>OldWorld machines</th>
<ti>
Limited support for IBM (RS/6000, iSeries, pSeries) and Amiga systems
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>At least 64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo
PPC FAQ</uri> before you begin.
</p>
</body>
</subsection>
</section>
<!-- Copy/paste of hb-install-x86-medium.xml, with s/x86/ppc/ -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
stage file is a tarball (compressed archive) that contains a minimal
environment.
</p>
<ul>
<li>
A stage1 file contains nothing more than a compiler, Portage (Gentoo's
software management system) and a couple of packages on which the
compiler or Portage depends.
</li>
<li>
A stage2 file contains a so-called bootstrapped system, a minimal
environment from which one can start building all other necessary
applications that make a Gentoo environment complete.
</li>
<li>
A stage3 file contains a prebuilt minimal system which is almost fully
deployable. It only lacks a few applications where you, the Gentoo user,
needs to choose which one you want to install.
</li>
</ul>
<p>
We will opt for a stage3 installation throughout this document. If you want to
perform a Gentoo installation using the stage1 or stage2 files, please use the
installation instructions in the <uri
link="/doc/en/handbook/handbook-ppc.xml">Gentoo Handbook</uri>. They do
require a working Internet connection though.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is no Installation CD but an additional
resource that you can exploit during the installation of your Gentoo system. It
contains prebuilt packages (the so-called GRP set) that allows you to easily
and quickly install additional applications (such as OpenOffice.org, KDE,
GNOME, ...) immediately after the Gentoo installation and right before you
update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located
in the <path>releases/ppc/2005.0/installcd</path> directory;
the Package CDs are located in the <path>releases/ppc/2005.0/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find so-called ISO-files. Those are full CD
images which you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows). How
to verify MD5 checksums with Mac OS X is described in the <uri
link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (0x17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.00</version>
<date>2005-01-22</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Installing the SPARC Bootloader: SILO</title>
<body>
<p>
It is now time to install and configure <uri
link="http://www.sparc-boot.org">SILO</uri>, the Sparc Improved boot
LOader.
</p>
<pre caption = "Installing SILO">
# <i>emerge silo</i>
</pre>
<p>
Now open up your favorite editor (we use <c>nano</c> as an example) and
create <path>/etc/silo.conf</path>.
</p>
<pre caption = "Creating /etc/silo.conf">
# <i>nano -w /etc/silo.conf</i>
</pre>
<p>
Below you'll find an example <path>silo.conf</path> file. It uses the
partitioning scheme we use throughout this book and
<path>kernel-2.4.29</path> as kernelimage.
</p>
<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>
image = /boot/kernel-2.4.29
label = linux
</pre>
<p>
If you use the example <path>silo.conf</path> delivered by Portage, be
sure to comment out <e>all</e> lines that you do not need.
</p>
<p>
If the physical disk on which you want to install SILO (as bootloader) differs
from the physical disk on which <path>/etc/silo.conf</path> resides, you must
copy over <path>/etc/silo.conf</path> to a partition on that disk. Assuming that
<path>/boot</path> is a separate partition on that disk, copy over the
configuration file to <path>/boot</path> and run <c>/sbin/silo</c>:
</p>
<pre caption = "Only if /boot and the SILO destination are 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
</pre>
<p>
Otherwise just run <c>/sbin/silo</c>:
</p>
<pre caption = "Run silo">
# <i>/sbin/silo</i>
/etc/silo.conf appears to be valid
</pre>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2005.1/hb-install-sparc-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-08-02</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at some of the disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions, and block
devices. Then, once you're familiar with the ins and outs of disks and
filesystems, you'll be guided through the process of setting up partitions
and filesystems for your Gentoo Linux installation.
</p>
<p>
To begin, we introduce <e>block devices</e>. The most typical block device is
probably the one that represents the first SCSI hard disk in a Linux system,
namely <path>/dev/sda</path>.
</p>
<p>
Block devices represent an abstract interface to the disk. User programs can
use these block devices to interact with your disk without worrying about
whether your drives are IDE, SCSI, or something else. The program can simply
address the storage on the disk as a bunch of contiguous, randomly-accessible
512-byte blocks.
</p>
<p>
Block devices show up as entries in <path>/dev/</path>. Typically, the first
SCSI drive is named <path>/dev/sda</path>, the second <path>/dev/sdb</path>,
and so on. IDE drives are named similarly, however, they are prefixed by hd-
instead of sd-. If you are using IDE drives, the first one will be named
<path>/dev/hda</path>, the second <path>/dev/hdb</path>, and so on.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Although it is theoretically possible to use the entire disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. These are known as
<e>partitions</e> or <e>slices</e>.
</p>
<p>
The first partition on the first SCSI disk is <path>/dev/sda1</path>, the second
<path>/dev/sda2</path> and so on. Similarly, the first two partitions on the
first IDE disk are <path>/dev/hda1</path> and <path>/dev/hda2</path>.
</p>
<p>
The third partition on Sun systems is set aside as a special "whole disk"
slice. This partition must not contain a file system.
</p>
<p>
Users who are used to the DOS partitioning scheme should note that Sun
disklabels do not have "primary" and "extended" partitions. Instead, up to
eight partitions are available per drive, with the third of these being
reserved.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme,
the table below suggests a suitable starting point for most systems. For
IDE-based systems, substitute <c>hda</c> for <c>sda</c> in the following.
</p>
<p>
Note that a separate <path>/boot</path> partition is generally <e>not</e>
recommended on SPARC, as it complicates the bootloader configuration.
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Mount Point</th>
<th>Description</th>
</tr>
<tr>
<ti>/dev/sda1</ti>
<ti>ext3</ti>
<ti><2 GByte</ti>
<ti>/</ti>
<ti>
Root partition. For all sparc32 systems, and 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>
</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>
</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>
</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>
</tr>
</table>
</body>
</subsection>
</section>
<section id="fdisk">
<title>Using fdisk to Partition your Disk</title>
<subsection>
<body>
<p>
The following parts explain how to create the example partition layout described
previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti>/dev/sda1</ti>
<ti>/</ti>
</tr>
<tr>
<ti>/dev/sda2</ti>
<ti>swap</ti>
</tr>
<tr>
<ti>/dev/sda3</ti>
<ti>whole disk slice</ti>
</tr>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-06-02</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then make a
symlink to <path>/etc/localtime</path> using <c>ln</c>:
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For sparc-based systems we have <c>sparc-sources</c> (kernel source optimized
for SPARC users) and <c>vanilla-sources</c> (the default kernel source as
developed by the linux-kernel developers).
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>.
</p>
<p>
In the next example we install the <c>sparc-sources</c>.
Of course substitute with your choice of sources, this is merely an example:
</p>
<pre caption="Installing a kernel source">
# <i>emerge sparc-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source:
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.4.29-sparc
</pre>
<p>
If this isn't the case (i.e. the symlink points to a different kernel source)
change the symlink before you continue:
</p>
<pre caption="Changing the kernel source symlink">
# <i>rm /usr/src/linux</i>
# <i>cd /usr/src</i>
# <i>ln -s linux-2.4.29-sparc linux</i>
</pre>
<p>
Now it is time to configure and compile your kernel source.
</p>
</body>
</subsection>
</section>
<section>
<title>Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc
file system</c>, <c>/dev file system</c> + <c>Automatically mount at boot</c>:
</p>
<pre caption="Selecting necessary file systems">
File systems --->
[*] Virtual memory file system support (former shm fs)
[*] /proc file system support
[*] /dev file system support (EXPERIMENTAL)
[*] Automatically mount at boot
[ ] /dev/pts file system for Unix98 PTYs
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Ext3 journalling file system support
<*> Second extended fs support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Network device support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
Now activate the correct bus-support:
</p>
<pre caption="Activating SBUS/UPA">
Console drivers --->
Frame-buffer support --->
[*] SBUS and UPA framebuffers
[*] Creator/Creator3D support <comment>(Only for UPA slot adapter used in many Ultras)</comment>
[*] CGsix (GX,TurboGX) support <comment>(Only for SBUS slot adapter used in many SPARCStations)</comment>
</pre>
<p>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-05-23</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>Sparc System</th>
<ti>
Please check the <uri
link="http://www.ultralinux.org/faq.html#s_2">UltraLinux FAQ</uri>
</ti>
</tr>
<tr>
<th>CPU</th>
<ti>
Although sparc64 is the only officially supported platform, experimental
support for sparc32 is available as well
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
We currently only provide Installation CDs for the sparc64 architecture. Users
of sparc32 can use the experimental netboot images to install Gentoo from.
More information about netbooting can be found in our <uri
link="/doc/en/gentoo-sparc-netboot-howto.xml">Gentoo Linux based Netboot
HOWTO</uri>.
</p>
</body>
</subsection>
</section>
<!-- Copy/Paste from hb-install-x86-medium.xml -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
stage file is a tarball (compressed archive) that contains a minimal
environment.
</p>
<ul>
<li>
A stage1 file contains nothing more than a compiler, Portage (Gentoo's
software management system) and a couple of packages on which the
compiler or Portage depends.
</li>
<li>
A stage2 file contains a so-called bootstrapped system, a minimal
environment from which one can start building all other necessary
applications that make a Gentoo environment complete.
</li>
<li>
A stage3 file contains a prebuilt minimal system which is almost fully
deployable. It only lacks a few applications where you, the Gentoo user,
needs to choose which one you want to install.
</li>
</ul>
<p>
We will opt for a stage3 installation throughout this document. If you want to
perform a Gentoo installation using the stage1 or stage2 files, please use the
installation instructions in the <uri
link="/doc/en/handbook/handbook-sparc.xml">Gentoo Handbook</uri>. They do
require a working Internet connection though.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is no Installation CD but an additional
resource that you can exploit during the installation of your Gentoo system. It
contains prebuilt packages (the so-called GRP set) that allows you to easily
and quickly install additional applications (such as OpenOffice.org, KDE,
GNOME, ...) immediately after the Gentoo installation and right before you
update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot a Gentoo Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CDs</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
the <path>releases/sparc/2005.0/installcd/sparc64</path>
directory; the Package CDs are located in the
<path>releases/sparc/2005.0/packagecd/sparc64</path> directory.
</p>
<p>
Inside those directories you'll find so-called ISO-files.
Those are full CD images which you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-stage.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-05-04</date>
<section>
<title>Installing a Stage Tarball</title>
<subsection>
<title>Setting the Date/Time Right</title>
<body>
<p>
Before you continue you need to check your date/time and update it. A
misconfigured clock may lead to strange results in the future!
</p>
<p>
To verify the current date/time, run <c>date</c>:
</p>
<pre caption="Verifying the date/time">
# <i>date</i>
Fri Mar 29 16:21:18 CEST 2005
</pre>
<p>
If the date/time displayed is wrong, update it using the <c>date
MMDDhhmmYYYY</c> syntax (<b>M</b>onth, <b>D</b>ay, <b>h</b>our, <b>m</b>inute
and <b>Y</b>ear). For instance, to set the date to Mar 29th, 16:21 in the
year 2005:
</p>
<pre caption="Setting the date/time">
# <i>date 032916212005</i>
</pre>
</body>
</subsection>
<subsection>
<title>Locating the Stage3 File</title>
<body>
<p>
If you have configured networking because you need to download a stage3 file for
your architecture, continue with <uri link="#download">Alternative: Using a
Stage3 from the Internet</uri>. Otherwise read <uri link="#available">Default:
Using a Stage3 from the Installation CD</uri>.
</p>
</body>
</subsection>
</section>
<section id="available">
<title>Default: Using a Stage from the Installation CD</title>
<subsection>
<title>Extracting the Stage Tarball</title>
<body>
<p>
The stages on the CD reside in the <path>/mnt/cdrom/stages</path> directory. To
see a listing of available stages, use <c>ls</c>:
</p>
<pre caption="List all available stages">
# <i>ls /mnt/cdrom/stages</i>
</pre>
<p>
If the system replies with an error, you may need to mount the CD-ROM first:
</p>
<pre caption="Mounting the CD-ROM">
# <i>ls /mnt/cdrom/stages</i>
ls: /mnt/cdrom/stages: No such file or directory
# <i>mount /dev/cdroms/cdrom0 /mnt/cdrom</i>
# <i>ls /mnt/cdrom/stages</i>
</pre>
<p>
Now go into your Gentoo mountpoint (usually <path>/mnt/gentoo</path>):
</p>
<pre caption="Changing directory to /mnt/gentoo">
# <i>cd /mnt/gentoo</i>
</pre>
<p>
We will now extract the stage tarball of your choice. We will do this with the
GNU <c>tar</c> tool. Make sure you use the same options (<c>-xvjpf</c>)! The
<c>x</c> stands for <e>Extract</e>, the <c>v</c> for <e>Verbose</e> to see what
happens during the extraction process (this one is optional), the <c>j</c> for
<e>Decompress with bzip2</e>, the <c>p</c> for <e>Preserve permissions</e> and
the <c>f</c> to denote that we want to extract a file, not standard input. In
the next example, we extract the stage tarball
<path>stage3-<subarch>-2005.0.tar.bz2</path>. Be sure to substitute the
tarball filename with your stage.
</p>
<pre caption="Extracting the stage tarball">
# <i>tar -xvjpf /mnt/cdrom/stages/stage3-<subarch>-2005.0.tar.bz2</i>
</pre>
<p>
Now that the stage is installed, continue with <uri
link="#installing_portage">Installing Portage</uri>.
</p>
</body>
</subsection>
</section>
<section id="download">
<title>Alternative: Using a Stage from the Internet</title>
<subsection>
<title>Downloading the Stage Tarball</title>
<body>
<p>
Go to the Gentoo mountpoint at which you mounted your filesystems
(most likely <path>/mnt/gentoo</path>):
</p>
<pre caption="Going to the Gentoo mountpoint">
# <i>cd /mnt/gentoo</i>
</pre>
<p>
Depending on your installation medium, you have a couple of tools available to
download a stage. If you have <c>links2</c> available, then you can immediately
surf to <uri link="/main/en/mirrors.xml">the Gentoo mirrorlist</uri> and
choose a mirror close to you.
</p>
<p>
If you don't have <c>links2</c> available you should have <c>lynx</c> at your
disposal. If you need to go through a proxy, export the <c>http_proxy</c> and
<c>ftp_proxy</c> variables:
</p>
<pre caption="Setting proxy information for lynx">
# <i>export http_proxy="http://proxy.server.com:port"</i>
# <i>export ftp_proxy="http://proxy.server.com:port"</i>
</pre>
<p>
We will now assume that you have <c>links2</c> at your disposal.
</p>
<p>
Pick the <path>releases/</path> directory, followed by your architecture (for
instance <path>x86/</path>) and the Gentoo version (<path>2005.0/</path>)
to finish up with the <path>stages/</path> directory. There you should see all
available stage files for your architecture (they might be stored within
subdirectories named to the individual sub architectures). Select one and
press <c>D</c> to download. When you're finished, press <c>Q</c> to quit the
browser.
</p>
<pre caption="Surfing to the mirror listing with links2">
# <i>links2 http://www.gentoo.org/main/en/mirrors.xml</i>
<comment>(If you need proxy support with links2:)</comment>
# <i>links2 -http-proxy proxy.server.com:8080 http://www.gentoo.org/main/en/mirrors.xml</i>
</pre>
<p>
If you want to check the integrity of the downloaded stage tarball, use
<c>md5sum</c> and compare the output with the MD5 checksum provided on the
mirror. For instance, to check the validity of the x86 stage tarball:
</p>
<pre caption="Example checking integrity of a stage tarball">
# <i>md5sum -c stage3-x86-2005.0.tar.bz2.md5</i>
stage3-x86-2005.0.tar.bz2: OK
</pre>
</body>
</subsection>
<subsection>
<title>Unpacking the Stage Tarball</title>
<body>
<p>
Now unpack your downloaded stage onto your system. We use GNU's <c>tar</c> to
proceed as it is the easiest method:
</p>
<pre caption="Unpacking the stage">
# <i>tar -xvjpf stage3-*.tar.bz2</i>
</pre>
<p>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-system.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.00</version>
<date>2005-01-07</date>
<section>
<title>Chrooting</title>
<subsection>
<title>Mounting the proc Filesystem</title>
<body>
<p>
Mount the <path>/proc</path> filesystem on <path>/mnt/gentoo/proc</path> to
allow the installation to use the kernel-provided information even within the
chrooted environment.
</p>
<pre caption="Mounting /proc">
# <i>mount -t proc none /mnt/gentoo/proc</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Copy over DNS Information</title>
<body>
<p>
If you configured your network to fetch the appropriate stage file later on from
the Internet, you need to copy over the DNS information stored in
<path>/etc/resolv.conf</path> to <path>/mnt/gentoo/etc/resolv.conf</path>. This
file contains the nameservers your system will use to resolve names to IP
addresses.
</p>
<pre caption="Copy over DNS Information">
# <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i>
</pre>
</body>
</subsection>
<subsection>
<title>Entering the new Environment</title>
<body>
<p>
Now that all partitions are initialized and the base environment
installed, it is time to enter our new installation environment by
<e>chrooting</e> into it. This means that we change from the current
installation environment to your installation system (namely the
initialized partitions).
</p>
<p>
This chrooting is done in three steps. First we will change the root
from <path>/</path> (on the installation medium) to <path>/mnt/gentoo</path>
(on your partitions) using <c>chroot</c>. Then we will create a new environment
using <c>env-update</c>, which essentially creates environment variables.
Finally, we load those variables into memory using <c>source</c>.
</p>
<pre caption = "Chrooting into the new environment">
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>env-update</i>
* Caching service dependencies...
# <i>source /etc/profile</i>
</pre>
<p>
Congratulations! You are now inside your own Gentoo Linux environment.
Of course it is far from finished, which is why the installation still
has some sections left :-)
</p>
</body>
</subsection>
</section>
<section id="configure_USE">
<title>Configuring the USE Variable</title>
<subsection>
<title>What is the USE Variable?</title>
<body>
<p>
<c>USE</c> is one of the most powerful variables Gentoo provides to its users.
Several programs can be compiled with or without optional support for certain
items. For instance, some programs can be compiled with gtk-support, or with
qt-support. Others can be compiled with or without SSL support. Some programs
can even be compiled with framebuffer support (svgalib) instead of X11 support
(X-server).
</p>
<p>
Most distributions compile their packages with support for as much as possible,
increasing the size of the programs and startup time, not to mention an enormous
amount of dependencies. With Gentoo you can define what options a package
should be compiled with. This is where <c>USE</c> comes into play.
</p>
<p>
In the <c>USE</c> variable you define keywords which are mapped onto
compile-options. For instance, <e>ssl</e> will compile ssl-support in the
programs that support it. <e>-X</e> will remove X-server support (note the minus
sign in front). <e>gnome gtk -kde -qt</e> will compile your programs with gnome
(and gtk) support, and not with kde (and qt) support, making your system fully
tweaked for GNOME.
</p>
</body>
</subsection>
<subsection>
<title>Modifying the USE Variable</title>
<body>
<warn>
Do not make any modifications to the USE variable yet if you plan to use our
prebuilt packages (GRP set). You can alter the USE variable after having
installed the packages you want. Gremlins are known to attack your system
if you ignore this warning!
</warn>
<p>
The default <c>USE</c> settings are placed in
<path>/etc/make.profile/make.defaults</path>. What you place in
<path>/etc/make.conf</path> is calculated against these defaults settings. If
you add something to the <c>USE</c> setting, it is added to the default list. If
you remove something from the <c>USE</c> setting (by placing a minus sign in
front of it) it is removed from the default list (if it was in the default list
at all). <e>Never</e> alter anything inside the <path>/etc/make.profile</path>
directory; it gets overwritten when you update Portage!
</p>
<p>
A full description on <c>USE</c> can be found in the second part of the Gentoo
Handbook, <uri link="?part=2&chap=2">USE flags</uri>. A full description on
the available USE flags can be found on your system in
<path>/usr/portage/profiles/use.desc</path>.
</p>
<pre caption="Viewing available USE flags">
# <i>less /usr/portage/profiles/use.desc</i>
<comment>(You can scroll using your arrow keys, exit by pressing 'q')</comment>
</pre>
<p>
As an example we show a <c>USE</c> setting for a KDE-based system with DVD, ALSA
and CD Recording support:
</p>
<pre caption="Opening /etc/make.conf">
# <i>nano -w /etc/make.conf</i>
</pre>
<pre caption="USE setting">
USE="-gtk -gnome qt kde dvd alsa cdr"
</pre>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-tools.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.00</version>
<date>2005-02-04</date>
<section>
<title>System Logger</title>
<body>
<p>
The first tool you need to decide on has to provide logging facilities for your
system. Unix and Linux have an excellent history of logging capabilities -- if
you want you can log everything that happens on your system in logfiles. This
happens through the <e>system logger</e>.
</p>
<p>
Gentoo offers several system loggers to choose from. There are <c>sysklogd</c>,
which is the traditional set of system logging daemons, <c>syslog-ng</c>, an
advanced system logger, and <c>metalog</c> which is a highly-configurable
system logger. Others might be available through Portage as well - our number of
available packages increases on a daily basis.
</p>
<p>
If you plan on using <c>sysklogd</c> or <c>syslog-ng</c> you might want to
install <c>logrotate</c> afterwards as those system loggers don't provide any
rotation mechanism for the log files.
</p>
<!--
Even though syslog-ng does not rotate the logs, it does conform to the syslog
RFC (http://www.faqs.org/rfcs/rfc3164.html) and is far more powerful than most other system loggers. That and some architectures really prefer syslog-ng
above others (metalog for instance doesn't work nicely with sparc all the
time).
-->
<p>
To install the system logger of your choice, <c>emerge</c> it and have it added
to the default runlevel using <c>rc-update</c>. The following example installs
<c>syslog-ng</c>. Of course substitute with your system logger:
</p>
<pre caption="Installing a system logger">
# <i>emerge syslog-ng</i>
# <i>rc-update add syslog-ng default</i>
</pre>
</body>
</section>
<section>
<title>Optional: Cron Daemon</title>
<body>
<p>
Next is the cron daemon. Although it is optional and not required for your
system, it is wise to install one. But what is a cron daemon? A cron daemon
executes scheduled commands. It is very handy if you need to execute some
command regularly (for instance daily, weekly or monthly).
</p>
<p>
We only provide <c>vixie-cron</c> for networkless installations. If you want
another cron daemon you can wait and install it later on.
</p>
<pre caption="Installing a cron daemon">
# <i>emerge vixie-cron</i>
# <i>rc-update add vixie-cron default</i>
</pre>
</body>
</section>
<section>
<title>Optional: File Indexing</title>
<body>
<p>
If you want to index your system's files so you are able to quickly
locate them using the <c>locate</c> tool, you need to install
<c>sys-apps/slocate</c>.
</p>
<pre caption="Installing slocate">
# <i>emerge slocate</i>
</pre>
</body>
</section>
<section>
<title>File System Tools</title>
<body>
<p>
Depending on what file systems you are using, you need to install the necessary
file system utilities (for checking the filesystem integrity, creating
additional file systems etc.).
</p>
<p>
The following table lists the tools you need to install if you use a certain
file system. Not all filesystems are available for each and every architecture
though.
</p>
<table>
<tr>
<th>File System</th>
<th>Tool</th>
<th>Install Command</th>
</tr>
<tr>
<ti>XFS</ti>
<ti>xfsprogs</ti>
<ti><c>emerge xfsprogs</c></ti>
</tr>
<tr>
<ti>ReiserFS</ti>
<ti>reiserfsprogs</ti>
<ti><c>emerge reiserfsprogs</c></ti>
</tr>
<tr>
<ti>JFS</ti>
<ti>jfsutils</ti>
<ti><c>emerge jfsutils</c></ti>
</tr>
</table>
<p>
If you don't require any additional networking-related tools (such as rp-pppoe
or a dhcp client) continue with <uri link="?part=1&chap=10">Configuring the
Bootloader</uri>.
</p>
</body>
</section>
<section>
<title>Networking Tools</title>
<subsection>
<title>Optional: Installing a DHCP Client</title>
<body>
<p>
If you require Gentoo to automatically obtain an IP address for your network
interface(s), you need to install <c>dhcpcd</c> (or any other DHCP Client)
on your system. If you don't do this now, you might not be able to connect
to the internet after the installation!
</p>
<pre caption="Installing dhcpcd">
# <i>emerge dhcpcd</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Installing a PPPoE Client</title>
<body>
<p>
If you need <c>rp-pppoe</c> to connect to the net, you need to install it.
</p>
<pre caption="Installing rp-pppoe">
# <i>USE="-X" emerge rp-pppoe</i>
</pre>
<p>
The <c>USE="-X"</c> will prohibit xorg-x11 to be installed as a dependency
(<c>rp-pppoe</c> has graphical tools; if you want those enabled, you can
recompile <c>rp-pppoe</c> later on or have xorg-x11 installed now -- which takes a
long time to compile).
</p>
<p>
Now continue with <uri link="?part=1&chap=10">Configuring the
Bootloader</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.4</version>
<date>2005-04-16</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>. For x86, Gentoo Linux provides <uri
link="#grub">GRUB</uri> and <uri link="#lilo">LILO</uri>. But before we
install one of these two bootloaders, we inform you how to configure framebuffer
(assuming you want it of course). With framebuffer you can run the Linux command
line with (limited) graphical features (such as using the nice bootsplash
image Gentoo provides).
</p>
</body>
</subsection>
<subsection>
<title>Optional: Framebuffer</title>
<body>
<p>
<e>If</e> you have configured your kernel with framebuffer support (or you used
<c>genkernel</c>'s default kernel configuration), you can activate it by adding
a <c>vga</c> and/or a <c>video</c> statement to your bootloader configuration
file.
</p>
<p>
First of all you need to know what type of framebuffer device you're using. If
you use a Gentoo patched kernel tree (such as <c>gentoo-sources</c>) you will
have had the possibility of selecting <c>vesafb-tng</c> as the <e>VESA driver
type</e> (which is default for these kernel sources). If this is the case, you
are using <c>vesafb-tng</c> and do not need to set a <c>vga</c> statement.
Otherwise you are using the <c>vesafb</c> driver and need to set the <c>vga</c>
statement.
</p>
<p>
The <c>vga</c> statement controls the resolution and color depth of your
framebuffer screen for <c>vesafb</c>. As stated in
<path>/usr/src/linux/Documentation/fb/vesafb.txt</path> (which gets installed
when you install a kernel source package), you need to pass the VESA number
corresponding to the requested resolution and color depth to it.
</p>
<p>
The following table lists the available resolutions and colordepths and matches
those against the value that you need to pass on to the <c>vga</c> statement.
</p>
<table>
<tr>
<ti></ti>
<th>640x480</th>
<th>800x600</th>
<th>1024x768</th>
<th>1280x1024</th>
</tr>
<tr>
<th>256</th>
<ti>0x301</ti>
<ti>0x303</ti>
<ti>0x305</ti>
<ti>0x307</ti>
</tr>
<tr>
<th>32k</th>
<ti>0x310</ti>
<ti>0x313</ti>
<ti>0x316</ti>
<ti>0x319</ti>
</tr>
<tr>
<th>64k</th>
<ti>0x311</ti>
<ti>0x314</ti>
<ti>0x317</ti>
<ti>0x31A</ti>
</tr>
<tr>
<th>16M</th>
<ti>0x312</ti>
<ti>0x315</ti>
<ti>0x318</ti>
<ti>0x31B</ti>
</tr>
</table>
<p>
The <c>video</c> statement controls framebuffer display options. It needs to be
given the framebuffer driver (<c>vesafb</c> for 2.6 kernels, or <c>vesa</c> for
2.4 kernels) followed by the control statements you wish to enable. All
variables are listed in <path>/usr/src/linux/Documentation/fb/vesafb.txt</path>,
but we'll inform you about three most-used options:
</p>
<table>
<tr>
<th>Control</th>
<th>Description</th>
</tr>
<tr>
<ti>ywrap</ti>
<ti>
Assume that the graphical card can wrap around its memory (i.e. continue at
the beginning when it has approached the end)
</ti>
</tr>
<tr>
<ti>mtrr</ti>
<ti>
Setup MTRR registers
</ti>
</tr>
<tr>
<ti><c>mode</c></ti>
<ti>
(<c>vesafb-tng</c> only)<br/>
Set up the resolution, color depth and refresh rate. For instance,
<c>1024x768-32@85</c> for a resolution of 1024x768, 32 bit color depth and a
refresh rate of 85 Hz.
</ti>
</tr>
</table>
<p>
The result of those two statements could be something like <c>vga=0x318
video=vesafb:mtrr,ywrap</c> or <c>video=vesafb:mtrr,ywrap,1024x768-32@85</c>.
Remember (or write down) this setting; you will need it shortly.
</p>
<p>
Now continue by installing <uri link="#grub">GRUB</uri> <e>or</e> <uri
link="#lilo">LILO</uri>.
</p>
</body>
</subsection>
</section>
<section id="grub">
<title>Default: Using GRUB</title>
<subsection>
<title>Understanding GRUB's terminology</title>
<body>
<p>
The most critical part of understanding GRUB is getting comfortable with
how GRUB refers to hard drives and partitions. Your Linux partition
<path>/dev/hda1</path> will most likely be called <path>(hd0,0)</path> under
GRUB. Notice the parenthesis around the <path>hd0,0</path> - they are required.
</p>
<p>
Hard drives count from zero rather than "a" and partitions start at zero
rather than one. Be aware too that with the hd devices, only hard drives are
counted, not atapi-ide devices such as cdrom players and burners. Also, the
same construct is used with scsi drives. (Normally they get higher numbers
than ide drives except when the bios is configured to boot from scsi devices.)
When you ask the BIOS to boot from a different hard disk (for instance your
primary slave), <e>that</e> harddisk is seen as <path>hd0</path>.
</p>
<p>
Assuming you have a hard drive on <path>/dev/hda</path>, a cdrom player on
<path>/dev/hdb</path>, a burner on <path>/dev/hdc</path>, a second hard drive
on <path>/dev/hdd</path> and no SCSI hard drive, <path>/dev/hdd7</path> gets
translated to <path>(hd1,6)</path>. It might sound tricky and tricky it is
indeed, but as we will see, GRUB offers a tab completion mechanism
that comes handy for those of you having a lot of hard drives and
partitions and who are a little lost in the GRUB numbering scheme.
</p>
<p>
Having gotten the feel for that, it is time to install GRUB.
</p>
</body>
</subsection>
<subsection>
<title>Installing GRUB</title>
<body>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2005.1/hb-install-x86-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-08-02</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI or SATA drives, then your
first hard drive would be <path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On x86 systems,
these are called <e>partitions</e>.
</p>
<p>
Partitions are divided in three types:
<e>primary</e>, <e>extended</e> and <e>logical</e>.
</p>
<p>
A <e>primary</e> partition is a partition which has its information stored in
the MBR (master boot record). As an MBR is very small (512 bytes) only four
primary partitions can be defined (for instance, <path>/dev/hda1</path> to
<path>/dev/hda4</path>).
</p>
<p>
An <e>extended</e> partition is a special primary partition (meaning the
extended partition must be one of the four possible primary partitions) which
contains more partitions. Such a partition didn't exist originally, but as
four partitions were too few, it was brought to life to extend the formatting
scheme without losing backward compatibility.
</p>
<p>
A <e>logical</e> partition is a partition inside the extended partition. Their
definitions aren't placed inside the MBR, but are declared inside the extended
partition.
</p>
</body>
</subsection>
<subsection>
<title>Advanced Storage</title>
<body>
<p>
The x86 Installation CDs provide support for EVMS and LVM2. EVMS and LVM2
increase the flexibility offered by your partitioning setup. During the
installation instructions, we will focus on "regular" partitions, but it is
still good to know EVMS and LVM2 are supported as well.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>ext2</ti>
<ti>32M</ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>ext3</ti>
<ti>Rest of the disk</ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
If you are interested in knowing how big a partition should be, or even how
many partitions you need, read on. Otherwise continue now with partitioning
your disk by reading <uri link="#fdisk">Using fdisk to Partition your
Disk</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
<p>
As an example partitioning, we show you one for a 20GB disk, used as a
demonstration laptop (containing webserver, mailserver, gnome, ...):
</p>
<pre caption="Filesystem usage example">
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.9</version>
<date>2005-07-04</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then make a
symlink to <path>/etc/localtime</path> using <c>ln</c>:
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For x86-based systems, our main supported kernel is named
<c>gentoo-sources</c>. This kernel is based on the official Linux sources, but
has security, stability, compatibility and bug fixes applied on top.
Alternatively, the plain and unpatched Linux sources are supplied through the
<c>vanilla-sources</c> package.
</p>
<p>
Both kernel sources are based on the official 2.6 kernel sources. If you
want to install a 2.4-based kernel, you will need to install Gentoo with a
working Internet connection as we do not supply these sources on our
Installation CD.
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>.
</p>
<pre caption="Installing a kernel source">
# <i>emerge gentoo-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. We will assume the kernel
source installed is <c>gentoo-sources-2.6.11-r3</c>:
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.11-gentoo-r3
</pre>
<p>
If the symlink doesn't point to the kernel source of your choice (note that
<c>linux-2.6.11-gentoo-r3</c> is merely an example) you should change it to the
right kernel:
</p>
<pre caption="Changing the kernel source symlink">
# <i>rm /usr/src/linux</i>
# <i>cd /usr/src</i>
# <i>ln -s linux-2.6.11-gentoo-r3 linux</i>
</pre>
<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
Make sure that every driver that is vital to the booting of your system (such as
SCSI controller, ...) is compiled <e>in</e> the kernel and not as a module,
otherwise your system will not be able to boot completely.
</p>
<p>
Now select the correct processor family:
</p>
<pre caption="General Support and processor family">
General setup --->
[*] Support for hot-pluggable devices
Processor type and features --->
Subarchitecture Type (PC-compatible) --->
<comment>(Change according to your system)</comment>
(<i>Athlon/Duron/K7</i>) Processor family
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>/proc file system</c> and
<c>Virtual memory</c>. Do <e>not</e> select the <c>/dev file system</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
<*> /proc file system support
< > /dev file system support (OBSOLETE)
<*> Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
Do not forget to enable DMA for your drives:
</p>
1.1 xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<sections>
<version>4.2</version>
<date>2005-05-23</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>i486 or later</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- General description, propagated to other architectures as well -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
stage file is a tarball (compressed archive) that contains a minimal
environment.
</p>
<ul>
<li>
A stage1 file contains nothing more than a compiler, Portage (Gentoo's
software management system) and a couple of packages on which the
compiler or Portage depends.
</li>
<li>
A stage2 file contains a so-called bootstrapped system, a minimal
environment from which one can start building all other necessary
applications that make a Gentoo environment complete.
</li>
<li>
A stage3 file contains a prebuilt minimal system which is almost fully
deployable. It only lacks a few applications where you, the Gentoo user,
needs to choose which one you want to install.
</li>
</ul>
<p>
We will opt for a stage3 installation throughout this document. If you want to
perform a Gentoo installation using the stage1 or stage2 files, please use the
installation instructions in the <uri
link="/doc/en/handbook/handbook-x86.xml">Gentoo Handbook</uri>. They do
require a working Internet connection though.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is no Installation CD but an additional
resource that you can exploit during the installation of your Gentoo system. It
contains prebuilt packages (the so-called GRP set) that allows you to easily
and quickly install additional applications (such as OpenOffice.org, KDE,
GNOME, ...) immediately after the Gentoo installation and right before you
update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CDs (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
the <path>releases/x86/2005.0/installcd</path> directory;
the Package CDs are located in the <path>releases/x86/2005.0/packagecd</path>
directory.
</p>
<p>
i686, athlon-xp, pentium3 and pentium4 Package CDs are available via
<uri link="http://torrents.gentoo.org">BitTorrent</uri>.
</p>
<p>
Inside those directories you'll find so-called ISO-files. Those are full CD
images which you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
1.1 xml/htdocs/doc/en/handbook/2005.1/index.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/index.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/index.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: index.xml
===================================================================
<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/index.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
<guide link="index.xml">
<title>Gentoo 2005.0 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<abstract>
The Gentoo 2005.0 Handbook contains the networkless installation instructions
for the 2005.0 release and parts on working with Gentoo and Portage.
</abstract>
<license/>
<version>4.2</version>
<date>2005-07-26</date>
<chapter>
<title>The Gentoo Linux 2005.0 Handbooks</title>
<!-- Uncomment when needed, probably for the 2005.0 versions -->
<!--
<section>
<title>Available languages</title>
<body>
<p>
The Gentoo Linux 2005.0 Handbook is available in the following languages:
</p>
<p>
<uri link="/doc/da/handbook">Danish</uri> |
<uri link="/doc/de/handbook">German</uri> |
<uri link="/doc/en/handbook">English</uri> |
<uri link="/doc/fr/handbook">French</uri> |
<uri link="/doc/id/handbook">Indonesian</uri> |
<uri link="/doc/it/handbook">Italian</uri> |
<uri link="/doc/ja/handbook">Japanese</uri> |
<uri link="/doc/pl/handbook">Polish</uri> |
<uri link="/doc/ro/handbook">Romanian</uri> |
<uri link="/doc/es/handbook">Spanish</uri> |
<uri link="/doc/zh_tw/handbook">Traditional Chinese</uri>
</p>
</body>
</section>
-->
<section>
<title>Introduction</title>
<body>
<p>
Welcome to the Gentoo Linux 2005.0 Handbooks. These handbooks are released
together with the Gentoo Linux releases and contain the necessary installation
instructions to install Gentoo Linux 2005.0 <brite>without an internet
connection.</brite>
</p>
<p>
However, if you want to install Gentoo Linux using the latest versions of all
available packages, please use the Installation Instructions in the <uri
link="/doc/en/handbook/index.xml">Gentoo Linux Handbook</uri> for your
architecture.
</p>
</body>
</section>
</chapter>
<chapter>
<title>View the Handbook</title>
<section>
<body>
<table>
<tr>
<th>Format</th>
<th>Description</th>
<th>Links</th>
</tr>
<tr>
<ti>HTML</ti>
<ti>One page per chapter, perfect for online viewing</ti>
<ti>
<uri link="handbook-x86.xml">x86</uri>,
<uri link="handbook-sparc.xml">sparc</uri>,
<uri link="handbook-alpha.xml">alpha</uri>,
<uri link="handbook-amd64.xml">amd64</uri>,
<uri link="handbook-ppc.xml">ppc</uri>
<!-- <uri link="handbook-hppa.xml">hppa</uri> -->
</ti>
</tr>
<tr>
<ti>HTML</ti>
<ti>All in one page</ti>
<ti>
<uri link="handbook-x86.xml?full=1">x86</uri>,
<uri link="handbook-sparc.xml?full=1">sparc</uri>,
<uri link="handbook-alpha.xml?full=1">alpha</uri>,
<uri link="handbook-amd64.xml?full=1">amd64</uri>,
<uri link="handbook-ppc.xml?full=1">ppc</uri>
<!-- <uri link="handbook-hppa.xml?full=1">hppa</uri> -->
</ti>
</tr>
<tr>
<ti>HTML</ti>
<ti>All in one page, printable version</ti>
<ti>
<uri link="handbook-x86.xml?style=printable&full=1">x86</uri>,
<uri link="handbook-sparc.xml?style=printable&full=1">sparc</uri>,
<uri link="handbook-alpha.xml?style=printable&full=1">alpha</uri>,
<uri link="handbook-amd64.xml?style=printable&full=1">amd64</uri>,
<uri link="handbook-ppc.xml?style=printable&full=1">ppc</uri>
<!-- <uri link="handbook-hppa.xml?style=printable&full=1">hppa</uri> -->
</ti>
</tr>
</table>
</body>
</section>
</chapter>
</guide>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-08-08 13:24 swift
0 siblings, 0 replies; 25+ messages in thread
From: swift @ 2005-08-08 13:24 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/08/08 13:24:47
Modified: xml/htdocs/doc/en/handbook/2005.1 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-sparc.xml
handbook-x86.xml hb-install-about.xml
hb-install-alpha-bootloader.xml
hb-install-alpha-disk.xml
hb-install-alpha-kernel.xml
hb-install-alpha-medium.xml
hb-install-amd64-bootloader.xml
hb-install-amd64-disk.xml
hb-install-amd64-kernel.xml
hb-install-amd64-medium.xml hb-install-config.xml
hb-install-finalise.xml
hb-install-hppa-bootloader.xml
hb-install-hppa-disk.xml hb-install-hppa-kernel.xml
hb-install-hppa-medium.xml hb-install-network.xml
hb-install-next.xml hb-install-ppc-bootloader.xml
hb-install-ppc-disk.xml hb-install-ppc-kernel.xml
hb-install-ppc-medium.xml
hb-install-sparc-bootloader.xml
hb-install-sparc-disk.xml
hb-install-sparc-kernel.xml
hb-install-sparc-medium.xml hb-install-stage.xml
hb-install-system.xml hb-install-tools.xml
hb-install-x86-bootloader.xml
hb-install-x86-disk.xml hb-install-x86-kernel.xml
hb-install-x86-medium.xml index.xml
Log:
Upgrading to 2005.1. This is the big one, translators!
Revision Changes Path
1.2 +21 -21 xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-alpha.xml 8 Aug 2005 13:16:09 -0000 1.1
+++ handbook-alpha.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -1,10 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v 1.1 2005/08/08 13:16:09 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<book link="handbook-alpha.xml">
-<title>Gentoo Linux 2005.0 Alpha Handbook</title>
+<title>Gentoo Linux 2005.1 Alpha Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
@@ -117,8 +117,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
-<date>2005-06-09</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<part>
<title>Installing Gentoo</title>
@@ -250,7 +250,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -259,7 +259,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -268,7 +268,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -278,7 +278,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -288,7 +288,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -305,7 +305,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -314,7 +314,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -325,7 +325,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -334,7 +334,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -344,7 +344,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -354,7 +354,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -368,7 +368,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -377,7 +377,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -386,7 +386,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -394,7 +394,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -402,7 +402,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -410,7 +410,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +21 -21 xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-amd64.xml 8 Aug 2005 13:16:09 -0000 1.1
+++ handbook-amd64.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -1,10 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v 1.1 2005/08/08 13:16:09 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<book link="handbook-amd64.xml">
-<title>Gentoo Linux 2005.0 AMD64 Handbook</title>
+<title>Gentoo Linux 2005.1 AMD64 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
@@ -117,8 +117,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
-<date>2005-06-09</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<part>
<title>Installing Gentoo</title>
@@ -249,7 +249,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -258,7 +258,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -267,7 +267,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -277,7 +277,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -287,7 +287,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -304,7 +304,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -313,7 +313,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -324,7 +324,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -333,7 +333,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -343,7 +343,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -353,7 +353,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -367,7 +367,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -376,7 +376,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -385,7 +385,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -393,7 +393,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -401,7 +401,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -409,7 +409,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +21 -21 xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-hppa.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ handbook-hppa.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -1,10 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<book link="handbook-hppa.xml">
-<title>Gentoo Linux 2005.0 HPPA Handbook</title>
+<title>Gentoo Linux 2005.1 HPPA Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
@@ -117,8 +117,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
-<date>2005-06-09</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<part>
<title>Installing Gentoo</title>
@@ -249,7 +249,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -258,7 +258,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -267,7 +267,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -277,7 +277,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -287,7 +287,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -304,7 +304,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -313,7 +313,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -324,7 +324,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -333,7 +333,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -343,7 +343,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -353,7 +353,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -367,7 +367,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -376,7 +376,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -385,7 +385,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -393,7 +393,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -401,7 +401,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -409,7 +409,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +21 -21 xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-ppc.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ handbook-ppc.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -1,10 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<book link="handbook-ppc.xml">
-<title>Gentoo Linux 2005.0 PPC Handbook</title>
+<title>Gentoo Linux 2005.1 PPC Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
@@ -120,8 +120,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
-<date>2005-06-09</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<part>
<title>Installing Gentoo</title>
@@ -253,7 +253,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -262,7 +262,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -281,7 +281,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -291,7 +291,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -308,7 +308,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -317,7 +317,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -328,7 +328,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -337,7 +337,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -347,7 +347,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -357,7 +357,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -371,7 +371,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -380,7 +380,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -389,7 +389,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -397,7 +397,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -405,7 +405,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -413,7 +413,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +21 -21 xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-sparc.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ handbook-sparc.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -1,10 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<book link="handbook-sparc.xml">
-<title>Gentoo Linux 2005.0 SPARC Handbook</title>
+<title>Gentoo Linux 2005.1 SPARC Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
@@ -117,8 +117,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
-<date>2005-06-09</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<part>
<title>Installing Gentoo</title>
@@ -249,7 +249,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -258,7 +258,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -267,7 +267,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -277,7 +277,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -287,7 +287,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -304,7 +304,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -313,7 +313,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -324,7 +324,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -333,7 +333,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -343,7 +343,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -353,7 +353,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -367,7 +367,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -376,7 +376,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -385,7 +385,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -393,7 +393,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -401,7 +401,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -409,7 +409,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +21 -21 xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-x86.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ handbook-x86.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -1,10 +1,10 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<book link="handbook-x86.xml">
-<title>Gentoo Linux 2005.0 x86 Handbook</title>
+<title>Gentoo Linux 2005.1 x86 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
@@ -117,8 +117,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
-<date>2005-06-09</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<part>
<title>Installing Gentoo</title>
@@ -249,7 +249,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -258,7 +258,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -267,7 +267,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -277,7 +277,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -287,7 +287,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -304,7 +304,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -313,7 +313,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -324,7 +324,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -333,7 +333,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -343,7 +343,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -353,7 +353,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -367,7 +367,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -376,7 +376,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -385,7 +385,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -393,7 +393,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -401,7 +401,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -409,7 +409,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +4 -4 xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-about.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-about.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-about.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -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.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-about.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.1</version>
-<date>2005-03-28</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Introduction</title>
@@ -264,7 +264,7 @@
<ul>
<li>
The <b>x86</b> architecture (x86, athlon-xp, pentium3, pentium4)
- Note: The x86 packages (packages-x86-2005.0.iso) are available on
+ Note: The x86 packages (packages-x86-2005.1.iso) are available on
our mirrors, while pentium3, pentium4 and athlon-xp are only available
via bittorrent.
</li>
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-alpha-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-alpha-bootloader.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-alpha-bootloader.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-bootloader.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.1</version>
-<date>2005-03-29</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Making your Choice</title>
1.2 +4 -4 xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-disk.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-disk.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-disk.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-alpha-disk.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-disk.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-alpha-disk.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-alpha-disk.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -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/2005.1/hb-install-alpha-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-disk.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-08-02</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Introduction to Block Devices</title>
@@ -661,7 +661,7 @@
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
-adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
+adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-alpha-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-alpha-kernel.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-alpha-kernel.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.6</version>
-<date>2005-07-04</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Timezone</title>
1.2 +5 -5 xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-alpha-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-alpha-medium.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-alpha-medium.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.3</version>
-<date>2005-08-01</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Hardware Requirements</title>
@@ -154,8 +154,8 @@
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
-the <path>releases/alpha/2005.0/installcd</path> directory;
-the Package CD is located in the <path>releases/alpha/2005.0/packagecd</path>
+the <path>releases/alpha/2005.1/installcd</path> directory;
+the Package CD is located in the <path>releases/alpha/2005.1/packagecd</path>
directory.
</p>
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-amd64-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-amd64-bootloader.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-amd64-bootloader.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-bootloader.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.6</version>
-<date>2005-06-10</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Making your Choice</title>
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-disk.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-disk.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-disk.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-amd64-disk.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-disk.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-amd64-disk.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-amd64-disk.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -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/2005.1/hb-install-amd64-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-disk.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-08-02</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Introduction to Block Devices</title>
1.2 +21 -18 xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-amd64-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-amd64-kernel.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-amd64-kernel.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.8</version>
-<date>2005-07-04</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Timezone</title>
@@ -53,17 +53,8 @@
Choose your kernel source and install it using <c>emerge</c>.
</p>
-<note>
-Running <c>emerge gentoo-sources</c> will fail due to a bug with the Universal
-Installation CD. Please make sure you run <c>emerge
-=gentoo-sources-2.6.11-r1</c> instead. This has no further effect on your
-environment as Portage will automatically download a more recent kernel source
-when updating your system (after the installation).
-</note>
-
<pre caption="Installing a kernel source">
-# <i>echo "=sys-kernel/gentoo-sources-2.6.11-r1 ~amd64" >> /etc/portage/package.keywords</i>
-# <i>emerge =gentoo-sources-2.6.11-r1</i>
+# <i>emerge gentoo-sources</i>
</pre>
<p>
@@ -73,7 +64,7 @@
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
-lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.11-gentoo-r1
+lrwxrwxrwx 1 root root 12 Jul 28 11:04 /usr/src/linux -> linux-2.6.12-gentoo-r6
</pre>
<p>
@@ -84,7 +75,7 @@
<pre caption="Changing the kernel source symlink">
# <i>rm /usr/src/linux</i>
# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.11-gentoo-r1 linux</i>
+# <i>ln -s linux-2.6.12-gentoo-r6 linux</i>
</pre>
<p>
@@ -163,10 +154,22 @@
</pre>
<p>
+Then we select the exact processor type.
+</p>
+
+<pre caption="Selecting processor type and features">
+Processor type and features --->
+ Processor family (AMD-Opteron/Athlon64) --->
+ ( ) AMD-Opteron/Athlon64
+ ( ) Intel EM64T
+ ( ) Generic-x86-64"
+</pre>
+
+<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
-file system</c>. Do <e>not</e> select <c>/dev file system</c> since 2005.0/AMD64
+file system</c>. Do <e>not</e> select <c>/dev file system</c> since 2005.1/AMD64
uses <c>udev</c> by default.
</p>
@@ -258,7 +261,7 @@
</p>
<pre caption="Installing the kernel">
-# <i>cp arch/x86_64/boot/bzImage /boot/kernel-2.6.11-gentoo-r1</i>
+# <i>cp arch/x86_64/boot/bzImage /boot/kernel-2.6.12-gentoo-r6</i>
</pre>
<p>
@@ -267,7 +270,7 @@
</p>
<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.11-gentoo-r1</i>
+# <i>cp .config /boot/config-2.6.12-gentoo-r6</i>
</pre>
<p>
1.2 +14 -24 xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-amd64-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-amd64-medium.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-amd64-medium.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -2,14 +2,14 @@
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.21</version>
-<date>2005-05-06</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Hardware Requirements</title>
@@ -47,11 +47,6 @@
</tr>
</table>
-<note>
-* Intel processors with EM64T extensions <e>might</e> work as well, but are
-untested.
-</note>
-
<p>
You should check the <uri link="http://amd64.gentoo.org">Gentoo
AMD64 Project Page</uri> before proceeding.
@@ -159,8 +154,8 @@
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
-the <path>releases/amd64/2005.0/installcd</path> directory;
-the Package CD is located in the <path>releases/amd64/2005.0/packagecd</path>
+the <path>releases/amd64/2005.1/installcd</path> directory;
+the Package CD is located in the <path>releases/amd64/2005.1/packagecd</path>
directory.
</p>
@@ -265,10 +260,6 @@
<ti>gentoo</ti>
<ti>Default kernel with support for K8 CPUs with NUMA</ti>
</tr>
-<tr>
- <ti>gentoo-em64t</ti>
- <ti>Same as gentoo, but compiled for gen. x86-64 with SMP support</ti>
-</tr>
</table>
<p>
@@ -313,15 +304,14 @@
<p>
You will then be greeted with a boot screen and progress bar. If you are
-installing Gentoo on a system with a non-US keyboard, make sure you press F2 to
-switch to verbose mode and follow the prompt. If no selection is made in 10
-seconds, the default (US keyboard) will be accepted and the boot process will
-continue. Once
-the boot process completes, you will be automatically logged in to the
-"Live" Gentoo Linux as "root", the super user. You should
-have a root ("#") prompt on the current console and can also switch
-to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one
-you started on by pressing Alt-F1.
+installing Gentoo on a system with a non-US keyboard, make sure you
+immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
+selection is made in 10 seconds, the default (US keyboard) will be accepted and
+the boot process will continue. Once the boot process completes, you will be
+automatically logged in to the "Live" Gentoo Linux as
+"root", the super user. You should have a root ("#") prompt
+on the current console and can also switch to other consoles by pressing Alt-F2,
+Alt-F3 and Alt-F4. Get back to the one you started on by pressing Alt-F1.
</p>
<p>
1.2 +135 -58 xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-config.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-config.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-config.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -2,14 +2,14 @@
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-config.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-05-23</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Filesystem Information</title>
@@ -181,7 +181,10 @@
</p>
<pre caption="Setting the hostname">
-# <i>echo tux > /etc/hostname</i>
+# <i>nano -w /etc/conf.d/hostname</i>
+
+<comment>(Set the HOSTNAME variable to your hostname)</comment>
+HOSTNAME="<i>tux</i>"
</pre>
<p>
@@ -189,7 +192,10 @@
</p>
<pre caption="Setting the domainname">
-# <i>echo homenetwork > /etc/dnsdomainname</i>
+# <i>nano -w /etc/conf.d/domainname</i>
+
+<comment>(Set the DNSDOMAIN variable to your domain name)</comment>
+DNSDOMAIN="<i>homenetwork</i>"
</pre>
<p>
@@ -198,7 +204,10 @@
</p>
<pre caption="Setting the NIS domainname">
-# <i>echo nis.homenetwork > /etc/nisdomainname</i>
+# <i>nano -w /etc/conf.d/domainname</i>
+
+<comment>(Set the NISDOMAIN variable to your NIS domain name)</comment>
+NISDOMAIN="<i>my-nisdomain</i>"
</pre>
<p>
@@ -217,20 +226,34 @@
<p>
Before you get that "Hey, we've had that already"-feeling, you should remember
-that the networking you set up in the beginning of the gentoo installation was
+that the networking you set up in the beginning of the Gentoo installation was
just for the installation. Right now you are going to configure networking for
your Gentoo system permanently.
</p>
+<note>
+More detailed information about networking, including advanced topics like
+bonding, bridging, 802.11q VLANs or wireless networking is covered in the <uri
+link="?part=4">Gentoo Network Configuration</uri> section.
+</note>
+
<p>
All networking information is gathered in <path>/etc/conf.d/net</path>. It uses
a straightforward yet not intuitive syntax if you don't know how to set up
-networking manually. But don't fear, we'll explain everything :)
+networking manually. But don't fear, we'll explain everything. A fully
+commented example that covers many different configurations is available in
+<path>/etc/conf.d/net.example</path>.
+</p>
+
+<p>
+DHCP is used by default and does not require any further configuration.
</p>
<p>
-First open <path>/etc/conf.d/net</path> with your favorite editor (<c>nano</c>
-is used in this example):
+If you need to configure your network connection either because you need
+specific DHCP options or because you do not use DHCP at all, open
+<path>/etc/conf.d/net</path> with your favorite editor (<c>nano</c> is used in
+this example):
</p>
<pre caption="Opening /etc/conf.d/net for editing">
@@ -238,54 +261,44 @@
</pre>
<p>
-The first variable you'll find is <c>iface_eth0</c>. It uses the following
-syntax:
+You will see the following file:
</p>
-<pre caption="iface_eth0 syntaxis">
-iface_eth0="<i><your ip address></i> broadcast <i><your broadcast address></i> netmask <i><your netmask></i>"
+<pre caption="Default /etc/conf.d/net">
+# This blank configuration will automatically use DHCP for any net.*
+# scripts in /etc/init.d. To create a more complete configuration,
+# please review /etc/conf.d/net.example and save your configuration
+# in /etc/conf.d/net (this file :]!).
</pre>
<p>
-If you use DHCP (automatic IP retrieval), you should just set <c>iface_eth0</c>
-to <c>dhcp</c>. If you use rp-pppoe (e.g. for ADSL), set it to <c>up</c>.
-If you need to set up your network manually and you're
-not familiar with all the above terms, please read the section on <uri
-link="?part=1&chap=3#network_term">Understanding Network
-Terminology</uri> if you haven't done so already.
+To enter your own IP address, netmask and gateway, you need
+to set both <c>config_eth0</c> and <c>routes_eth0</c>:
</p>
+<pre caption="Manually setting IP information for eth0">
+config_eth0=( "192.168.0.2 netmask 255.255.255.0" )
+routes_eth0=( "default gw 192.168.0.1" )
+</pre>
+
<p>
-So let us give three examples; the first one uses DHCP, the second one a static
-IP (192.168.0.2) with netmask 255.255.255.0, broadcast 192.168.0.255 and
-gateway 192.168.0.1 while the third one just activates the interface for
-rp-pppoe usage:
+To use DHCP and add specific DHCP options, define <c>config_eth0</c> and
+<c>dhcp_eth0</c>:
</p>
-<pre caption="Examples for /etc/conf.d/net">
-<comment>(For DHCP)</comment>
-iface_eth0="dhcp"
-<comment># Some network admins require that you use the</comment>
-<comment># hostname and domainname provided by the DHCP server.</comment>
-<comment># In that case, add the following to let dhcpcd use them.</comment>
-<comment># That will override your own hostname and domainname definitions.</comment>
-dhcpcd_eth0="-HD"
-<comment># If you intend on using NTP to keep your machine clock synchronized, use</comment>
-<comment># the -N option to prevent dhcpcd from overwriting your /etc/ntp.conf file</comment>
-dhcpcd_eth0="-N"
-
-<comment>(For static IP)</comment>
-iface_eth0="192.168.0.2 broadcast 192.168.0.255 netmask 255.255.255.0"
-gateway="eth0/192.168.0.1"
-
-<comment>(For rp-pppoe)</comment>
-iface_eth0="up"
+<pre caption="Automatically obtaining an IP address for eth0">
+config_eth0=( "dhcp" )
+dhcp_eth0="nodns nontp nonis"
</pre>
<p>
-If you have several network interfaces, create extra <c>iface_eth</c> variables,
-like <c>iface_eth1</c>, <c>iface_eth2</c> etc. The <c>gateway</c> variable
-shouldn't be reproduced as you can only set one gateway per computer.
+Please read <path>/etc/conf.d/net.example</path> for a list of all available
+options.
+</p>
+
+<p>
+If you have several network interfaces repeat the above steps for
+<c>config_eth1</c>, <c>config_eth2</c>, etc.
</p>
<p>
@@ -379,11 +392,12 @@
<p>
PCMCIA-users should first install the <c>pcmcia-cs</c> package. This also
includes users who will be working with a 2.6 kernel (even though they won't be
-using the PCMCIA drivers from this package).
+using the PCMCIA drivers from this package). The <c>USE="-X"</c> is necessary
+to avoid installing xorg-x11 at this moment:
</p>
<pre caption="Installing pcmcia-cs">
-# <i>emerge pcmcia-cs</i>
+# <i>USE="-X" emerge pcmcia-cs</i>
</pre>
<p>
@@ -437,32 +451,95 @@
</pre>
1.2 +4 -4 xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-finalise.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-finalise.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-finalise.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-finalise.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.00</version>
-<date>2005-03-21</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>User Administration</title>
@@ -136,7 +136,7 @@
<p>
Now install the packages you want. The Packages CD contains several prebuilt
-binaries, for instance KDE:
+binaries, for instance KDE (not available for HPPA though):
</p>
<pre caption="Installing KDE">
1.2 +8 -8 xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-hppa-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-hppa-bootloader.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-hppa-bootloader.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-bootloader.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.00</version>
-<date>2004-09-24</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Installing PALO</title>
@@ -22,16 +22,16 @@
</p>
<pre caption = "/etc/palo.conf example">
---commandline=2/vmlinux root=/dev/sdb2 HOME=/
+--commandline=2/kernel-2.6.12.2-pa2 root=/dev/sda4
--recoverykernel=/vmlinux.old
---init-partitioned=/dev/sdb
+--init-partitioned=/dev/sda
</pre>
<p>
The first line tells palo the location of the kernel and which boot
-parameters it must use. <c>2/vmlinux</c> means the kernel named <c>/vmlinux</c>
-resides on the second partition. Beware, the path to the kernel is
-relative to the partition, not to the root of your filesystem.
+parameters it must use. <c>2/kernel-2.6.12.2-pa2</c> means the kernel named
+<c>kernel-2.6.12.2-pa2</c> resides on the second partition. Beware, the path
+to the kernel is relative to the partition, not to the root of your filesystem.
</p>
<p>
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-disk.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-disk.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-disk.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-hppa-disk.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-disk.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-hppa-disk.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-hppa-disk.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -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/2005.1/hb-install-hppa-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-disk.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-08-02</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Introduction to Block Devices</title>
1.2 +15 -15 xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-hppa-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-hppa-kernel.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-hppa-kernel.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.3</version>
-<date>2005-06-09</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Timezone</title>
@@ -61,7 +61,7 @@
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
-lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.10_p11
+lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.12.2-pa2
</pre>
<p>
@@ -72,7 +72,7 @@
<pre caption="Changing the kernel source symlink">
# <i>rm /usr/src/linux</i>
# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.10_p11 linux</i>
+# <i>ln -s linux-2.6.12.2-pa2 linux</i>
</pre>
<p>
@@ -265,12 +265,12 @@
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. In the next example we assume you have configured and
-compiled <c>hppa-sources-2.6.10_p11</c>.
+compiled <c>hppa-sources-2.6.12.2-pa2</c>.
</p>
<pre caption="Installing the kernel">
-# <i>cp vmlinux /boot/kernel-2.6.10_p11</i>
-# <i>cp System.map /boot/System.map-2.6.10_p11</i>
+# <i>cp vmlinux /boot/kernel-2.6.12.2-pa2</i>
+# <i>cp System.map /boot/System.map-2.6.12.2-pa2</i>
</pre>
<p>
@@ -279,7 +279,7 @@
</p>
<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.10_p11</i>
+# <i>cp .config /boot/config-2.6.12.2-pa2</i>
</pre>
<p>
@@ -367,14 +367,14 @@
<p>
Now, let's perform one more step to get our system to be more like the
-Installation CD -- let's emerge <c>hotplug</c>. While the initrd autodetects
-hardware that is needed to boot your system, <c>hotplug</c> autodetects
-everything else. To emerge and enable <c>hotplug</c>, type the following:
+Installation CD -- let's emerge <c>coldplug</c>. While the initrd autodetects
+hardware that is needed to boot your system, <c>coldplug</c> autodetects
+everything else. To emerge and enable <c>coldplug</c>, type the following:
</p>
-<pre caption="Emerging and enabling hotplug">
-# <i>emerge hotplug</i>
-# <i>rc-update add hotplug default</i>
+<pre caption="Emerging and enabling coldplug">
+# <i>emerge coldplug</i>
+# <i>rc-update add coldplug default</i>
</pre>
</body>
1.2 +32 -39 xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-hppa-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-hppa-medium.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-hppa-medium.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-05-24</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Hardware Requirements</title>
@@ -125,19 +125,6 @@
</li>
</ul>
-<p>
-Gentoo also provides a Package CD. This is no Installation CD but an additional
-resource that you can exploit during the installation of your Gentoo system. It
-contains prebuilt packages (the so-called GRP set) that allows you to easily
-and quickly install additional applications (such as OpenOffice.org, KDE,
-GNOME, ...) immediately after the Gentoo installation and right before you
-update your Portage tree.
-</p>
-
-<p>
-The use of the Package CD is covered later in this document.
-</p>
-
</body>
</subsection>
</section>
@@ -149,12 +136,9 @@
<body>
<p>
-You can download the Universal Installation CD (and, if you want to, the
-Packages CD as well) from one of our <uri
+You can download the Universal Installation CD from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
-the <path>releases/hppa/2005.0/installcd</path> directory;
-the Package CD is located in the <path>releases/hppa/2005.0/packagecd</path>
-directory.
+the <path>releases/hppa/2005.1/installcd</path> directory.
</p>
<p>
@@ -302,23 +286,32 @@
Attempting to load IPL.
-Hard booted.
-palo ipl 1.2 root@b180l.da-kot Tue Apr 8 12:43:07 CEST 2003
+HARD Booted.
+palo ipl 1.5 root@hope Sat Apr 23 18:06:47 CEST 2005
Boot image contains:
- 0/vmlinux32 4028015 bytes @ 0x1520000
- 0/ramdisk 834748 bytes @ 0xf800
-Current command line:
-0/vmlinux initrd=initrd.gz TERM=linux console=tty root=/dev/ram0 init=/linuxrc
- 0: 0/vmlinux
- 1: initrd=initrd.gz
- 2: TERM=linux
- 3: console=tty
- 4: root=/dev/ram0
- 5: init=/linuxrc
-
-Edit which field?
-(or 'b' to boot with this command line)?
+ 0/vmlinux32 6241293 bytes @ 0x3904000
+ 0/vmlinux64 8352719 bytes @ 0x3ef8000
+ 0/ramdisk 1007589 bytes @ 0x105800
+
+Information: No console specified on kernel command line. This is normal.
+PALO will choose the console currently used by firmware (serial).Current command line:
+0/vmlinux initrd=initrd TERM=linux root=/dev/ram0 init=/linuxrc cdroot looptype=squashfs loop=/livecd.squashfs hda=scsi console=ttyS0
+ 0: 0/vmlinux
+ 1: initrd=initrd
+ 2: TERM=linux
+ 3: root=/dev/ram0
+ 4: init=/linuxrc
+ 5: cdroot
+ 6: looptype=squashfs
+ 7: loop=/livecd.squashfs
+ 8: hda=scsi
+ 9: console=ttyS0
+
+<#> edit the numbered field
+'b' boot with this command line
+'r' restore command line
+'l' list dir
</pre>
<p>
@@ -334,9 +327,9 @@
disable loading of particular modules.
</p>
-<pre caption="Adding cdcache as boot option">
-(or 'b' to boot with this command line)? <i>5</i>
-init=/linuxrc <i>cdcache</i>
+<pre caption="Adding hdb=scsi as boot option">
+(or 'b' to boot with this command line)? <i>9</i>
+console=ttyS0 <i>hdb=scsi</i>
</pre>
<p>
1.2 +28 -28 xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-network.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-network.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-network.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-network.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.1</version>
-<date>2005-07-28</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Do you need Networking?</title>
@@ -106,19 +106,19 @@
</body>
</subsection>
<subsection>
-<title>Optional: Configure Proxy</title>
+<title>Optional: Configure any Proxies</title>
<body>
<p>
If you access the Internet through a proxy, you might need to set up proxy
information during the installation. It is very easy to define a proxy: you just
-need to define a variable which contains the proxy server information.
+need to define a variable which contains the proxy server information.
</p>
<p>
In most cases, you can just define the variables using the server hostname. As
-an example, we assume the proxy is called <e>proxy.gentoo.org</e> and the port
-is 8080.
+an example, we assume the proxy is called <c>proxy.gentoo.org</c> and the port
+is <c>8080</c>.
</p>
<pre caption="Defining proxy servers">
@@ -147,9 +147,9 @@
<p>
You may want to try pinging your ISP's DNS server (found in
-<path>/etc/resolv.conf</path>) and a Web site of choice, just to make sure
+<path>/etc/resolv.conf</path>) and a Web site of your choice, just to make sure
that your packets are reaching the net, DNS name resolution is working
-correctly, etc..
+correctly, etc.
</p>
<pre caption="Further network testing">
@@ -157,9 +157,9 @@
</pre>
<p>
-Are you able to use your network? If so, you can skip the rest of this
+If you are now able to use your network, you can skip the rest of this
section and continue with <uri link="?part=1&chap=4">Preparing the
-Disks</uri>. If not, bad luck, you'll have to work on it a bit more.
+Disks</uri>. If not, read on.
</p>
</body>
@@ -178,7 +178,7 @@
<p>
If your installation medium does not contain any of these tools or your network
-doesn't function yet, continue with <uri link="#doc_chap4">Manual Network
+doesn't function yet, continue with <uri link="#doc_chap3">Manual Network
Configuration</uri>.
</p>
@@ -193,7 +193,7 @@
</li>
<li>
PPTP users should continue with <uri link="#pptp">Alternative:
- Using PPTP</uri> (x86 only)
+ Using PPTP</uri>
</li>
</ul>
@@ -222,7 +222,7 @@
</p>
<p>
-If your network still doesn't work, continue with <uri link="#doc_chap4">Manual
+If your network still doesn't work, continue with <uri link="#doc_chap3">Manual
Network Configuration</uri>.
</p>
@@ -238,7 +238,7 @@
version) has made things easy for you by including <c>rp-pppoe</c>. Use the
provided <c>adsl-setup</c> script to configure your connection. You will be
prompted for the ethernet device that is connected to your adsl modem, your
-username and password, the IPs of your DNS servers and if you need a basic
+username and password, the IPs of your DNS servers and if you need a basic
firewall or not.
</p>
@@ -253,7 +253,7 @@
<path>/etc/ppp/chap-secrets</path> and make sure you are using the right
ethernet device. If your ethernet device doesn't exist, you will have to load
the appropriate network modules. In that case you should continue with
-<uri link="#doc_chap4">Manual Network Configuration</uri> as we explain how to
+<uri link="#doc_chap3">Manual Network Configuration</uri> as we explain how to
load the appropriate network modules there.
</p>
@@ -269,7 +269,7 @@
<body>
<note>
-PPTP is only available for the x86 architecture.
+PPTP support is only available for x86
</note>
<p>
@@ -323,7 +323,7 @@
<p>
If <c>net-setup</c> or <c>adsl-setup</c> failed, then it is possible that
-your networkcard wasn't found immediately. This means you may have to load
+your network card wasn't found immediately. This means you may have to load
the appropriate kernel modules manually.
</p>
@@ -443,9 +443,9 @@
<note>
Support for the <c>iwconfig</c> command is only available on x86, amd64 and ppc
-Installation CDs. You can still get the extensions working otherwise by
-following the instructions of the <uri
-link="ftp://ftp.linux-wlan.org/pub/linux-wlan-ng/README">linux-wlan-ng
+Installation CDs. You can still get the extensions working otherwise
+by following the instructions of the
+<uri link="ftp://ftp.linux-wlan.org/pub/linux-wlan-ng/README">linux-wlan-ng
project</uri>.
</note>
@@ -514,10 +514,10 @@
</note>
<p>
-If all above fails, you will have to configure your network manually.
-Have no fear, it is far from difficult. But we are going to explain a
-certain amount of networking to you as you will need it to be able to
-configure your network to your satisfaction. When you're done reading this, you
+If all of the above fails, you will have to configure your network manually.
+This is not difficult at all. However, you need to be familiar with some
+network terminology, as you will need it to be able to
+configure your network to your satisfaction. After reading this, you
will know what a <e>gateway</e> is, what a <e>netmask</e> serves for,
how a <e>broadcast</e> address is formed and why you need
<e>nameservers</e>.
@@ -540,9 +540,9 @@
<p>
Such an IP address is unique to a host as far as all accessible networks are
-concerned (i.e. all hosts that you are able to reach must have unique IP
-addresses). To be able to make a distinction between hosts inside a network,
-and hosts outside a network, the IP address is divided in two parts: the
+concerned (i.e. every host that you are able to reach must have a unique IP
+address). In order to distinguish between hosts inside and outside a
+network, the IP address is divided in two parts: the
<e>network</e> part and the <e>host</e> part.
</p>
1.2 +5 -16 xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-next.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-next.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-next.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-next.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-06-09</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Documentation</title>
@@ -73,7 +73,7 @@
</body>
</section>
<section>
-<title>Gentoo Changes since 2005.0</title>
+<title>Gentoo Changes since 2005.1</title>
<subsection>
<title>Changes?</title>
<body>
@@ -86,20 +86,9 @@
</p>
<p>
-The following changes need to happen right after having updated your system (and
-before rebooting):
+There have been no significant changes since.
</p>
-<ul>
- <li>
- The <c>baselayout</c> package has received major updates, including on the
- <uri link="?part=4">Gentoo Network Configuration</uri> aspect. The changes
- include a new syntax for the <path>/etc/conf.d/net</path> file although the
- old syntax is still supported. You are advised to change to the new one in
- time.
- </li>
-</ul>
-
</body>
</subsection>
</section>
1.2 +197 -53 xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-ppc-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-ppc-bootloader.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-ppc-bootloader.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,33 +4,31 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-bootloader.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.00</version>
-<date>2005-03-19</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
-<title>Making your Choice</title>
+<title>Choosing a Bootloader</title>
<subsection>
<title>Introduction</title>
<body>
<p>
-Now that your kernel is configured and compiled and the necessary system
-configuration files are filled in correctly, it is time to install a
-program that will fire up your kernel when you start the system. Such a
-program is called a <e>bootloader</e>. But before you start, consider
-your options...
+Now that the kernel is configured and compiled, you'll need a <e>bootloader</e>
+to start your new linux installation. The <e>bootloader</e> that you use will
+depend upon the type of PPC machine you have.
</p>
<p>
-Several bootloaders exist for Linux/PPC. We have <uri link="#yaboot">yaboot</uri>
-(for NewWorld Apple and IBM machines) and <uri link="#bootx">BootX</uri> (for
-OldWorld Apple and IBM machines). The Pegasos does not require a bootloader, but
-we included the <uri link="#bootcreator">BootCreator</uri> for creating a
-SmartFirmware bootmenu.
+If you are using a NewWorld Apple or IBM machine, you need to use
+<uri link="#yaboot">yaboot</uri>. OldWorld Apple machines have two options,
+<uri link="#bootx">BootX</uri> (recommended) and <uri link="#quik">quik</uri>.
+The Pegasos does not require a bootloader, but you will need to emerge
+<uri link="#bootcreator">BootCreator</uri> to create SmartFirmware bootmenus.
</p>
</body>
@@ -47,9 +45,9 @@
</impo>
<p>
-First we have to create the <path>/dev</path> files in our new home, which is
-needed during the bootloader installation. This could be done by "bind"-mapping
-the <path>/dev</path>-filesystem from the Installation CD:
+In order to find the boot devices, yaboot needs access to the <path>/dev</path>
+filesystem. To do this, you will need to "bind-map" the <path>/dev</path>
+filesystem from the Installation CD to <path>/dev</path> inside of the chroot.
</p>
<pre caption="Bind-mounting the /dev-filesystem">
@@ -60,14 +58,35 @@
</pre>
<p>
-There are two ways to configure yaboot for your system. You can use the
-included <c>yabootconfig</c> to automatically set up yaboot. If
-for some reason you do not want to run <c>yabootconfig</c> to
-automatically set up <path>/etc/yaboot.conf</path> or you are installing Gentoo
-on a G5 (on which <c>yabootconfig</c> does not always work), you can just edit
-the sample file already installed on your system.
+To set up yaboot, you can use <c>yabootconfig</c> to automatically create a
+configuration file for you. If you are installing Gentoo on a G5 (where
+<c>yabootconfig</c> does not always work), or you plan to boot from firewire
+or USB, you will need to manually configure yaboot.
</p>
+<note>
+You will need to manually edit the yaboot.conf when using genkernel, even if
+yabootconfig is used. The kernel image section of yaboot.conf should be
+modified as follows:
+</note>
+
+<pre caption="Adding genkernel boot arguments to yaboot.conf">
+<comment>###########################################################
+## This section can be duplicated if you have more than one
+## kernel or set of boot options - replace kernel-2.6.12
+## with the exact filename of your kernel.
+###########################################################</comment>
+image=/boot/kernel-2.6.12
+ label=Linux
+ root=/dev/ram0 <comment># If using genkernel this is /dev/ram0</comment>
+ partition=3
+ append="real_root=/dev/hda3 init=/linuxrc"
+ <comment># You can add additional kernel arguments to append such as
+ # rootdelay=10 for a USB/Firewire Boot</comment>
+ read-only
+<comment>##########################################################</comment>
+</pre>
+
<ul>
<li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li>
<li>
@@ -138,10 +157,10 @@
</pre>
<p>
-Below you find a completed <path>yaboot.conf</path> file. Alter it at
-will. G5 users should be aware that their disks are Serial ATA disks which are
-seen as SCSI disks by the Linux kernel (so substitute <path>/dev/hda</path> with
-<path>/dev/sda</path>).
+An example <path>yaboot.conf</path> file is given below, but you will need to
+alter it to fit your needs. G5 users and users booting from firewire and USB
+should be aware that their disks are seen as SCSI disks by the Linux kernel, so
+you will need to substitute <path>/dev/hda</path> with <path>/dev/sda</path>).
</p>
<pre caption = "/etc/yaboot.conf">
@@ -166,9 +185,21 @@
#ofboot=hd:2
-## hd: is open firmware speak for hda</comment>
+## Users booting from firewire should use something like this line:
+# ofboot=fw/node/sbp-2/disk@0:
+
+## Users booting from USB should use something like this line:
+# ofboot=usb/disk@0:
+
+## hd: is shorthand for the first hard drive OpenFirmware sees</comment>
device=hd:
+<comment>## Firewire and USB users will need to specify the whole OF device name
+## This can be found using ofpath, which is included with yaboot.
+
+# device=fw/node@0001d200e00d0207/sbp-2@c000/disk@0:
+</comment>
+
delay=5
defaultos=macosx
timeout=30
@@ -183,7 +214,7 @@
label=Linux
root=/dev/hda3
partition=3
- sysmap=/boot/System.map-2.6.9
+<comment># append="rootdelay=10" # Required for booting USB/Firewire</comment>
read-only
<comment>##################
@@ -198,17 +229,10 @@
</pre>
<p>
-Once <path>yaboot.conf</path> is set up the way you want it, you run
-<c>mkofboot -v</c> to install the settings in the bootstrap partition. <e>Don't
-forget this!</e> Confirm when <c>mkofboot</c> asks you to create a new
-filesystem.
-</p>
-
-<p>
-If all goes well, and you have the same options as the sample
-above, your next reboot will give you a simple, five-entry boot menu. If you
-update your yaboot config later on, you'll just need to run <c>ybin -v</c> to
-update the bootstrap partition - <c>mkofboot</c> is for initial setup only.
+Once <path>yaboot.conf</path> is configured, run <c>mkofboot -v</c> to format
+the Apple_bootstrap partition and install the settings. If you change
+yaboot.conf after the Apple_bootstrap partition has been created, you can
+update the settings by running <c>ybin -v</c>
</p>
<p>
@@ -226,22 +250,44 @@
<body>
<impo>
-BootX can only be used on OldWorld Apple and IBM systems!
+BootX can only be used on OldWorld Apple systems!
</impo>
<p>
-BootX requires that you reboot first. So, let's reboot shall we :)
+Since BootX boots Linux from within MacOS, the kernel will need to be copied
+from the Linux Partition to the MacOS partition. First, mount the MacOS
+partition from outside of the chroot. Use <c>mac-fdisk -l</c> to find the
+MacOS partition number, sda6 is used as an example here. Once the partition is
+mounted, we'll copy the kernel to the system folder so BootX can find it.
</p>
+<pre caption="Copying the kernel to the MacOS partition">
+# <i>exit</i>
+cdimage ~# <i>mkdir /mnt/mac</i>
+cdimage ~# <i>mount /dev/sda6 /mnt/mac -t hfs</i>
1.2 +27 -28 xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-disk.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-disk.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-disk.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-ppc-disk.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-disk.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-ppc-disk.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-ppc-disk.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -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/2005.1/hb-install-ppc-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-disk.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-08-02</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Introduction to Block Devices</title>
@@ -43,15 +43,14 @@
</body>
</subsection>
<subsection>
-<title>Partitions and Slices</title>
+<title>Partitions</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On most systems,
-these are called <e>partitions</e>. Other architectures use a similar technique,
-called <e>slices</e>.
+these are called <e>partitions</e>.
</p>
</body>
@@ -106,8 +105,8 @@
<ti>Type 0x41</ti>
</tr>
<tr>
- <ti>(Not needed)</ti>
- <ti>(Not needed)</ti>
+ <ti>(Not applicable)</ti>
+ <ti><path>/dev/hda2</path> (If using quik)</ti>
<ti><path>/dev/hda1</path></ti>
<ti>(Not needed)</ti>
<ti>ext2</ti>
@@ -116,7 +115,7 @@
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
- <ti><path>/dev/hda2</path></ti>
+ <ti><path>/dev/hda2</path> (<path>/dev/hda3</path> if using quik)</ti>
<ti><path>/dev/hda2</path></ti>
<ti><path>/dev/sda2</path></ti>
<ti>(swap)</ti>
@@ -125,7 +124,7 @@
</tr>
<tr>
<ti><path>/dev/hda4</path></ti>
- <ti><path>/dev/hda3</path></ti>
+ <ti><path>/dev/hda3</path> (<path>/dev/hda4</path> if using quik)</ti>
<ti><path>/dev/hda3</path></ti>
<ti><path>/dev/sda3</path></ti>
<ti>ext3, xfs</ti>
@@ -135,11 +134,11 @@
</table>
<note>
-There are some partitions named like this: <path>Apple_Driver43,
-Apple_Driver_ATA, Apple_FWDriver, Apple_Driver_IOKit, Apple_Patches</path>. If
-you are not planning to use MacOS 9 you can delete them, because MacOS X and
-Linux don't need them. You might have to use <c>parted</c> in order to delete
-them, as mac-fdisk can't delete them yet.
+There are some partitions named: <path>Apple_Driver63, Apple_Driver_ATA,
+Apple_FWDriver, Apple_Driver_IOKit, Apple_Patches</path>. If you are not
+planning to use MacOS 9 you can delete them, because MacOS X and Linux don't
+need them. To delete them, either use parted or erase the whole disk by
+initialing the partition map.
</note>
<warn>
@@ -152,9 +151,9 @@
<p>
If you are interested in knowing how big a partition should be, or even how many
-partitions you need, read on. Otherwise continue now with <uri
-link="#fdisk">Default: Using mac-fdisk (Apple/IBM) to Partition your Disk</uri>
-or <uri link="#parted">Alternative: Using parted (especially Pegasos) to
+partitions you need, read on. Otherwise continue now with
+<uri link="#mac-fdisk"> Default: Using mac-fdisk (Apple) to Partition your Disk
+</uri> or <uri link="#parted">Alternative: Using parted (IBM/Pegasos) to
Partition your Disk</uri>.
</p>
@@ -212,7 +211,7 @@
</body>
</subsection>
</section>
-<section id="fdisk">
+<section id="mac-fdisk">
<title>Default: Using mac-fdisk (Apple) Partition your Disk</title>
<body>
@@ -372,9 +371,8 @@
<body>
<p>
-Several filesystems are available. ext2, ext3 and XFS are found stable on the
-PPC architecture. jfs is unsupported, ReiserFS still has some problems on ppc
-and is not supported.
+Several filesystems are available. ext2, ext3, ReiserFS and XFS have been found
+stable on the PPC architecture.
</p>
<p>
@@ -393,7 +391,7 @@
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
-adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
+adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
@@ -404,8 +402,7 @@
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
-files and directories containing tens of thousands of files. Unfortunately we still have some
-issues with ReiserFS on ppc. We do not encourage people to use this filesystem.
+files and directories containing tens of thousands of files.
</p>
<p>
@@ -467,9 +464,11 @@
</p>
<note>
-On OldWorld machines and the PegasosII your partition which holds the kernel must
-be ext2 or ext3. NewWorld machines can boot from any of ext2, ext3, XFS,
-ReiserFS or even HFS/HFS+ filesystems.
+On the PegasosII your partition which holds the kernel must be ext2 or ext3.
+NewWorld machines can boot from any of ext2, ext3, XFS, ReiserFS or even
+HFS/HFS+ filesystems. On OldWorld machines booting with BootX, the kernel must
+be placed on an HFS partition, but this will be completed when you configure
+your bootloader.
</note>
</body>
1.2 +118 -49 xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-ppc-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-ppc-kernel.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-ppc-kernel.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.9</version>
-<date>2005-07-04</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Timezone</title>
@@ -44,11 +44,10 @@
</p>
<p>
-For PPC you can choose between <c>vanilla-sources</c> and
-<c>gentoo-sources</c> (both 2.6 kernels). The latter is available when you
-perform a networkless installation. Beside those there is a special
-kernel-2.6-patchset for the Pegasos: <c>pegasos-sources</c>. So let's
-continue with <c>emerge</c>'ing the kernel sources:
+We suggest using either <c>vanilla-sources</c> or <c>gentoo-sources</c>
+on PPC, which are both 2.6 kernels. The latter is available when you
+perform a networkless installation. So let's continue with <c>emerge</c>'ing
+the kernel sources:
</p>
<pre caption="Installing a kernel source">
@@ -56,32 +55,31 @@
</pre>
<note>
-The PowerPC sources are based on a 2.6.10-kernel with security patches from
-2.6.11 backported. As the time of the release the 2.6.11 kernel produced
-several problems on different PowerPC machines.
+The suggested sources at the time of the 2005.1 release are
+<c>gentoo-sources-2.6.12-r6</c> and <c>vanilla-sources-2.6.12.2</c>.
</note>
<p>
-When you take a look in <path>/usr/src</path> you should see a symlink called
-<path>linux</path> pointing to your kernel source. We will assume the kernel
-source installed is <c>gentoo-sources-2.6.10-r8</c>:
+If you take a look in <path>/usr/src</path> you should see a symlink named
+<path>linux</path> pointing to your current kernel source. Here, we will assume
+that the kernel source installed is <c>gentoo-sources-2.6.12-r6</c>:
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
-lrwxrwxrwx 1 root root 22 Mar 18 16:23 /usr/src/linux -> linux-2.6.10-gentoo-r8
+lrwxrwxrwx 1 root root 22 Mar 18 16:23 /usr/src/linux -> linux-2.6.12-gentoo-r6
</pre>
<p>
If the symlink doesn't point to the kernel source of your choice (note that
-<c>linux-2.6.10-gentoo-r8</c> is merely an example) you should change it to the
-right kernel:
+<c>linux-2.6.12-gentoo-r6</c> is merely an example) you should change it to the
+desired kernel sources:
</p>
<pre caption="Changing the kernel source symlink">
# <i>rm /usr/src/linux</i>
# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.10-gentoo-r8 linux</i>
+# <i>ln -s linux-2.6.12-gentoo-r6 linux</i>
</pre>
<p>
@@ -122,7 +120,10 @@
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
-uses (it might provide you with a nice hint on what to enable).
+uses (it might provide you with a nice hint on what to enable). Another place
+to look for clues as to what components to enable is to check the kernel
+message logs from the successful boot that got you this far. Type <c>dmesg</c>
+to see the kernel messages.
</p>
<p>
@@ -205,38 +206,80 @@
</p>
<p>
-Disable ADB raw keycodes:
+Users of NewWorld and OldWorld machines will want HFS support as well. OldWorld
+users require it for copying compiled kernels to the MacOS partition. NewWorld
+users require it for configuring the special Apple_Bootstrap partition:
</p>
-<pre caption="Disabling ADB raw keycodes">
-Macintosh Device Drivers --->
- [ ] Support for ADB raw keycodes
+<pre caption="Activating HFS support">
+File Systems --->
+ [*] HFS Support
</pre>
<p>
-Also choose the correct RTC support (<e>disable</e> the <c>Enhanced RTC</c>
-option):
+At this time, kernel preemption is still unstable on PPC and may cause
+compilation failures and random segfaults. It is <e>strongly</e> suggested
+that you do not use this feature.
</p>
-<pre caption="Activating the correct RTC option">
-Character devices --->
- [ ] Enhanced RTC
+<pre caption="Ensure the Preemptible Kernel Option is Off">
+Platform options --->
+ [ ] Preemptible Kernel
+</pre>
+
+<p>
+If you're booting from Firewire, you'll need to enable these options. If you donot want to compile in support, you'll need to include these modules and their
+dependencies in an initrd.
+</p>
-General setup --->
- [*] Support for /dev/rtc
+<pre caption="Enable support for firewire devices on boot">
+Device Drivers --->
+ IEEE 1394 (FireWire) support --->
+ <*> IEEE 1394 (FireWire) support
+ <*> OHCI-1394 support
+ <*> SBP-2 support (Harddisks etc.)
</pre>
<p>
-Users of OldWorld machines will want HFS support so they can copy compiled
-kernels to the MacOS partition. This applies also to NewWorld machines as it is
-needed for the special Apple_Bootstrap partition:
+If you're booting from USB, you'll need to enable these options. If you do not
+want to compile in support, you'll need to include these modules and their
+dependencies in an initrd.
</p>
-<pre caption="Activating HFS support">
-File Systems --->
- [*] HFS Support
+<pre caption="Enable support for USB devices on boot">
+Device Drivers --->
+ USB support --->
+ <*> Support for Host-side USB
+ <*> OHCI HCD support
+ <*> USB Mass Storage support
+</pre>
+
+<p>
+Do not turn off kernel framebuffer support as it is required for a successful
+boot. If you are using an NVIDIA based chipset, you should use the OpenFirmware
+framebuffer. If you are using an ATI based chipset, you should select the
+framebuffer driver based upon your chipset (Mach64, Rage128 or Radeon).
+</p>
+
+<pre caption="Chosing a Framebuffer Driver">
+Device Drivers --->
+ Graphics support --->
+ <*> Support for frame buffer devices
+ [*] Open Firmware frame buffer device support
+ <*> ATI Radeon display support
+ <*> ATI Rage128 display support
+ <*> ATI Mach64 display support
+ Console display driver support --->
+ <*> Framebuffer Console support
</pre>
+<note>
+If you select more than one framebuffer device, it may default to a less than
+optimal driver. Either use only one framebuffer device or specify which
+to use by passing the driver to use to the kernel on boot such as
+<c>video=radeonfb</c>.
+</note>
+
<p>
When you're done configuring your kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
@@ -254,7 +297,7 @@
</p>
<pre caption="Compiling the kernel">
-# <i>make all && make modules_install</i>
+# <i>make && make modules_install</i>
</pre>
1.2 +79 -34 xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-ppc-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-ppc-medium.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-ppc-medium.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -2,14 +2,14 @@
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.01</version>
-<date>2005-05-06</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Hardware Requirements</title>
@@ -30,16 +30,30 @@
<table>
<tr>
- <th>NewWorld machines</th>
+ <th>Apple NewWorld Machines</th>
<ti>
Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
- PowerBook, Xserver, PowerMac, Genesi's Pegasos II
+ PowerBook, Xserver, PowerMac
</ti>
</tr>
<tr>
- <th>OldWorld machines</th>
+ <th>Apple OldWorld machines</th>
<ti>
- Limited support for IBM (RS/6000, iSeries, pSeries) and Amiga systems
+ Apple Machines with an OpenFirmware revision less than 3, such as the Beige
+ G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also
+ be supported.
+ </ti>
+</tr>
+<tr>
+ <th>Genesi's Pegasos</th>
+ <ti>
+ Pegasos I/II, Open Desktop Workstation
+ </ti>
+</tr>
+<tr>
+ <th>IBM</th>
+ <ti>
+ RS/6000, iSeries, pSeries
</ti>
</tr>
<tr>
@@ -163,9 +177,9 @@
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located
-in the <path>releases/ppc/2005.0/installcd</path> directory;
-the Package CDs are located in the <path>releases/ppc/2005.0/packagecd</path>
-directory.
+in the <path>releases/ppc/2005.1/ppc/installcd</path> directory;
+the Package CDs are located in the
+<path>releases/ppc/2005.1/ppc/packagecd</path> directory.
</p>
<p>
@@ -182,8 +196,8 @@
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
- <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows). How
- to verify MD5 checksums with Mac OS X is described in the <uri
+ <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows).
+ Verifying MD5 checksums with Mac OS X is described in the <uri
link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
</li>
<li>
@@ -231,7 +245,7 @@
</body>
</subsection>
<subsection>
-<title>Default: Booting the Universal Installation CD on an Apple/IBM</title>
+<title>Default: Booting the Installation CD with Yaboot</title>
<body>
<p>
@@ -241,25 +255,6 @@
</p>
<p>
-If you have an OldWorld Mac the bootable portion of the Installation CD can't
-be used. Instead you need to download <uri
-link="http://penguinppc.org/projects/bootx/">BootX</uri> and have a working
-MacOS installed on your system. You need to copy the <c>BootX Extension</c> from
-the unpacked archive-file into the <c>Extensions Folder</c> and make a new
-directory called <c>Linux Kernels</c> in the System Folder. In the next step you
-need to copy the files <c>G3G4</c> and <c>G3G4.igz</c> from the
-Installation CD <path>boot</path> folder into the <c>Linux Kernels</c>
-directory. Then reboot the system and wait for BootX to load. After BootX
-loaded you still have to set up a few items. In the options dialog you need
-to check <c>Use Specified RAM Disk</c> and select the <c>G3G4.igz</c>
-which you put in the <c>Linux Kernels</c> directory. The ramdisk size should
-be set to at least <c>32000</c>.
-Furthermore the kernel argument needs to be set to <c>rw init=/linuxrc
-cdroot</c>. Eventually you are able to boot the Installation CD when you
-select Linux on Startup.
-</p>
-
-<p>
After the Installation CD loaded, you will be greeted by a friendly welcome
message and a <e>boot:</e> prompt at the bottom of the screen.
</p>
@@ -321,7 +316,7 @@
</body>
</subsection>
<subsection>
-<title>Alternative: Booting the Universal Installation CD on a Pegasos</title>
+<title>Alternative: Booting the Installation CD on a Pegasos</title>
<body>
<p>
@@ -337,6 +332,56 @@
</body>
</subsection>
+
+<subsection>
+<title>Alternative: Booting the Installation CD with BootX</title>
+<body>
+
+<p>
+If you have an OldWorld Mac the bootable portion of the livecd can't be used.
+The most simple solution is to use MacOS to bootstrap into a Linux environment
+with a tool called BootX. Boot floppies are being prepared for Macs without
+MacOS, but they are not available at this time.
+</p>
+
+<p>
+First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
+and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
+archive into <c>Extensions Folder</c> and the BootX App Control Panel into
+<c>Control Panels</c>, both of which are located in your MacOS System Folder.
+Next, create a folder called "Linux Kernels" in your System folder and copy the
+<c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c>
+from the Installation CD <path>boot</path> folder into the MacOS
+<c>System Folder</c>.
+</p>
+
+<p>
+To prepare BootX, start the BootX App Control Panel. First select the Options
+dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from
+your System Folder. Continue back to the initial screen and ensure that the
+ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
+shown below:
+</p>
+
+<pre caption="BootX kernel arguments">
+cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev
+</pre>
+
+<note>
+The kernel parameters in the yaboot section above are also applicable here.
+</note>
+
+<p>
+Check once more to make sure the settings are correct and then save the
+configuration. This saves typing just in case it doesn't boot or something is
+missing. Press the Linux button at the top of the window to boot into the
+Installation CD and continue with <uri link="#booted">And When
+You're Booted...</uri>
+</p>
+
+</body>
+</subsection>
+
<subsection id="booted">
<title>And When You're Booted...</title>
<body>
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-sparc-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-sparc-bootloader.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-sparc-bootloader.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-bootloader.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.00</version>
-<date>2005-01-22</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Making your Choice</title>
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-disk.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-disk.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-disk.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-sparc-disk.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-disk.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-sparc-disk.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-sparc-disk.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -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/2005.1/hb-install-sparc-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-disk.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-08-02</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Introduction to Block Devices</title>
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-sparc-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-sparc-kernel.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-sparc-kernel.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-06-02</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Timezone</title>
1.2 +8 -9 xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-sparc-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-sparc-medium.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-sparc-medium.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -2,14 +2,14 @@
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-05-23</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Hardware Requirements</title>
@@ -167,9 +167,9 @@
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
-the <path>releases/sparc/2005.0/installcd/sparc64</path>
+the <path>releases/sparc/2005.1/installcd/sparc64</path>
directory; the Package CDs are located in the
-<path>releases/sparc/2005.0/packagecd/sparc64</path> directory.
+<path>releases/sparc/2005.1/packagecd/sparc64</path> directory.
</p>
<p>
@@ -248,9 +248,8 @@
<p>
You will be greeted by the SILO boot manager (on the Installation CD). Type in
-<c>gentoo-2.4</c> (single-CPU kernel) or <c>gentoo-2.4-smp</c>
-(multi-CPU kernel) and press enter to continue booting the system. In the
-following example we'll boot the <c>gentoo-2.4</c> kernel.
+<c>gentoo-2.4</c> and press enter to continue booting the
+system:
</p>
<pre caption="Continue booting from the Installation CD">
1.2 +10 -8 xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-stage.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-stage.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-05-04</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Installing a Stage Tarball</title>
@@ -100,12 +100,12 @@
<e>Decompress with bzip2</e>, the <c>p</c> for <e>Preserve permissions</e> and
the <c>f</c> to denote that we want to extract a file, not standard input. In
the next example, we extract the stage tarball
-<path>stage3-<subarch>-2005.0.tar.bz2</path>. Be sure to substitute the
+<path>stage3-<subarch>-2005.1.tar.bz2</path>. Be sure to substitute the
tarball filename with your stage.
</p>
<pre caption="Extracting the stage tarball">
-# <i>tar -xvjpf /mnt/cdrom/stages/stage3-<subarch>-2005.0.tar.bz2</i>
+# <i>tar -xvjpf /mnt/cdrom/stages/stage3-<subarch>-2005.1.tar.bz2</i>
</pre>
<p>
@@ -155,7 +155,7 @@
<p>
Pick the <path>releases/</path> directory, followed by your architecture (for
-instance <path>x86/</path>) and the Gentoo version (<path>2005.0/</path>)
+instance <path>x86/</path>) and the Gentoo version (<path>2005.1/</path>)
to finish up with the <path>stages/</path> directory. There you should see all
available stage files for your architecture (they might be stored within
subdirectories named to the individual sub architectures). Select one and
@@ -177,8 +177,8 @@
</p>
<pre caption="Example checking integrity of a stage tarball">
-# <i>md5sum -c stage3-x86-2005.0.tar.bz2.md5</i>
-stage3-x86-2005.0.tar.bz2: OK
+# <i>md5sum -c stage3-x86-2005.1.tar.bz2.md5</i>
+stage3-x86-2005.1.tar.bz2: OK
</pre>
</body>
@@ -368,6 +368,7 @@
<pre caption="The GCC march setting">
<comment># AMD64 users who want to use a native 64 bit system should use -march=k8</comment>
+<comment># EM64T users should use -march=nocona</comment>
-march=athlon-xp
</pre>
@@ -402,6 +403,7 @@
<pre caption="Defining the CFLAGS and CXXFLAGS variable">
CFLAGS="-march=athlon-xp -pipe -O2" <comment># AMD64 users use march=k8</comment>
+ <comment># EM64T users use march=nocona</comment>
CXXFLAGS="${CFLAGS}" <comment># Use the same settings for both variables</comment>
</pre>
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-system.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-system.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-system.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-system.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.00</version>
-<date>2005-01-07</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Chrooting</title>
1.2 +11 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-tools.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-tools.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-tools.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-tools.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.00</version>
-<date>2005-02-04</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>System Logger</title>
@@ -135,6 +135,14 @@
</table>
<p>
+If you are an EVMS user, you need to install <c>emvs</c>:
+</p>
+
+<pre caption="Installing EVMS utilities">
+# <i>emerge evms</i>
+</pre>
+
+<p>
If you don't require any additional networking-related tools (such as rp-pppoe
or a dhcp client) continue with <uri link="?part=1&chap=10">Configuring the
Bootloader</uri>.
1.2 +16 -17 xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-x86-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-x86-bootloader.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-x86-bootloader.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-bootloader.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.4</version>
-<date>2005-04-16</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Making your Choice</title>
@@ -219,7 +219,7 @@
<p>
Now we are going to write up a <path>grub.conf</path>. Below you'll
find two possible <path>grub.conf</path> for the partitioning example we use
-in this guide, with kernel image <path>kernel-2.6.11-gentoo-r3</path>. We've
+in this guide. We've
only extensively commented the first <path>grub.conf</path>. Make sure you use
<e>your</e> kernel image filename and, if appropriate, <e>your</e> initrd image
filename.
@@ -250,10 +250,10 @@
# Comment out if you don't have a graphics card installed</comment>
splashimage=(hd0,0)/grub/splash.xpm.gz
-title=Gentoo Linux 2.6.11-r3
+title=Gentoo Linux 2.6.11-r11
<comment># Partition where the kernel image (or operating system) is located</comment>
root (hd0,0)
-kernel /kernel-2.6.11-gentoo-r3 root=/dev/hda3
+kernel /kernel-2.6.11-gentoo-r11 root=/dev/hda3
<comment># The next four lines are only if you dualboot with a Windows system.</comment>
<comment># In this case, Windows is hosted on /dev/hda6.</comment>
@@ -269,10 +269,10 @@
timeout 30
splashimage=(hd0,0)/grub/splash.xpm.gz
-title=Gentoo Linux 2.6.11-r3
+title=Gentoo Linux 2.6.11-r11
root (hd0,0)
-kernel /kernel-2.6.11-gentoo-r3 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
-initrd /initrd-2.6.11-gentoo-r3
+kernel /kernel-genkernel-x86-2.6.11-gentoo-r11 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
+initrd /initramfs-genkernel-x86-2.6.11-gentoo-r11
<comment># Only in case you want to dual-boot</comment>
title=Windows XP
@@ -463,7 +463,7 @@
</p>
<pre caption = "Installing LILO">
-# <i>emerge --usepkg lilo</i>
+# <i>emerge lilo</i>
</pre>
</body>
@@ -484,9 +484,8 @@
<p>
Some sections ago we have asked you to remember the kernel-image name
-you have created. In the next example <path>lilo.conf</path> we assume
-the imagename is <path>kernel-2.6.11-gentoo-r3</path>. We also use the
-example partitioning scheme in this example. There are two separate parts:
+you have created. In the next example <path>lilo.conf</path> we also use the
+example partitioning scheme. There are two separate parts:
</p>
<ul>
@@ -516,18 +515,18 @@
default=gentoo <comment># When the timeout has passed, boot the "gentoo" section</comment>
<comment># For non-genkernel users</comment>
-image=/boot/kernel-2.6.11-gentoo-r3
+image=/boot/kernel-2.6.11-gentoo-r11
label=gentoo <comment># Name we give to this section</comment>
read-only <comment># Start with a read-only root. Do not alter!</comment>
root=/dev/hda3 <comment># Location of the root filesystem</comment>
<comment># For genkernel users</comment>
-image=/boot/kernel-2.6.11-gentoo-r3
+image=/boot/kernel-genkernel-x86-2.6.11-gentoo-r11
label=gentoo
read-only
root=/dev/ram0
append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev"
- initrd=/boot/initrd-2.6.11-gentoo-r3
+ initrd=/boot/initramfs-genkernel-x86-2.6.11-gentoo-r11
<comment># The next two lines are only if you dualboot with a Windows system.</comment>
<comment># In this case, Windows is hosted on /dev/hda6.</comment>
@@ -547,7 +546,7 @@
</p>
<pre caption = "Using append to add kernel options">
-image=/boot/kernel-2.6.11-gentoo-r3
+image=/boot/kernel-2.6.11-gentoo-r11
label=gentoo
read-only
root=/dev/hda3
1.2 +3 -3 xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-disk.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-disk.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-disk.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-x86-disk.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-disk.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-x86-disk.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-x86-disk.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -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/2005.1/hb-install-x86-disk.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-disk.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-08-02</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Introduction to Block Devices</title>
1.2 +10 -21 xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-x86-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-x86-kernel.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-x86-kernel.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.9</version>
-<date>2005-07-04</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Timezone</title>
@@ -347,16 +347,7 @@
</pre>
<p>
-Next, copy over the kernel configuration used by the Installation CD to the
-location where genkernel looks for the default kernel configuration:
-</p>
-
-<pre caption="Copying over the Installation CD kernel config">
-# <i>zcat /proc/config.gz > /usr/share/genkernel/x86/kernel-config-2.6</i>
-</pre>
-
-<p>
-Now, compile your kernel sources by running <c>genkernel --udev all</c>.
+Now, compile your kernel sources by running <c>genkernel all</c>.
Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware, this compilation will take quite a while to finish!
</p>
@@ -370,7 +361,7 @@
</p>
<pre caption="Running genkernel">
-# <i>genkernel --udev all</i>
+# <i>genkernel all</i>
</pre>
<p>
@@ -388,16 +379,14 @@
</pre>
<p>
-If you want your system to be more like the Installation CD you should,
-when your Gentoo installation is over, emerge <c>coldplug</c>. While the
-initrd autodetects hardware that is needed to boot your system,
-<c>coldplug</c> autodetects everything else. <c>coldplug</c> is available as one
-of the packages on the Package CD.
+If you want your system to be more like the Installation CD you should
+emerge <c>coldplug</c>. While the initrd autodetects hardware that is
+needed to boot your system, <c>coldplug</c> autodetects everything
+else.
</p>
<pre caption="Emerging and enabling coldplug">
-<comment>(Do this after the installation, during the GRP installation instructions)</comment>
-# <i>emerge -k coldplug</i>
+# <i>emerge coldplug</i>
# <i>rc-update add coldplug boot</i>
</pre>
1.2 +14 -14 xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: hb-install-x86-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-x86-medium.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ hb-install-x86-medium.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -2,14 +2,14 @@
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<sections>
-<version>4.2</version>
-<date>2005-05-23</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<section>
<title>Hardware Requirements</title>
@@ -150,8 +150,8 @@
You can download the Universal Installation CDs (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
-the <path>releases/x86/2005.0/installcd</path> directory;
-the Package CDs are located in the <path>releases/x86/2005.0/packagecd</path>
+the <path>releases/x86/2005.1/installcd</path> directory;
+the Package CDs are located in the <path>releases/x86/2005.1/packagecd</path>
directory.
</p>
@@ -317,14 +317,14 @@
<p>
You will then be greeted with a boot screen and progress bar. If you are
-installing Gentoo on a system with a non-US keyboard, make sure you press F2
-to switch to verbose mode and follow the prompt. If no selection is made in 10
-seconds the default (US keyboard) will be accepted and the boot process will
-continue. Once the boot process completes, you will be automatically logged
-in to the "Live" Gentoo Linux as "root", the super user.
-You should have a root ("#") prompt on the current console and can
-also switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back
-to the one you started on by pressing Alt-F1.
+installing Gentoo on a system with a non-US keyboard, make sure you
+immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
+selection is made in 10 seconds the default (US keyboard) will be accepted and
+the boot process will continue. Once the boot process completes, you will be
+automatically logged in to the "Live" Gentoo Linux as
+"root", the super user. You should have a root ("#") prompt
+on the current console and can also switch to other consoles by pressing Alt-F2,
+Alt-F3 and Alt-F4. Get back to the one you started on by pressing Alt-F1.
</p>
</body>
1.2 +21 -17 xml/htdocs/doc/en/handbook/2005.1/index.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/index.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/index.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/index.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: index.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/index.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.xml 8 Aug 2005 13:16:10 -0000 1.1
+++ index.xml 8 Aug 2005 13:24:46 -0000 1.2
@@ -1,35 +1,36 @@
<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/index.xml,v 1.1 2005/08/08 13:16:10 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/index.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
<guide link="index.xml">
-<title>Gentoo 2005.0 Handbook</title>
+<title>Gentoo 2005.1 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<abstract>
-The Gentoo 2005.0 Handbook contains the networkless installation instructions
-for the 2005.0 release and parts on working with Gentoo and Portage.
+The Gentoo 2005.1 Handbook is an effort to centralise documentation into a
+coherent handbook. It contains the installation instructions for the 2005.1
+release and parts on working with Gentoo and Portage.
</abstract>
<license/>
-<version>4.2</version>
-<date>2005-07-26</date>
+<version>5.0</version>
+<date>2005-08-08</date>
<chapter>
-<title>The Gentoo Linux 2005.0 Handbooks</title>
-<!-- Uncomment when needed, probably for the 2005.0 versions -->
+<title>The Gentoo Linux 2005.1 Handbooks</title>
+<!-- Uncomment when needed, probably for the 2005.1 versions -->
<!--
<section>
<title>Available languages</title>
<body>
<p>
-The Gentoo Linux 2005.0 Handbook is available in the following languages:
+The Gentoo Linux 2005.1 Handbook is available in the following languages:
</p>
<p>
@@ -54,9 +55,9 @@
<body>
<p>
-Welcome to the Gentoo Linux 2005.0 Handbooks. These handbooks are released
+Welcome to the Gentoo Linux 2005.1 Handbooks. These handbooks are released
together with the Gentoo Linux releases and contain the necessary installation
-instructions to install Gentoo Linux 2005.0 <brite>without an internet
+instructions to install Gentoo Linux 2005.1 <brite>without an internet
connection.</brite>
</p>
@@ -89,8 +90,9 @@
<uri link="handbook-sparc.xml">sparc</uri>,
<uri link="handbook-alpha.xml">alpha</uri>,
<uri link="handbook-amd64.xml">amd64</uri>,
- <uri link="handbook-ppc.xml">ppc</uri>
-<!-- <uri link="handbook-hppa.xml">hppa</uri> -->
+ <uri link="handbook-ppc.xml">ppc</uri>,
+ <uri link="handbook-ppc64.xml">ppc64</uri>,
+ <uri link="handbook-hppa.xml">hppa</uri>
</ti>
</tr>
<tr>
@@ -101,8 +103,9 @@
<uri link="handbook-sparc.xml?full=1">sparc</uri>,
<uri link="handbook-alpha.xml?full=1">alpha</uri>,
<uri link="handbook-amd64.xml?full=1">amd64</uri>,
- <uri link="handbook-ppc.xml?full=1">ppc</uri>
-<!-- <uri link="handbook-hppa.xml?full=1">hppa</uri> -->
+ <uri link="handbook-ppc.xml?full=1">ppc</uri>,
+ <uri link="handbook-ppc64.xml?full=1">ppc64</uri>,
+ <uri link="handbook-hppa.xml?full=1">hppa</uri>
</ti>
</tr>
<tr>
@@ -113,8 +116,9 @@
<uri link="handbook-sparc.xml?style=printable&full=1">sparc</uri>,
<uri link="handbook-alpha.xml?style=printable&full=1">alpha</uri>,
<uri link="handbook-amd64.xml?style=printable&full=1">amd64</uri>,
- <uri link="handbook-ppc.xml?style=printable&full=1">ppc</uri>
-<!-- <uri link="handbook-hppa.xml?style=printable&full=1">hppa</uri> -->
+ <uri link="handbook-ppc.xml?style=printable&full=1">ppc</uri>,
+ <uri link="handbook-ppc64.xml?style=printable&full=1">ppc64</uri>,
+ <uri link="handbook-hppa.xml?style=printable&full=1">hppa</uri>
</ti>
</tr>
</table>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-08-08 13:27 swift
0 siblings, 0 replies; 25+ messages in thread
From: swift @ 2005-08-08 13:27 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/08/08 13:27:20
Modified: xml/htdocs/doc/en/handbook/2005.1 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc64.xml handbook-ppc.xml
handbook-sparc.xml handbook-x86.xml
Log:
Sorry lads, forgot to change the relative links. Done (s:../../:../:g)
Revision Changes Path
1.3 +19 -19 xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-alpha.xml 8 Aug 2005 13:24:46 -0000 1.2
+++ handbook-alpha.xml 8 Aug 2005 13:27:20 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2005.1 Alpha Handbook</title>
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>5.0</version>
+<version>5.1</version>
<date>2005-08-08</date>
<part>
@@ -250,7 +250,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -259,7 +259,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -268,7 +268,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -278,7 +278,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -288,7 +288,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -305,7 +305,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -314,7 +314,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -325,7 +325,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -334,7 +334,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -344,7 +344,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -354,7 +354,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -368,7 +368,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -377,7 +377,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -386,7 +386,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -394,7 +394,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -402,7 +402,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -410,7 +410,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +19 -19 xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-amd64.xml 8 Aug 2005 13:24:46 -0000 1.2
+++ handbook-amd64.xml 8 Aug 2005 13:27:20 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2005.1 AMD64 Handbook</title>
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>5.0</version>
+<version>5.1</version>
<date>2005-08-08</date>
<part>
@@ -249,7 +249,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -258,7 +258,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -267,7 +267,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -277,7 +277,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -287,7 +287,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -304,7 +304,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -313,7 +313,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -324,7 +324,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -333,7 +333,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -343,7 +343,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -353,7 +353,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -367,7 +367,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -376,7 +376,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -385,7 +385,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -393,7 +393,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -401,7 +401,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -409,7 +409,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +19 -19 xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-hppa.xml 8 Aug 2005 13:24:46 -0000 1.2
+++ handbook-hppa.xml 8 Aug 2005 13:27:20 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2005.1 HPPA Handbook</title>
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>5.0</version>
+<version>5.1</version>
<date>2005-08-08</date>
<part>
@@ -249,7 +249,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -258,7 +258,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -267,7 +267,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -277,7 +277,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -287,7 +287,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -304,7 +304,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -313,7 +313,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -324,7 +324,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -333,7 +333,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -343,7 +343,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -353,7 +353,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -367,7 +367,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -376,7 +376,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -385,7 +385,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -393,7 +393,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -401,7 +401,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -409,7 +409,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.2 +19 -19 xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-ppc64.xml 8 Aug 2005 13:21:15 -0000 1.1
+++ handbook-ppc64.xml 8 Aug 2005 13:27:20 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml,v 1.1 2005/08/08 13:21:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml,v 1.2 2005/08/08 13:27:20 swift Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux 2005.1 PPC64 Handbook</title>
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>5.0</version>
+<version>5.1</version>
<date>2005-08-08</date>
<part>
@@ -251,7 +251,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -260,7 +260,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -269,7 +269,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -279,7 +279,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -289,7 +289,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -306,7 +306,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -315,7 +315,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -326,7 +326,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -335,7 +335,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -345,7 +345,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -355,7 +355,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -369,7 +369,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -378,7 +378,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -387,7 +387,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -395,7 +395,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -403,7 +403,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -411,7 +411,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +19 -19 xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-ppc.xml 8 Aug 2005 13:24:46 -0000 1.2
+++ handbook-ppc.xml 8 Aug 2005 13:27:20 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2005.1 PPC Handbook</title>
@@ -120,7 +120,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>5.0</version>
+<version>5.1</version>
<date>2005-08-08</date>
<part>
@@ -253,7 +253,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -262,7 +262,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -281,7 +281,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -291,7 +291,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -308,7 +308,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -317,7 +317,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -328,7 +328,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -337,7 +337,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -347,7 +347,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -357,7 +357,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -371,7 +371,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -380,7 +380,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -389,7 +389,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -397,7 +397,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -405,7 +405,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -413,7 +413,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +19 -19 xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-sparc.xml 8 Aug 2005 13:24:46 -0000 1.2
+++ handbook-sparc.xml 8 Aug 2005 13:27:20 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2005.1 SPARC Handbook</title>
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>5.0</version>
+<version>5.1</version>
<date>2005-08-08</date>
<part>
@@ -249,7 +249,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -258,7 +258,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -267,7 +267,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -277,7 +277,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -287,7 +287,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -304,7 +304,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -313,7 +313,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -324,7 +324,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -333,7 +333,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -343,7 +343,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -353,7 +353,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -367,7 +367,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -376,7 +376,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -385,7 +385,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -393,7 +393,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -401,7 +401,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -409,7 +409,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +19 -19 xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-x86.xml 8 Aug 2005 13:24:46 -0000 1.2
+++ handbook-x86.xml 8 Aug 2005 13:27:20 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v 1.2 2005/08/08 13:24:46 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2005.1 x86 Handbook</title>
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>5.0</version>
+<version>5.1</version>
<date>2005-08-08</date>
<part>
@@ -249,7 +249,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -258,7 +258,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -267,7 +267,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -277,7 +277,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -287,7 +287,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -304,7 +304,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -313,7 +313,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -324,7 +324,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -333,7 +333,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -343,7 +343,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -353,7 +353,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -367,7 +367,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -376,7 +376,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -385,7 +385,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -393,7 +393,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -401,7 +401,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -409,7 +409,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-08-08 14:00 swift
0 siblings, 0 replies; 25+ messages in thread
From: swift @ 2005-08-08 14:00 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/08/08 14:00:13
Removed: xml/htdocs/doc/en/handbook/draft/2005.1 handbook-alpha.xml
Log:
Removing handbook-alpha.xml from this location
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-10-09 23:24 Lukasz Damentko
0 siblings, 0 replies; 25+ messages in thread
From: Lukasz Damentko @ 2005-10-09 23:24 UTC (permalink / raw
To: gentoo-doc-cvs
rane 05/10/09 23:24:31
Modified: xml/htdocs/doc/en/handbook/2004.2 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-mips.xml handbook-ppc.xml
handbook-sparc.xml handbook-x86.xml
Log:
adding disclaimers, please add them in translations as well
Revision Changes Path
1.3 +3 -3 xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-alpha.xml 28 Jul 2005 14:33:44 -0000 1.2
+++ handbook-alpha.xml 9 Oct 2005 23:24:31 -0000 1.3
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-alpha.xml,v 1.3 2005/10/09 23:24:31 rane Exp $ -->
-<book link="handbook-alpha.xml">
+<book link="handbook-alpha.xml" disclaimer="oldbook">
<title>Gentoo Linux/Alpha Handbook</title>
<author title="Author">
@@ -114,7 +114,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>3.7</version>
+<version>3.8</version>
<date>November 09, 2004</date>
<part>
1.3 +3 -3 xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-amd64.xml 28 Jul 2005 14:33:44 -0000 1.2
+++ handbook-amd64.xml 9 Oct 2005 23:24:31 -0000 1.3
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-amd64.xml,v 1.3 2005/10/09 23:24:31 rane Exp $ -->
-<book link="handbook-amd64.xml">
+<book link="handbook-amd64.xml" disclaimer="oldbook">
<title>Gentoo Linux/AMD64 Handbook</title>
<author title="Author">
@@ -114,7 +114,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>3.13</version>
+<version>3.14</version>
<date>November 09, 2004</date>
<part>
1.3 +3 -3 xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-hppa.xml 28 Jul 2005 14:33:44 -0000 1.2
+++ handbook-hppa.xml 9 Oct 2005 23:24:31 -0000 1.3
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-hppa.xml,v 1.3 2005/10/09 23:24:31 rane Exp $ -->
-<book link="handbook-hppa.xml">
+<book link="handbook-hppa.xml" disclaimer="oldbook">
<title>Gentoo Linux/HPPA Handbook</title>
<author title="Author">
@@ -114,7 +114,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>3.7</version>
+<version>3.8</version>
<date>November 09, 2004</date>
<part>
1.3 +3 -3 xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-mips.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-mips.xml 28 Jul 2005 14:33:44 -0000 1.2
+++ handbook-mips.xml 9 Oct 2005 23:24:31 -0000 1.3
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-mips.xml,v 1.3 2005/10/09 23:24:31 rane Exp $ -->
-<book link="handbook-mips.xml">
+<book link="handbook-mips.xml" disclaimer="oldbook">
<title>Gentoo Linux/MIPS Handbook</title>
<author title="Author">
@@ -114,7 +114,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>3.7</version>
+<version>3.8</version>
<date>November 09, 2004</date>
<part>
1.3 +3 -3 xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-ppc.xml 28 Jul 2005 14:33:44 -0000 1.2
+++ handbook-ppc.xml 9 Oct 2005 23:24:31 -0000 1.3
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-ppc.xml,v 1.3 2005/10/09 23:24:31 rane Exp $ -->
-<book link="handbook-ppc.xml">
+<book link="handbook-ppc.xml" disclaimer="oldbook">
<title>Gentoo Linux/PPC Handbook</title>
<author title="Author">
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>3.17</version>
+<version>3.18</version>
<date>November 09, 2004</date>
<part>
1.3 +3 -3 xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-sparc.xml 28 Jul 2005 14:33:44 -0000 1.2
+++ handbook-sparc.xml 9 Oct 2005 23:24:31 -0000 1.3
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-sparc.xml,v 1.3 2005/10/09 23:24:31 rane Exp $ -->
-<book link="handbook-sparc.xml">
+<book link="handbook-sparc.xml" disclaimer="oldbook">
<title>Gentoo Linux/SPARC Handbook</title>
<author title="Author">
@@ -114,7 +114,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>3.7</version>
+<version>3.8</version>
<date>November 09, 2004</date>
<part>
1.3 +3 -3 xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-x86.xml 28 Jul 2005 14:33:44 -0000 1.2
+++ handbook-x86.xml 9 Oct 2005 23:24:31 -0000 1.3
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml,v 1.2 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2004.2/handbook-x86.xml,v 1.3 2005/10/09 23:24:31 rane Exp $ -->
-<book link="handbook-x86.xml">
+<book link="handbook-x86.xml" disclaimer="oldbook">
<title>Gentoo Linux/x86 Handbook</title>
<author title="Author">
@@ -114,7 +114,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>3.7</version>
+<version>3.8</version>
<date>November 09, 2004</date>
<part>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-10-09 23:28 Lukasz Damentko
0 siblings, 0 replies; 25+ messages in thread
From: Lukasz Damentko @ 2005-10-09 23:28 UTC (permalink / raw
To: gentoo-doc-cvs
rane 05/10/09 23:28:41
Modified: xml/htdocs/doc/en/handbook/2005.0 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-x86.xml index.xml
Log:
adding disclaimers, please add them in translations as well
Revision Changes Path
1.5 +3 -3 xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- handbook-alpha.xml 28 Jul 2005 14:33:44 -0000 1.4
+++ handbook-alpha.xml 9 Oct 2005 23:28:41 -0000 1.5
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-alpha.xml,v 1.5 2005/10/09 23:28:41 rane Exp $ -->
-<book link="handbook-alpha.xml">
+<book link="handbook-alpha.xml" disclaimer="oldbook">
<title>Gentoo Linux 2005.0 Alpha Handbook</title>
<author title="Author">
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
+<version>4.2</version>
<date>2005-06-09</date>
<part>
1.5 +3 -3 xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- handbook-amd64.xml 28 Jul 2005 14:33:44 -0000 1.4
+++ handbook-amd64.xml 9 Oct 2005 23:28:41 -0000 1.5
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-amd64.xml,v 1.5 2005/10/09 23:28:41 rane Exp $ -->
-<book link="handbook-amd64.xml">
+<book link="handbook-amd64.xml" disclaimer="oldbook">
<title>Gentoo Linux 2005.0 AMD64 Handbook</title>
<author title="Author">
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
+<version>4.2</version>
<date>2005-06-09</date>
<part>
1.5 +3 -3 xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- handbook-hppa.xml 28 Jul 2005 14:33:44 -0000 1.4
+++ handbook-hppa.xml 9 Oct 2005 23:28:41 -0000 1.5
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-hppa.xml,v 1.5 2005/10/09 23:28:41 rane Exp $ -->
-<book link="handbook-hppa.xml">
+<book link="handbook-hppa.xml" disclaimer="oldbook">
<title>Gentoo Linux 2005.0 HPPA Handbook</title>
<author title="Author">
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
+<version>4.2</version>
<date>2005-06-09</date>
<part>
1.5 +3 -3 xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- handbook-ppc.xml 28 Jul 2005 14:33:44 -0000 1.4
+++ handbook-ppc.xml 9 Oct 2005 23:28:41 -0000 1.5
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-ppc.xml,v 1.5 2005/10/09 23:28:41 rane Exp $ -->
-<book link="handbook-ppc.xml">
+<book link="handbook-ppc.xml" disclaimer="oldbook">
<title>Gentoo Linux 2005.0 PPC Handbook</title>
<author title="Author">
@@ -120,7 +120,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
+<version>4.2</version>
<date>2005-06-09</date>
<part>
1.5 +3 -3 xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- handbook-x86.xml 28 Jul 2005 14:33:44 -0000 1.4
+++ handbook-x86.xml 9 Oct 2005 23:28:41 -0000 1.5
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml,v 1.4 2005/07/28 14:33:44 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/handbook-x86.xml,v 1.5 2005/10/09 23:28:41 rane Exp $ -->
-<book link="handbook-x86.xml">
+<book link="handbook-x86.xml" disclaimer="oldbook">
<title>Gentoo Linux 2005.0 x86 Handbook</title>
<author title="Author">
@@ -117,7 +117,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>4.1</version>
+<version>4.2</version>
<date>2005-06-09</date>
<part>
1.6 +3 -3 xml/htdocs/doc/en/handbook/2005.0/index.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/index.xml?rev=1.6&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/index.xml?rev=1.6&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.0/index.xml.diff?r1=1.5&r2=1.6&cvsroot=gentoo
Index: index.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/index.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- index.xml 26 Jul 2005 12:06:51 -0000 1.5
+++ index.xml 9 Oct 2005 23:28:41 -0000 1.6
@@ -1,9 +1,9 @@
<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/index.xml,v 1.5 2005/07/26 12:06:51 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.0/index.xml,v 1.6 2005/10/09 23:28:41 rane Exp $ -->
-<guide link="index.xml">
+<guide link="index.xml" disclaimer="oldbook">
<title>Gentoo 2005.0 Handbook</title>
<author title="Author">
@@ -17,7 +17,7 @@
<license/>
-<version>4.2</version>
+<version>4.3</version>
<date>2005-07-26</date>
<chapter>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-10-13 15:08 Xavier Neys
0 siblings, 0 replies; 25+ messages in thread
From: Xavier Neys @ 2005-10-13 15:08 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 05/10/13 15:08:01
Modified: xml/htdocs/doc/en/handbook/2005.1 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc64.xml handbook-ppc.xml
handbook-sparc.xml handbook-x86.xml
Log:
#109113 Improve abstracts
Revision Changes Path
1.4 +10 -6 xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-alpha.xml 8 Aug 2005 13:27:20 -0000 1.3
+++ handbook-alpha.xml 13 Oct 2005 15:08:01 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v 1.4 2005/10/13 15:08:01 neysx Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2005.1 Alpha Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for a networkless
+installation on Alpha systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>5.1</version>
-<date>2005-08-08</date>
+<version>5.2</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.4 +10 -6 xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-amd64.xml 8 Aug 2005 13:27:20 -0000 1.3
+++ handbook-amd64.xml 13 Oct 2005 15:08:01 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v 1.4 2005/10/13 15:08:01 neysx Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2005.1 AMD64 Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for a networkless
+installation on AMD64 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>5.1</version>
-<date>2005-08-08</date>
+<version>5.2</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.4 +9 -5 xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-hppa.xml 8 Aug 2005 13:27:20 -0000 1.3
+++ handbook-hppa.xml 13 Oct 2005 15:08:01 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-hppa.xml,v 1.4 2005/10/13 15:08:01 neysx Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2005.1 HPPA Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for a networkless
+installation on HPPA systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
-<version>5.1</version>
-<date>2005-08-08</date>
+<version>5.2</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.3 +9 -5 xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-ppc64.xml 8 Aug 2005 13:27:20 -0000 1.2
+++ handbook-ppc64.xml 13 Oct 2005 15:08:01 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml,v 1.2 2005/08/08 13:27:20 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc64.xml,v 1.3 2005/10/13 15:08:01 neysx Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux 2005.1 PPC64 Handbook</title>
@@ -89,6 +89,9 @@
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for a networkless
+installation on PPC64 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>5.1</version>
-<date>2005-08-08</date>
+<version>5.2</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.4 +10 -6 xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-ppc.xml 8 Aug 2005 13:27:20 -0000 1.3
+++ handbook-ppc.xml 13 Oct 2005 15:08:01 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-ppc.xml,v 1.4 2005/10/13 15:08:01 neysx Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2005.1 PPC Handbook</title>
@@ -98,6 +98,9 @@
<author title="Editor">
<mail link="sejo@gentoo.org">Jochen Maes </mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -112,16 +115,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for a networkless
+installation on PPC systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>5.1</version>
-<date>2005-08-08</date>
+<version>5.2</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.4 +10 -6 xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-sparc.xml 8 Aug 2005 13:27:20 -0000 1.3
+++ handbook-sparc.xml 13 Oct 2005 15:08:01 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-sparc.xml,v 1.4 2005/10/13 15:08:01 neysx Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2005.1 SPARC Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for a networkless
+installation on Sparc systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>5.1</version>
-<date>2005-08-08</date>
+<version>5.2</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.4 +10 -6 xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-x86.xml 8 Aug 2005 13:27:20 -0000 1.3
+++ handbook-x86.xml 13 Oct 2005 15:08:01 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v 1.3 2005/08/08 13:27:20 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-x86.xml,v 1.4 2005/10/13 15:08:01 neysx Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2005.1 x86 Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for a networkless
+installation on x86 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>5.1</version>
-<date>2005-08-08</date>
+<version>5.2</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-10-13 15:08 Xavier Neys
0 siblings, 0 replies; 25+ messages in thread
From: Xavier Neys @ 2005-10-13 15:08 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 05/10/13 15:08:01
Modified: xml/htdocs/doc/en/handbook handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-mips.xml handbook-ppc64.xml
handbook-ppc.xml handbook-sparc.xml
handbook-x86.xml
Log:
#109113 Improve abstracts
Revision Changes Path
1.117 +10 -6 xml/htdocs/doc/en/handbook/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.117&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.117&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml.diff?r1=1.116&r2=1.117&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v
retrieving revision 1.116
retrieving revision 1.117
diff -u -r1.116 -r1.117
--- handbook-alpha.xml 28 Jul 2005 14:33:43 -0000 1.116
+++ handbook-alpha.xml 13 Oct 2005 15:08:00 -0000 1.117
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.116 2005/07/28 14:33:43 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.117 2005/10/13 15:08:00 neysx Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux Alpha Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for an internet-based
+installation on Alpha systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.0</version>
-<date>2005-06-09</date>
+<version>4.1</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.125 +10 -6 xml/htdocs/doc/en/handbook/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.125&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.125&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml.diff?r1=1.124&r2=1.125&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v
retrieving revision 1.124
retrieving revision 1.125
diff -u -r1.124 -r1.125
--- handbook-amd64.xml 28 Jul 2005 14:33:43 -0000 1.124
+++ handbook-amd64.xml 13 Oct 2005 15:08:00 -0000 1.125
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.124 2005/07/28 14:33:43 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.125 2005/10/13 15:08:00 neysx Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux AMD64 Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for an internet-based
+installation on AMD64 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.0</version>
-<date>2005-06-09</date>
+<version>4.1</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.114 +10 -6 xml/htdocs/doc/en/handbook/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.114&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.114&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml.diff?r1=1.113&r2=1.114&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v
retrieving revision 1.113
retrieving revision 1.114
diff -u -r1.113 -r1.114
--- handbook-hppa.xml 28 Jul 2005 14:33:43 -0000 1.113
+++ handbook-hppa.xml 13 Oct 2005 15:08:00 -0000 1.114
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.113 2005/07/28 14:33:43 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.114 2005/10/13 15:08:00 neysx Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux HPPA Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for an internet-based
+installation on HPPA systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.0</version>
-<date>2005-06-09</date>
+<version>4.1</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.104 +10 -6 xml/htdocs/doc/en/handbook/handbook-mips.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.104&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.104&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml.diff?r1=1.103&r2=1.104&cvsroot=gentoo
Index: handbook-mips.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v
retrieving revision 1.103
retrieving revision 1.104
diff -u -r1.103 -r1.104
--- handbook-mips.xml 28 Jul 2005 14:33:43 -0000 1.103
+++ handbook-mips.xml 13 Oct 2005 15:08:00 -0000 1.104
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.103 2005/07/28 14:33:43 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.104 2005/10/13 15:08:00 neysx Exp $ -->
<book link="handbook-mips.xml">
<title>Gentoo Linux/MIPS Handbook</title>
@@ -95,6 +95,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -112,16 +115,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for an internet-based
+installation on MIPS systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.0</version>
-<date>2005-06-09</date>
+<version>4.1</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.56 +10 -6 xml/htdocs/doc/en/handbook/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.56&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.56&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml.diff?r1=1.55&r2=1.56&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v
retrieving revision 1.55
retrieving revision 1.56
diff -u -r1.55 -r1.56
--- handbook-ppc64.xml 28 Jul 2005 14:33:43 -0000 1.55
+++ handbook-ppc64.xml 13 Oct 2005 15:08:00 -0000 1.56
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.55 2005/07/28 14:33:43 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.56 2005/10/13 15:08:00 neysx Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux PPC64 Handbook</title>
@@ -89,6 +89,9 @@
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for an internet-based
+installation on PPC64 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.0</version>
-<date>2005-06-09</date>
+<version>4.1</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.134 +10 -6 xml/htdocs/doc/en/handbook/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.134&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.134&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml.diff?r1=1.133&r2=1.134&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v
retrieving revision 1.133
retrieving revision 1.134
diff -u -r1.133 -r1.134
--- handbook-ppc.xml 28 Jul 2005 14:33:43 -0000 1.133
+++ handbook-ppc.xml 13 Oct 2005 15:08:00 -0000 1.134
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.133 2005/07/28 14:33:43 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.134 2005/10/13 15:08:00 neysx Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux PPC Handbook</title>
@@ -98,6 +98,9 @@
<author title="Editor">
<mail link="sejo@gentoo.org">Jochen Maes </mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -112,16 +115,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for an internet-based
+installation on PPC systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.0</version>
-<date>2005-06-09</date>
+<version>4.1</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.117 +10 -6 xml/htdocs/doc/en/handbook/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.117&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.117&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml.diff?r1=1.116&r2=1.117&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v
retrieving revision 1.116
retrieving revision 1.117
diff -u -r1.116 -r1.117
--- handbook-sparc.xml 28 Jul 2005 14:33:43 -0000 1.116
+++ handbook-sparc.xml 13 Oct 2005 15:08:00 -0000 1.117
@@ -1,7 +1,7 @@
<?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.116 2005/07/28 14:33:43 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v 1.117 2005/10/13 15:08:00 neysx Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux SPARC Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for an internet-based
+installation on Sparc systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.0</version>
-<date>2005-06-09</date>
+<version>4.1</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
1.144 +10 -6 xml/htdocs/doc/en/handbook/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.144&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.144&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml.diff?r1=1.143&r2=1.144&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v
retrieving revision 1.143
retrieving revision 1.144
diff -u -r1.143 -r1.144
--- handbook-x86.xml 28 Jul 2005 14:33:43 -0000 1.143
+++ handbook-x86.xml 13 Oct 2005 15:08:00 -0000 1.144
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.143 2005/07/28 14:33:43 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.144 2005/10/13 15:08:00 neysx Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux x86 Handbook</title>
@@ -92,6 +92,9 @@
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
+<author title="Editor">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
@@ -109,16 +112,17 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
-information.
+This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
+This handbook contains the installation instructions for an internet-based
+installation on x86 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
-<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.0</version>
-<date>2005-06-09</date>
+<version>4.1</version>
+<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-11-11 17:27 swift
0 siblings, 0 replies; 25+ messages in thread
From: swift @ 2005-11-11 17:27 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/11/11 17:27:15
Modified: xml/htdocs/doc/en/handbook handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-mips.xml handbook-ppc.xml
handbook-ppc64.xml handbook-sparc.xml
handbook-x86.xml hb-install-alpha-medium.xml
hb-install-amd64-medium.xml
hb-install-hppa-medium.xml
hb-install-mips-medium.xml
hb-install-ppc-medium.xml
hb-install-ppc64-medium.xml
hb-install-sparc-medium.xml hb-install-stage.xml
hb-install-system.xml hb-install-x86-medium.xml
index.xml
Log:
#105809 - Moving bootstrapping/system to FAQ, outside handbook
Revision Changes Path
1.118 +5 -5 xml/htdocs/doc/en/handbook/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.118&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.118&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml.diff?r1=1.117&r2=1.118&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v
retrieving revision 1.117
retrieving revision 1.118
diff -u -r1.117 -r1.118
--- handbook-alpha.xml 13 Oct 2005 15:08:00 -0000 1.117
+++ handbook-alpha.xml 11 Nov 2005 17:27:15 -0000 1.118
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.117 2005/10/13 15:08:00 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.118 2005/11/11 17:27:15 swift Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux Alpha Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.1</version>
-<date>2005-10-13</date>
+<version>4.2</version>
+<date>2005-11-11</date>
<part>
<title>Installing Gentoo</title>
@@ -170,8 +170,8 @@
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
-Gentoo installs work through so-called stage-files. In this chapter we
-describe how you extract a stage-file and configure Portage.
+Gentoo installs work through a stage3 archive. In this chapter we
+describe how you extract the stage3 archive and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
1.126 +5 -5 xml/htdocs/doc/en/handbook/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.126&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.126&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml.diff?r1=1.125&r2=1.126&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v
retrieving revision 1.125
retrieving revision 1.126
diff -u -r1.125 -r1.126
--- handbook-amd64.xml 13 Oct 2005 15:08:00 -0000 1.125
+++ handbook-amd64.xml 11 Nov 2005 17:27:15 -0000 1.126
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.125 2005/10/13 15:08:00 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.126 2005/11/11 17:27:15 swift Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux AMD64 Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.1</version>
-<date>2005-10-13</date>
+<version>4.2</version>
+<date>2005-11-11</date>
<part>
<title>Installing Gentoo</title>
@@ -170,8 +170,8 @@
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
-Gentoo installs work through so-called stage-files. In this chapter we
-describe how you extract a stage-file and configure Portage.
+Gentoo installs work through a stage3 archive. In this chapter we
+describe how you extract the stage3 archive and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
1.115 +5 -5 xml/htdocs/doc/en/handbook/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.115&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.115&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml.diff?r1=1.114&r2=1.115&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v
retrieving revision 1.114
retrieving revision 1.115
diff -u -r1.114 -r1.115
--- handbook-hppa.xml 13 Oct 2005 15:08:00 -0000 1.114
+++ handbook-hppa.xml 11 Nov 2005 17:27:15 -0000 1.115
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.114 2005/10/13 15:08:00 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.115 2005/11/11 17:27:15 swift Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux HPPA Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.1</version>
-<date>2005-10-13</date>
+<version>4.2</version>
+<date>2005-11-11</date>
<part>
<title>Installing Gentoo</title>
@@ -170,8 +170,8 @@
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
-Gentoo installs work through so-called stage-files. In this chapter we
-describe how you extract a stage-file and configure Portage.
+Gentoo installs work through a stage3 archive. In this chapter we
+describe how you extract the stage3 archive and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
1.105 +5 -5 xml/htdocs/doc/en/handbook/handbook-mips.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.105&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.105&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml.diff?r1=1.104&r2=1.105&cvsroot=gentoo
Index: handbook-mips.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v
retrieving revision 1.104
retrieving revision 1.105
diff -u -r1.104 -r1.105
--- handbook-mips.xml 13 Oct 2005 15:08:00 -0000 1.104
+++ handbook-mips.xml 11 Nov 2005 17:27:15 -0000 1.105
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.104 2005/10/13 15:08:00 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.105 2005/11/11 17:27:15 swift Exp $ -->
<book link="handbook-mips.xml">
<title>Gentoo Linux/MIPS Handbook</title>
@@ -124,8 +124,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.1</version>
-<date>2005-10-13</date>
+<version>4.2</version>
+<date>2005-11-11</date>
<part>
<title>Installing Gentoo</title>
@@ -172,8 +172,8 @@
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
-Gentoo installs work through so-called stage-files. In this chapter we
-describe how you extract a stage-file and configure Portage.
+Gentoo installs work through a stage3 archive. In this chapter we
+describe how you extract the stage3 archive and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
1.135 +5 -5 xml/htdocs/doc/en/handbook/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.135&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.135&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml.diff?r1=1.134&r2=1.135&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v
retrieving revision 1.134
retrieving revision 1.135
diff -u -r1.134 -r1.135
--- handbook-ppc.xml 13 Oct 2005 15:08:00 -0000 1.134
+++ handbook-ppc.xml 11 Nov 2005 17:27:15 -0000 1.135
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.134 2005/10/13 15:08:00 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.135 2005/11/11 17:27:15 swift Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux PPC Handbook</title>
@@ -124,8 +124,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.1</version>
-<date>2005-10-13</date>
+<version>4.2</version>
+<date>2005-11-11</date>
<part>
<title>Installing Gentoo</title>
@@ -173,8 +173,8 @@
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
-Gentoo installs work through so-called stage-files. In this chapter we describe
-how you extract a stage-file and configure Portage.
+Gentoo installs work through a stage3 archive. In this chapter we describe
+how you extract a stage3 archive and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
1.57 +5 -5 xml/htdocs/doc/en/handbook/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.57&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.57&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml.diff?r1=1.56&r2=1.57&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v
retrieving revision 1.56
retrieving revision 1.57
diff -u -r1.56 -r1.57
--- handbook-ppc64.xml 13 Oct 2005 15:08:00 -0000 1.56
+++ handbook-ppc64.xml 11 Nov 2005 17:27:15 -0000 1.57
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.56 2005/10/13 15:08:00 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.57 2005/11/11 17:27:15 swift Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux PPC64 Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.1</version>
-<date>2005-10-13</date>
+<version>4.2</version>
+<date>2005-11-11</date>
<part>
<title>Installing Gentoo</title>
@@ -170,8 +170,8 @@
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
-Gentoo installs work through so-called stage-files. In this chapter we describe
-how you extract a stage-file and configure Portage.
+Gentoo installs work through a stage3 archive. In this chapter we describe
+how you extract a stage3 archive and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
1.118 +5 -5 xml/htdocs/doc/en/handbook/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.118&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.118&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml.diff?r1=1.117&r2=1.118&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v
retrieving revision 1.117
retrieving revision 1.118
diff -u -r1.117 -r1.118
--- handbook-sparc.xml 13 Oct 2005 15:08:00 -0000 1.117
+++ handbook-sparc.xml 11 Nov 2005 17:27:15 -0000 1.118
@@ -1,7 +1,7 @@
<?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.117 2005/10/13 15:08:00 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v 1.118 2005/11/11 17:27:15 swift Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux SPARC Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.1</version>
-<date>2005-10-13</date>
+<version>4.2</version>
+<date>2005-11-11</date>
<part>
<title>Installing Gentoo</title>
@@ -170,8 +170,8 @@
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
-Gentoo installs work through so-called stage-files. In this chapter we
-describe how you extract a stage-file and configure Portage.
+Gentoo installs work through a stage3 archive. In this chapter we
+describe how you extract the stage3 archive and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
1.145 +5 -5 xml/htdocs/doc/en/handbook/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.145&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.145&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml.diff?r1=1.144&r2=1.145&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v
retrieving revision 1.144
retrieving revision 1.145
diff -u -r1.144 -r1.145
--- handbook-x86.xml 13 Oct 2005 15:08:00 -0000 1.144
+++ handbook-x86.xml 11 Nov 2005 17:27:15 -0000 1.145
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.144 2005/10/13 15:08:00 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.145 2005/11/11 17:27:15 swift Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux x86 Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.1</version>
-<date>2005-10-13</date>
+<version>4.2</version>
+<date>2005-11-11</date>
<part>
<title>Installing Gentoo</title>
@@ -170,8 +170,8 @@
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
-Gentoo installs work through so-called stage-files. In this chapter we
-describe how you extract a stage-file and configure Portage.
+Gentoo installs work through a stage3 archive. In this chapter we
+describe how you extract the stage3 archive and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
1.37 +26 -215 xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml?rev=1.37&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml?rev=1.37&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml.diff?r1=1.36&r2=1.37&cvsroot=gentoo
Index: hb-install-alpha-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- hb-install-alpha-medium.xml 9 Oct 2005 16:33:54 -0000 1.36
+++ hb-install-alpha-medium.xml 11 Nov 2005 17:27:15 -0000 1.37
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v 1.36 2005/10/09 16:33:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v 1.37 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>2.8</version>
-<date>2005-10-09</date>
+<version>2.9</version>
+<date>2005-11-11</date>
<section>
<title>Hardware Requirements</title>
@@ -53,208 +53,9 @@
</body>
</subsection>
</section>
-<!-- Copy/paste from the hb-install-x86-medium.xml file. -->
-<!-- START -->
-<section>
-<title>The Gentoo Installation Approaches</title>
-<subsection>
-<title>Introduction</title>
-<body>
-
-<p>
-Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
-A stage file is a tarball (compressed archive) that contains a minimal
-environment.
-</p>
-
-<ul>
- <li>
- A stage1 file contains nothing more than a compiler, Portage (Gentoo's
- software management system) and a couple of packages on which the compiler
- or Portage depends.
- </li>
- <li>
- A stage2 file contains a so-called bootstrapped system, a minimal
- environment from which one can start building all other necessary
- applications that make a Gentoo environment complete.
- </li>
- <li>
- A stage3 file contains a prebuilt minimal system which is almost fully
- deployable. It only lacks a few applications where you, the Gentoo user,
- needs to choose which one you want to install.
- </li>
-</ul>
-
-<p>
-To help you decide what stage file you want to use, we have written down the
-major advantages and disadvantages of each stage file.
-</p>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage1 Approach</title>
-<body>
-
-<p>
-A <e>stage1</e> is used when you want to bootstrap and build the entire system
-from scratch.
-</p>
-
-<p>
-This approach builds core system packages that are vital to your system and is
-used by Gentoo developers to prepare the Gentoo release media. It is a great
-installation method for those who would like to learn more about the inner
-workings of bootstrapping, toolchains and the like.
-</p>
-
-<p>
-However, if you do not plan to tweak the bootstrapping instructions in the
-<path>bootstrap.sh</path> script written by the Gentoo developers, then a
-stage1 approach has no benefits for you.
-</p>
-
-<table>
-<tr>
- <th>Stage1</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>
- Allows you to have total control over the installation routine, bootstrap
- sequence, etc.
- </ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Suitable for powerusers and developers who know what they are doing</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Takes a long time to finish the installation (it is the lengthiest approach)
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- If you don't intend to tweak the settings, it is a waste of time
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage2 Approach</title>
-<body>
-
-<p>
-A <e>stage2</e> is used for building the entire system from a bootstrapped
-"semi-compiled" state.
-</p>
-
-<p>
-When you perform a stage2 installation approach, you will build all system
-packages (core packages, including toolchain) using your specific <c>USE</c>,
-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
-optimized to your preference.
-</p>
-
-<p>
-However, this installation takes some time and if you do not intend to change
-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
-default", using this approach only makes sense if your <c>USE</c> variable is
-sufficiently different from the default <c>USE</c> we provide.
-</p>
-
-<table>
-<tr>
- <th>Stage2</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>You don't need to bootstrap</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Faster than starting with stage1</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>You can still tweak your settings</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>It's still not the fastest way to install Gentoo</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage3 Approach</title>
-<body>
-
-<p>
-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
-built for you. You will only need to build a few packages (such as system
-logger, networking tools, ...) before you can boot into a base Gentoo
-installation.
-</p>
-
-<p>
-Choosing to go with a stage3 allows for the fastest install of Gentoo
-Linux, but also means that your base system will have the optimization
-settings that we chose for you (which to be honest, are good settings
-and were carefully chosen to enhance performance while maintaining
-stability). Stage3 is also required if you want to install Gentoo using
-prebuilt packages or without a network connection.
1.39 +24 -215 xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml?rev=1.39&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml?rev=1.39&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml.diff?r1=1.38&r2=1.39&cvsroot=gentoo
Index: hb-install-amd64-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- hb-install-amd64-medium.xml 31 Oct 2005 13:31:33 -0000 1.38
+++ hb-install-amd64-medium.xml 11 Nov 2005 17:27:15 -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-amd64-medium.xml,v 1.38 2005/10/31 13:31:33 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml,v 1.39 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>2.9</version>
-<date>2005-10-31</date>
+<version>2.10</version>
+<date>2005-11-11</date>
<section>
<title>Hardware Requirements</title>
@@ -58,206 +58,6 @@
<!-- Copy/paste from hb-install-x86-medium.xml -->
<!-- START -->
<section>
-<title>The Gentoo Installation Approaches</title>
-<subsection>
-<title>Introduction</title>
-<body>
-
-<p>
-Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
-A stage file is a tarball (compressed archive) that contains a minimal
-environment.
-</p>
-
-<ul>
- <li>
- A stage1 file contains nothing more than a compiler, Portage (Gentoo's
- software management system) and a couple of packages on which the compiler
- or Portage depends.
- </li>
- <li>
- A stage2 file contains a so-called bootstrapped system, a minimal
- environment from which one can start building all other necessary
- applications that make a Gentoo environment complete.
- </li>
- <li>
- A stage3 file contains a prebuilt minimal system which is almost fully
- deployable. It only lacks a few applications where you, the Gentoo user,
- needs to choose which one you want to install.
- </li>
-</ul>
-
-<p>
-To help you decide what stage file you want to use, we have written down the
-major advantages and disadvantages of each stage file.
-</p>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage1 Approach</title>
-<body>
-
-<p>
-A <e>stage1</e> is used when you want to bootstrap and build the entire system
-from scratch.
-</p>
-
-<p>
-This approach builds core system packages that are vital to your system and is
-used by Gentoo developers to prepare the Gentoo release media. It is a great
-installation method for those who would like to learn more about the inner
-workings of bootstrapping, toolchains and the like.
-</p>
-
-<p>
-However, if you do not plan to tweak the bootstrapping instructions in the
-<path>bootstrap.sh</path> script written by the Gentoo developers, then a
-stage1 approach has no benefits for you.
-</p>
-
-<table>
-<tr>
- <th>Stage1</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>
- Allows you to have total control over the installation routine, bootstrap
- sequence, etc.
- </ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Suitable for powerusers and developers who know what they are doing</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Takes a long time to finish the installation (it is the lengthiest approach)
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- If you don't intend to tweak the settings, it is a waste of time
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage2 Approach</title>
-<body>
-
-<p>
-A <e>stage2</e> is used for building the entire system from a bootstrapped
-"semi-compiled" state.
-</p>
-
-<p>
-When you perform a stage2 installation approach, you will build all system
-packages (core packages, including toolchain) using your specific <c>USE</c>,
-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
-optimized to your preference.
-</p>
-
-<p>
-However, this installation takes some time and if you do not intend to change
-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
-default", using this approach only makes sense if your <c>USE</c> variable is
-sufficiently different from the default <c>USE</c> we provide.
-</p>
-
-<table>
-<tr>
- <th>Stage2</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>You don't need to bootstrap</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Faster than starting with stage1</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>You can still tweak your settings</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>It's still not the fastest way to install Gentoo</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage3 Approach</title>
-<body>
-
-<p>
-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
-built for you. You will only need to build a few packages (such as system
-logger, networking tools, ...) before you can boot into a base Gentoo
-installation.
-</p>
-
-<p>
-Choosing to go with a stage3 allows for the fastest install of Gentoo
-Linux, but also means that your base system will have the optimization
-settings that we chose for you (which to be honest, are good settings
-and were carefully chosen to enhance performance while maintaining
-stability). Stage3 is also required if you want to install Gentoo using
-prebuilt packages or without a network connection.
-</p>
-
-<table>
1.35 +24 -215 xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml?rev=1.35&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml?rev=1.35&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml.diff?r1=1.34&r2=1.35&cvsroot=gentoo
Index: hb-install-hppa-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- hb-install-hppa-medium.xml 25 Oct 2005 17:27:35 -0000 1.34
+++ hb-install-hppa-medium.xml 11 Nov 2005 17:27:15 -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/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v 1.34 2005/10/25 17:27:35 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v 1.35 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>1.27</version>
-<date>2005-10-09</date>
+<version>1.28</version>
+<date>2005-11-11</date>
<section>
<title>Hardware Requirements</title>
@@ -56,206 +56,6 @@
<!-- Copy/paste from hb-install-x86-medium.xml -->
<!-- START -->
<section>
-<title>The Gentoo Installation Approaches</title>
-<subsection>
-<title>Introduction</title>
-<body>
-
-<p>
-Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
-A stage file is a tarball (compressed archive) that contains a minimal
-environment.
-</p>
-
-<ul>
- <li>
- A stage1 file contains nothing more than a compiler, Portage (Gentoo's
- software management system) and a couple of packages on which the compiler
- or Portage depends.
- </li>
- <li>
- A stage2 file contains a so-called bootstrapped system, a minimal
- environment from which one can start building all other necessary
- applications that make a Gentoo environment complete.
- </li>
- <li>
- A stage3 file contains a prebuilt minimal system which is almost fully
- deployable. It only lacks a few applications where you, the Gentoo user,
- needs to choose which one you want to install.
- </li>
-</ul>
-
-<p>
-To help you decide what stage file you want to use, we have written down the
-major advantages and disadvantages of each stage file.
-</p>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage1 Approach</title>
-<body>
-
-<p>
-A <e>stage1</e> is used when you want to bootstrap and build the entire system
-from scratch.
-</p>
-
-<p>
-This approach builds core system packages that are vital to your system and is
-used by Gentoo developers to prepare the Gentoo release media. It is a great
-installation method for those who would like to learn more about the inner
-workings of bootstrapping, toolchains and the like.
-</p>
-
-<p>
-However, if you do not plan to tweak the bootstrapping instructions in the
-<path>bootstrap.sh</path> script written by the Gentoo developers, then a
-stage1 approach has no benefits for you.
-</p>
-
-<table>
-<tr>
- <th>Stage1</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>
- Allows you to have total control over the installation routine, bootstrap
- sequence, etc.
- </ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Suitable for powerusers and developers who know what they are doing</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Takes a long time to finish the installation (it is the lengthiest approach)
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- If you don't intend to tweak the settings, it is a waste of time
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage2 Approach</title>
-<body>
-
-<p>
-A <e>stage2</e> is used for building the entire system from a bootstrapped
-"semi-compiled" state.
-</p>
-
-<p>
-When you perform a stage2 installation approach, you will build all system
-packages (core packages, including toolchain) using your specific <c>USE</c>,
-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
-optimized to your preference.
-</p>
-
-<p>
-However, this installation takes some time and if you do not intend to change
-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
-default", using this approach only makes sense if your <c>USE</c> variable is
-sufficiently different from the default <c>USE</c> we provide.
-</p>
-
-<table>
-<tr>
- <th>Stage2</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>You don't need to bootstrap</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Faster than starting with stage1</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>You can still tweak your settings</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>It's still not the fastest way to install Gentoo</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage3 Approach</title>
-<body>
-
-<p>
-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
-built for you. You will only need to build a few packages (such as system
-logger, networking tools, ...) before you can boot into a base Gentoo
-installation.
-</p>
-
-<p>
-Choosing to go with a stage3 allows for the fastest install of Gentoo
-Linux, but also means that your base system will have the optimization
-settings that we chose for you (which to be honest, are good settings
-and were carefully chosen to enhance performance while maintaining
-stability). Stage3 is also required if you want to install Gentoo using
-prebuilt packages or without a network connection.
-</p>
-
-<table>
1.16 +21 -204 xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml?rev=1.16&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml?rev=1.16&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml.diff?r1=1.15&r2=1.16&cvsroot=gentoo
Index: hb-install-mips-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- hb-install-mips-medium.xml 9 Oct 2005 16:33:54 -0000 1.15
+++ hb-install-mips-medium.xml 11 Nov 2005 17:27:15 -0000 1.16
@@ -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-mips-medium.xml,v 1.15 2005/10/09 16:33:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml,v 1.16 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>1.10</version>
-<date>2005-10-09</date>
+<version>1.11</version>
+<date>2005-11-11</date>
<section>
<title>Hardware Requirements</title>
@@ -51,208 +51,9 @@
</body>
</subsection>
</section>
-<!-- Only the stuff about the stages is replicated from the
- hb-install-x86-medium.xml file since MIPS uses netbooting
- -->
-<!-- START -->
-<section>
-<title>The Gentoo Installation Approaches</title>
-<subsection>
-<title>Introduction</title>
-<body>
-
-<p>
-Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
-A stage file is a tarball (compressed archive) that contains a minimal
-environment.
-</p>
-
-<ul>
- <li>
- A stage1 file contains nothing more than a compiler, Portage (Gentoo's
- software management system) and a couple of packages on which the compiler
- or Portage depends.
- </li>
- <li>
- A stage2 file contains a so-called bootstrapped system, a minimal
- environment from which one can start building all other necessary
- applications that make a Gentoo environment complete.
- </li>
- <li>
- A stage3 file contains a prebuilt minimal system which is almost fully
- deployable. It only lacks a few applications where you, the Gentoo user,
- needs to choose which one you want to install.
- </li>
-</ul>
-
-<p>
-To help you decide what stage file you want to use, we have written down the
-major advantages and disadvantages of each stage file.
-</p>
-</body>
-</subsection>
-<subsection>
-<title>A Stage1 Approach</title>
-<body>
-
-<p>
-A <e>stage1</e> is used when you want to bootstrap and build the entire system
-from scratch.
-</p>
-
-<p>
-This approach builds core system packages that are vital to your system and is
-used by Gentoo developers to prepare the Gentoo release media. It is a great
-installation method for those who would like to learn more about the inner
-workings of bootstrapping, toolchains and the like.
-</p>
-
-<p>
-However, if you do not plan to tweak the bootstrapping instructions in the
-<path>bootstrap.sh</path> script written by the Gentoo developers, then a
-stage1 approach has no benefits for you.
-</p>
-
-<table>
-<tr>
- <th>Stage1</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>
- Allows you to have total control over the installation routine, bootstrap
- sequence, etc.
- </ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Suitable for powerusers and developers who know what they are doing</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Takes a long time to finish the installation (it is the lengthiest approach)
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- If you don't intend to tweak the settings, it is a waste of time
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage2 Approach</title>
-<body>
-
-<p>
-A <e>stage2</e> is used for building the entire system from a bootstrapped
-"semi-compiled" state.
-</p>
-
-<p>
-When you perform a stage2 installation approach, you will build all system
-packages (core packages, including toolchain) using your specific <c>USE</c>,
-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
-optimized to your preference.
-</p>
-
-<p>
-However, this installation takes some time and if you do not intend to change
-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
-default", using this approach only makes sense if your <c>USE</c> variable is
-sufficiently different from the default <c>USE</c> we provide.
-</p>
-
-<table>
-<tr>
- <th>Stage2</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>You don't need to bootstrap</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Faster than starting with stage1</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>You can still tweak your settings</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>It's still not the fastest way to install Gentoo</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage3 Approach</title>
-<body>
-
-<p>
-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
-built for you. You will only need to build a few packages (such as system
-logger, networking tools, ...) before you can boot into a base Gentoo
-installation.
-</p>
-
-<p>
-Choosing to go with a stage3 allows for the fastest install of Gentoo
-Linux, but also means that your base system will have the optimization
-settings that we chose for you (which to be honest, are good settings
-and were carefully chosen to enhance performance while maintaining
1.49 +24 -215 xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml?rev=1.49&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml?rev=1.49&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml.diff?r1=1.48&r2=1.49&cvsroot=gentoo
Index: hb-install-ppc-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v
retrieving revision 1.48
retrieving revision 1.49
diff -u -r1.48 -r1.49
--- hb-install-ppc-medium.xml 9 Oct 2005 16:33:54 -0000 1.48
+++ hb-install-ppc-medium.xml 11 Nov 2005 17:27:15 -0000 1.49
@@ -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-ppc-medium.xml,v 1.48 2005/10/09 16:33:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.49 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>2.6</version>
-<date>2005-10-09</date>
+<version>2.7</version>
+<date>2005-11-11</date>
<section>
<title>Hardware Requirements</title>
@@ -81,206 +81,6 @@
<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) -->
<!-- START -->
<section>
-<title>The Gentoo Installation Approaches</title>
-<subsection>
-<title>Introduction</title>
-<body>
-
-<p>
-Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
-A stage file is a tarball (compressed archive) that contains a minimal
-environment.
-</p>
-
-<ul>
- <li>
- A stage1 file contains nothing more than a compiler, Portage (Gentoo's
- software management system) and a couple of packages on which the compiler
- or Portage depends.
- </li>
- <li>
- A stage2 file contains a so-called bootstrapped system, a minimal
- environment from which one can start building all other necessary
- applications that make a Gentoo environment complete.
- </li>
- <li>
- A stage3 file contains a prebuilt minimal system which is almost fully
- deployable. It only lacks a few applications where you, the Gentoo user,
- needs to choose which one you want to install.
- </li>
-</ul>
-
-<p>
-To help you decide what stage file you want to use, we have written down the
-major advantages and disadvantages of each stage file.
-</p>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage1 Approach</title>
-<body>
-
-<p>
-A <e>stage1</e> is used when you want to bootstrap and build the entire system
-from scratch.
-</p>
-
-<p>
-This approach builds core system packages that are vital to your system and is
-used by Gentoo developers to prepare the Gentoo release media. It is a great
-installation method for those who would like to learn more about the inner
-workings of bootstrapping, toolchains and the like.
-</p>
-
-<p>
-However, if you do not plan to tweak the bootstrapping instructions in the
-<path>bootstrap.sh</path> script written by the Gentoo developers, then a
-stage1 approach has no benefits for you.
-</p>
-
-<table>
-<tr>
- <th>Stage1</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>
- Allows you to have total control over the installation routine, bootstrap
- sequence, etc.
- </ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Suitable for powerusers and developers who know what they are doing</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Takes a long time to finish the installation (it is the lengthiest approach)
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- If you don't intend to tweak the settings, it is a waste of time
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage2 Approach</title>
-<body>
-
-<p>
-A <e>stage2</e> is used for building the entire system from a bootstrapped
-"semi-compiled" state.
-</p>
-
-<p>
-When you perform a stage2 installation approach, you will build all system
-packages (core packages, including toolchain) using your specific <c>USE</c>,
-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
-optimized to your preference.
-</p>
-
-<p>
-However, this installation takes some time and if you do not intend to change
-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
-default", using this approach only makes sense if your <c>USE</c> variable is
-sufficiently different from the default <c>USE</c> we provide.
-</p>
-
-<table>
-<tr>
- <th>Stage2</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>You don't need to bootstrap</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Faster than starting with stage1</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>You can still tweak your settings</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>It's still not the fastest way to install Gentoo</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage3 Approach</title>
-<body>
-
-<p>
-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
-built for you. You will only need to build a few packages (such as system
-logger, networking tools, ...) before you can boot into a base Gentoo
-installation.
-</p>
-
-<p>
-Choosing to go with a stage3 allows for the fastest install of Gentoo
-Linux, but also means that your base system will have the optimization
-settings that we chose for you (which to be honest, are good settings
-and were carefully chosen to enhance performance while maintaining
-stability). Stage3 is also required if you want to install Gentoo using
-prebuilt packages or without a network connection.
-</p>
-
-<table>
1.25 +21 -211 xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml?rev=1.25&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml?rev=1.25&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml.diff?r1=1.24&r2=1.25&cvsroot=gentoo
Index: hb-install-ppc64-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- hb-install-ppc64-medium.xml 9 Oct 2005 16:33:54 -0000 1.24
+++ hb-install-ppc64-medium.xml 11 Nov 2005 17:27:15 -0000 1.25
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.24 2005/10/09 16:33:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.25 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>2.7</version>
-<date>2005-10-09</date>
+<version>2.8</version>
+<date>2005-11-11</date>
<section>
<title>Hardware Requirements</title>
@@ -64,206 +64,6 @@
<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
<!-- START -->
<section>
-<title>The Gentoo Installation Approaches</title>
-<subsection>
-<title>Introduction</title>
-<body>
-
-<p>
-Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
-A stage file is a tarball (compressed archive) that contains a minimal
-environment.
-</p>
-
-<ul>
- <li>
- A stage1 file contains nothing more than a compiler, Portage (Gentoo's
- software management system) and a couple of packages on which the compiler
- or Portage depends.
- </li>
- <li>
- A stage2 file contains a so-called bootstrapped system, a minimal
- environment from which one can start building all other necessary
- applications that make a Gentoo environment complete.
- </li>
- <li>
- A stage3 file contains a prebuilt minimal system which is almost fully
- deployable. It only lacks a few applications where you, the Gentoo user,
- needs to choose which one you want to install.
- </li>
-</ul>
-
-<p>
-To help you decide what stage file you want to use, we have written down the
-major advantages and disadvantages of each stage file.
-</p>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage1 Approach</title>
-<body>
-
-<p>
-A <e>stage1</e> is used when you want to bootstrap and build the entire system
-from scratch.
-</p>
-
-<p>
-This approach builds core system packages that are vital to your system and is
-used by Gentoo developers to prepare the Gentoo release media. It is a great
-installation method for those who would like to learn more about the inner
-workings of bootstrapping, toolchains and the like.
-</p>
-
-<p>
-However, if you do not plan to tweak the bootstrapping instructions in the
-<path>bootstrap.sh</path> script written by the Gentoo developers, then a
-stage1 approach has no benefits for you.
-</p>
-
-<table>
-<tr>
- <th>Stage1</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>
- Allows you to have total control over the installation routine, bootstrap
- sequence, etc.
- </ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Suitable for powerusers and developers who know what they are doing</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Takes a long time to finish the installation (it is the lengthiest approach)
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- If you don't intend to tweak the settings, it is a waste of time
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage2 Approach</title>
-<body>
-
-<p>
-A <e>stage2</e> is used for building the entire system from a bootstrapped
-"semi-compiled" state.
-</p>
-
-<p>
-When you perform a stage2 installation approach, you will build all system
-packages (core packages, including toolchain) using your specific <c>USE</c>,
-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
-optimized to your preference.
-</p>
-
-<p>
-However, this installation takes some time and if you do not intend to change
-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
-default", using this approach only makes sense if your <c>USE</c> variable is
-sufficiently different from the default <c>USE</c> we provide.
-</p>
-
-<table>
-<tr>
- <th>Stage2</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>You don't need to bootstrap</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Faster than starting with stage1</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>You can still tweak your settings</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>It's still not the fastest way to install Gentoo</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage3 Approach</title>
-<body>
-
-<p>
-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
-built for you. You will only need to build a few packages (such as system
-logger, networking tools, ...) before you can boot into a base Gentoo
-installation.
-</p>
-
-<p>
-Choosing to go with a stage3 allows for the fastest install of Gentoo
-Linux, but also means that your base system will have the optimization
-settings that we chose for you (which to be honest, are good settings
-and were carefully chosen to enhance performance while maintaining
-stability). Stage3 is also required if you want to install Gentoo using
-prebuilt packages or without a network connection.
-</p>
-
-<table>
1.36 +24 -215 xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml?rev=1.36&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml?rev=1.36&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml.diff?r1=1.35&r2=1.36&cvsroot=gentoo
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.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- hb-install-sparc-medium.xml 9 Oct 2005 16:33:54 -0000 1.35
+++ hb-install-sparc-medium.xml 11 Nov 2005 17:27:15 -0000 1.36
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.35 2005/10/09 16:33:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.36 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>2.5</version>
-<date>2005-10-09</date>
+<version>2.6</version>
+<date>2005-11-11</date>
<section>
<title>Hardware Requirements</title>
@@ -63,206 +63,6 @@
<!-- Warning: The part originally contains "x86" -->
<!-- START -->
<section>
-<title>The Gentoo Installation Approaches</title>
-<subsection>
-<title>Introduction</title>
-<body>
-
-<p>
-Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
-A stage file is a tarball (compressed archive) that contains a minimal
-environment.
-</p>
-
-<ul>
- <li>
- A stage1 file contains nothing more than a compiler, Portage (Gentoo's
- software management system) and a couple of packages on which the compiler
- or Portage depends.
- </li>
- <li>
- A stage2 file contains a so-called bootstrapped system, a minimal
- environment from which one can start building all other necessary
- applications that make a Gentoo environment complete.
- </li>
- <li>
- A stage3 file contains a prebuilt minimal system which is almost fully
- deployable. It only lacks a few applications where you, the Gentoo user,
- needs to choose which one you want to install.
- </li>
-</ul>
-
-<p>
-To help you decide what stage file you want to use, we have written down the
-major advantages and disadvantages of each stage file.
-</p>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage1 Approach</title>
-<body>
-
-<p>
-A <e>stage1</e> is used when you want to bootstrap and build the entire system
-from scratch.
-</p>
-
-<p>
-This approach builds core system packages that are vital to your system and is
-used by Gentoo developers to prepare the Gentoo release media. It is a great
-installation method for those who would like to learn more about the inner
-workings of bootstrapping, toolchains and the like.
-</p>
-
-<p>
-However, if you do not plan to tweak the bootstrapping instructions in the
-<path>bootstrap.sh</path> script written by the Gentoo developers, then a
-stage1 approach has no benefits for you.
-</p>
-
-<table>
-<tr>
- <th>Stage1</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>
- Allows you to have total control over the installation routine, bootstrap
- sequence, etc.
- </ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Suitable for powerusers and developers who know what they are doing</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Takes a long time to finish the installation (it is the lengthiest approach)
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- If you don't intend to tweak the settings, it is a waste of time
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage2 Approach</title>
-<body>
-
-<p>
-A <e>stage2</e> is used for building the entire system from a bootstrapped
-"semi-compiled" state.
-</p>
-
-<p>
-When you perform a stage2 installation approach, you will build all system
-packages (core packages, including toolchain) using your specific <c>USE</c>,
-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
-optimized to your preference.
-</p>
-
-<p>
-However, this installation takes some time and if you do not intend to change
-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
-default", using this approach only makes sense if your <c>USE</c> variable is
-sufficiently different from the default <c>USE</c> we provide.
-</p>
-
-<table>
-<tr>
- <th>Stage2</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>You don't need to bootstrap</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Faster than starting with stage1</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>You can still tweak your settings</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>It's still not the fastest way to install Gentoo</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage3 Approach</title>
-<body>
-
-<p>
-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
-built for you. You will only need to build a few packages (such as system
-logger, networking tools, ...) before you can boot into a base Gentoo
-installation.
-</p>
-
-<p>
-Choosing to go with a stage3 allows for the fastest install of Gentoo
-Linux, but also means that your base system will have the optimization
-settings that we chose for you (which to be honest, are good settings
-and were carefully chosen to enhance performance while maintaining
-stability). Stage3 is also required if you want to install Gentoo using
-prebuilt packages or without a network connection.
-</p>
-
-<table>
1.90 +17 -106 xml/htdocs/doc/en/handbook/hb-install-stage.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.90&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.90&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-stage.xml.diff?r1=1.89&r2=1.90&cvsroot=gentoo
Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.89
retrieving revision 1.90
diff -u -r1.89 -r1.90
--- hb-install-stage.xml 13 Aug 2005 21:21:30 -0000 1.89
+++ hb-install-stage.xml 11 Nov 2005 17:27:15 -0000 1.90
@@ -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-stage.xml,v 1.89 2005/08/13 21:21:30 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.90 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>2.5</version>
-<date>2005-08-13</date>
+<version>2.6</version>
+<date>2005-11-11</date>
<section>
<title>Installing a Stage Tarball</title>
@@ -49,8 +49,8 @@
<body>
<p>
-The next step you need to perform is to install the <e>stage</e> tarball of
-your choice onto your system. You have the option of downloading the required
+The next step you need to perform is to install the <e>stage3</e> tarball
+onto your system. You have the option of downloading the required
tarball from the Internet or, if you are booted from one of the Gentoo
Universal Installation CDs, copy it over from the CD itself. If you have a
Universal CD and the stage you want to use is on the CD, downloading it from
@@ -124,14 +124,19 @@
</pre>
<p>
+Make sure you download a stage3 tarball - installations using a stage1 or stage2
+tarball are not supported anymore.
+</p>
+
+<p>
If you want to check the integrity of the downloaded stage tarball, use
<c>md5sum</c> and compare the output with the MD5 checksum provided on the
mirror. For instance, to check the validity of the x86 stage tarball:
</p>
<pre caption="Example checking integrity of a stage tarball">
-# <i>md5sum -c stage1-x86-2005.1.tar.bz2.md5</i>
-stage1-x86-2005.1.tar.bz2: OK
+# <i>md5sum -c stage3-x86-2005.1.tar.bz2.md5</i>
+stage3-x86-2005.1.tar.bz2: OK
</pre>
</body>
@@ -146,7 +151,7 @@
</p>
<pre caption="Unpacking the stage">
-# <i>tar -xvjpf stage?-*.tar.bz2</i>
+# <i>tar -xvjpf stage3-*.tar.bz2</i>
</pre>
<p>
@@ -340,105 +345,11 @@
<title>CHOST</title>
<body>
-<warn>
-Although it might be tempting for non-stage1 users, they should <e>not</e>
-change the <c>CHOST</c> setting in <path>make.conf</path>. Doing so might render
-their system unusable. Again: only change this variable if you use a
-<e>stage1</e> installation.
-</warn>
-
-<p>
-The <c>CHOST</c> variable defines what architecture <c>gcc</c> has to
-compile programs for. The possibilities are:
-</p>
-
-<table>
-<tr>
- <th>Architecture</th>
- <th>Subarchitecture</th>
- <th>CHOST Setting</th>
-</tr>
-<tr>
- <ti>x86</ti>
- <ti>i386</ti>
- <ti>i386-pc-linux-gnu</ti>
-</tr>
-<tr>
- <ti>x86</ti>
- <ti>i486</ti>
- <ti>i486-pc-linux-gnu</ti>
-</tr>
-<tr>
- <ti>x86</ti>
- <ti>i586</ti>
- <ti>i586-pc-linux-gnu</ti>
-</tr>
-<tr>
- <ti>x86</ti>
- <ti>i686 and above (incl. athlon)</ti>
- <ti>i686-pc-linux-gnu</ti>
-</tr>
-<tr>
- <ti>alpha</ti>
- <ti></ti>
- <ti>alpha-unknown-linux-gnu</ti>
-</tr>
-<tr>
- <ti>ppc</ti>
- <ti></ti>
- <ti>powerpc-unknown-linux-gnu</ti>
-</tr>
-<tr>
- <ti>ppc64</ti>
- <ti></ti>
- <ti>powerpc64-unknown-linux-gnu</ti>
-</tr>
-<tr>
- <ti>sparc</ti>
- <ti></ti>
- <ti>sparc-unknown-linux-gnu</ti>
-</tr>
-<tr>
- <ti>sparc64</ti>
- <ti></ti>
- <ti>sparc-unknown-linux-gnu</ti>
-</tr>
-<tr>
- <ti>hppa</ti>
- <ti>(generic)</ti>
- <ti>hppa-unknown-linux-gnu</ti>
-</tr>
-<tr>
- <ti>hppa</ti>
- <ti>pa7000</ti>
- <ti>hppa1.1-unknown-linux-gnu</ti>
-</tr>
-<tr>
- <ti>hppa</ti>
- <ti>pa8000 and above</ti>
- <ti>hppa2.0-unknown-linux-gnu</ti>
-</tr>
-<tr>
- <ti>mips</ti>
- <ti></ti>
- <ti>mips-unknown-linux-gnu</ti>
-</tr>
-<tr>
- <ti>amd64</ti>
- <ti></ti>
- <ti>x86_64-pc-linux-gnu</ti>
-</tr>
-</table>
-
-<p>
-Please, make sure that you use the <e>correct</e> CHOST setting. For instance,
-the CHOST setting for sparc64 still is <c>sparc-unknown-linux-gnu</c> and
-<e>not</e> <c>sparc64-unknown-linux-gnu</c>!
-</p>
-
<p>
-Users interested in bootstrapping their entire system with NPTL support on an
-x86 system need to set their CHOST to <c>i586-pc-linux-gnu</c> or higher.
+The <c>CHOST</c> variable declares the target build host for your system. This
+variable should already be set to the correct value. <brite>Do not edit
+it</brite> as that might break your system. If the <c>CHOST</c> variable does
+not look correct to you, you might be using the wrong stage3 tarball.
</p>
</body>
1.85 +9 -203 xml/htdocs/doc/en/handbook/hb-install-system.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.85&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.85&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml.diff?r1=1.84&r2=1.85&cvsroot=gentoo
Index: hb-install-system.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v
retrieving revision 1.84
retrieving revision 1.85
diff -u -r1.84 -r1.85
--- hb-install-system.xml 16 Aug 2005 22:14:44 -0000 1.84
+++ hb-install-system.xml 11 Nov 2005 17:27:15 -0000 1.85
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.84 2005/08/16 22:14:44 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.85 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>2.11</version>
-<date>2005-08-17</date>
+<version>2.12</version>
+<date>2005-11-11</date>
<section>
<title>Chrooting</title>
@@ -124,6 +124,10 @@
</body>
</subsection>
+</section>
+
+<section>
+<title>Configuring Portage</title>
<subsection>
<title>Updating the Portage tree</title>
<body>
@@ -341,8 +345,7 @@
after compiling <c>glibc</c> a full set of all available locales will be
created. As of now you can activate the <c>userlocales</c> USE flag and specify
only the locales you will need in <path>/etc/locales.build</path>. Only do this
-if you know what locales to choose. This will not work for the bootstrapping,
-but when you recompile glibc afterwards it will.
+if you know what locales to choose.
</p>
<pre caption="Activate the userlocales USE flag especially for glibc">
@@ -370,208 +373,11 @@
de_DE@euro/ISO-8859-15
</pre>
-</body>
-</subsection>
-</section>
-<section>
-<title>Differences between Stage1, Stage2 and Stage3</title>
-<body>
-
-<p>
-Now take a seat and think of your previous steps. We asked you to
-select a <e>stage1</e>, <e>stage2</e> or <e>stage3</e> and warned you
-that your choice is important for further installation steps. Well, this
-is the first place where your choice defines the subsequent steps.
-</p>
-
-<ul>
-<li>
- If you chose <e>stage1</e>, then you have to follow <e>both</e> steps in
- this chapter (starting with <uri link="#doc_chap3">Progressing from Stage1
- to Stage2</uri>)
-</li>
-<li>
- If you chose <e>stage2</e> you only can skip the first step
- and immediately start with the second one (<uri link="#doc_chap4">Progressing
- from Stage2 to Stage3</uri>)
-</li>
-<li>
- If you chose <e>stage3</e> then you can skip both
- steps and continue with <uri link="?part=1&chap=7">Configuring the
- Kernel</uri>
-</li>
-</ul>
-
-</body>
-</section>
-<section>
-<title>Progressing from Stage1 to Stage2</title>
-<subsection>
-<title>Introduction to Bootstrapping</title>
-<body>
-
-<p>
-So, you want to compile everything from scratch? Okay then :-)
-</p>
-
-<p>
-In this step, we will <e>bootstrap</e> your Gentoo system. This takes a
-long time, but the result is a system that has been optimized from the
-ground up for your specific machine and needs.
-</p>
-
-<p>
-<e>Bootstrapping</e> means building the GNU C Library, GNU Compiler
-Collection and several other key system programs.
-</p>
-
-<p>
-Before starting the bootstrap, you might want to download all necessary
-sourcecode first. If you do not want to do this, continue
-with <uri link="#bootstrap">Bootstrapping the System</uri>.
-</p>
-
-</body>
-</subsection>
-<subsection>
-<title>Optional: Downloading the Sources First</title>
-<body>
-
-<p>
-If you haven't copied over all source code before, then the bootstrap
-script will download all necessary files. If you want to
-download the source code first and later bootstrap the system (for instance
-because you don't want to have your internet connection open during the
-compilation) use the <e>-f</e> option of the bootstrap script, which will
-fetch (hence the letter <e>f</e>) all source code for you.
-</p>
-
-<pre caption = "Downloading the necessary sources">
-# <i>cd /usr/portage</i>
-# <i>scripts/bootstrap.sh -f</i>
-</pre>
-
-</body>
-</subsection>
-<subsection id="bootstrap">
-<title>Bootstrapping the System</title>
-<body>
-
-<p>
-Okay then, take your keyboard and punch in the next commands to start
-the bootstrap. Then go amuse yourself with something else because this step
-takes quite some time to finish.
-</p>
-
-<pre caption = "Bootstrapping the system">
-# <i>cd /usr/portage</i>
-# <i>scripts/bootstrap.sh</i>
-</pre>
-
-<p>
-Now continue with the next step, <uri link="#doc_chap4">Progressing from Stage2
-to Stage3</uri>.
-</p>
-
-</body>
-</subsection>
-</section>
-<section>
-<title>Progressing from Stage2 to Stage3</title>
-<subsection>
-<title>Introduction</title>
-<body>
-
-<p>
-If you are reading this section, then you have a bootstrapped system
-(either because you bootstrapped it previously, or you are using a
-<e>stage2</e>). Then it is now time to build all system packages.
-</p>
-
-<p>
-<e>All</e> system packages? No, not really. In this step, you will build
-the system packages of which there are no alternatives to use.
-Some system packages have several alternatives (such as system loggers)
-and as Gentoo is all about choices, we don't want to force one upon you.
-</p>
-
-</body>
-</subsection>
-<subsection>
-<title>Optional: Viewing what will be done</title>
-<body>
-
-<p>
-If you want to know what packages will be installed, execute <c>emerge
---pretend --emptytree system</c>. This will list all packages that will be
-built. As this list is pretty big, you should also use a pager like
-<c>less</c> or <c>more</c> to go up and down the list.
-</p>
-
-<pre caption = "View what 'emerge system' will do">
-# <i>emerge --pretend --emptytree system | less</i>
-</pre>
-
-<p>
-Note that, if you haven't touched the default CFLAGS/CXXFLAGS setting, using
-<c>emerge --pretend --newuse system</c> is sufficient: it will rebuild the
-applications that are affected by a change in USE flags (compared to the USE
-flag we used while building the stage2). If you didn't touch
-the USE flag either, why are you running a stage2 installation then?
-</p>
-
1.41 +24 -214 xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml?rev=1.41&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml?rev=1.41&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml.diff?r1=1.40&r2=1.41&cvsroot=gentoo
Index: hb-install-x86-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- hb-install-x86-medium.xml 9 Oct 2005 16:33:54 -0000 1.40
+++ hb-install-x86-medium.xml 11 Nov 2005 17:27:15 -0000 1.41
@@ -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-x86-medium.xml,v 1.40 2005/10/09 16:33:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml,v 1.41 2005/11/11 17:27:15 swift Exp $ -->
<sections>
-<version>2.5</version>
-<date>2005-10-09</date>
+<version>2.6</version>
+<date>2005-11-11</date>
<section>
<title>Hardware Requirements</title>
@@ -53,205 +53,6 @@
<!-- This part can be propagated to the other architectures as well. -->
<!-- START -->
<section>
-<title>The Gentoo Installation Approaches</title>
-<subsection>
-<title>Introduction</title>
-<body>
-
-<p>
-Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
-A stage file is a tarball (compressed archive) that contains a minimal
-environment.
-</p>
-
-<ul>
- <li>
- A stage1 file contains nothing more than a compiler, Portage (Gentoo's
- software management system) and a couple of packages on which the compiler
- or Portage depends.
- </li>
- <li>
- A stage2 file contains a so-called bootstrapped system, a minimal
- environment from which one can start building all other necessary
- applications that make a Gentoo environment complete.
- </li>
- <li>
- A stage3 file contains a prebuilt minimal system which is almost fully
- deployable. It only lacks a few applications where you, the Gentoo user,
- needs to choose which one you want to install.
- </li>
-</ul>
-
-<p>
-To help you decide what stage file you want to use, we have written down the
-major advantages and disadvantages of each stage file.
-</p>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage1 Approach</title>
-<body>
-
-<p>
-A <e>stage1</e> is used when you want to bootstrap and build the entire system
-from scratch.
-</p>
-
-<p>
-This approach builds core system packages that are vital to your system and is
-used by Gentoo developers to prepare the Gentoo release media. It is a great
-installation method for those who would like to learn more about the inner
-workings of bootstrapping, toolchains and the like.
-</p>
-
-<p>
-However, if you do not plan to tweak the bootstrapping instructions in the
-<path>bootstrap.sh</path> script written by the Gentoo developers, then a
-stage1 approach has no benefits for you.
-</p>
-
-<table>
-<tr>
- <th>Stage1</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>
- Allows you to have total control over the installation routine, bootstrap
- sequence, etc.
- </ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Suitable for powerusers and developers who know what they are doing</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Takes a long time to finish the installation (it is the lengthiest approach)
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- If you don't intend to tweak the settings, it is a waste of time
- </ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage2 Approach</title>
-<body>
-
-<p>
-A <e>stage2</e> is used for building the entire system from a bootstrapped
-"semi-compiled" state.
-</p>
-
-<p>
-When you perform a stage2 installation approach, you will build all system
-packages (core packages, including toolchain) using your specific <c>USE</c>,
-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
-optimized to your preference.
-</p>
-
-<p>
-However, this installation takes some time and if you do not intend to change
-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
-default", using this approach only makes sense if your <c>USE</c> variable is
-sufficiently different from the default <c>USE</c> we provide.
-</p>
-
-<table>
-<tr>
- <th>Stage2</th>
- <th>Pros and Cons</th>
-</tr>
-<tr>
- <th>+</th>
- <ti>You don't need to bootstrap</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>Faster than starting with stage1</ti>
-</tr>
-<tr>
- <th>+</th>
- <ti>You can still tweak your settings</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>It's still not the fastest way to install Gentoo</ti>
-</tr>
-<tr>
- <th>-</th>
- <ti>
- Requires a working Internet connection during the installation
- </ti>
-</tr>
-</table>
-
-</body>
-</subsection>
-<subsection>
-<title>A Stage3 Approach</title>
-<body>
-
-<p>
-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
-built for you. You will only need to build a few packages (such as system
-logger, networking tools, ...) before you can boot into a base Gentoo
-installation.
-</p>
-
-<p>
-Choosing to go with a stage3 allows for the fastest install of Gentoo
-Linux, but also means that your base system will have the optimization
-settings that we chose for you (which to be honest, are good settings
-and were carefully chosen to enhance performance while maintaining
-stability). Stage3 is also required if you want to install Gentoo using
-prebuilt packages or without a network connection.
-</p>
-
-<table>
1.55 +7 -14 xml/htdocs/doc/en/handbook/index.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/index.xml?rev=1.55&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/index.xml?rev=1.55&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/index.xml.diff?r1=1.54&r2=1.55&cvsroot=gentoo
Index: index.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/index.xml,v
retrieving revision 1.54
retrieving revision 1.55
diff -u -r1.54 -r1.55
--- index.xml 8 Aug 2005 13:48:40 -0000 1.54
+++ index.xml 11 Nov 2005 17:27:15 -0000 1.55
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/index.xml,v 1.54 2005/08/08 13:48:40 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/index.xml,v 1.55 2005/11/11 17:27:15 swift Exp $ -->
<guide link="index.xml">
<title>Gentoo Handbook</title>
@@ -19,8 +19,8 @@
<license/>
-<version>0.29</version>
-<date>2005-08-08</date>
+<version>0.30</version>
+<date>2005-11-11</date>
<chapter>
<title>The Gentoo Handbook Effort</title>
@@ -290,9 +290,7 @@
<p>
By not separating the instructions for each possible option, the user can view
the results of the other choices easily. This provides a <b>better view on the
-installation instructions</b> for the user: even though they chose - for
-instance - stage3, they are easily informed about what stage2 or stage1 does.
-Not hiding these instructions is a good thing.
+installation instructions</b> for the user.
</p>
</body>
@@ -302,14 +300,9 @@
<body>
<p>
-You are reading the wrong Gentoo Handbook.
-</p>
-
-<p>
-The release-specific Gentoo Handbooks (such as the 2005.0 one) are meant for
-networkless installations only. Running a stage1 or stage2 installation requires
-source code that isn't available on the universal installation CD, so you would
-need a working Internet connection to do a stage1 or stage2 installation.
+Instructions on using a stage1 or stage2 tarball are now available in the <uri
+link="/doc/en/faq.xml#stage12">Gentoo FAQ</uri>. A stage3 installation is the
+only supported installation as of now.
</p>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-12-19 12:28 Jan Kundrat
0 siblings, 0 replies; 25+ messages in thread
From: Jan Kundrat @ 2005-12-19 12:28 UTC (permalink / raw
To: gentoo-doc-cvs
jkt 05/12/19 12:28:29
Modified: xml/htdocs/doc/en/handbook handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-mips.xml handbook-ppc.xml
handbook-ppc64.xml handbook-sparc.xml
handbook-x86.xml
Log:
#114938, s/internet/Internet/, s/centralise/centralize/ - *NO CONTENT CHANGE*
Revision Changes Path
1.119 +3 -3 xml/htdocs/doc/en/handbook/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.119&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.119&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml.diff?r1=1.118&r2=1.119&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v
retrieving revision 1.118
retrieving revision 1.119
diff -u -r1.118 -r1.119
--- handbook-alpha.xml 11 Nov 2005 17:27:15 -0000 1.118
+++ handbook-alpha.xml 19 Dec 2005 12:28:29 -0000 1.119
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.118 2005/11/11 17:27:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.119 2005/12/19 12:28:29 jkt Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux Alpha Handbook</title>
@@ -112,8 +112,8 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
-This handbook contains the installation instructions for an internet-based
+This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
+This handbook contains the installation instructions for an Internet-based
installation on Alpha systems and parts about working with Gentoo and Portage.
</abstract>
1.127 +3 -3 xml/htdocs/doc/en/handbook/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.127&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.127&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml.diff?r1=1.126&r2=1.127&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v
retrieving revision 1.126
retrieving revision 1.127
diff -u -r1.126 -r1.127
--- handbook-amd64.xml 11 Nov 2005 17:27:15 -0000 1.126
+++ handbook-amd64.xml 19 Dec 2005 12:28:29 -0000 1.127
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.126 2005/11/11 17:27:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.127 2005/12/19 12:28:29 jkt Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux AMD64 Handbook</title>
@@ -112,8 +112,8 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
-This handbook contains the installation instructions for an internet-based
+This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
+This handbook contains the installation instructions for an Internet-based
installation on AMD64 systems and parts about working with Gentoo and Portage.
</abstract>
1.116 +3 -3 xml/htdocs/doc/en/handbook/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.116&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.116&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml.diff?r1=1.115&r2=1.116&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v
retrieving revision 1.115
retrieving revision 1.116
diff -u -r1.115 -r1.116
--- handbook-hppa.xml 11 Nov 2005 17:27:15 -0000 1.115
+++ handbook-hppa.xml 19 Dec 2005 12:28:29 -0000 1.116
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.115 2005/11/11 17:27:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.116 2005/12/19 12:28:29 jkt Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux HPPA Handbook</title>
@@ -112,8 +112,8 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
-This handbook contains the installation instructions for an internet-based
+This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
+This handbook contains the installation instructions for an Internet-based
installation on HPPA systems and parts about working with Gentoo and Portage.
</abstract>
1.106 +3 -3 xml/htdocs/doc/en/handbook/handbook-mips.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.106&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.106&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml.diff?r1=1.105&r2=1.106&cvsroot=gentoo
Index: handbook-mips.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v
retrieving revision 1.105
retrieving revision 1.106
diff -u -r1.105 -r1.106
--- handbook-mips.xml 11 Nov 2005 17:27:15 -0000 1.105
+++ handbook-mips.xml 19 Dec 2005 12:28:29 -0000 1.106
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.105 2005/11/11 17:27:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.106 2005/12/19 12:28:29 jkt Exp $ -->
<book link="handbook-mips.xml">
<title>Gentoo Linux/MIPS Handbook</title>
@@ -115,8 +115,8 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
-This handbook contains the installation instructions for an internet-based
+This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
+This handbook contains the installation instructions for an Internet-based
installation on MIPS systems and parts about working with Gentoo and Portage.
</abstract>
1.136 +3 -3 xml/htdocs/doc/en/handbook/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.136&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.136&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml.diff?r1=1.135&r2=1.136&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v
retrieving revision 1.135
retrieving revision 1.136
diff -u -r1.135 -r1.136
--- handbook-ppc.xml 11 Nov 2005 17:27:15 -0000 1.135
+++ handbook-ppc.xml 19 Dec 2005 12:28:29 -0000 1.136
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.135 2005/11/11 17:27:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.136 2005/12/19 12:28:29 jkt Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux PPC Handbook</title>
@@ -115,8 +115,8 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
-This handbook contains the installation instructions for an internet-based
+This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
+This handbook contains the installation instructions for an Internet-based
installation on PPC systems and parts about working with Gentoo and Portage.
</abstract>
1.58 +3 -3 xml/htdocs/doc/en/handbook/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.58&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.58&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml.diff?r1=1.57&r2=1.58&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v
retrieving revision 1.57
retrieving revision 1.58
diff -u -r1.57 -r1.58
--- handbook-ppc64.xml 11 Nov 2005 17:27:15 -0000 1.57
+++ handbook-ppc64.xml 19 Dec 2005 12:28:29 -0000 1.58
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.57 2005/11/11 17:27:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.58 2005/12/19 12:28:29 jkt Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux PPC64 Handbook</title>
@@ -112,8 +112,8 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
-This handbook contains the installation instructions for an internet-based
+This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
+This handbook contains the installation instructions for an Internet-based
installation on PPC64 systems and parts about working with Gentoo and Portage.
</abstract>
1.119 +3 -3 xml/htdocs/doc/en/handbook/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.119&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.119&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml.diff?r1=1.118&r2=1.119&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v
retrieving revision 1.118
retrieving revision 1.119
diff -u -r1.118 -r1.119
--- handbook-sparc.xml 11 Nov 2005 17:27:15 -0000 1.118
+++ handbook-sparc.xml 19 Dec 2005 12:28:29 -0000 1.119
@@ -1,7 +1,7 @@
<?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.118 2005/11/11 17:27:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v 1.119 2005/12/19 12:28:29 jkt Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux SPARC Handbook</title>
@@ -112,8 +112,8 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
-This handbook contains the installation instructions for an internet-based
+This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
+This handbook contains the installation instructions for an Internet-based
installation on Sparc systems and parts about working with Gentoo and Portage.
</abstract>
1.146 +3 -3 xml/htdocs/doc/en/handbook/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.146&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.146&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml.diff?r1=1.145&r2=1.146&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v
retrieving revision 1.145
retrieving revision 1.146
diff -u -r1.145 -r1.146
--- handbook-x86.xml 11 Nov 2005 17:27:15 -0000 1.145
+++ handbook-x86.xml 19 Dec 2005 12:28:29 -0000 1.146
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.145 2005/11/11 17:27:15 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.146 2005/12/19 12:28:29 jkt Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux x86 Handbook</title>
@@ -112,8 +112,8 @@
</author>
<abstract>
-This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
-This handbook contains the installation instructions for an internet-based
+This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
+This handbook contains the installation instructions for an Internet-based
installation on x86 systems and parts about working with Gentoo and Portage.
</abstract>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2005-12-19 12:36 Jan Kundrat
0 siblings, 0 replies; 25+ messages in thread
From: Jan Kundrat @ 2005-12-19 12:36 UTC (permalink / raw
To: gentoo-doc-cvs
jkt 05/12/19 12:36:16
Modified: xml/htdocs/doc/en/handbook handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-mips.xml handbook-ppc.xml
handbook-ppc64.xml handbook-sparc.xml
handbook-x86.xml
Log:
#114938, "handbook covers: no more choice between stages"
Revision Changes Path
1.120 +4 -4 xml/htdocs/doc/en/handbook/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.120&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.120&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-alpha.xml.diff?r1=1.119&r2=1.120&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v
retrieving revision 1.119
retrieving revision 1.120
diff -u -r1.119 -r1.120
--- handbook-alpha.xml 19 Dec 2005 12:28:29 -0000 1.119
+++ handbook-alpha.xml 19 Dec 2005 12:36:15 -0000 1.120
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.119 2005/12/19 12:28:29 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.120 2005/12/19 12:36:15 jkt Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux Alpha Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.2</version>
-<date>2005-11-11</date>
+<version>4.3</version>
+<date>2005-12-19</date>
<part>
<title>Installing Gentoo</title>
@@ -179,7 +179,7 @@
<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
-Independent of what stage you chose, the eventual result is that you
+After installing and configuring a stage3, the eventual result is that you
have a Gentoo base system at your disposal. This chapter describes how
to progress to that stadium.
</abstract>
1.128 +4 -4 xml/htdocs/doc/en/handbook/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.128&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.128&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-amd64.xml.diff?r1=1.127&r2=1.128&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v
retrieving revision 1.127
retrieving revision 1.128
diff -u -r1.127 -r1.128
--- handbook-amd64.xml 19 Dec 2005 12:28:29 -0000 1.127
+++ handbook-amd64.xml 19 Dec 2005 12:36:15 -0000 1.128
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.127 2005/12/19 12:28:29 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.128 2005/12/19 12:36:15 jkt Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux AMD64 Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.2</version>
-<date>2005-11-11</date>
+<version>4.3</version>
+<date>2005-12-19</date>
<part>
<title>Installing Gentoo</title>
@@ -179,7 +179,7 @@
<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
-Independent of what stage you chose, the eventual result is that you
+After installing and configuring a stage3, the eventual result is that you
have a Gentoo base system at your disposal. This chapter describes how
to progress to that stadium.
</abstract>
1.117 +4 -4 xml/htdocs/doc/en/handbook/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.117&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.117&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-hppa.xml.diff?r1=1.116&r2=1.117&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v
retrieving revision 1.116
retrieving revision 1.117
diff -u -r1.116 -r1.117
--- handbook-hppa.xml 19 Dec 2005 12:28:29 -0000 1.116
+++ handbook-hppa.xml 19 Dec 2005 12:36:15 -0000 1.117
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.116 2005/12/19 12:28:29 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.117 2005/12/19 12:36:15 jkt Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux HPPA Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.2</version>
-<date>2005-11-11</date>
+<version>4.3</version>
+<date>2005-12-19</date>
<part>
<title>Installing Gentoo</title>
@@ -179,7 +179,7 @@
<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
-Independent of what stage you chose, the eventual result is that you
+After installing and configuring a stage3, the eventual result is that you
have a Gentoo base system at your disposal. This chapter describes how
to progress to that stadium.
</abstract>
1.107 +4 -4 xml/htdocs/doc/en/handbook/handbook-mips.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.107&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.107&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml.diff?r1=1.106&r2=1.107&cvsroot=gentoo
Index: handbook-mips.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v
retrieving revision 1.106
retrieving revision 1.107
diff -u -r1.106 -r1.107
--- handbook-mips.xml 19 Dec 2005 12:28:29 -0000 1.106
+++ handbook-mips.xml 19 Dec 2005 12:36:15 -0000 1.107
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.106 2005/12/19 12:28:29 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.107 2005/12/19 12:36:15 jkt Exp $ -->
<book link="handbook-mips.xml">
<title>Gentoo Linux/MIPS Handbook</title>
@@ -124,8 +124,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.2</version>
-<date>2005-11-11</date>
+<version>4.3</version>
+<date>2005-12-19</date>
<part>
<title>Installing Gentoo</title>
@@ -181,7 +181,7 @@
<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
-Independent of what stage you chose, the eventual result is that you
+After installing and configuring a stage3, the eventual result is that you
have a Gentoo base system at your disposal. This chapter describes how
to progress to that stadium.
</abstract>
1.137 +4 -4 xml/htdocs/doc/en/handbook/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.137&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.137&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml.diff?r1=1.136&r2=1.137&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v
retrieving revision 1.136
retrieving revision 1.137
diff -u -r1.136 -r1.137
--- handbook-ppc.xml 19 Dec 2005 12:28:29 -0000 1.136
+++ handbook-ppc.xml 19 Dec 2005 12:36:15 -0000 1.137
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.136 2005/12/19 12:28:29 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.137 2005/12/19 12:36:15 jkt Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux PPC Handbook</title>
@@ -124,8 +124,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.2</version>
-<date>2005-11-11</date>
+<version>4.3</version>
+<date>2005-12-19</date>
<part>
<title>Installing Gentoo</title>
@@ -182,7 +182,7 @@
<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
-Independent of what stage you chose, the eventual result is that you
+After installing and configuring a stage3, the eventual result is that you
have a Gentoo base system at your disposal. This chapter describes how
to progress to that stadium.
</abstract>
1.59 +6 -6 xml/htdocs/doc/en/handbook/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.59&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.59&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc64.xml.diff?r1=1.58&r2=1.59&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v
retrieving revision 1.58
retrieving revision 1.59
diff -u -r1.58 -r1.59
--- handbook-ppc64.xml 19 Dec 2005 12:28:29 -0000 1.58
+++ handbook-ppc64.xml 19 Dec 2005 12:36:15 -0000 1.59
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.58 2005/12/19 12:28:29 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.59 2005/12/19 12:36:15 jkt Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux PPC64 Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.2</version>
-<date>2005-11-11</date>
+<version>4.3</version>
+<date>2005-12-19</date>
<part>
<title>Installing Gentoo</title>
@@ -179,9 +179,9 @@
<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
-Independent of what stage you chose, the eventual result is that you have a
-Gentoo base system at your disposal. This chapter describes how to progress to
-that stadium.
+After installing and configuring a stage3, the eventual result is that you
+have a Gentoo base system at your disposal. This chapter describes how
+to progress to that stadium.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
1.120 +4 -4 xml/htdocs/doc/en/handbook/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.120&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.120&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-sparc.xml.diff?r1=1.119&r2=1.120&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v
retrieving revision 1.119
retrieving revision 1.120
diff -u -r1.119 -r1.120
--- handbook-sparc.xml 19 Dec 2005 12:28:29 -0000 1.119
+++ handbook-sparc.xml 19 Dec 2005 12:36:15 -0000 1.120
@@ -1,7 +1,7 @@
<?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.119 2005/12/19 12:28:29 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v 1.120 2005/12/19 12:36:15 jkt Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux SPARC Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.2</version>
-<date>2005-11-11</date>
+<version>4.3</version>
+<date>2005-12-19</date>
<part>
<title>Installing Gentoo</title>
@@ -179,7 +179,7 @@
<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
-Independent of what stage you chose, the eventual result is that you
+After installing and configuring a stage3, the eventual result is that you
have a Gentoo base system at your disposal. This chapter describes how
to progress to that stadium.
</abstract>
1.147 +4 -4 xml/htdocs/doc/en/handbook/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.147&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.147&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-x86.xml.diff?r1=1.146&r2=1.147&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v
retrieving revision 1.146
retrieving revision 1.147
diff -u -r1.146 -r1.147
--- handbook-x86.xml 19 Dec 2005 12:28:29 -0000 1.146
+++ handbook-x86.xml 19 Dec 2005 12:36:15 -0000 1.147
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.146 2005/12/19 12:28:29 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.147 2005/12/19 12:36:15 jkt Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux x86 Handbook</title>
@@ -121,8 +121,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.2</version>
-<date>2005-11-11</date>
+<version>4.3</version>
+<date>2005-12-19</date>
<part>
<title>Installing Gentoo</title>
@@ -179,7 +179,7 @@
<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
-Independent of what stage you chose, the eventual result is that you
+After installing and configuring a stage3, the eventual result is that you
have a Gentoo base system at your disposal. This chapter describes how
to progress to that stadium.
</abstract>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2006-02-01 18:38 Shyam Mani
0 siblings, 0 replies; 25+ messages in thread
From: Shyam Mani @ 2006-02-01 18:38 UTC (permalink / raw
To: gentoo-doc-cvs
fox2mike 06/02/01 18:38:18
Added: xml/htdocs/doc/en/handbook/draft/2006.0 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-ppc64.xml
handbook-sparc.xml handbook-x86.xml
hb-install-about.xml
hb-install-alpha-bootloader.xml
hb-install-alpha-disk.xml
hb-install-alpha-kernel.xml
hb-install-alpha-medium.xml
hb-install-amd64-bootloader.xml
hb-install-amd64-disk.xml
hb-install-amd64-kernel.xml
hb-install-amd64-medium.xml hb-install-config.xml
hb-install-finalise.xml
hb-install-hppa-bootloader.xml
hb-install-hppa-disk.xml hb-install-hppa-kernel.xml
hb-install-hppa-medium.xml hb-install-network.xml
hb-install-next.xml hb-install-ppc-bootloader.xml
hb-install-ppc-disk.xml hb-install-ppc-kernel.xml
hb-install-ppc-medium.xml
hb-install-ppc64-bootloader.xml
hb-install-ppc64-disk.xml
hb-install-ppc64-kernel.xml
hb-install-ppc64-medium.xml
hb-install-sparc-bootloader.xml
hb-install-sparc-disk.xml
hb-install-sparc-kernel.xml
hb-install-sparc-medium.xml hb-install-stage.xml
hb-install-system.xml hb-install-tools.xml
hb-install-x86-bootloader.xml
hb-install-x86-disk.xml hb-install-x86-kernel.xml
hb-install-x86-medium.xml
Log:
Bunch of 2005.1 -> 2006.0 files, initial version.
Revision Changes Path
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2006.0 Alpha Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on Alpha systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-alpha-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-alpha-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-alpha-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
Several bootloaders exist. Each one of them has its own way of
configuration. In this chapter we'll describe all possibilities for you
and step you through the process of configuring a bootloader to your
needs.
</abstract>
<include href="hb-install-alpha-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install the prebuild packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2006.0 AMD64 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on AMD64 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-amd64-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-amd64-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-amd64-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
In this chapter we'll describe the GRUB bootloader
and step you through the process of configuring GRUB to your
needs.
</abstract>
<include href="hb-install-amd64-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install the prebuild packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2006.0 HPPA Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on HPPA systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-hppa-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-hppa-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
Gentoo installs work through so-called stage-files. In this chapter we
describe how you extract a stage-file and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-hppa-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
In this chapter we'll describe the PALO bootloader
and step you through the process of configuring PALO to your
needs.
</abstract>
<include href="hb-install-hppa-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2006.0 PPC Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<author title="Editor">
<mail link="sejo@gentoo.org">Jochen Maes </mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on PPC systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-ppc-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-ppc-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-ppc-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
Several bootloaders exist. Each one of them has its own way of
configuration. In this chapter we'll describe all possibilities for you
and step you through the process of configuring a bootloader to your
needs.
</abstract>
<include href="hb-install-ppc-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux 2006.0 PPC64 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on PPC64 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-ppc64-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-ppc64-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-ppc64-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
Several bootloaders exist. Each one of them has its own way of
configuration. In this chapter we'll describe all possibilities for you
and step you through the process of configuring a bootloader to your
needs.
</abstract>
<include href="hb-install-ppc64-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2006.0 SPARC Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on Sparc systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-sparc-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-sparc-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-sparc-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
The SPARC architecture uses the SILO bootloader to fire up your Linux system. In
this chapter we step you through the process of configuring this bootloader to
your needs.
</abstract>
<include href="hb-install-sparc-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2006.0 x86 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on x86 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-x86-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-x86-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and
how to configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and
modify the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-x86-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
Several bootloaders exist for the x86 architecture. Each one of them has its
own way of configuration. We step you through the process of configuring a
bootloader to your needs.
</abstract>
<include href="hb-install-x86-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-about.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-about.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-about.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-about.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-about.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.0</version>
<date>2005-08-08</date>
<section>
<title>Introduction</title>
<subsection>
<title>Welcome!</title>
<body>
<p>
First of all, <e>welcome</e> to Gentoo. You are about to enter the world
of choices and performance. Gentoo is all about choices. When
installing Gentoo, this is made clear to you several times -- you can
choose how much you want to compile yourself, how to install Gentoo,
what system logger you want, etc.
</p>
<p>
Gentoo is a fast, modern metadistribution with a clean and flexible
design. Gentoo is built around free software and doesn't hide from its
users what is beneath the hood. Portage, the package maintenance system
which Gentoo uses, is written in Python, meaning you can easily view and
modify the source code. Gentoo's packaging system uses source code
(although support for precompiled packages is included too) and
configuring Gentoo happens through regular textfiles. In other words,
openness everywhere.
</p>
<p>
It is very important that you understand that <e>choices</e> are what
makes Gentoo run. We try not to force you onto anything you don't like.
If you feel like we do, please <uri
link="http://bugs.gentoo.org">bugreport</uri> it.
</p>
</body>
</subsection>
<subsection>
<title>How is the Installation Structured?</title>
<body>
<p>
The Gentoo Installation can be seen as a 10-step procedure,
corresponding to chapters 2 - 11. Every step results in
a certain state:
</p>
<ul>
<li>
After step 1, you are in a working environment ready to install Gentoo
</li>
<li>
After step 2, your internet connection is prepared in case you need it (this
is however optional)
</li>
<li>
After step 3, your hard disks are initialized to house your Gentoo
installation
</li>
<li>
After step 4, your installation environment is prepared and you are
ready to chroot into the new environment
</li>
<li>
After step 5, core packages, which are the same on all Gentoo
installations, are installed
</li>
<li>
After step 6, you have compiled your Linux kernel
</li>
<li>
After step 7, you have written most of your Gentoo system
configuration files
</li>
<li>
After step 8, necessary system tools (which you can choose from a nice
list) are installed
</li>
<li>
After step 9, your choice of bootloader has been installed and
configured and you are logged in into your new Gentoo installation
</li>
<li>
After step 10, your Gentoo Linux environment is ready to be explored
</li>
</ul>
<p>
When you are given a certain choice, we try our best to explain what the pros
and cons are. We will continue then with a default
choice, identified by "Default: " in the title. The other
possibilities are marked by "Alternative: ". Do <e>not</e>
think that the default is what we recommend. It is however what we
believe most users will use.
</p>
<p>
Sometimes you can pursue an optional step. Such steps are marked as
"Optional: " and are therefore not needed to install Gentoo.
However, some optional steps are dependant on a previous decision you
made. We will inform you when this happens, both when you make the
decision, and right before the optional step is described.
</p>
</body>
</subsection>
<subsection>
<title>What are my Options?</title>
<body>
<p>
You can install Gentoo in many different ways. You can download and install from
one of our Installation CDs, from an existing distribution,
from a bootable CD (such as Knoppix), from a netbooted environment, from a
rescue floppy, etc.
</p>
<p>
This document covers the installation using the Universal Installation CD, a
bootable CD that contains everything you need to get Gentoo Linux up and
running. You can optionally use one of our Package CDs as well to install a
complete system in a matter of minutes after having installed the Gentoo base
system.
</p>
<p>
This installation approach however does not immediately use the latest version
of the available packages; if you want this you should check out the
Installation Instructions inside our <uri
link="/doc/en/handbook/index.xml">Gentoo Linux Handbooks</uri>.
</p>
<p>
For help on the other installation approaches,
please read our <uri link="/doc/en/altinstall.xml">Alternative Installation
Guide</uri>. We also provide a <uri
link="/doc/en/gentoo-x86-tipsntricks.xml">Gentoo Installation Tips &
Tricks</uri> document that might be useful to read as well. If you feel that
the current installation instructions are too elaborate, feel free to use our
Quick Installation Guide available from our <uri
link="/doc/en/index.xml">Documentation Resources</uri> if your architecture
has such a document available.
</p>
</body>
</subsection>
<subsection>
<title>Troubles?</title>
<body>
<p>
If you find a problem in the installation (or in the installation
documentation), please check the errata from our <uri
link="/proj/en/releng/">Gentoo Release Engineering Project</uri>,
visit our <uri link="http://bugs.gentoo.org">bugtracking
system</uri> and check if the bug is known. If not, please create a bugreport
for it so we can take care of it. Do not be afraid of the developers who are
assigned to (your) bugs -- they generally don't eat people.
</p>
<p>
Note though that, although the document you are now reading is
architecture-specific, it will contain references to other architectures as
well. This is due to the fact that large parts of the Gentoo Handbook use source
code that is common for all architectures (to avoid duplication of efforts and
starvation of development resources). We will try to keep this to a minimum
to avoid confusion.
</p>
<p>
If you are uncertain if the problem is a user-problem (some error you
made despite having read the documentation carefully) or a
software-problem (some error we made despite having tested the
installation/documentation carefully) you are free to join #gentoo on
irc.freenode.net. Of course, you are welcome otherwise too :)
</p>
<p>
If you have a question regarding Gentoo, check out our <uri
link="/doc/en/faq.xml">Frequently Asked
Questions</uri>, available from the <uri
link="/doc/en/">Gentoo Documentation</uri>. You can
also view the <uri
link="http://forums.gentoo.org/viewforum.php?f=40">FAQs</uri> on our
<uri link="http://forums.gentoo.org">forums</uri>. If you can't find the answer
there ask on #gentoo, our IRC-channel on irc.freenode.net. Yes, several of
us are freaks who sit on IRC :-)
</p>
</body>
</subsection>
</section>
<section>
<title>Fast Installation using the Gentoo Reference Platform</title>
<subsection>
<title>What is the Gentoo Reference Platform?</title>
<body>
<p>
The Gentoo Reference Platform, from now on abbreviated to GRP, is a snapshot of
prebuilt packages users (that means you!) can install during the installation
of Gentoo to speed up the installation process. The GRP consists of all
packages required to have a fully functional Gentoo installation. They are not
just the ones you need to have a base installation up to speed in no time, but
all lengthier builds (such as KDE, xorg-x11, GNOME, OpenOffice, Mozilla, ...)
are available as GRP packages too.
</p>
<p>
However, these prebuilt packages aren't maintained during the lifetime of the
Gentoo distribution. They are snapshots released at every Gentoo release and
make it possible to have a functional environment in a short amount of time. You
can then upgrade your system in the background while working in your Gentoo
environment.
</p>
</body>
</subsection>
<subsection>
<title>How Portage Handles GRP Packages</title>
<body>
<p>
Your Portage tree - the collection of <e>ebuilds</e> (files that contain all
information about a package, such as its description, homepage, sourcecode URLs,
compilation instructions, dependencies, etc.) - must be synchronised with the
GRP set: the versions of the available ebuilds and their accompanying GRP
packages must match.
</p>
<p>
For this reason you can only benefit from the GRP packages Gentoo provides while
performing the current installation approach. GRP is not available for those
interested in performing an installation using the latest versions of all
available packages.
</p>
</body>
</subsection>
<subsection>
<title>Is GRP Available?</title>
<body>
<p>
Not all architectures provide GRP packages. That doesn't mean GRP isn't
supported on the other architectures, but it means that we don't have the
resources to build and test the GRP packages.
</p>
<p>
At present we provide GRP packages for the following architectures:
</p>
<ul>
<li>
The <b>x86</b> architecture (x86, athlon-xp, pentium3, pentium4)
Note: The x86 packages (packages-x86-2006.0.iso) are available on
our mirrors, while pentium3, pentium4 and athlon-xp are only available
via bittorrent.
</li>
<li>
The <b>amd64</b> architecture (amd64)
</li>
<li>
The <b>sparc</b> architecture (sparc64)
</li>
<li>
The <b>ppc</b> architecture (G3, G4, G5)
</li>
<li>
The <b>alpha</b> architecture
</li>
</ul>
<p>
If your architecture (or subarchitecture) isn't on this list, you are not
able to opt for a GRP installation.
</p>
<p>
Now that this introduction is over, let's continue with <uri
link="?part=1&chap=2">Booting the Universal Installation CD</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-bootloader.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2006-01-19</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
<p>
Several bootloaders exist for Linux/Alpha. You must choose one of the supported
bootloaders, not all. You have the choice between <uri link="#aboot">aBoot</uri>
and <uri link="#milo">MILO</uri>.
</p>
</body>
</subsection>
</section>
<section id="aboot">
<title>Default: Using aboot</title>
<body>
<p>
We first install aboot on our system. Of course we use <c>emerge</c> to
do so:
</p>
<pre caption = "Installing aboot">
# <i>emerge --usepkg aboot</i>
</pre>
<p>
The next step is to make our bootdisk bootable. This will start
<c>aboot</c> when you boot your system. We make our bootdisk bootable by
writing the <c>aboot</c> bootloader to the start of the disk.
</p>
<pre caption = "Making your bootdisk bootable">
# <i>swriteboot -f3 /dev/sda /boot/bootlx</i>
# <i>abootconf /dev/sda 2</i>
</pre>
<note>
If you use a different partitioning scheme than the one we use
throughout this chapter, you have to change the commands accordingly.
Please read the appropriate manual pages (<c>man 8 swriteboot</c> and
<c>man 8 abootconf</c>). Also, if your root filesystem uses the JFS filesystem,
make sure to pass the <c>ro</c> kernel option so that it can replay its log
before it gets mounted read-write.
</note>
<p>
Additionally, you can make Gentoo boot automatically by setting up the
aboot configuration file and some SRM variables. You can try setting
these variables from Linux, but it may be easier to do so from the SRM
console itself.
</p>
<pre caption = "Automatically booting Gentoo">
# <i>echo '0:2/boot/vmlinux.gz root=/dev/sda2' > /etc/aboot.conf</i>
# <i>cd /proc/srm_environment/named_variables</i>
# <i>echo -n 0 > boot_osflags</i>
# <i>echo -n '' > boot_file</i>
# <i>echo -n 'BOOT' > auto_action</i>
# <i>echo -n 'dkc100' > bootdef_dev</i>
<comment>(Substitute dkc100 with whatever your boot device is)</comment>
</pre>
<p>
If you need to get into the SRM console again in the future (to recover
your Gentoo install, play with some variables, or whatever), just hit
CTRL+C to abort the automatic loading process.
</p>
<p>
If you're installing using a serial console, don't forget to include
the serial console boot flag in <path>aboot.conf</path>. See
<path>/etc/aboot.conf.example</path> for some further information.
</p>
<p>
Aboot is now configured and ready to use. Continue with <uri
link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="milo">
<title>Alternative: Using MILO</title>
<body>
<p>
Before continuing, you should decide on how to use MILO. In this
section, we will assume that you want to make a MILO boot floppy. If you
are going to boot from an MS-DOS partition on your hard disk, you should
amend the commands appropriately.
</p>
<p>
To install MILO, we use <c>emerge</c>.
</p>
<pre caption = "Installing MILO">
# <i>emerge --usepkg milo</i>
</pre>
<p>
After MILO has been installed, the MILO images should be in
<path>/opt/milo</path>. The commands below make a bootfloppy for use
with MILO. Remember to use the correct image for your Alpha-system.
</p>
<pre caption = "Installing MILO on a floppy">
<comment>(First insert a blank floppy)</comment>
# <i>fdformat /dev/fd0</i>
# <i>mformat a:</i>
# <i>mcopy /opt/milo/milo-2.2-18-gentoo-ruffian a:\milo</i>
# <i>mcopy /opt/milo/linload.exe a:\lilnload.exe</i>
<comment>(Only if you have a Ruffian:</comment>
# <i>mcopy /opt/milo/ldmilo.exe a:\ldmilo.exe</i>
<comment>)</comment>
# <i>echo -ne '\125\252' | dd of=/dev/fd0 bs=1 seek=510 count=2</i>
</pre>
<p>
Your MILO boot floppy is now ready to boot Gentoo Linux. You may need to
set environment variables in your ARCS Firmware to get MILO to start;
this is all explained in the <uri
link="http://tldp.org/HOWTO/MILO-HOWTO/">MILO-HOWTO</uri> with some examples
on common systems, and examples of the commands to use in interactive mode.
</p>
<p>
Not reading the <uri link="http://tldp.org/HOWTO/MILO-HOWTO/">MILO-HOWTO</uri>
is a <e>bad</e> idea.
</p>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-alpha-disk.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-25</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first SCSI HD in a Linux system, namely
<path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On Alpha systems,
these are called <e>slices</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
As an example we use the following slice layout:
</p>
<table>
<tr>
<th>Slice</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Swap slice</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Root slice</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Full disk (required)</ti>
</tr>
</table>
<p>
If you are interested in knowing how big a partition should be, or even how
many partitions (or volumes) you need, read on. Otherwise continue now with
<uri link="#fdisk_SRM">Using fdisk to Partition your Disk (SRM only)</uri>
or <uri link="#fdisk_ARC">Using fdisk to Partition your Disk (ARC/AlphaBIOS
only)</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another.
</p>
</body>
</subsection>
</section>
<section id="fdisk_SRM">
<title>Using fdisk to Partition your Disk (SRM only)</title>
<subsection>
<body>
<p>
The following parts explain how to create the example slice layout described
previously, namely:
</p>
<table>
<tr>
<th>Slice</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Swap slice</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Root slice</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Full disk (required)</ti>
</tr>
</table>
<p>
Change your slice layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Identifying Available Disks</title>
<body>
<p>
To figure out what disks you have running, use the following commands:
</p>
<pre caption="Identifying available disks">
# <i>dmesg | grep 'drive$'</i> <comment>(For IDE disks)</comment>
# <i>dmesg | grep 'scsi'</i> <comment>(For SCSI disks)</comment>
</pre>
<p>
>From this output you should be able to see what disks were detected and their
respective <path>/dev</path> entry. In the following parts we assume that the
disk is a SCSI disk on <path>/dev/sda</path>.
</p>
<p>
Now fire up <c>fdisk</c>:
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/sda</i>
</pre>
</body>
</subsection>
<subsection>
<title>Deleting All Slices</title>
<body>
<p>
If your hard drive is completely blank, then you'll have to first create
a BSD disklabel.
</p>
<pre caption="Creating a BSD disklabel">
Command (m for help): <i>b</i>
/dev/sda contains no disklabel.
Do you want to create a disklabel? (y/n) <i>y</i>
<comment>A bunch of drive-specific info will show here</comment>
3 partitions:
# start end size fstype [fsize bsize cpg]
c: 1 5290* 5289* unused 0 0
</pre>
<p>
We start with deleting all slices <e>except</e> the 'c'-slice (a requirement
for using BSD disklabels). The following shows how to delete a slice (in
the example we use 'a'). Repeat the process to delete all other slices
(again, except the 'c'-slice).
</p>
<p>
Use <c>p</c> to view all existing slices. <c>d</c> is used to delete a slice.
</p>
<pre caption="Deleting a slice">
BSD disklabel command (m for help): <i>p</i>
8 partitions:
# start end size fstype [fsize bsize cpg]
a: 1 235* 234* 4.2BSD 1024 8192 16
b: 235* 469* 234* swap
c: 1 5290* 5289* unused 0 0
d: 469* 2076* 1607* unused 0 0
e: 2076* 3683* 1607* unused 0 0
f: 3683* 5290* 1607* unused 0 0
g: 469* 1749* 1280 4.2BSD 1024 8192 16
h: 1749* 5290* 3541* unused 0 0
BSD disklabel command (m for help): <i>d</i>
Partition (a-h): <i>a</i>
</pre>
<p>
After repeating this process for all slices, a listing should show you something
similar to this:
</p>
<pre caption="Viewing an empty scheme">
BSD disklabel command (m for help): <i>p</i>
3 partitions:
# start end size fstype [fsize bsize cpg]
c: 1 5290* 5289* unused 0 0
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Swap Slice</title>
<body>
<p>
On Alpha based systems you don't need a separate boot partition. However, the
first cylinder cannot be used as the <c>aboot</c> image will be placed there.
</p>
<p>
We will create a swap slice starting at the third cylinder, with a total
size of 1 GB. Use <c>n</c> to create a new slice. After creating the slice,
we will change its type to <c>1</c> (one), meaning <e>swap</e>.
</p>
<pre caption="Creating the swap slice">
BSD disklabel command (m for help): <i>n</i>
Partition (a-p): <i>a</i>
First cylinder (1-5290, default 1): <i>3</i>
Last cylinder or +size or +sizeM or +sizeK (3-5290, default 5290): <i>+1024M</i>
BSD disklabel command (m for help): <i>t</i>
Partition (a-c): <i>a</i>
Hex code (type L to list codes): <i>1</i>
</pre>
<p>
After these steps you should see a layout similar to the following:
</p>
<pre caption="Slice layout after creating the swap slice">
BSD disklabel command (m for help): <i>p</i>
3 partitions:
# start end size fstype [fsize bsize cpg]
a: 3 1003 1001 swap
c: 1 5290* 5289* unused 0 0
</pre>
</body>
</subsection>
<subsection>
<title>Create the Root Slice</title>
<body>
<p>
We will now create the root slice, starting from the first cylinder <e>after</e>
the swap slice. Use the <c>p</c> command to view where the swap slice ends. In
our example, this is at 1003, making the root partition start at 1004.
</p>
<p>
Another problem is that there is currently a bug in <c>fdisk</c> making it think
the number of available cylinders is one above the real number of cylinders. In
other words, when you are asked for the last cylinder, decrease the cylinder
number (in this example: 5290) with one.
</p>
<p>
When the partition is created, we change the type to <c>8</c>, for <e>ext2</e>.
</p>
<pre caption="Creating the root slice">
D disklabel command (m for help): <i>n</i>
Partition (a-p): <i>b</i>
First cylinder (1-5290, default 1): <i>1004</i>
Last cylinder or +size or +sizeM or +sizeK (1004-5290, default 5290): <i>5289</i>
BSD disklabel command (m for help): <i>t</i>
Partition (a-c): <i>b</i>
Hex code (type L to list codes): <i>8</i>
</pre>
<p>
Your slice layout should now be similar to this:
</p>
<pre caption="Viewing the slice layout">
BSD disklabel command (m for help): <i>p</i>
3 partitions:
# start end size fstype [fsize bsize cpg]
a: 3 1003 1001 swap
b: 1004 5289 4286 ext2
c: 1 5290* 5289* unused 0 0
</pre>
</body>
</subsection>
<subsection>
<title>Save the Slice Layout and Exit</title>
<body>
<p>
Save <c>fdisk</c> by typing <c>w</c>. This will also save your slice layout.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your slices are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="fdisk_ARC">
<title>Using fdisk to Partition your Disk (ARC/AlphaBIOS only)</title>
<subsection>
<body>
<p>
The following parts explain how to partition the disk with a layout
similar to the one described previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
Change your partition layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Identifying Available Disks</title>
<body>
<p>
To figure out what disks you have running, use the following commands:
</p>
<pre caption="Identifying available disks">
# <i>dmesg | grep 'drive$'</i> <comment>(For IDE disks)</comment>
# <i>dmesg | grep 'scsi'</i> <comment>(For SCSI disks)</comment>
</pre>
<p>
>From this output you should be able to see what disks were detected and their
respective <path>/dev</path> entry. In the following parts we assume that the
disk is a SCSI disk on <path>/dev/sda</path>.
</p>
<p>
Now fire up <c>fdisk</c>:
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/sda</i>
</pre>
</body>
</subsection>
<subsection>
<title>Deleting All Partitions</title>
<body>
<p>
If your hard drive is completely blank, then you'll have to first create
a DOS disklabel.
</p>
<pre caption="Creating a DOS disklabel">
Command (m for help): <i>o</i>
Building a new DOS disklabel.
</pre>
<p>
We start with deleting all partitions. The following shows how to delete
a partition (in the example we use '1'). Repeat the process to delete all
other partitions.
</p>
<p>
Use <c>p</c> to view all existing partitions. <c>d</c> is used to delete a
partition.
</p>
<pre caption="Deleting a partition">
command (m for help): <i>p</i>
Disk /dev/sda: 9150 MB, 9150996480 bytes
64 heads, 32 sectors/track, 8727 cylinders
Units = cylinders of 2048 * 512 = 1048576 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 478 489456 83 Linux
/dev/sda2 479 8727 8446976 5 Extended
/dev/sda5 479 1433 977904 83 Linux Swap
/dev/sda6 1434 8727 7469040 83 Linux
command (m for help): <i>d</i>
Partition number (1-6): <i>1</i>
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Boot Partition</title>
<body>
<p>
On Alpha systems which use MILO to boot, we have to create a small vfat
boot partition.
</p>
<pre caption="Creating the boot partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>1</i>
First cylinder (1-8727, default 1): <i>1</i>
Last cylinder or +size or +sizeM or +sizeK (1-8727, default 8727): <i>+16M</i>
Command (m for help): <i>t</i>
Selected partition 1
Hex code (type L to list codes): <i>6</i>
Changed system type of partition 1 to 6 (FAT16)
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Swap Partition</title>
<body>
<p>
We will create a swap partition starting at the third cylinder, with a total
size of 1 GB. Use <c>n</c> to create a new partition.
</p>
<pre caption="Creating the swap partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>2</i>
First cylinder (17-8727, default 17): <i>17</i>
Last cylinder or +size or +sizeM or +sizeK (17-8727, default 8727): <i>+1000M</i>
Command (m for help): <i>t</i>
Partition number (1-4): <i>1</i>
Hex code (type L to list codes): <i>82</i>
Changed system type of partition 2 to 82 (Linux swap)
</pre>
<p>
After these steps you should see a layout similar to the following:
</p>
<pre caption="Partition listing after creating a swap partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 9150 MB, 9150996480 bytes
64 heads, 32 sectors/track, 8727 cylinders
Units = cylinders of 2048 * 512 = 1048576 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 16 16368 6 FAT16
/dev/sda2 17 971 977920 82 Linux swap
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
We will now create the root partition. Again, just use the <c>n</c> command.
</p>
<pre caption="Creating the root partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>3</i>
First cylinder (972-8727, default 972): <i>972</i>
Last cylinder or +size or +sizeM or +sizeK (972-8727, default 8727): <i>8727</i>
</pre>
<p>
After these steps you should see a layout similar to the following:
</p>
<pre caption="Partition listing after creating the root partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 9150 MB, 9150996480 bytes
64 heads, 32 sectors/track, 8727 cylinders
Units = cylinders of 2048 * 512 = 1048576 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 16 16368 6 FAT16
/dev/sda2 17 971 977920 82 Linux swap
/dev/sda3 972 8727 7942144 83 Linux
</pre>
</body>
</subsection>
<subsection>
<title>Save the Partition Layout and Exit</title>
<body>
<p>
Save <c>fdisk</c> by typing <c>w</c>. This will also save your partition layout.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available. Most of them are found stable on the
Alpha architecture.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready and there hasn't been a sufficient track record to
comment positively nor negatively on its general stability at this point.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the root partition (<path>/dev/sda2</path> in our example)
in ext3, you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs -j /dev/sda2</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/sda1</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/sda1</i>
</pre>
<p>
Create and activate the swap with the commands mentioned above.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/sda2 /mnt/gentoo</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-alpha-kernel.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For alpha-based systems we have <c>vanilla-sources</c> (the default 2.6 kernel source).
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>. The
<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<p>
In the next example we install the <c>vanilla-sources</c>.
Of course substitute with your choice of sources, this is merely an example:
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge vanilla-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>vanilla-sources-2.6.11.2</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.11.2
</pre>
<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as it is
the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. You can run <c>lsmod</c> to see what kernel
modules the Installation CD uses (it might provide you with a nice hint on
what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc
file system</c>, (<c>/dev file system</c> + <c>Automatically mount at boot</c> only for 2.4 kernel):
</p>
<pre caption="Selecting necessary file systems">
<comment>(With a 2.4.x kernel)</comment>
File systems --->
[*] Virtual memory file system support (former shm fs)
[*] /proc file system support
[*] /dev file system support (EXPERIMENTAL)
[*] Automatically mount at boot
[ ] /dev/pts file system for Unix98 PTYs
<comment>(With a 2.6.x kernel)</comment>
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
<comment>(With a 2.4.x kernel)</comment>
Network device support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
<comment>(With a 2.6.x kernel)</comment>
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
The following options are recommended as well:
</p>
<pre caption="Recommended Alpha options">
General setup --->
<*> SRM environment through procfs
<*> Configure uac policy via sysctl
Plug and Play configuration --->
<*> Plug and Play support
<M> ISA Plug and Play support
SCSI support --->
SCSI low-level drivers --->
<*> SYM53C8XX Version 2 SCSI support (NEW)
<*> Qlogic ISP SCSI support
Network device support --->
Ethernet (10 or 100 Mbit) --->
<M> DECchip Tulip (dc21x4x) PCI support
<M> Generic DECchip & DIGITAL EtherWORKS PCI/EISA
<M> EtherExpressPro/100 support (eepro100)
<M> EtherExpressPro/100 support (e100)
Ethernet (1000 Mbit) --->
<M> Alteon AceNIC
[*] Omit support for old Tigon I
<M> Broadcom Tigon3
[*] FDDI driver support
<M> Digital DEFEA and DEFPA
<*> PPP support
<*> PPP Deflate compression
Character devices --->
[*] Support for console on serial port
[*] Direct Rendering Manager
File systems --->
<*> Kernel automounter version 4 support
Network File Systems --->
<*> NFS
[*] NFSv3 client
<*> NFS server
[*] NFSv3 server
Partition Types --->
[*] Advanced partition selection
[*] Alpha OSF partition support
Native Language Support
<*> NLS ISO 8859-1
Sound --->
<M> Sound card support
<M> OSS sound modules
[*] Verbose initialisation
[*] Persistent DMA buffers
<M> 100% Sound Blaster compatibles
</pre>
<p>
When you've finished configuring the kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
<comment>(For 2.4 kernel)</comment>
# <i>make dep && make vmlinux modules modules_install</i>
<comment>(For 2.6 kernel)</comment>
# <i>make && make modules_install</i>
<comment>(For all kernels)</comment>
# <i>make boot</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Recent kernels might create <path>vmlinux</path> instead of
<path>vmlinux.gz</path>. Keep this in mind when you copy your kernel image.
</p>
<pre caption="Installing the kernel">
# <i>cp arch/alpha/boot/vmlinux.gz /boot/</i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Installing Separate Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because genkernel
doesn't require any manual kernel configuration, it is an ideal solution for
those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Now, compile your kernel sources by running <c>genkernel all</c>.
Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware, this compilation will take quite a while to finish!
</p>
<p>
Note that, if your boot partition doesn't use ext2 or ext3 as filesystem you
need to manually configure your kernel using <c>genkernel --menuconfig all</c>
and add support for your filesystem <e>in</e> the kernel (i.e. <e>not</e> as a
module).
</p>
<pre caption="Running genkernel">
# <i>genkernel all</i>
GenKernel v3.0.1_beta10
* ARCH: Alpha
* KERNEL VER: 2.6.11.2
* kernel: configuring source
* kernel: running mrproper
<comment>(Output removed to increase readability)</comment>
* Kernel compiled successfully!
* Required Kernel Params:
* : root=/dev/ram0 init=/linuxrc real_root=/dev/$ROOT
* where $ROOT is the devicenode for your root partition as
* you should have specified in /etc/fstab
*
* You MUST tell your bootloader to use the generated initrd
*
* Recommended Kernel Params:
* : vga=0x317 splash=verbose
*
* Do NOT report kernel bugs (configs included) as genkernel bugs.
* Make sure you have the latest genkernel before reporting bugs
*
* For more info see /usr/share/genkernel/README
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD) before
your "real" system starts up.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
Now, let's perform one more step to get our system to be more like the Installation CD -- let's emerge <c>coldplug</c>. While the initrd autodetects hardware that
is needed to boot your system, <c>coldplug</c> autodetects everything else.
To emerge and enable <c>coldplug</c>, type the following:
</p>
<pre caption="Emerging and enabling coldplug">
# <i>emerge coldplug</i>
# <i>rc-update add coldplug boot</i>
</pre>
</body>
</section>
<section id="kernel_modules">
<title>Installing Separate Kernel Modules</title>
<subsection>
<title>Installing Extra Modules</title>
<body>
<p>
If appropriate, you should emerge ebuilds for any additional hardware that is
on your system. Here is a list of kernel-related ebuilds that you could emerge:
</p>
<table>
<tcolumn width="1in"/>
<tcolumn width="4in"/>
<tcolumn width="2in"/>
<tr>
<th>Ebuild</th>
<th>Purpose</th>
<th>Command</th>
</tr>
<tr>
<ti>x11-drm</ti>
<ti>
Accelerated graphics for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and
other cards for xorg-x11. Please check the <c>IUSE_VIDEO_CARDS</c> variable
in the <path>/usr/portage/x11-base/x11-drm</path> ebuilds to see what you
need to fill in as <c>yourcard</c>.
</ti>
<ti><c>VIDEO_CARDS="yourcard" emerge x11-drm</c></ti>
</tr>
</table>
<p>
Beware though, some of these ebuilds might deal with big dependencies. To verify
what packages will be installed by emerging an ebuild, use <c>emerge
--pretend</c>. For instance, for the <c>x11-drm</c> package:
</p>
<pre caption="View full installation package listing">
# <i>emerge --pretend x11-drm</i>
</pre>
</body>
</subsection>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.4</path> (or <path>kernel-2.6</path>).
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.4</path> or <path>kernel-2.6</path> file and enter the module
name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.4">
<comment>(Example for 2.4 kernels)</comment>
# <i>nano -w /etc/modules.autoload.d/kernel-2.4</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.4 or kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-alpha-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-alpha-medium.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>
Please check with the <uri
link="http://www.alphalinux.org/faq/FAQ-5.html">Alpha/Linux FAQ</uri>
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- Copy/paste from the hb-install-x86-medium.xml file but no Universal
Installation CD.
Also s/x86/alpha -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can succesfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
the <path>releases/alpha/2006.0/installcd</path> directory;
the Package CD is located in the <path>releases/alpha/2006.0/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<p>
When your Alpha is powered on, the first thing that gets started is the
firmware. It is loosely synonymous with the BIOS software on PC systems. There
are two types of firmware on Alpha systems: SRM (<e>Systems Reference
Manual</e>) and ARC (<e>Advanced Risc Console</e>).
</p>
<p>
SRM is based on the Alpha Console Subsystem specification, which provides an
operating environment for OpenVMS, Tru64 UNIX, and Linux operating systems. ARC
is based on the Advanced RISC Computing (ARC) specification, which provides
an operating environment for Windows NT. You can find a
<uri link="http://www.alphalinux.org/faq/SRM-HOWTO/">detailed guide</uri> on
using SRM over at the Alpha Linux website.
</p>
<p>
If your Alpha system supports both SRC and ARCs (ARC, AlphaBIOS, ARCSBIOS) you
should follow <uri link="http://www.alphalinux.org/faq/x31.html">these
instructions</uri> for switching to SRM. If your system already uses SRM, you
are all set. If your system can only use ARCs (Ruffian, nautilus, xl, etc.) you
will need to choose <c>MILO</c> later on when we are talking about bootloaders.
</p>
<p>
Now to boot an Alpha Installation CD, put the CD-ROM in the tray and reboot the system.
You can use SRM to boot the Installation CD. If you cannot do that, you will have to use
<c>MILO</c>. If you don't have <c>MILO</c> installed already, use one of the
precompiled <c>MILO</c> images available on <uri
link="http://dev.gentoo.org/~taviso/milo/">taviso's homepage</uri>.
</p>
<pre caption="Booting a CD-ROM using SRM">
<comment>(List available hardware drives)</comment>
>>> <i>show device</i>
dkb0.0.1.4.0 DKB0 TOSHIBA CDROM
<comment>(...)</comment>
<comment>(Substitute dkb0 with your CD-ROM drive device)</comment>
>>> <i>boot dkb0 -flags 0</i>
<comment>To boot the 2.4 kernel instead of the default 2.6 kernel use:</comment>
>>> <i>boot dkb -flags 1</i>
</pre>
<pre caption="Booting a CD-ROM using MILO">
<comment>(Substitute hdb with your CD-ROM drive device)</comment>
MILO> <i>boot hdb:/boot/gentoo_2.6 initrd=/boot/gentoo_2_6.igz root=/dev/ram0 init=/linuxrc looptype=zisofs loop=/zisofs cdroot</i>
<comment>To boot the 2.4 kernel instead of the default 2.6 kernel use:</comment>
MILO> <i>boot hdb:/boot/gentoo_2.4 initrd=/boot/gentoo_2_4.igz root=/dev/ram0 init=/linuxrc looptype=zisofs loop=/zisofs cdroot</i>
</pre>
<p>
You should have a root ("#") prompt on the current console and can also switch
to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you
started on by pressing Alt-F1.
</p>
<p>
Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases (the
SPARC Installation CDs don't even do autodetection), it may not auto-load the kernel
modules you need. If the PCI auto-detection missed some of your system's
hardware, you will have to load the appropriate kernel modules manually.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
<p>
If you need PCMCIA support, you should start the <c>pcmcia</c> init script:
</p>
<pre caption="Starting the PCMCIA init script">
# <i>/etc/init.d/pcmcia start</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>lynx</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>lynx /mnt/cdrom/docs/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>lynx</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>lynx http://www.gentoo.org/doc/en/handbook/handbook-alpha.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-bootloader.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.8</version>
<date>2006-01-29</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Framebuffer</title>
<body>
<!--
Verbatim copy from x86 bootloader framebuffer explanation, minus the section on
vesafb-tng
-->
<p>
<e>If</e> you have configured your kernel with framebuffer support (or you used
<c>genkernel</c>'s default kernel configuration), you can activate it by adding
a <c>vga</c> and/or a <c>video</c> statement to your bootloader configuration
file.
</p>
<p>
64-bit systems must use the the <c>vesafb</c> driver, and so will need to set
the <c>vga</c> statement. The <c>vga</c> statement controls the resolution and
color depth of your framebuffer screen for <c>vesafb</c>. As stated in
<path>/usr/src/linux/Documentation/fb/vesafb.txt</path> (which gets installed
when you install a kernel source package), you need to pass the VESA number
corresponding to the requested resolution and color depth to it.
</p>
<p>
The following table lists the available resolutions and colordepths and matches
those against the value that you need to pass on to the <c>vga</c> statement.
</p>
<table>
<tr>
<ti></ti>
<th>640x480</th>
<th>800x600</th>
<th>1024x768</th>
<th>1280x1024</th>
</tr>
<tr>
<th>256</th>
<ti>0x301</ti>
<ti>0x303</ti>
<ti>0x305</ti>
<ti>0x307</ti>
</tr>
<tr>
<th>32k</th>
<ti>0x310</ti>
<ti>0x313</ti>
<ti>0x316</ti>
<ti>0x319</ti>
</tr>
<tr>
<th>64k</th>
<ti>0x311</ti>
<ti>0x314</ti>
<ti>0x317</ti>
<ti>0x31A</ti>
</tr>
<tr>
<th>16M</th>
<ti>0x312</ti>
<ti>0x315</ti>
<ti>0x318</ti>
<ti>0x31B</ti>
</tr>
</table>
<p>
The <c>video</c> statement controls framebuffer display options. It needs to be
given the framebuffer driver (<c>vesafb</c> for 2.6 kernels, or <c>vesa</c> for
2.4 kernels) followed by the control statements you wish to enable. All
variables are listed in <path>/usr/src/linux/Documentation/fb/vesafb.txt</path>,
but we'll inform you about three most-used options:
</p>
<table>
<tr>
<th>Control</th>
<th>Description</th>
</tr>
<tr>
<ti>ywrap</ti>
<ti>
Assume that the graphical card can wrap around its memory (i.e. continue at
the beginning when it has approached the end)
</ti>
</tr>
<tr>
<ti>mtrr</ti>
<ti>
Setup MTRR registers
</ti>
</tr>
</table>
<p>
The result of those two statements could be something like <c>vga=0x318
video=vesafb:mtrr,ywrap</c> or <c>video=vesafb:mtrr,ywrap,1024x768-32@85</c>.
Remember (or write down) this setting; you will need it shortly.
</p>
<p>
While LILO does work on AMD64, Gentoo only supports using GRUB. Now continue by
its installation.
</p>
</body>
</subsection>
</section>
<section>
<title>Using GRUB</title>
<subsection>
<title>Understanding GRUB's terminology</title>
<body>
<p>
The most critical part of understanding GRUB is getting comfortable with
how GRUB refers to hard drives and partitions. Your Linux partition
<path>/dev/hda1</path> will most likely be called <path>(hd0,0)</path> under
GRUB. Notice the parenthesis around the <path>hd0,0</path> - they are required.
</p>
<p>
Hard drives count from zero rather than "a" and partitions start at zero
rather than one. Be aware too that with the hd devices, only hard drives are
counted, not atapi-ide devices such as cdrom players and burners. Also, the
same construct is used with SCSI drives. (Normally they get higher numbers
than IDE drives except when the BIOS is configured to boot from SCSI devices.)
When you ask the BIOS to boot from a different hard disk (for instance your
primary slave), <e>that</e> harddisk is seen as <path>hd0</path>.
</p>
<p>
Assuming you have a hard drive on <path>/dev/hda</path>, a cdrom player on
<path>/dev/hdb</path>, a burner on <path>/dev/hdc</path>, a second hard drive
on <path>/dev/hdd</path> and no SCSI hard drive, <path>/dev/hdd7</path> gets
translated to <path>(hd1,6)</path>. It might sound tricky and tricky it is
indeed, but as we will see, GRUB offers a tab completion mechanism
that comes handy for those of you having a lot of hard drives and
partitions and who are a little lost in the GRUB numbering scheme.
</p>
<p>
Having gotten the feel for that, it is time to install GRUB.
</p>
</body>
</subsection>
<subsection>
<title>Installing GRUB</title>
<body>
<p>
To install GRUB, let's first emerge it.
</p>
<pre caption="Installing GRUB">
# <i>emerge grub</i>
</pre>
<p>
Although GRUB is now installed, we still need to write up a
configuration file for it and install GRUB in the MBR so that GRUB
automatically boots your newly created kernel. Create
<path>/boot/grub/grub.conf</path> with <c>nano</c> (or, if applicable, another
editor):
</p>
<pre caption="Creating /boot/grub/grub.conf">
# <i>nano -w /boot/grub/grub.conf</i>
</pre>
<p>
Now we are going to write up a <path>grub.conf</path>. Below you'll
find two possible <path>grub.conf</path> for the partitioning example we use
in this guide, with kernel image <path>kernel-2.6.12-gentoo-r10</path>. We've
only extensively commented the first <path>grub.conf</path>.
</p>
<ul>
<li>
The first <path>grub.conf</path> is for people who have not used
<c>genkernel</c> to build their kernel
</li>
<li>
The second <path>grub.conf</path> is for people who have used
<c>genkernel</c> to build their kernel
</li>
</ul>
<note>
If your root filesystem is JFS, you <e>must</e> add " ro" to the <c>kernel</c>
line since JFS needs to replay its log before it allows read-write mounting.
</note>
<pre caption="grub.conf for non-genkernel users">
<comment># Which listing to boot as default. 0 is the first, 1 the second etc.</comment>
default 0
<comment># How many seconds to wait before the default listing is booted.</comment>
timeout 30
<comment># Nice, fat splash-image to spice things up :)
# Comment out if you don't have a graphics card installed</comment>
splashimage=(hd0,0)/boot/grub/splash.xpm.gz
title=Gentoo Linux 2.6.12
<comment># Partition where the kernel image (or operating system) is located</comment>
root (hd0,0)
kernel /boot/kernel-2.6.12-gentoo-r10 root=/dev/hda3
<comment># The next four lines are only if you dualboot with a Windows system.</comment>
<comment># In this case, Windows is hosted on /dev/hda6.</comment>
title=Windows XP
rootnoverify (hd0,5)
makeactive
chainloader +1
</pre>
<pre caption="grub.conf for genkernel users">
default 0
timeout 30
splashimage=(hd0,0)/boot/grub/splash.xpm.gz
title=Gentoo Linux 2.6.12
root (hd0,0)
kernel /boot/kernel-2.6.12-gentoo-r10 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
initrd /boot/initramfs-genkernel-amd64-2.6.12-gentoo-r10
<comment># Only in case you want to dual-boot</comment>
title=Windows XP
root (hd0,5)
makeactive
chainloader +1
</pre>
<p>
If you used a different partitioning scheme and/or kernel image, adjust
accordingly. However, make sure that anything that follows a GRUB-device (such
as <path>(hd0,0)</path>) is relative to the mountpoint, not the root. In other
words, <path>(hd0,0)/grub/splash.xpm.gz</path> is in reality
<path>/boot/grub/splash.xpm.gz</path> since <path>(hd0,0)</path> is
<path>/boot</path>.
</p>
<p>
Besides, if you chose to use a different partitioning scheme and did not put
<path>/boot</path> in a separate partition, the <path>/boot</path> prefix used
in the above code samples is really <e>required</e>. If you followed our
suggested partitioning plan, the <path>/boot</path> prefix it not required, but
a <path>boot</path> symlink makes it work. In short, the above examples should
work whether you defined a separate <path>/boot</path> partition or not.
</p>
<p>
If you need to pass any additional options to the kernel, simply add
them to the end of the kernel command. We're already passing one option
(<c>root=/dev/hda3</c> or <c>real_root=/dev/hda3</c>), but you can pass others
as well, such as the <c>video</c> statement for framebuffer as we discussed
previously.
</p>
<p>
<c>genkernel</c> users should know that their kernels use the same boot options
as is used for the Installation CD. For instance, if you have SCSI devices, you
should add <c>doscsi</c> as kernel option.
</p>
<p>
Now save the <path>grub.conf</path> file and exit. We still need to install GRUB
in the MBR (Master Boot Record) though.
</p>
<p>
The GRUB developers recommend the use of <c>grub-install</c>. However, if for
some reason <c>grub-install</c> fails to work correctly you still have the
option to manually install GRUB.
</p>
<p>
Continue with <uri link="#grub-install-auto">Default: Setting up GRUB using
grub-install</uri> or <uri link="#grub-install-manual">Alternative: Setting up
GRUB using manual instructions</uri>.
</p>
</body>
</subsection>
<subsection id="grub-install-auto">
<title>Default: Setting up GRUB using grub-install</title>
<body>
<p>
To install GRUB you will need to issue the <c>grub-install</c> command.
However, <c>grub-install</c> won't work off-the-shelf since we are inside a
chrooted environment. We need to create <path>/etc/mtab</path> which lists all
mounted filesystems. Fortunately, there is an easy way to accomplish this -
just copy over <path>/proc/mounts</path> to <path>/etc/mtab</path>, excluding
the <c>rootfs</c> line if you haven't created a separate boot partition. The
following command will work in both cases:
</p>
<pre caption="Creating /etc/mtab">
# <i>grep -v rootfs /proc/mounts > /etc/mtab</i>
</pre>
<p>
Now we can install GRUB using <c>grub-install</c>:
</p>
<pre caption="Running grub-install">
# <i>grub-install /dev/hda</i>
</pre>
<p>
If you have more questions regarding GRUB, please consult the <uri
link="http://www.gnu.org/software/grub/grub-faq.html">GRUB FAQ</uri> or the <uri
link="http://www.gnu.org/software/grub/manual/">GRUB Manual</uri>.
</p>
<p>
Continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
<subsection id="grub-install-manual">
<title>Alternative: Setting up GRUB using manual instructions</title>
<body>
<p>
To start configuring GRUB, you type in <c>grub</c>. You'll be presented
with the <path>grub></path> grub command-line prompt. Now, you need to type
in the right commands to install the GRUB boot record onto your hard drive.
</p>
<pre caption=" Starting the GRUB shell">
# <i>grub</i>
</pre>
<note>
If your system does not have any floppy drives, add the <c>--no-floppy</c>
option to the above command to prevent grub from probing the (non-existing)
floppy drives.
</note>
<p>
In the example configuration we want to install GRUB so that it reads its
information from the boot-partition <path>/dev/hda1</path>, and installs the
GRUB boot record on the hard drive's MBR (master boot record) so that the first
thing we see when we turn on the computer is the GRUB prompt. Of course, if you
haven't followed the example configuration during the installation,
change the commands accordingly.
</p>
<p>
The tab completion mechanism of GRUB can be used from within GRUB.
For instance, if you type in "<c>root (</c>" followed by a TAB, you will
be presented with a list of devices (such as <path>hd0</path>). If you
type in "<c>root (hd0,</c>" followed by a TAB, you will receive a list
of available partitions to choose from (such as <path>hd0,0</path>).
</p>
<p>
By using the tab completion, setting up GRUB should be not that hard.
Now go on, configure GRUB, shall we? :-)
</p>
<pre caption=" Installing GRUB in the MBR">
grub> <i>root (hd0,0)</i> <comment>(Specify where your /boot partition resides)</comment>
grub> <i>setup (hd0)</i> <comment>(Install GRUB in the MBR)</comment>
grub> <i>quit</i> <comment>(Exit the GRUB shell)</comment>
</pre>
<note>
If you want to install GRUB in a certain partition instead of the MBR,
you have to alter the <c>setup</c> command so it points to the right
partition. For instance, if you want GRUB installed in
<path>/dev/hda3</path>, then the command becomes <c>setup (hd0,2)</c>.
Few users however want to do this.
</note>
<p>
If you have more questions regarding GRUB, please consult the <uri
link="http://www.gnu.org/software/grub/grub-faq.html">GRUB FAQ</uri> or the <uri
link="http://www.gnu.org/software/grub/manual/">GRUB Manual</uri>.
</p>
<p>
Continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Unmounting all partitions and rebooting">
# <i>exit</i>
# <i>cd</i>
# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-amd64-disk.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2006-01-01</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI drives, then your first hard
drive would be <path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions and Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On amd64 systems,
these are called <e>partitions</e>.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Partitions are divided in three types:
<e>primary</e>, <e>extended</e> and <e>logical</e>.
</p>
<p>
A <e>primary</e> partition is a partition which has its information stored in
the MBR (master boot record). As an MBR is very small (512 bytes) only four
primary partitions can be defined (for instance, <path>/dev/hda1</path> to
<path>/dev/hda4</path>).
</p>
<p>
An <e>extended</e> partition is a special primary partition (meaning the
extended partition must be one of the four possible primary partitions) which
contains more partitions. Such a partition didn't exist originally, but as
four partitions were too few, it was brought to life to extend the formatting
scheme without losing backward compatibility.
</p>
<p>
A <e>logical</e> partition is a partition inside the extended partition. Their
definitions aren't placed inside the MBR, but are declared inside the extended
partition.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>ext2</ti>
<ti>32M</ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>ext3</ti>
<ti>Rest of the disk</ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
If you are interested in knowing how big a partition (or logical
volume) should be, or even how many partitions (or volumes) you need, read on.
Otherwise continue with <uri link="#fdisk">Using fdisk to Partition your
Disk</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
<p>
As an example partitioning, we show you one for a 20GB disk, used as a
demonstration laptop (containing webserver, mailserver, gnome, ...):
</p>
<pre caption="Filesystem usage example">
Filesystem Type Size Used Avail Use% Mounted on
/dev/hda5 ext3 509M 132M 351M 28% /
/dev/hda2 ext3 5.0G 3.0G 1.8G 63% /home
/dev/hda7 ext3 7.9G 6.2G 1.3G 83% /usr
/dev/hda8 ext3 1011M 483M 477M 51% /opt
/dev/hda9 ext3 2.0G 607M 1.3G 32% /var
/dev/hda1 ext2 51M 17M 31M 36% /boot
/dev/hda6 swap 516M 12M 504M 2% <not mounted>
<comment>(Unpartitioned space for future usage: 2 GB)</comment>
</pre>
<p>
<path>/usr</path> is rather full (83% used) here, but once
all software is installed, <path>/usr</path> doesn't tend to grow that much.
Although allocating a few gigabytes of disk space for <path>/var</path> may
seem excessive, remember that Portage uses this partition by default for
compiling packages. If you want to keep <path>/var</path> at a more reasonable
size, such as 1GB, you will need to alter your <c>PORTAGE_TMPDIR</c> variable
in <path>/etc/make.conf</path> to point to the partition with enough free space
for compiling extremely large packages such as OpenOffice.
</p>
</body>
</subsection>
</section>
<section id="fdisk">
<title>Using fdisk to Partition your Disk</title>
<subsection>
<body>
<p>
The following parts explain how to create the example partition layout
described previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
Change your partition layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Viewing the Current Partition Layout</title>
<body>
<p>
<c>fdisk</c> is a popular and powerful tool to split your disk into partitions.
Fire up <c>fdisk</c> on your disk (in our example, we use
<path>/dev/hda</path>):
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/hda</i>
</pre>
<p>
Once in <c>fdisk</c>, you'll be greeted with a prompt that looks like this:
</p>
<pre caption="fdisk prompt">
Command (m for help):
</pre>
<p>
Type <c>p</c> to display your disk's current partition configuration:
</p>
<pre caption="An example partition configuration">
Command (m for help): <i>p</i>
Disk /dev/hda: 240 heads, 63 sectors, 2184 cylinders
Units = cylinders of 15120 * 512 bytes
Device Boot Start End Blocks Id System
/dev/hda1 1 14 105808+ 83 Linux
/dev/hda2 15 49 264600 82 Linux swap
/dev/hda3 50 70 158760 83 Linux
/dev/hda4 71 2184 15981840 5 Extended
/dev/hda5 71 209 1050808+ 83 Linux
/dev/hda6 210 348 1050808+ 83 Linux
/dev/hda7 349 626 2101648+ 83 Linux
/dev/hda8 627 904 2101648+ 83 Linux
/dev/hda9 905 2184 9676768+ 83 Linux
Command (m for help):
</pre>
<p>
This particular disk is configured to house seven Linux filesystems (each with a
corresponding partition listed as "Linux") as well as a swap partition (listed
as "Linux swap").
</p>
</body>
</subsection>
<subsection>
<title>Removing all Partitions</title>
<body>
<p>
We will first remove all existing partitions from the disk. Type <c>d</c> to
delete a partition. For instance, to delete an existing <path>/dev/hda1</path>:
</p>
<pre caption="Deleting a partition">
Command (m for help): <i>d</i>
Partition number (1-4): <i>1</i>
</pre>
<p>
The partition has been scheduled for deletion. It will no longer show up if you
type <c>p</c>, but it will not be erased until your changes have been saved. If
you made a mistake and want to abort without saving your changes, type <c>q</c>
immediately and hit enter and your partition will not be deleted.
</p>
<p>
Now, assuming that you do indeed want to wipe out all the partitions on your
system, repeatedly type <c>p</c> to print out a partition listing and then type
<c>d</c> and the number of the partition to delete it. Eventually, you'll end
up with a partition table with nothing in it:
</p>
<pre caption="An empty partition table">
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
Command (m for help):
</pre>
<p>
Now that the in-memory partition table is empty, we're ready to create the
partitions. We will use a default partitioning scheme as discussed previously.
Of course, don't follow these instructions to the letter if you don't want the
same partitioning scheme!
</p>
</body>
</subsection>
<subsection>
<title>Creating the Boot Partition</title>
<body>
<p>
We first create a small boot partition. Type <c>n</c> to create a new partition,
then <c>p</c> to select a primary partition, followed by <c>1</c> to select the
first primary partition. When prompted for the first cylinder, hit enter. When
prompted for the last cylinder, type <c>+32M</c> to create a partition 32 Mbyte
in size:
</p>
<pre caption="Creating the boot partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>1</i>
First cylinder (1-3876, default 1): <comment>(Hit Enter)</comment>
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-3876, default 3876): <i>+32M</i>
</pre>
<p>
Now, when you type <c>p</c>, you should see the following partition printout:
</p>
<pre caption="Created boot partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 1 14 105808+ 83 Linux
</pre>
<p>
We need to make this partition bootable. Type <c>a</c> to toggle the bootable
flag on a partition and select <c>1</c>. If you press <c>p</c> again, you will
notice that an <path>*</path> is placed in the "Boot" column.
</p>
</body>
</subsection>
<subsection>
<title>Creating the Swap Partition</title>
<body>
<p>
Let's now create the swap partition. To do this, type <c>n</c> to create a new
partition, then <c>p</c> to tell fdisk that you want a primary partition. Then
type <c>2</c> to create the second primary partition, <path>/dev/hda2</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
you've done this, type <c>t</c> to set the partition type, <c>2</c> to select
the partition you just created 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 this:
</p>
<pre caption="Partition listing after creating a swap partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 * 1 14 105808+ 83 Linux
/dev/hda2 15 81 506520 82 Linux swap
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
Finally, let's create the root partition. To do this, type <c>n</c> to create a
new partition, then <c>p</c> to tell fdisk that you want a primary partition.
Then type <c>3</c> to create the third primary partition, <path>/dev/hda3</path>
in our case. When prompted for the first cylinder, hit enter. When prompted for
the last cylinder, hit enter to create a partition that takes up the rest of the
remaining space on your disk. After completing these steps, typing <c>p</c>
should display a partition table that looks similar to this:
</p>
<pre caption="Partition listing after creating the root partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 * 1 14 105808+ 83 Linux
/dev/hda2 15 81 506520 82 Linux swap
/dev/hda3 82 3876 28690200 83 Linux
</pre>
</body>
</subsection>
<subsection>
<title>Saving the Partition Layout</title>
<body>
<p>
To save the partition layout and exit <c>fdisk</c>, type <c>w</c>.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available. Some of them are found stable on the amd64
architecture, others aren't. The following filesystems are found to be stable:
ext2 and ext3. jfs and reiserfs may work but need more testing. If you're really
adventurous you can try the unsupported filesystems.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready and there hasn't been a sufficient track record to
comment positively nor negatively on its general stability at this point.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the boot partition (<path>/dev/hda1</path> in our
example) in ext2 and the root partition (<path>/dev/hda3</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs /dev/hda1</i>
# <i>mke2fs -j /dev/hda3</i>
</pre>
<p>
Now create the filesystems on your newly created partitions.
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/hda2</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/hda2</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/hda3 /mnt/gentoo</i>
# <i>mkdir /mnt/gentoo/boot</i>
# <i>mount /dev/hda1 /mnt/gentoo/boot</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-amd64-kernel.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For AMD64-based systems we have <c>gentoo-sources</c> (kernel v2.6 source
patched with amd64 specific fixes for stability, performance and hardware
support).
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>. The
<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Jul 28 11:04 /usr/src/linux -> linux-2.6.12-gentoo-r10
</pre>
<p>
Now it is time to configure and compile your kernel source.
You can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Then we select the exact processor type.
</p>
<pre caption="Selecting processor type and features">
Processor type and features --->
Processor family (AMD-Opteron/Athlon64) --->
( ) AMD-Opteron/Athlon64
( ) Intel EM64T
( ) Generic-x86-64"
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
file system</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
<*> /proc file system support
<*> Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking Support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
If you have a multi-CPU Opteron system, you should activate "Symmetric
multi-processing support":
</p>
<pre caption="Activating SMP support">
Processor type and features --->
[*] Symmetric multi-processing support
</pre>
<p>
If you use USB Input Devices (like Keyboard or Mouse) don't forget to enable
those as well:
</p>
<pre caption="Activating USB Support for Input Devices">
Device Drivers --->
USB Support --->
<*> USB Human Interface Device (full HID) support
[*] HID input layer support
</pre>
<p>
When you've finished configuring the kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
# <i>make && make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
choice and remember it as you will need it later on when you configure your
bootloader. Remember to replace <path><kernel-version></path> with the
name and version of your kernel.
</p>
<pre caption="Installing the kernel">
# <i>cp arch/x86_64/boot/bzImage /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Configuring Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because
genkernel doesn't require any manual kernel configuration, it is an ideal
solution for those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Now, compile your kernel sources by running <c>genkernel all</c>.
Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware, this compilation will take quite a while to finish!
</p>
<p>
Note that, if your boot partition doesn't use ext2 or ext3 as filesystem you
need to manually configure your kernel using <c>genkernel --menuconfig all</c>
and add support for your filesystem <e>in</e> the kernel (i.e. <e>not</e> as a
module).
</p>
<pre caption="Running genkernel">
# <i>genkernel all</i>
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD)
before your "real" system starts up.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
Now, let's perform one more step to get our system to be more like the
Installation CD -- let's emerge <c>coldplug</c>. While the initrd autodetects
hardware that is needed to boot your system, <c>coldplug</c> autodetects
everything else. To emerge and enable <c>coldplug</c>, type the following:
</p>
<pre caption="Emerging and enabling coldplug">
# <i>emerge coldplug</i>
# <i>rc-update add coldplug boot</i>
</pre>
</body>
</section>
<section id="kernel_modules">
<title>Configuring Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.4</path> (or <path>kernel-2.6</path>).
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> file and enter the module name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-amd64-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-amd64-medium.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>Any AMD64 CPU *</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
You should check the <uri link="http://amd64.gentoo.org">Gentoo
AMD64 Project Page</uri> before proceeding.
</p>
</body>
</subsection>
</section>
<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/amd64/) -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can succesfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
the <path>releases/amd64/2006.0-r1/installcd</path> directory;
the Package CD is located in the <path>releases/amd64/2006.0/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<p>
Once you have burned your installation CDs, it is time to boot them.
Remove all CDs from the CD drives, reboot your system and enter the BIOS.
This is usually done by hitting DEL, F1
or ESC, depending on your BIOS. Inside the BIOS, change the boot
order so that the CD-ROM is tried before the hard disk. This is often found
under "CMOS Setup". If you don't do this, your system will just reboot from the
hard disk, ignoring the CD-ROM.
</p>
<p>
Now place the installation CD in the CD-ROM drive and reboot. You
should see a boot prompt. At this
screen, you can hit Enter to begin the boot process with the default
boot options, or boot the Installation CD with custom boot options by specifying
a kernel followed by boot options and then hitting Enter.
</p>
<p>
Specifying a kernel? Yes, we provide several kernels on our Installation CD. The
default one is <c>gentoo</c>. Other kernels are for specific hardware needs and
the <c>-nofb</c> variants which disable framebuffer.
</p>
<p>
Below you'll find a short overview on the available kernels:
</p>
<table>
<tr>
<th>Kernel</th>
<th>Description</th>
</tr>
<tr>
<ti>gentoo</ti>
<ti>Default kernel with support for K8 CPUs with NUMA</ti>
</tr>
</table>
<p>
You can also provide kernel options. They represent optional settings
you can (de)activate at will. The following code listing explains all available
kernel options.
</p>
<pre caption="Available boot options">
- agpgart loads agpgart (use if you have graphic problems,lockups)
- acpi=on loads support for ACPI firmware
- ide=nodma force disabling of DMA for malfunctioning IDE devices
- doscsi scan for scsi devices (breaks some ethernet cards)
- dopcmcia starts pcmcia service for PCMCIA cdroms
- nofirewire disables firewire modules in initrd (for firewire cdroms,etc)
- nokeymap disables keymap selection for non-us keyboard layouts
- docache cache the entire runtime portion of cd in RAM, allows you
to umount /mnt/cdrom to mount another cdrom.
- nodetect causes hwsetup/kudzu and hotplug not to run
- nousb disables usb module load from initrd, disables hotplug
- nodhcp dhcp does not automatically start if nic detected
- nohotplug disables loading hotplug service
- noapic disable apic (try if having hardware problems nics,scsi,etc)
- noevms2 disable loading of EVMS2 modules
- nolvm2 disable loading of LVM2 modules
- hdx=stroke allows you to partition the whole harddrive even when your BIOS
can't handle large harddrives
- noload=module1[,module2[,...]]
disable loading of specific kernel modules
</pre>
<p>
Now boot your CD, select a kernel (if you are not happy with the default
<c>gentoo</c> kernel) and boot options. As an example, we show you how
to boot the <c>gentoo</c> kernel, with <c>dopcmcia</c> as kernel
parameters:
</p>
<pre caption="Booting an Installation CD">
boot: <i>gentoo dopcmcia</i>
</pre>
<p>
You will then be greeted with a boot screen and progress bar. If you are
installing Gentoo on a system with a non-US keyboard, make sure you
immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
selection is made in 10 seconds, the default (US keyboard) will be accepted and
the boot process will continue. Once the boot process completes, you will be
automatically logged in to the "Live" Gentoo Linux as
"root", the super user. You should have a root ("#") prompt
on the current console and can also switch to other consoles by pressing Alt-F2,
Alt-F3 and Alt-F4. Get back to the one you started on by pressing Alt-F1.
</p>
<p>
Now continue with <uri link="#hardware">Extra Hardware
Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases it may
not auto-load the kernel modules you need. If the PCI auto-detection missed
some of your system's hardware, you will have to load the appropriate kernel
modules manually.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
<p>
If you need PCMCIA support, you should start the <c>pcmcia</c> init script:
</p>
<pre caption="Starting the PCMCIA init script">
# <i>/etc/init.d/pcmcia start</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-config.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-config.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2005-11-19</date>
<section>
<title>Filesystem Information</title>
<subsection>
<title>What is fstab?</title>
<body>
<p>
Under Linux, all partitions used by the system must be listed in
<path>/etc/fstab</path>. This file contains the mountpoints of those partitions
(where they are seen in the file system structure), how they should be mounted
and with what special options (automatically or not, whether users can mount
them or not, etc.)
</p>
</body>
</subsection>
<subsection>
<title>Creating /etc/fstab</title>
<body>
<p>
<path>/etc/fstab</path> uses a special syntax. Every line consists of six
fields, separated by whitespace (space(s), tabs or a mixture). Each field has
its own meaning:
</p>
<ul>
<li>
The first field shows the <b>partition</b> described (the path to the device
file)
</li>
<li>
The second field shows the <b>mountpoint</b> at which the partition should be
mounted
</li>
<li>
The third field shows the <b>filesystem</b> used by the partition
</li>
<li>
The fourth field shows the <b>mountoptions</b> used by <c>mount</c> when it
wants to mount the partition. As every filesystem has its own mountoptions,
you are encouraged to read the mount man page (<c>man mount</c>) for a full
listing. Multiple mountoptions are comma-separated.
</li>
<li>
The fifth field is used by <c>dump</c> to determine if the partition needs to
be <b>dump</b>ed or not. You can generally leave this as <c>0</c> (zero).
</li>
<li>
The sixth field is used by <c>fsck</c> to determine the order in which
filesystems should be <b>check</b>ed if the system wasn't shut down properly.
The root filesystem should have <c>1</c> while the rest should have <c>2</c>
(or <c>0</c> if a filesystem check isn't necessary).
</li>
</ul>
<p>
The default <path>/etc/fstab</path> file provided by Gentoo <e>is no valid fstab
file</e>, so start <c>nano</c> (or your favorite editor) to create your
<path>/etc/fstab</path>:
</p>
<pre caption="Opening /etc/fstab">
# <i>nano -w /etc/fstab</i>
</pre>
<p>
Let us take a look at how we write down the options for the <path>/boot</path>
partition. This is just an example, so if your architecture doesn't require a
<path>/boot</path> partition (such as <b>PPC</b>), don't copy it verbatim.
</p>
<p>
In our default x86 partitioning example <path>/boot</path> is the
<path>/dev/hda1</path> partition, with <c>ext2</c> as filesystem.
It needs to be checked during boot, so we would write down:
</p>
<pre caption="An example /boot line for /etc/fstab">
/dev/hda1 /boot ext2 defaults 1 2
</pre>
<p>
Some users don't want their <path>/boot</path> partition to be mounted
automatically to improve their system's security. Those people should
substitute <c>defaults</c> with <c>noauto</c>. This does mean that you need to
manually mount this partition every time you want to use it.
</p>
<p>
Now, to improve performance, most users would want to add the <c>noatime</c>
option as mountoption, which results in a faster system since access times
aren't registered (you don't need those generally anyway):
</p>
<pre caption="An improved /boot line for /etc/fstab">
/dev/hda1 /boot ext2 defaults,noatime 1 2
</pre>
<p>
If we continue with this, we would end up with the following three lines (for
<path>/boot</path>, <path>/</path> and the swap partition):
</p>
<pre caption="Three /etc/fstab lines">
/dev/hda1 /boot ext2 defaults,noatime 1 2
/dev/hda2 none swap sw 0 0
/dev/hda3 / ext3 noatime 0 1
</pre>
<p>
To finish up, you should add a rule for <path>/proc</path>, <c>tmpfs</c>
(required) and for your CD-ROM drive (and of course, if you have other
partitions or drives, for those too):
</p>
<pre caption="A full /etc/fstab example">
/dev/hda1 /boot ext2 defaults,noatime 1 2
/dev/hda2 none swap sw 0 0
/dev/hda3 / ext3 noatime 0 1
none /proc proc defaults 0 0
none /dev/shm tmpfs nodev,nosuid,noexec 0 0
/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
</pre>
<p>
<c>auto</c> makes <c>mount</c> guess for the filesystem (recommended for
removable media as they can be created with one of many filesystems) and
<c>user</c> makes it possible for non-root users to mount the CD.
</p>
<p>
Now use the above example to create your <path>/etc/fstab</path>. If you are a
<b>SPARC</b>-user, you should add the following line to your
<path>/etc/fstab</path>
too:
</p>
<pre caption="Adding openprom filesystem to /etc/fstab">
none /proc/openprom openpromfs defaults 0 0
</pre>
<p>
Double-check your <path>/etc/fstab</path>, save and quit to continue.
</p>
</body>
</subsection>
</section>
<section>
<title>Networking Information</title>
<subsection>
<title>Hostname, Domainname etc.</title>
<body>
<p>
One of the choices the user has to make is name his/her PC. This seems to be
quite easy, but <e>lots</e> of users are having difficulties finding the
appropriate name for their Linux-pc. To speed things up, know that any name you
choose can be changed afterwards. For all we care, you can just call your system
<c>tux</c> and domain <c>homenetwork</c>.
</p>
<p>
We use these values in the next examples. First we set the hostname:
</p>
<pre caption="Setting the hostname">
# <i>nano -w /etc/conf.d/hostname</i>
<comment>(Set the HOSTNAME variable to your hostname)</comment>
HOSTNAME="<i>tux</i>"
</pre>
<p>
Second we set the domainname:
</p>
<pre caption="Setting the domainname">
# <i>nano -w /etc/conf.d/domainname</i>
<comment>(Set the DNSDOMAIN variable to your domain name)</comment>
DNSDOMAIN="<i>homenetwork</i>"
</pre>
<p>
If you have a NIS domain (if you don't know what that is, then you don't have
one), you need to define that one too:
</p>
<pre caption="Setting the NIS domainname">
# <i>nano -w /etc/conf.d/domainname</i>
<comment>(Set the NISDOMAIN variable to your NIS domain name)</comment>
NISDOMAIN="<i>my-nisdomain</i>"
</pre>
<p>
Now add the <c>domainname</c> script to the default runlevel:
</p>
<pre caption="Adding domainname to the default runlevel">
# <i>rc-update add domainname default</i>
</pre>
</body>
</subsection>
<subsection>
<title>Configuring your Network</title>
<body>
<p>
Before you get that "Hey, we've had that already"-feeling, you should remember
that the networking you set up in the beginning of the Gentoo installation was
just for the installation. Right now you are going to configure networking for
your Gentoo system permanently.
</p>
<note>
More detailed information about networking, including advanced topics like
bonding, bridging, 802.1Q VLANs or wireless networking is covered in the <uri
link="?part=4">Gentoo Network Configuration</uri> section.
</note>
<p>
All networking information is gathered in <path>/etc/conf.d/net</path>. It uses
a straightforward yet not intuitive syntax if you don't know how to set up
networking manually. But don't fear, we'll explain everything. A fully
commented example that covers many different configurations is available in
<path>/etc/conf.d/net.example</path>.
</p>
<p>
DHCP is used by default and does not require any further configuration.
</p>
<p>
If you need to configure your network connection either because you need
specific DHCP options or because you do not use DHCP at all, open
<path>/etc/conf.d/net</path> with your favorite editor (<c>nano</c> is used in
this example):
</p>
<pre caption="Opening /etc/conf.d/net for editing">
# <i>nano -w /etc/conf.d/net</i>
</pre>
<p>
You will see the following file:
</p>
<pre caption="Default /etc/conf.d/net">
# This blank configuration will automatically use DHCP for any net.*
# scripts in /etc/init.d. To create a more complete configuration,
# please review /etc/conf.d/net.example and save your configuration
# in /etc/conf.d/net (this file :]!).
</pre>
<p>
To enter your own IP address, netmask and gateway, you need
to set both <c>config_eth0</c> and <c>routes_eth0</c>:
</p>
<pre caption="Manually setting IP information for eth0">
config_eth0=( "192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" )
routes_eth0=( "default gw 192.168.0.1" )
</pre>
<p>
To use DHCP and add specific DHCP options, define <c>config_eth0</c> and
<c>dhcp_eth0</c>:
</p>
<pre caption="Automatically obtaining an IP address for eth0">
config_eth0=( "dhcp" )
dhcp_eth0="nodns nontp nonis"
</pre>
<p>
Please read <path>/etc/conf.d/net.example</path> for a list of all available
options.
</p>
<p>
If you have several network interfaces repeat the above steps for
<c>config_eth1</c>, <c>config_eth2</c>, etc.
</p>
<p>
Now save the configuration and exit to continue.
</p>
</body>
</subsection>
<subsection>
<title>Automatically Start Networking at Boot</title>
<body>
<p>
To have your network interfaces activated at boot, you need to add them to the
default runlevel. If you have PCMCIA interfaces you should skip this action as
the PCMCIA interfaces are started by the PCMCIA init script.
</p>
<pre caption="Adding net.eth0 to the default runlevel">
# <i>rc-update add net.eth0 default</i>
</pre>
<p>
If you have several network interfaces, you need to create the appropriate
<path>net.eth1</path>, <path>net.eth2</path> etc. initscripts for those. You can
use <c>ln</c> to do this:
</p>
<pre caption="Creating extra initscripts">
# <i>cd /etc/init.d</i>
# <i>ln -s net.eth0 net.eth1</i>
# <i>rc-update add net.eth1 default</i>
</pre>
</body>
</subsection>
<subsection>
<title>Writing Down Network Information</title>
<body>
<p>
You now need to inform Linux about your network. This is defined in
<path>/etc/hosts</path> and helps in resolving hostnames to IP addresses
for hosts that aren't resolved by your nameserver. For instance, if your
internal network consists of three PCs called <c>jenny</c> (192.168.0.5),
<c>benny</c> (192.168.0.6) and <c>tux</c> (192.168.0.7 - this system) you would
open <path>/etc/hosts</path> and fill in the values:
</p>
<pre caption="Opening /etc/hosts">
# <i>nano -w /etc/hosts</i>
</pre>
<pre caption="Filling in the networking information">
127.0.0.1 localhost
192.168.0.5 jenny.homenetwork jenny
192.168.0.6 benny.homenetwork benny
192.168.0.7 tux.homenetwork tux
</pre>
<p>
If your system is the only system (or the nameservers handle all name
resolution) a single line is sufficient. For instance, if you want to call your
system <c>tux</c>:
</p>
<pre caption="/etc/hosts for lonely or fully integrated PCs">
127.0.0.1 localhost tux
</pre>
<p>
Save and exit the editor to continue.
</p>
<p>
If you don't have PCMCIA, you can now continue with <uri
link="#doc_chap3">System Information</uri>. PCMCIA-users should read the
following topic on PCMCIA.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Get PCMCIA Working</title>
<body>
<note>
pcmcia-cs is only available for x86, amd64 and ppc platforms.
</note>
<p>
PCMCIA-users should first install the <c>pcmcia-cs</c> package. This also
includes users who will be working with a 2.6 kernel (even though they won't be
using the PCMCIA drivers from this package). The <c>USE="-X"</c> is necessary
to avoid installing xorg-x11 at this moment:
</p>
<pre caption="Installing pcmcia-cs">
# <i>USE="-X" emerge pcmcia-cs</i>
</pre>
<p>
When <c>pcmcia-cs</c> is installed, add <c>pcmcia</c> to the <e>default</e>
runlevel:
</p>
<pre caption="Adding pcmcia to the default runlevel">
# <i>rc-update add pcmcia default</i>
</pre>
</body>
</subsection>
</section>
<section>
<title>System Information</title>
<subsection>
<title>Root Password</title>
<body>
<p>
First we set the root password by typing:
</p>
<pre caption="Setting the root password">
# <i>passwd</i>
</pre>
<p>
If you want root to be able to log on through the serial console, add
<c>tts/0</c> to <path>/etc/securetty</path>:
</p>
<pre caption="Adding tts/0 to /etc/securetty">
# <i>echo "tts/0" >> /etc/securetty</i>
</pre>
</body>
</subsection>
<subsection>
<title>System Information</title>
<body>
<p>
Gentoo uses <path>/etc/rc.conf</path> for general, system-wide configuration.
Open up <path>/etc/rc.conf</path> and enjoy all the comments in that file :)
</p>
<pre caption="Opening /etc/rc.conf">
# <i>nano -w /etc/rc.conf</i>
</pre>
<p>
When you're finished configuring <path>/etc/rc.conf</path>, save and exit.
</p>
<p>
As you can see, this file is well commented to help you set up the necessary
configuration variables. You can configure your system to use unicode and
define your default editor and your display manager (like gdm or kdm).
</p>
<p>
Gentoo uses <path>/etc/conf.d/keymaps</path> to handle keyboard configuration.
Edit it to configure your keyboard.
</p>
<pre caption="Opening /etc/conf.d/keymaps">
# <i>nano -w /etc/conf.d/keymaps</i>
</pre>
<p>
Take special care with the <c>KEYMAP</c> variable. If you select the wrong
<c>KEYMAP</c>, you will get weird results when typing on your keyboard.
</p>
<note>
Users of USB-based <b>SPARC</b> systems and <b>SPARC</b> clones might need to
select an i386 keymap (such as "us") instead of "sunkeymap". <b>PPC</b> uses x86
keymaps on most systems. Users who want to be able to use ADB keymaps on boot
have to enable ADB keycode sendings in their kernel and have to set a mac/ppc
keymap in <path>/etc/conf.d/keymaps</path>.
</note>
<p>
When you're finished configuring <path>/etc/conf.d/keymaps</path>, save and
exit.
</p>
<p>
Gentoo uses <path>/etc/conf.d/clock</path> to set clock options. Edit it
according to your needs.
</p>
<pre caption="Opening /etc/conf.d/clock">
# <i>nano -w /etc/conf.d/clock</i>
</pre>
<p>
If your hardware clock is not using UTC, you need to add <c>CLOCK="local"</c> to
the file. Otherwise you will notice some clock skew.
</p>
<p>
When you're finished configuring <path>/etc/conf.d/clock</path>, save and
exit.
</p>
<p>
If you are not installing Gentoo on IBM PPC64 hardware, continue with
<uri link="?part=1&chap=9">Installing Necessary System Tools</uri>.
</p>
</body>
</subsection>
<subsection>
<title>Configuring the Console</title>
<body>
<note>
The following section applies to the IBM PPC64 hardware platforms.
</note>
<p>
If you are running Gentoo on IBM PPC64 hardware and using a virtual console
you must uncomment the appropriate line in <path>/etc/inittab</path> for the
virtual console to spawn a login prompt.
</p>
<pre caption="Enabling hvc or hvsi support in /etc/inittab">
hvc0:12345:respawn:/sbin/agetty -L 9600 hvc0
hvsi:12345:respawn:/sbin/agetty -L 19200 hvsi0
</pre>
<p>
You should also take this time to verify that the appropriate console is
listed in <path>/etc/securetty</path>.
</p>
<p>
You may now continue with <uri link="?part=1&chap=9">Installing Necessary
System Tools</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-finalise.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-finalise.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-finalise.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-finalise.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-finalise.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2006-01-23</date>
<section>
<title>User Administration</title>
<subsection>
<title>Adding a User for Daily Use</title>
<body>
<p>
Working as root on a Unix/Linux system is <e>dangerous</e> and should be avoided
as much as possible. Therefore it is <e>strongly</e> recommended to add a user
for day-to-day use.
</p>
<p>
The groups the user is member of define what activities the user can perform.
The following table lists a number of important groups you might wish to use:
</p>
<table>
<tr>
<th>Group</th>
<th>Description</th>
</tr>
<tr>
<ti>audio</ti>
<ti>be able to access the audio devices</ti>
</tr>
<tr>
<ti>cdrom</ti>
<ti>be able to directly access optical devices</ti>
</tr>
<tr>
<ti>floppy</ti>
<ti>be able to directly access floppy devices</ti>
</tr>
<tr>
<ti>games</ti>
<ti>be able to play games</ti>
</tr>
<tr>
<ti>portage</ti>
<ti>be able to use <c>emerge --pretend</c> as a normal user</ti>
</tr>
<tr>
<ti>usb</ti>
<ti>be able to access USB devices</ti>
</tr>
<tr>
<ti>plugdev</ti>
<ti>
Be able to mount and use pluggable devices such as cameras and USB sticks
</ti>
</tr>
<tr>
<ti>video</ti>
<ti>
be able to access video capturing hardware and doing hardware
acceleration
</ti>
</tr>
<tr>
<ti>wheel</ti>
<ti>be able to use <c>su</c></ti>
</tr>
</table>
<p>
For instance, to create a user called <c>john</c> who is member of the
<c>wheel</c>, <c>users</c> and <c>audio</c> groups, log in as root first
(only root can create users) and run <c>useradd</c>:
</p>
<pre caption="Adding a user for day-to-day use">
Login: <i>root</i>
Password: <comment>(Your root password)</comment>
# <i>useradd -m -G users,wheel,audio -s /bin/bash john</i>
# <i>passwd john</i>
Password: <comment>(Enter the password for john)</comment>
Re-enter password: <comment>(Re-enter the password to verify)</comment>
</pre>
<p>
If a user ever needs to perform some task as root, they can use <c>su -</c>
to temporarily receive root privileges. Another way is to use the <c>sudo</c>
package which is, if correctly configured, very secure.
</p>
</body>
</subsection>
</section>
<section>
<title>Optional: Install GRP Packages</title>
<body>
<impo>
This part is for GRP users only. Other users should skip this part and continue
with <uri link="?part=1&chap=12">Where to go from here?</uri>.
</impo>
<p>
Now that your system is booted, log on as the user you created (for instance,
<c>john</c>) and use <c>su -</c> to gain root privileges:
</p>
<pre caption="Gaining root privileges">
$ <i>su -</i>
Password: <comment>(Enter your root password)</comment>
</pre>
<p>
Now we need to change the Portage configuration to look for the prebuilt
binaries from the second CD (Gentoo Packages CD). First mount this CD:
</p>
<pre caption="Mount the Packages CD">
<comment>(Put the Gentoo Packages CD in the CD tray)</comment>
# <i>mount /mnt/cdrom</i>
</pre>
<p>
Now configure Portage to use <path>/mnt/cdrom</path> for its prebuilt packages:
</p>
<pre caption="Configuring Portage to use /mnt/cdrom">
# <i>ls /mnt/cdrom</i>
<comment>(If there is a /mnt/cdrom/packages directory:)</comment>
# <i>export PKGDIR="/mnt/cdrom/packages"</i>
<comment>(Otherwise:)</comment>
# <i>export PKGDIR="/mnt/cdrom"</i>
</pre>
<p>
Now install the packages you want. The Packages CD contains several prebuilt
binaries, for instance KDE and GNOME.
</p>
<pre caption="Installing GNOME">
# <i>emerge --usepkg gnome</i>
</pre>
<p>
To find out what prebuilt packages are available, do a quick listing of all
the files in <path>/mnt/cdrom/All</path>. For instance, to find out if KDE is
emergeable:
</p>
<pre caption="Finding out if KDE is installable">
# <i>ls /mnt/cdrom/All/kde*</i>
</pre>
<p>
Be sure to install the binaries now. When you do an <c>emerge --sync</c> to
update Portage (as you will learn later), the prebuilt binaries might not match
against the ebuilds in your updated Portage. You can try to circumvent this by
using <c>emerge --usepkgonly</c> instead of <c>emerge --usepkg</c>.
</p>
<p>
Congratulations, your system is now fully equipped! Continue with <uri
link="?part=1&chap=12">Where to go from here?</uri> to learn more about
Gentoo.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-bootloader.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2006-01-19</date>
<section>
<title>Installing PALO</title>
<body>
<p>
On the PA-RISC platform, the boot loader is called palo. You can find
the configuration file in <path>/etc/palo.conf</path>. Here is a sample
configuration:
</p>
<pre caption = "/etc/palo.conf example">
--commandline=2/kernel-2.6.12.2-pa2 root=/dev/sda4
--recoverykernel=/vmlinux.old
--init-partitioned=/dev/sda
</pre>
<p>
The first line tells palo the location of the kernel and which boot
parameters it must use. <c>2/kernel-2.6.12.2-pa2</c> means the kernel named
<c>kernel-2.6.12.2-pa2</c> resides on the second partition. Beware, the path
to the kernel is relative to the partition, not to the root of your filesystem.
</p>
<p>
The second line indicates which recovery kernel to use. If it is your
first install and you do not have a recovery kernel, please comment this
out. The third line indicates on which disk palo will reside.
</p>
<p>
When configuration is done, just run <c>palo</c>.
</p>
<pre caption = "Applying the PALO configuration">
# <i>palo</i>
</pre>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-hppa-disk.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-25</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first SCSI HD in a Linux system, namely
<path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions and Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On most systems,
these are called <e>partitions</e>. Other architectures use a similar technique,
called <e>slices</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
</body>
</subsection>
</section>
<section>
<title>Using fdisk on HPPA to Partition your Disk</title>
<body>
<p>
Use <c>fdisk</c> to create the partitions you want:
</p>
<pre caption="Partitioning the disk">
# <i>fdisk /dev/sda</i>
</pre>
<p>
HPPA machines use the PC standard DOS partition tables. To create a new
DOS partition table, simply use the <c>o</c> command.
</p>
<pre caption="Creating a DOS partition table">
# <i>fdisk /dev/sda</i>
Command (m for help): <i>o</i>
Building a new DOS disklabel.
</pre>
<p>
PALO (the HPPA bootloader) needs a special partition to work. You have
to create a partition of at least 16MB at the beginning of your disk.
The partition type must be of type <e>f0</e> (Linux/PA-RISC boot).
</p>
<impo>
If you ignore this and continue without a special PALO partition, your system
will stop loving you and fail to start. Also, if your disk is larger than 2GB,
make sure that the boot partition is in the first 2GB of your disk. PALO is
unable to read a kernel after the 2GB limit.
</impo>
<pre caption="A simple default partition schema">
# <i>cat /etc/fstab</i>
/dev/sda2 /boot ext3 noauto,noatime 1 1
/dev/sda3 none swap sw 0 0
/dev/sda4 / ext3 noatime 0 0
# <i>fdisk /dev/sda</i>
Command (m for help): <i>p</i>
Disk /dev/sda: 4294 MB, 4294816768 bytes
133 heads, 62 sectors/track, 1017 cylinders
Units = cylinders of 8246 * 512 = 4221952 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 8 32953 f0 Linux/PA-RISC boot
/dev/sda2 9 20 49476 83 Linux
/dev/sda3 21 70 206150 82 Linux swap
/dev/sda4 71 1017 3904481 83 Linux
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available. Ext2, ext3, XFS and reiserfs are found stable on
the HPPA architecture. The others are very experimental.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready and there hasn't been a sufficient track record to
comment positively nor negatively on its general stability at this point.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the boot partition (<path>/dev/sda2</path> in our
example) in ext2 and the root partition (<path>/dev/sda4</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs /dev/sda2</i>
# <i>mke2fs -j /dev/sda4</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/sda3</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/sda3</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/sda4 /mnt/gentoo</i>
# <i>mkdir /mnt/gentoo/boot</i>
# <i>mount /dev/sda2 /mnt/gentoo/boot</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-hppa-kernel.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For HPPA we have <c>hppa-sources</c>. Default these sources are based on the
2.6 kernel sources. If you want to install a 2.4 kernel, you will need to
install Gentoo from a working Internet connection as we do not supply those
sources on our Installation CD. Continue by installing the kernel source. The
<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge hppa-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>hppa-sources-2.6.12.2-pa2</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.12.2-pa2
</pre>
<p>
Now it is time to configure and compile your kernel source. All architectures
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
file system</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
If you have a HIL mouse or keyboard, do not forget to compile in support for
them.
</p>
<pre caption="Activating HIL support">
Input core support --->
[*] Keyboard support
[*] Mouse support
[*] Event interface support
</pre>
<p>
If you have no mouse on your HIL port, only use the basic support:
</p>
<pre caption="Basic HIL support">
HIL support --->
[*] HIL Keyboard (basic) support
</pre>
<p>
If you however want <e>full</e> HIL support, select the following options:
</p>
<pre caption="Full HIL support">
HIL support --->
[*] HP System Device Controller i8042 Support
[*] HIL MLC Support
[*] HIL Keyboard (full) support
[*] HIL Mouse & Pointer support
</pre>
<p>
Also include display driver support:
</p>
<pre caption="Display Driver support">
Graphics support --->
[*] Support for frame buffer devices
[*] HP STI frame buffer device support
Console display driver support --->
[*] STI text console
</pre>
<p>
When you're done configuring your kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
# <i>make && make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
choice and remember it as you will need it later on when you configure your
bootloader. Remember to replace <path><kernel-version></path> with the
name and version of your kernel.
</p>
<pre caption="Installing the kernel">
# <i>cp vmlinux /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Configuring Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because genkernel
doesn't require any manual kernel configuration, it is an ideal solution for
those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Now, compile your kernel sources by running <c>genkernel all</c>.
Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware, this compilation will take quite a while to finish!
</p>
<p>
Note that, if your boot partition doesn't use ext2 or ext3 as filesystem you
need to manually configure your kernel using <c>genkernel --menuconfig all</c>
and add support for your filesystem <e>in</e> the kernel (i.e. <e>not</e> as a
module).
</p>
<pre caption="Running genkernel">
# <i>genkernel all</i>
<comment>(Output removed to increase readability)</comment>
* Kernel compiled successfully!
* Required Kernel Params:
* : root=/dev/ram0 init=/linuxrc real_root=/dev/$ROOT
* where $ROOT is the devicenode for your root partition as
* you should have specified in /etc/fstab
*
* You MUST tell your bootloader to use the generated initrd
*
* Recommended Kernel Params:
* : vga=0x317 splash=verbose
*
* Do NOT report kernel bugs (configs included) as genkernel bugs.
* Make sure you have the latest genkernel before reporting bugs
*
* For more info see /usr/share/genkernel/README
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD)
before your "real" system starts up.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
Now, let's perform one more step to get our system to be more like the
Installation CD -- let's emerge <c>coldplug</c>. While the initrd autodetects
hardware that is needed to boot your system, <c>coldplug</c> autodetects
everything else. To emerge and enable <c>coldplug</c>, type the following:
</p>
<pre caption="Emerging and enabling coldplug">
# <i>emerge coldplug</i>
# <i>rc-update add coldplug default</i>
</pre>
</body>
</section>
<section id="kernel_modules">
<title>Configuring Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.6</path>.
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> file and enter the module
name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-hppa-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-hppa-medium.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<p>
A list of supported hardware can be found on the
<uri link="http://www.pateam.org/list.html">PA Team website</uri>.
You may find additional information about your box in the <uri
link="http://hwdb.parisc-linux.org">Parisc-Linux Hardware Database</uri>.
</p>
<table>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- Copy/paste from hb-install-x86-medium.xml -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can succesfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
the <path>releases/hppa/2006.0/installcd</path> directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<note>
If you have problems booting the Installation CD or any other media, please
read the <uri
link="http://www.tldp.org/HOWTO/PA-RISC-Linux-Boot-HOWTO/index.html">
PA-RISC Linux Boot HOWTO</uri>.
</note>
<p>
Boot your HPPA system. During the boot process, you will see a message similar
to the following:
</p>
<pre caption="HPPA boot message">
Searching for Potential Boot Devices.
To terminate search, press and hold the ESCAPE key.
</pre>
<p>
When this message appears, press and hold the Esc-key until an option menu
appears. This can take a while, be patient. By default, you should enter the
BOOT_ADMIN console. If you receive an option menu, choose <c>Enter Boot
Administration mode</c> to enter the BOOT_ADMIN console. You should now have an
'>' prompt.
</p>
<p>
Put the Gentoo Installation CD in the CD-ROM. If you do not know the SCSI ID of
your CD-ROM drive, your PA-RISC station will search for it when you issue the
<c>search</c> command.
</p>
<pre caption="Searching for SCSI ID">
> <i>search</i>
Searching for Devices with Bootable Media.
To terminate search, please press and hold the ESCAPE key.
</pre>
<p>
Your PA-RISC station will now display all the available boot media. This is an
example result of this command:
</p>
<pre caption="Available boot media">
Device Selection Device Path Device Type and Utilities
---------------------------------------------------------------------------
P0 scsi.5.0 TOSHIBA CD-ROM XM-3301TA
IPL
P1 scsi.2.0 COMPAQ ST32550N
IPL
P2 lan.0010a7-06d1b6.3.6 server
IPL
</pre>
<p>
To boot from a CD-ROM you need the accompanying Device Path. For instance, if we
want to boot from the TOSHIBA CD-ROM in the above example, we would need to type
the following command:
</p>
<pre caption="Booting from a CD-ROM">
> <i>boot scsi.5.0 ipl</i>
Trying scsi.5.0
</pre>
<p>
The <c>ipl</c> keyword (Initial Program Loader) tells palo (the PA-RISC boot
LOader) to enter interactive mode. This will allow you to change, for example,
the kernel boot parameters.
</p>
<p>
When the boot is successful, palo will start in interactive mode:
</p>
<pre caption="PALO Interactive Mode">
Boot path initialized.
Attempting to load IPL.
HARD Booted.
palo ipl 1.5 root@hope Sat Apr 23 18:06:47 CEST 2005
Boot image contains:
0/vmlinux32 6241293 bytes @ 0x3904000
0/vmlinux64 8352719 bytes @ 0x3ef8000
0/ramdisk 1007589 bytes @ 0x105800
Information: No console specified on kernel command line. This is normal.
PALO will choose the console currently used by firmware (serial).Current command line:
0/vmlinux initrd=initrd TERM=linux root=/dev/ram0 init=/linuxrc cdroot looptype=squashfs loop=/livecd.squashfs hda=scsi console=ttyS0
0: 0/vmlinux
1: initrd=initrd
2: TERM=linux
3: root=/dev/ram0
4: init=/linuxrc
5: cdroot
6: looptype=squashfs
7: loop=/livecd.squashfs
8: hda=scsi
9: console=ttyS0
<#> edit the numbered field
'b' boot with this command line
'r' restore command line
'l' list dir
</pre>
<p>
These parameters are suitable for most situations.
</p>
<p>
If you need extra features you must add the appropriate keyword(s) to the end of
the command line. To add a keyword, edit the last field, add a space and type
your keyword. The only implemented keywords as of now are <c>cdcache</c> which
tells the Installation CD to load itself into RAM, allowing you to unmount the
CD, and <c>noload=module1[,module2[,...]]</c> which allows you to explicitly
disable loading of particular modules.
</p>
<pre caption="Adding hdb=scsi as boot option">
(or 'b' to boot with this command line)? <i>9</i>
console=ttyS0 <i>hdb=scsi</i>
</pre>
<p>
Now that you have tweaked your kernel boot params, boot it.
</p>
<pre caption="Booting the kernel">
(or 'b' to boot with this command line)? <i>b</i>
</pre>
<p>
You should have a root ("#") prompt on the current console and can also switch
to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you
started on by pressing Alt-F1.
</p>
<p>
Now continue with <uri link="#hardware">Extra Hardware
Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
Most hppa machines have an onboard ethernet card. Old ones use the lasi driver
which is compiled in the kernel. Newer ones need the tulip driver which is
compiled as a module. To use the latter, you need to load its driver.
</p>
<p>
In the next example, we try to load the <c>tulip</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe tulip</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-hppa.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-network.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-network.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-network.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-network.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-network.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.0</version>
<date>2005-08-08</date>
<section>
<title>Do you need Networking?</title>
<subsection>
<title>Who can do without?</title>
<body>
<p>
Generally, you don't need a working network connection to install Gentoo using
the Universal Installation CD. However, there are some circumstances where you
do want to have a working Internet connection:
</p>
<ul>
<li>
The stage3 files that are stored in the Universal Installation CD do not
match your architecture and you need to download the correct stage3 file
</li>
<li>
You need to install a specific networking application that will allow you to
connect to the Internet which isn't available on the Universal Installation
CD but is supported by the Installation CD (i.e. you can connect to the
Internet using the Installation CD but the necessary sources are not
available on the Installation CD)
</li>
<li>
You want remote assistance during the installation (using SSH or through
direct conversations using IRC)
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Do I need Networking?</title>
<body>
<p>
To find out if the stage3 file for your architecture is available, take a look
inside <path>/mnt/cdrom/stages</path> and check if one of the available stages
matches your architecture. If not, you can still opt for a stage3 file of an
architecture compatible with yours.
</p>
<p>
If you on the other hand want to use a stage3 file optimized for your
architecture and the stage3 file of your choice is not available, then you will
need networking to download the appropriate stage3 file.
</p>
<p>
So, if you don't need networking, you can skip the rest of this chapter and
continue with <uri link="?part=1&chap=4">Preparing the Disks</uri>.
Otherwise, continue with the networking configuration sections below.
</p>
</body>
</subsection>
</section>
<section>
<title>Automatic Network Detection</title>
<subsection>
<title>Maybe it just works?</title>
<body>
<p>
If your system is plugged into an Ethernet network with a DHCP server, it is
very likely that your networking configuration has already been set up
automatically for you. If so, you should be able to take advantage of the many
included network-aware commands on the Installation CD such as <c>ssh</c>,
<c>scp</c>, <c>ping</c>, <c>irssi</c>, <c>wget</c> and <c>links</c>, among
others.
</p>
<p>
If networking has been configured for you, the <c>/sbin/ifconfig</c> command
should list some network interfaces besides lo, such as eth0:
</p>
<pre caption="/sbin/ifconfig for a working network configuration">
# <i>/sbin/ifconfig</i>
<comment>(...)</comment>
eth0 Link encap:Ethernet HWaddr 00:50:BA:8F:61:7A
inet addr:192.168.0.2 Bcast:192.168.0.255 Mask:255.255.255.0
inet6 addr: fe80::50:ba8f:617a/10 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:1498792 errors:0 dropped:0 overruns:0 frame:0
TX packets:1284980 errors:0 dropped:0 overruns:0 carrier:0
collisions:1984 txqueuelen:100
RX bytes:485691215 (463.1 Mb) TX bytes:123951388 (118.2 Mb)
Interrupt:11 Base address:0xe800
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Configure any Proxies</title>
<body>
<p>
If you access the Internet through a proxy, you might need to set up proxy
information during the installation. It is very easy to define a proxy: you just
need to define a variable which contains the proxy server information.
</p>
<p>
In most cases, you can just define the variables using the server hostname. As
an example, we assume the proxy is called <c>proxy.gentoo.org</c> and the port
is <c>8080</c>.
</p>
<pre caption="Defining proxy servers">
<comment>(If the proxy filters HTTP traffic)</comment>
# <i>export http_proxy="http://proxy.gentoo.org:8080"</i>
<comment>(If the proxy filters FTP traffic)</comment>
# <i>export ftp_proxy="ftp://proxy.gentoo.org:8080"</i>
<comment>(If the proxy filters RSYNC traffic)</comment>
# <i>export RSYNC_PROXY="proxy.gentoo.org:8080"</i>
</pre>
<p>
If your proxy requires a username and password, you should use the following
syntax for the variable:
</p>
<pre caption="Adding username/password to the proxy variable">
http://<i>username</i>:<i>password</i>@proxy.gentoo.org:8080
</pre>
</body>
</subsection>
<subsection>
<title>Testing the Network</title>
<body>
<p>
You may want to try pinging your ISP's DNS server (found in
<path>/etc/resolv.conf</path>) and a Web site of your choice, just to make sure
that your packets are reaching the net, DNS name resolution is working
correctly, etc.
</p>
<pre caption="Further network testing">
# <i>ping -c 3 www.yahoo.com</i>
</pre>
<p>
If you are now able to use your network, you can skip the rest of this
section and continue with <uri link="?part=1&chap=4">Preparing the
Disks</uri>. If not, read on.
</p>
</body>
</subsection>
</section>
<section>
<title>Automatic Network Configuration</title>
<subsection>
<body>
<p>
If the network doesn't work immediately, some installation media allow you to
use <c>net-setup</c> (for regular or wireless networks), <c>adsl-setup</c>
(for ADSL-users) or <c>pptp</c> (for PPTP-users - only available on x86).
</p>
<p>
If your installation medium does not contain any of these tools or your network
doesn't function yet, continue with <uri link="#doc_chap3">Manual Network
Configuration</uri>.
</p>
<ul>
<li>
Regular Ethernet users should continue with <uri
link="#net-setup">Default: Using net-setup</uri>
</li>
<li>
ADSL users should continue with <uri link="#rp-pppoe">Alternative:
Using RP-PPPoE</uri>
</li>
<li>
PPTP users should continue with <uri link="#pptp">Alternative:
Using PPTP</uri>
</li>
</ul>
</body>
</subsection>
<subsection id="net-setup">
<title>Default: Using net-setup</title>
<body>
<p>
The simplest way to set up networking if it didn't get configured
automatically is to run the <c>net-setup</c> script:
</p>
<pre caption="Running the net-setup script">
# <i>net-setup eth0</i>
</pre>
<p>
<c>net-setup</c> will ask you some questions about your network
environment. When all is done, you should have a working network
connection. Test your network connection as stated before. If the tests
are positive, congratulations! You are now ready to install Gentoo. Skip
the rest of this section and continue with <uri
link="?part=1&chap=4">Preparing the Disks</uri>.
</p>
<p>
If your network still doesn't work, continue with <uri link="#doc_chap3">Manual
Network Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="rp-pppoe">
<title>Alternative: Using RP-PPPoE</title>
<body>
<p>
Assuming you need PPPoE to connect to the internet, the Installation CD (any
version) has made things easy for you by including <c>rp-pppoe</c>. Use the
provided <c>adsl-setup</c> script to configure your connection. You will be
prompted for the ethernet device that is connected to your adsl modem, your
username and password, the IPs of your DNS servers and if you need a basic
firewall or not.
</p>
<pre caption="Using rp-pppoe">
# <i>adsl-setup</i>
# <i>adsl-start</i>
</pre>
<p>
If something goes wrong, double-check that you correctly typed your username and
password by looking at <path>/etc/ppp/pap-secrets</path> or
<path>/etc/ppp/chap-secrets</path> and make sure you are using the right
ethernet device. If your ethernet device doesn't exist, you will have to load
the appropriate network modules. In that case you should continue with
<uri link="#doc_chap3">Manual Network Configuration</uri> as we explain how to
load the appropriate network modules there.
</p>
<p>
If everything worked, continue with <uri link="?part=1&chap=4">Preparing the
Disks</uri>.
</p>
</body>
</subsection>
<subsection id="pptp">
<title>Alternative: Using PPTP</title>
<body>
<note>
PPTP support is only available for x86
</note>
<p>
If you need PPTP support, you can use <c>pptpclient</c> which is provided by our
Installation CDs. But first you need to make sure that your configuration is
correct. Edit <path>/etc/ppp/pap-secrets</path> or
<path>/etc/ppp/chap-secrets</path> so it contains the correct username/password
combination:
</p>
<pre caption="Editing /etc/ppp/chap-secrets">
# <i>nano -w /etc/ppp/chap-secrets</i>
</pre>
<p>
Then adjust <path>/etc/ppp/options.pptp</path> if necessary:
</p>
<pre caption="Editing /etc/ppp/options.pptp">
# <i>nano -w /etc/ppp/options.pptp</i>
</pre>
<p>
When all that is done, just run <c>pptp</c> (along with the options you couldn't
set in <path>options.pptp</path>) to connect the server:
</p>
<pre caption="Connection to a dial-in server">
# <i>pptp <server ip></i>
</pre>
<p>
Now continue with <uri link="?part=1&chap=4">Preparing the Disks</uri>.
</p>
</body>
</subsection>
</section>
<section>
<title>Manual Network Configuration</title>
<subsection>
<title>Loading the Appropriate Network Modules</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules (drivers) to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases,
it may not auto-load the kernel modules you need.
</p>
<p>
If <c>net-setup</c> or <c>adsl-setup</c> failed, then it is possible that
your network card wasn't found immediately. This means you may have to load
the appropriate kernel modules manually.
</p>
<p>
To find out what kernel modules we provide for networking, use
<c>ls</c>:
</p>
<pre caption="Searching for provided modules">
# <i>ls /lib/modules/`uname -r`/kernel/drivers/net</i>
</pre>
<p>
If you find a driver for your network card, use <c>modprobe</c> to load
the kernel module:
</p>
<pre caption="Using modprobe to load a kernel module">
<comment>(As an example, we load the pcnet32 module)</comment>
# <i>modprobe pcnet32</i>
</pre>
<p>
To check if your network card is now detected, use <c>ifconfig</c>. A
detected network card would result in something like this:
</p>
<pre caption="Testing availability of your network card, successful">
# <i>ifconfig eth0</i>
eth0 Link encap:Ethernet HWaddr FE:FD:00:00:00:00
BROADCAST NOARP MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)
</pre>
<p>
If however you receive the following error, the network card is not
detected:
</p>
<pre caption="Testing availability of your network card, failed">
# <i>ifconfig eth0</i>
eth0: error fetching interface information: Device not found
</pre>
<p>
If you have multiple network cards in your system they are named <e>eth0</e>,
<e>eth1</e>, etc. Make sure that the network card you want to use works well and
remember to use the correct naming throughout this document. We will assume that
the network card <e>eth0</e> is used.
</p>
<p>
Assuming that you now have a detected network card, you can
retry <c>net-setup</c> or <c>adsl-setup</c> again (which should work
now), but for the hardcore people amongst you we explain how to configure your
network manually.
</p>
<p>
Select one of the following sections based on your network setup:
</p>
<ul>
<li><uri link="#dhcp">Using DHCP</uri> for automatic IP retrieval</li>
<li>
<uri link="#wireless">Preparing for Wireless Access</uri> if you have a
wireless card
</li>
<li>
<uri link="#network_term">Understanding Network Terminology</uri> explains
what you need to know about networking
</li>
<li>
<uri link="#ifconfig_route">Using ifconfig and route</uri> explains how to
set up your networking manually
</li>
</ul>
</body>
</subsection>
<subsection id="dhcp">
<title>Using DHCP</title>
<body>
<p>
DHCP (Dynamic Host Configuration Protocol) makes it possible to
automatically receive networking information (IP address, netmask,
broadcast address, gateway, nameservers etc.). This only works if you
have a DHCP server in your network (or if your provider provides a DHCP
service). To have a network interface receive this information automatically,
use <c>dhcpcd</c>:
</p>
<pre caption="Using dhcpcd">
# <i>dhcpcd eth0</i>
<comment>Some network admins require that you use the</comment>
<comment>hostname and domainname provided by the DHCP server.</comment>
<comment>In that case, use</comment>
# <i>dhcpcd -HD eth0</i>
</pre>
<p>
If this works (try pinging some internet server, like <uri
link="http://www.google.com">Google</uri>), then you are all set and
ready to continue. Skip the rest of this section and continue with <uri
link="?part=1&chap=4">Preparing the Disks</uri>.
</p>
</body>
</subsection>
<subsection id="wireless">
<title>Preparing for Wireless Access</title>
<body>
<note>
Support for the <c>iwconfig</c> command is only available on x86, amd64 and ppc
Installation CDs. You can still get the extensions working otherwise
by following the instructions of the
<uri link="ftp://ftp.linux-wlan.org/pub/linux-wlan-ng/README">linux-wlan-ng
project</uri>.
</note>
<p>
If you are using a wireless (802.11) card, you may need to configure your
wireless settings before going any further. To see the current wireless settings
on your card, you can use <c>iwconfig</c>. Running <c>iwconfig</c> might show
something like:
</p>
<pre caption="Showing the current wireless settings">
# <i>iwconfig eth0</i>
eth0 IEEE 802.11-DS ESSID:"GentooNode"
Mode:Managed Frequency:2.442GHz Access Point: 00:09:5B:11:CC:F2
Bit Rate:11Mb/s Tx-Power=20 dBm Sensitivity=0/65535
Retry limit:16 RTS thr:off Fragment thr:off
Power Management:off
Link Quality:25/10 Signal level:-51 dBm Noise level:-102 dBm
Rx invalid nwid:5901 Rx invalid crypt:0 Rx invalid frag:0 Tx
excessive retries:237 Invalid misc:350282 Missed beacon:84
</pre>
<note>
Some wireless cards may have a device name of <c>wlan0</c> or <c>ra0</c> instead
of <c>eth0</c>. Run <c>iwconfig</c> without any command-line parameters to
determine the correct device name.
</note>
<p>
For most users, there are only two settings that might be important to change,
the ESSID (aka wireless network name) or the WEP key. If the ESSID and Access
Point address listed are already that of your access point and you are not using
WEP, then your wireless is working. If you need to change your ESSID, or add a
WEP key, you can issue the following commands:
</p>
<pre caption="Changing ESSID and/or adding WEP key">
<comment>(This sets the network name to "GentooNode")</comment>
# <i>iwconfig eth0 essid GentooNode</i>
<comment>(This sets a hex WEP key)</comment>
# <i>iwconfig eth0 key 1234123412341234abcd</i>
<comment>(This sets an ASCII key - prefix it with "s:")</comment>
# <i>iwconfig eth0 key s:some-password</i>
</pre>
<p>
You can then confirm your wireless settings again by using <c>iwconfig</c>.
Once you have wireless working, you can continue configuring the IP level
networking options as described in the next section (<uri
link="#network_term">Understanding Network Terminology</uri>) or use the
<c>net-setup</c> tool as described previously.
</p>
</body>
</subsection>
<subsection id="network_term">
<title>Understanding Network Terminology</title>
<body>
<note>
If you know your IP address, broadcast address, netmask and nameservers,
then you can skip this subsection and continue with <uri
link="#ifconfig_route">Using ifconfig and route</uri>.
</note>
<p>
If all of the above fails, you will have to configure your network manually.
This is not difficult at all. However, you need to be familiar with some
network terminology, as you will need it to be able to
configure your network to your satisfaction. After reading this, you
will know what a <e>gateway</e> is, what a <e>netmask</e> serves for,
how a <e>broadcast</e> address is formed and why you need
<e>nameservers</e>.
</p>
<p>
In a network, hosts are identified by their <e>IP address</e> (Internet
Protocol address). Such an address is a combination of four numbers
between 0 and 255. Well, at least that is how we perceive it. In
reality, such an IP address consists of 32 bits (ones and zeros). Let's
view an example:
</p>
<pre caption="Example of an IP address">
IP Address (numbers): 192.168.0.2
IP Address (bits): 11000000 10101000 00000000 00000010
-------- -------- -------- --------
192 168 0 2
</pre>
<p>
Such an IP address is unique to a host as far as all accessible networks are
concerned (i.e. every host that you are able to reach must have a unique IP
address). In order to distinguish between hosts inside and outside a
network, the IP address is divided in two parts: the
<e>network</e> part and the <e>host</e> part.
</p>
<p>
The separation is written down with the <e>netmask</e>, a collection of
ones followed by a collection of zeros. The part of the IP that can be
mapped on the ones is the network-part, the other one is the host-part.
As usual, the netmask can be written down as an IP-address.
</p>
<pre caption="Example of network/host separation">
IP-address: 192 168 0 2
11000000 10101000 00000000 00000010
Netmask: 11111111 11111111 11111111 00000000
255 255 255 0
+--------------------------+--------+
Network Host
</pre>
<p>
In other words, 192.168.0.14 is still part of our example network, but
192.168.1.2 is not.
</p>
<p>
The <e>broadcast</e> address is an IP-address with the same network-part
as your network, but with only ones as host-part. Every host on your
network listens to this IP address. It is truly meant for broadcasting
packets.
</p>
<pre caption="Broadcast address">
IP-address: 192 168 0 2
11000000 10101000 00000000 00000010
Broadcast: 11000000 10101000 00000000 11111111
192 168 0 255
+--------------------------+--------+
Network Host
</pre>
<p>
To be able to surf on the internet, you must know which host shares the
Internet connection. This host is called the <e>gateway</e>. Since it is
a regular host, it has a regular IP address (for instance 192.168.0.1).
</p>
<p>
We previously stated that every host has its own IP address. To be able
to reach this host by a name (instead of an IP address) you need a
service that translates a name (such as <e>dev.gentoo.org</e>) to an IP
address (such as <e>64.5.62.82</e>). Such a service is called a name
service. To use such a service, you must define the necessary <e>name
servers</e> in <path>/etc/resolv.conf</path>.
</p>
<p>
In some cases, your gateway also serves as nameserver. Otherwise you
will have to enter the nameservers provided by your ISP.
</p>
<p>
To summarise, you will need the following information before continuing:
</p>
<table>
<tr>
<th>Network Item</th>
<th>Example</th>
</tr>
<tr>
<ti>Your IP address</ti>
<ti>192.168.0.2</ti>
</tr>
<tr>
<ti>Netmask</ti>
<ti>255.255.255.0</ti>
</tr>
<tr>
<ti>Broadcast</ti>
<ti>192.168.0.255</ti>
</tr>
<tr>
<ti>Gateway</ti>
<ti>192.168.0.1</ti>
</tr>
<tr>
<ti>Nameserver(s)</ti>
<ti>195.130.130.5, 195.130.130.133</ti>
</tr>
</table>
</body>
</subsection>
<subsection id="ifconfig_route">
<title>Using ifconfig and route</title>
<body>
<p>
Setting up your network consists of three steps. First we assign
ourselves an IP address using <c>ifconfig</c>. Then we set up routing to
the gateway using <c>route</c>. Then we finish up by placing the
nameserver IPs in <path>/etc/resolv.conf</path>.
</p>
<p>
To assign an IP address, you will need your IP address, broadcast
address and netmask. Then execute the following command, substituting
<c>${IP_ADDR}</c> with your IP address, <c>${BROADCAST}</c> with your
broadcast address and <c>${NETMASK}</c> with your netmask:
</p>
<pre caption="Using ifconfig">
# <i>ifconfig eth0 ${IP_ADDR} broadcast ${BROADCAST} netmask ${NETMASK} up</i>
</pre>
<p>
Now set up routing using <c>route</c>. Substitute <c>${GATEWAY}</c> with
your gateway IP address:
</p>
<pre caption="Using route">
# <i>route add default gw ${GATEWAY}</i>
</pre>
<p>
Now open <path>/etc/resolv.conf</path> with your favorite editor (in our
example, we use <c>nano</c>):
</p>
<pre caption="Creating /etc/resolv.conf">
# <i>nano -w /etc/resolv.conf</i>
</pre>
<p>
Now fill in your nameserver(s) using the following as a template. Make
sure you substitute <c>${NAMESERVER1}</c> and <c>${NAMESERVER2}</c> with
the appropriate nameserver addresses:
</p>
<pre caption="/etc/resolv.conf template">
nameserver ${NAMESERVER1}
nameserver ${NAMESERVER2}
</pre>
<p>
That's it. Now test your network by pinging some Internet server (like
<uri link="http://www.google.com">Google</uri>). If this works,
congratulations then. You are now ready to install Gentoo. Continue with <uri
link="?part=1&chap=4">Preparing the Disks</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-next.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-next.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-next.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-next.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-next.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-22</date>
<section>
<title>Documentation</title>
<subsection>
<body>
<p>
Congratulations! You now have a working Gentoo system. But where to go from
here? What are your options now? What to explore first? Gentoo provides its
users with lots of possibilities, and therefore lots of documented (and less
documented) features.
</p>
<p>
You should definitely take a look at the next part of the Gentoo Handbook
entitled <uri link="?part=2">Working with Gentoo</uri> which explains
how to keep your software up to date, how to install more software, what USE
flags are, how the Gentoo Init system works, etc.
</p>
<p>
If you are interested in optimizing your system for desktop use, or you want to
learn how to configure your system to be a full working desktop system, consult
our extensive <uri link="/doc/en/index.xml?catid=desktop">Gentoo Desktop
Documentation Resources</uri>. Besides, you might want to use our <uri
link="/doc/en/guide-localization.xml">localization guide</uri> to make your
system feel more at home.
</p>
<p>
We also have a <uri link="/doc/en/security/">Gentoo Security Handbook</uri>
which is worth reading.
</p>
<p>
For a full listing of all our available documentation check out our <uri
link="/doc/en/index.xml">Documentation Resources</uri> page.
</p>
</body>
</subsection>
</section>
<section>
<title>Gentoo Online</title>
<body>
<p>
You are of course always welcome on our <uri
link="http://forums.gentoo.org">Gentoo Forums</uri> or on one of our many
<uri link="/main/en/irc.xml">Gentoo IRC channels</uri>.
</p>
<p>
We also have several <uri
link="/main/en/lists.xml">mailinglists</uri> open to all
our users. Information on how to join is contained in that page.
</p>
<p>
We'll shut up now and let you enjoy your installation :)
</p>
</body>
</section>
<section>
<title>Gentoo Changes since 2006.0</title>
<subsection>
<title>Changes?</title>
<body>
<p>
Gentoo is a fast-moving target. The following sections describe important
changes that affect a Gentoo installation. We only list those that have anything
in common with the installation, not with package changes that did not occur
during the installation.
</p>
<p>
There have been no significant changes since.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2006-01-19</date>
<section>
<title>Choosing a Bootloader</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that the kernel is configured and compiled, you'll need a <e>bootloader</e>
to start your new linux installation. The <e>bootloader</e> that you use will
depend upon the type of PPC machine you have.
</p>
<p>
If you are using a NewWorld Apple or IBM machine, you need to use
<uri link="#yaboot">yaboot</uri>. OldWorld Apple machines have two options,
<uri link="#bootx">BootX</uri> (recommended) and <uri link="#quik">quik</uri>.
The Pegasos does not require a bootloader, but you will need to emerge
<uri link="#bootcreator">BootCreator</uri> to create SmartFirmware bootmenus.
</p>
</body>
</subsection>
</section>
<section id="yaboot">
<title>Default: Using yaboot</title>
<subsection>
<title>Introduction</title>
<body>
<impo>
yaboot can only be used on NewWorld Apple and IBM systems!
</impo>
<p>
In order to find the boot devices, yaboot needs access to the <path>/dev</path>
filesystem. To do this, you will need to "bind-map" the <path>/dev</path>
filesystem from the Installation CD to <path>/dev</path> inside of the chroot.
</p>
<pre caption="Bind-mounting the /dev-filesystem">
# <i>exit </i> # this will exit the chroot
# <i>mount -o bind /dev /mnt/gentoo/dev</i>
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>/usr/sbin/env-update && source /etc/profile </i>
</pre>
<p>
To set up yaboot, you can use <c>yabootconfig</c> to automatically create a
configuration file for you. If you are installing Gentoo on a G5 (where
<c>yabootconfig</c> does not always work), or you plan to boot from firewire
or USB, you will need to manually configure yaboot.
</p>
<note>
You will need to manually edit the yaboot.conf when using genkernel, even if
yabootconfig is used. The kernel image section of yaboot.conf should be
modified as follows:
</note>
<pre caption="Adding genkernel boot arguments to yaboot.conf">
<comment>###########################################################
## This section can be duplicated if you have more than one
## kernel or set of boot options - replace kernel-2.6.12
## with the exact filename of your kernel.
###########################################################</comment>
image=/boot/kernel-2.6.12
label=Linux
root=/dev/ram0 <comment># If using genkernel this is /dev/ram0</comment>
partition=3
append="real_root=/dev/hda3 init=/linuxrc"
<comment># You can add additional kernel arguments to append such as
# rootdelay=10 for a USB/Firewire Boot</comment>
read-only
<comment>##########################################################</comment>
</pre>
<ul>
<li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li>
<li>
<uri link="#manual_yaboot">Alternative: Manual yaboot Configuration</uri>
</li>
</ul>
</body>
</subsection>
<subsection id="yabootconfig">
<title>Default: Using yabootconfig</title>
<body>
<p>
<c>yabootconfig</c> will auto-detect the partitions on your machine and will
set up dual and triple boot combinations with Linux, Mac OS, and Mac OS X.
</p>
<p>
To use <c>yabootconfig</c>, your drive must have an Apple_Bootstrap partition,
and <path>/etc/fstab</path> must be configured with your Linux partitions. Both
of these should have been done already in the steps above. To start, ensure that
you have the latest <c>yaboot</c> installed.
</p>
<pre caption = "Installing yaboot with GRP">
# <i>emerge --usepkg --update yaboot</i>
</pre>
<p>
Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. The
program will run and it will confirm the location of the bootstrap partition.
Type <c>Y</c> if it is correct. If not, double check <path>/etc/fstab</path>.
yabootconfig will then scan your system setup, create
<path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for you. <c>mkofboot</c>
is used to format the Apple_Bootstrap partition, and install the yaboot
configuration file into it. After this enter the chroot again.
</p>
<pre caption="enter chroot">
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>/usr/sbin/env-update && source /etc/profile</i>
</pre>
<p>
You might want to verify the contents of <path>/etc/yaboot.conf</path>. If you
make changes to <path>/etc/yaboot.conf</path> (like setting the default/boot
OS), make sure to rerun <c>ybin -v</c> to apply changes to the Apple_Bootstrap
partition.
</p>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
<subsection id="manual_yaboot">
<title>Alternative: Manual yaboot Configuration</title>
<body>
<p>
First make sure you have the latest <c>yaboot</c> installed on your
system:
</p>
<pre caption = "Installing yaboot">
# <i>emerge --usepkg --update yaboot</i>
</pre>
<p>
An example <path>yaboot.conf</path> file is given below, but you will need to
alter it to fit your needs. G5 users and users booting from firewire and USB
should be aware that their disks are seen as SCSI disks by the Linux kernel, so
you will need to substitute <path>/dev/hda</path> with <path>/dev/sda</path>).
</p>
<pre caption = "/etc/yaboot.conf">
<comment>## /etc/yaboot.conf
##
## run: "man yaboot.conf" for details. Do not make changes until you have!!
## see also: /usr/share/doc/yaboot/examples for example configurations.
##
## For a dual-boot menu, add one or more of:
## bsd=/dev/hdaX, macos=/dev/hdaY, macosx=/dev/hdaZ
## our bootstrap partition:</comment>
boot=/dev/hda2
<comment>## ofboot is the openfirmware way to specify the bootstrap partition.
## If this isn't defined, yaboot fails on the G5 and some G4s (unless
## you pass the necessary arguments to the mkofboot/ybin program).
## hd:X means /dev/sdaX (or /dev/hdaX).
##
## G5 users should uncomment this line!!
#ofboot=hd:2
## Users booting from firewire should use something like this line:
# ofboot=fw/node/sbp-2/disk@0:
## Users booting from USB should use something like this line:
# ofboot=usb/disk@0:
## hd: is shorthand for the first hard drive OpenFirmware sees</comment>
device=hd:
<comment>## Firewire and USB users will need to specify the whole OF device name
## This can be found using ofpath, which is included with yaboot.
# device=fw/node@0001d200e00d0207/sbp-2@c000/disk@0:
</comment>
delay=5
defaultos=macosx
timeout=30
install=/usr/lib/yaboot/yaboot
magicboot=/usr/lib/yaboot/ofboot
<comment>#################
## This section can be duplicated if you have more than one kernel or set of
## boot options - replace 2.6.9 with your kernel-version
#################</comment>
image=/boot/kernel-2.6.9
label=Linux
root=/dev/hda3
partition=3
<comment># append="rootdelay=10" # Required for booting USB/Firewire</comment>
read-only
<comment>##################
## G5 users and some G4 users should set
## macos=hd:13
## macosx=hd:12
## instead of the example values.</comment>
macos=/dev/hda13
macosx=/dev/hda12
enablecdboot
enableofboot
</pre>
<p>
Once <path>yaboot.conf</path> is configured, run <c>mkofboot -v</c> to format
the Apple_bootstrap partition and install the settings. If you change
yaboot.conf after the Apple_bootstrap partition has been created, you can
update the settings by running <c>ybin -v</c>
</p>
<p>
For more information on yaboot, take a look at the <uri
link="http://penguinppc.org/bootloaders/yaboot">yaboot project</uri>. For
now, continue the installation with <uri link="#reboot">Rebooting the
System</uri>.
</p>
</body>
</subsection>
</section>
<section id="bootx">
<title>Alternative: BootX</title>
<body>
<impo>
BootX can only be used on OldWorld Apple systems!
</impo>
<p>
Since BootX boots Linux from within MacOS, the kernel will need to be copied
from the Linux Partition to the MacOS partition. First, mount the MacOS
partition from outside of the chroot. Use <c>mac-fdisk -l</c> to find the
MacOS partition number, sda6 is used as an example here. Once the partition is
mounted, we'll copy the kernel to the system folder so BootX can find it.
</p>
<pre caption="Copying the kernel to the MacOS partition">
# <i>exit</i>
cdimage ~# <i>mkdir /mnt/mac</i>
cdimage ~# <i>mount /dev/sda6 /mnt/mac -t hfs</i>
cdimage ~# <i>cp /mnt/gentoo/usr/src/linux/vmlinux "/mnt/mac/System Folder/Linux Kernels"</i>
</pre>
<p>
If genkernel is used, both the kernel and initrd will need to be copied to the
MacOS partition.
</p>
<pre caption="Copying the Genkernel kernel and initrd to the MacOS partition">
# <i>exit</i>
cdimage ~# <i>mkdir /mnt/mac</i>
cdimage ~# <i>mount /dev/sda6 /mnt/mac -t hfs</i>
cdimage ~# <i>cp /mnt/gentoo/boot/kernel-* "/mnt/mac/System Folder/Linux Kernels"</i>
cdimage ~# <i>cp /mnt/gentoo/boot/initramfs-* "/mnt/mac/System Folder"</i>
</pre>
<p>
Now that the kernel is copied over, we'll need to reboot to set up BootX.
</p>
<pre caption="Unmounting all partitions and rebooting">
cdimage ~# <i>cd /</i>
cdimage ~# <i>umount /mnt/gentoo/proc /mnt/gentoo/dev /mnt/gentoo /mnt/mac</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of MacOS.
</p>
<p>
Once the machine has booted into MacOS, open the BootX control panel. If you're
not using genkernel, select <c>Options</c> and uncheck <c>Use specified RAM
disk</c>. If you are using genkernel, ensure that the genkernel initrd is
selected instead of the Installation CD initrd. If not using genkernel,
there is now an option to specify the machine's Linux root disk and partition.
Fill these in with the appropriate values. Depending upon the kernel
configuration, additional boot arguments may need to be applied.
</p>
<p>
BootX can be configured to start Linux upon boot. If you do this, you will first
see your machine boot into MacOS then, during startup, BootX will load and start
Linux. See the <uri link="http://penguinppc.org/bootloaders/bootx/">BootX home
page</uri> for more information.
</p>
<p>
Now reboot again and boot into Linux, then continue with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</section>
<section id="quik">
<title>Alternative: quik</title>
<body>
<p>
quik allows OldWorld Macs to boot without MacOS. However, it isn't well
supported and has a number of quirks. If you have the option, it is recommended
that you use BootX instead since it is much more reliable and easier to set up
than quik.
</p>
<p>
First, we'll need to install quik:
</p>
<pre caption="Emerge quik">
# <i>emerge quik</i>
</pre>
<p>
Next, we'll need to set it up. Edit /etc/quik.conf and set your image to the
kernel that we copied to your boot partition.
</p>
<pre caption="Configuring quik.conf">
# Example of quik.conf
init-message = "Gentoo 2006.0\n"
partition = 2 <comment># This is the boot partition</comment>
root = /dev/hda4
timeout = 30
default = gentoo
image = /vmlinux-2.6.12
label = gentoo
</pre>
<p>
Your quik.conf file <e>must</e> be on the same disk as the quik boot images,
however it can be on a different partition on the same disk, although it is
recommended to move it to your boot partition.
</p>
<pre caption="Moving quik.conf to /boot">
# <i>mv /etc/quik.conf /boot/quik.conf</i>
</pre>
<p>
We will now set your boot variables so that quik loads on boot. To do this,
we'll use a program called <c>nvsetenv</c>. The variables that you want to
set vary from machine to machine, it's best to find your machine's
<uri link="http://penguinppc.org/bootloaders/quik/quirks.php">quirks</uri>
before attempting this.
</p>
<pre caption="Setting the boot variables">
# <i>nvsetenv auto-boot true</i> <comment># Set to false if you want to boot into OF, not all models can display the OF output</comment>
# <i>nvsetenv output-device video</i> <comment># Check the quirks page, there are many variations here</comment>
# <i>nvsetenv input-device kbd</i>
# <i>nvsetenv boot-device scsi/sd@1:0</i> <comment># For SCSI</comment>
# <i>nvsetenv boot-device ata/ata-disk@0:0</i> <comment># For ATA</comment>
# <i>nvsetenv boot-file /boot/vmlinux-2.6.12 root=/dev/hda4</i> <comment>First item is the path to the kernel, the second is the root partition. You may append any kernel options to the end of this line.</comment>
# <i>nvsetenv boot-command boot</i> <comment># Set this to bye for MacOS and boot for Linux</comment>
</pre>
<note>
It is also possible to change your boot variables from MacOS. Depending
upon the model, either
<uri link="http://penguinppc.org/bootloaders/quik/BootVars.sit.hqx">bootvars</uri> or
<uri link="ftp://ftp.apple.com/developer/macosxserver/utilities/SystemDisk2.3.1.smi.bin">
Apple System Disk</uri> should be used. Please see the quik quirks page
above for more information.
</note>
<p>
Now that we've set up our machine to boot, we'll need to make sure the boot
images are installed correctly. Run <c>quik -v -C /boot/quik.conf</c>. It
should tell you that it has installed the first stage QUIK boot block.
</p>
<note>
If something has gone wrong, you can always reset your PRAM back to the default
values by holding down <c>command + option + p + r</c> before powering on your
machine. This will clear the values you set with nvsetenv and should allow you
to boot either a MacOS bootdisk or a Linux bootdisk.
</note>
<p>
Now, continue the installation with
<uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="bootcreator">
<title>Alternative: BootCreator</title>
<body>
<impo>
BootCreator will build a nice SmartFirmware bootmenu written in Forth for the
Pegasos.
</impo>
<p>
First make sure you have the latest <c>bootcreator</c> installed on your
system:
</p>
<pre caption = "Installing bootcreator">
# <i>emerge --usepkg --update bootcreator</i>
</pre>
<p>
Now copy the file <path>/etc/bootmenu.example</path> into
<path>/etc/bootmenu</path> and edit it to your needs:
</p>
<pre caption = "Edit the bootcreator config file">
# <i>cp /etc/bootmenu.example /etc/bootmenu</i>
# <i>nano -w /etc/bootmenu</i>
</pre>
<p>
Below you find a completed <path>/etc/bootmenu</path> config file. Alter it at
will.
</p>
<pre caption = "bootcreator config file">
<comment>#
# Example description file for bootcreator 1.1
#</comment>
[VERSION]
1
[TITLE]
Boot Menu
[SETTINGS]
AbortOnKey = false
Timeout = 9
Default = 1
[SECTION]
Local HD -> Morphos (Normal)
ide:0 boot2.img ramdebug edebugflags="logkprintf"
[SECTION]
Local HD -> Linux 2.6.12 (Normal)
ide:0 linux-2.6.12 video=radeonfb:1024x768@70 root=/dev/hda3
[SECTION]
Local HD -> Genkernel (Normal)
ide:0 kernelz-2.6.12 root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc
</pre>
<p>
Finally the <path>bootmenu</path> must be transfered into Forth and copied to
your boot partition, so that the SmartFirmware can read it. Therefore you have
to call <c>bootcreator</c>:
</p>
<pre caption = "Install the bootmenu">
# <i>bootcreator /etc/bootmenu /boot/menu</i>
</pre>
<note>
Be sure to have a look into the SmartFirmware's settings when you reboot, that
<path>menu</path> is the file that will be loaded by default.
</note>
<p>
For now, continue the installation with <uri link="#reboot">Rebooting the
System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
livecd ~# <i>umount /mnt/gentoo/proc /mnt/gentoo/dev /mnt/gentoo</i>
livecd ~# <i>reboot</i>
</pre>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-ppc-disk.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-25</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI or SATA drives, then your first
hard drive would be <path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On most systems,
these are called <e>partitions</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition NewWorld</th>
<th>Partition OldWorld</th>
<th>Partition Pegasos</th>
<th>Partition RS/6000</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti><path>/dev/hda1</path></ti>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti>(Partition Map)</ti>
<ti>32k</ti>
<ti>Apple_partition_map</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>(Not needed)</ti>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti>(bootstrap)</ti>
<ti>800k</ti>
<ti>Apple_Bootstrap</ti>
</tr>
<tr>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti><path>/dev/sda1</path></ti>
<ti>(PReP Boot)</ti>
<ti>800k</ti>
<ti>Type 0x41</ti>
</tr>
<tr>
<ti>(Not applicable)</ti>
<ti><path>/dev/hda2</path> (If using quik)</ti>
<ti><path>/dev/hda1</path></ti>
<ti>(Not needed)</ti>
<ti>ext2</ti>
<ti>32MB</ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti><path>/dev/hda2</path> (<path>/dev/hda3</path> if using quik)</ti>
<ti><path>/dev/hda2</path></ti>
<ti><path>/dev/sda2</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition, Type 0x82</ti>
</tr>
<tr>
<ti><path>/dev/hda4</path></ti>
<ti><path>/dev/hda3</path> (<path>/dev/hda4</path> if using quik)</ti>
<ti><path>/dev/hda3</path></ti>
<ti><path>/dev/sda3</path></ti>
<ti>ext3, xfs</ti>
<ti>Rest of the disk</ti>
<ti>Root partition, Type 0x83</ti>
</tr>
</table>
<note>
There are some partitions named: <path>Apple_Driver63, Apple_Driver_ATA,
Apple_FWDriver, Apple_Driver_IOKit, Apple_Patches</path>. If you are not
planning to use MacOS 9 you can delete them, because MacOS X and Linux don't
need them. To delete them, either use parted or erase the whole disk by
initialing the partition map.
</note>
<warn>
<c>parted</c> is able to resize partitions. On the Installation CD there
are patches included to resize HFS+ filesystem. Unfortunately it is not
possible to resize HFS+ journaled filesystems, even if the journaling has been
switchedoff in Mac OS X. Everything you do with resizing in parted you do it
on your own risk! Be sure to have a backup of your data!
</warn>
<p>
If you are interested in knowing how big a partition should be, or even how many
partitions you need, read on. Otherwise continue now with
<uri link="#mac-fdisk"> Default: Using mac-fdisk (Apple) to Partition your Disk
</uri> or <uri link="#parted">Alternative: Using parted (IBM/Pegasos) to
Partition your Disk</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your <path>/var</path>
should be separate as all mails are stored inside <path>/var</path>. A good
choice of filesystem will then maximise your performance. Gameservers will have
a separate <path>/opt</path> as most gaming servers are installed there. The
reason is similar for <path>/home</path>: security and backups. You will
definitely want to keep <path>/usr</path> big: not only will it contain the
majority of applications, the Portage tree alone takes around 500 Mbyte
excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots of free space on one
partition and none on another. There is also a 15-partition limit for SCSI and
SATA.
</p>
</body>
</subsection>
</section>
<section id="mac-fdisk">
<title>Default: Using mac-fdisk (Apple) Partition your Disk</title>
<body>
<p>
At this point, create your partitions using <c>mac-fdisk</c>:
</p>
<pre caption="Starting mac-fdisk">
# <i>mac-fdisk /dev/hda</i>
</pre>
<p>
First delete the partitions you have cleared previously to make room for your
Linux partitions. Use <c>d</c> in <c>mac-fdisk</c> to delete those partition(s).
It will ask for the partition number to delete. Usually the first partition on
NewWorld machines (Apple_partition_map) could not be deleted.
</p>
<p>
Second, create an <e>Apple_Bootstrap</e> partition by using <c>b</c>. It will
ask for what block you want to start. Enter the number of your first free
partition, followed by a <c>p</c>. For instance this is <c>2p</c>.
</p>
<note>
This partition is <e>not</e> a <path>/boot</path> partition. It is not used by
Linux at all; you don't have to place any filesystem on it and you should never
mount it. Apple users don't need an extra partition for <path>/boot</path>.
</note>
<p>
Now create a swap partition by pressing <c>c</c>. Again <c>mac-fdisk</c> will
ask for what block you want to start this partition from. As we used <c>2</c>
before to create the Apple_Bootstrap partition, you now have to enter
<c>3p</c>. When you're asked for the size, enter <c>512M</c> (or whatever size
you want -- 512MB is recommended though). When asked for a name, enter <c>swap</c>
(mandatory).
</p>
<p>
To create the root partition, enter <c>c</c>, followed by <c>4p</c> to select
from what block the root partition should start. When asked for the size, enter
<c>4p</c> again. <c>mac-fdisk</c> will interpret this as "Use all available
space". When asked for the name, enter <c>root</c> (mandatory).
</p>
<p>
To finish up, write the partition to the disk using <c>w</c> and <c>q</c> to
quit <c>mac-fdisk</c>.
</p>
<note>
To make sure everything is ok, you should run mac-fdisk once more and check
whether all the partitions are there. If you don't see any of the partitions
you created, or the changes you made, you should reinitialize your partitions
by pressing "i" in mac-fdisk. Note that this will recreate the partition map
and thus remove all your partitions.
</note>
<p>
Now that your partitions are created, you can continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</section>
<section id="parted">
<title>Using parted (especially Pegasos) to Partition your Disk</title>
<body>
<p>
<c>parted</c>, the Partition Editor, can now handle HFS+ partitions used by
Mac OS and Mac OS X. With this tool you can resize your Mac-partitions and
create space for your Linux partitions. Nevertheless, the example below
describes partitioning for Pegasos machines only.
</p>
<p>
To begin let's fire up <c>parted</c>:
</p>
<pre caption="Starting parted">
# <i>parted /dev/hda</i>
</pre>
<p>
If the drive is unpartitioned, run <c>mklabel amiga</c> to create a new
disklabel for the drive.
</p>
<p>
You can type <c>print</c> at any time in parted to display the current partition
table. If at any time you change your mind or made a mistake you can press
<c>Ctrl-c</c> to abort parted.
</p>
<p>
If you intend to also install MorphOS on your Pegasos create an affs1 filesystem
named "BI0" (BI zero) at the start of the drive. 32MB should be more than enough
to store the MorphOS kernel. If you have a Pegasos I or intend to use reiserfs or
xfs, you will also have to store your Linux kernel on this partition (the
Pegasos II can only boot from ext2/ext3 or affs1 partitions). To create the partition run
<c>mkpart primary affs1 START END</c> where <c>START</c> and <c>END</c> should
be replaced with the megabyte range (e.g. <c>0 32</c> creates a 32 MB partition
starting at 0MB and ending at 32MB.
</p>
<p>
You need to create two partitions for Linux, one root filesystem for all your
program files etc, and one swap partition. To create the root filesystem you
must first decide which filesystem to use. Possible options are ext2, ext3,
reiserfs and xfs. Unless you know what you are doing, use ext3. Run
<c>mkpart primary ext3 START END</c> to create an ext3 partition. Again, replace
<c>START</c> and <c>END</c> with the megabyte start and stop marks for the
partition.
</p>
<p>
It is generally recommended that you create a swap partition the same size as
the amount of RAM in your computer times two. You will probably get away with a
smaller swap partition unless you intend to run a lot of applications at the
same time (although at least 512MB is recommended). To create the swap
partition, run <c>mkpart primary linux-swap START END</c>.
</p>
<p>
Write down the partition minor numbers as they are required during the
installation process. To display the minor numbers run <c>print</c>. Your drives
are accessed as <path>/dev/hdaX</path> where X is replaced with the minor number
of the partition.
</p>
<p>
When you are done in parted simply run <c>quit</c>.
</p>
</body>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available. ext2, ext3, ReiserFS and XFS have been found
stable on the PPC architecture.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mkfs.ext2</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mkfs.ext3</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkfs.reiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
</table>
<p>
For instance, to have the root partition (<path>/dev/hda4</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mkfs.ext3 /dev/hda4</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
<note>
On the PegasosII your partition which holds the kernel must be ext2 or ext3.
NewWorld machines can boot from any of ext2, ext3, XFS, ReiserFS or even
HFS/HFS+ filesystems. On OldWorld machines booting with BootX, the kernel must
be placed on an HFS partition, but this will be completed when you configure
your bootloader.
</note>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/hda3</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/hda3</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we create a mount-point and mount the root partition:
</p>
<pre caption="Mounting partitions">
# <i>mkdir /mnt/gentoo</i>
# <i>mount /dev/hda4 /mnt/gentoo</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the
partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-ppc-kernel.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.4</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
We suggest using either <c>vanilla-sources</c> or <c>gentoo-sources</c> on PPC,
which are both 2.6 kernels. The latter is available when you perform a
networkless installation. So let's continue with <c>emerge</c>'ing the kernel
sources. The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or
other dependencies at this point. <c>USE="symlink"</c> is not necessary for a
new install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
If you take a look in <path>/usr/src</path> you should see a symlink named
<path>linux</path> pointing to your current kernel source. In this case, the
installed kernel source points to <c>gentoo-sources-2.6.12-r6</c>. Your version
may be different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 22 Mar 18 16:23 /usr/src/linux -> linux-2.6.12-gentoo-r6
</pre>
<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable). Another place
to look for clues as to what components to enable is to check the kernel
message logs from the successful boot that got you this far. Type <c>dmesg</c>
to see the kernel messages.
</p>
<p>
Now, go to your kernel source directory, it's time to configure your kernel.
It is recommended that you add the default settings to your configuration by
first running <c>make defconfig</c>. After the default configuration has been
generated, run <c>make menuconfig</c> which will fire up an ncurses-based
configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make defconfig</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>/proc file system</c> and
<c>Virtual memory</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
Users of NewWorld and OldWorld machines will want HFS support as well. OldWorld
users require it for copying compiled kernels to the MacOS partition. NewWorld
users require it for configuring the special Apple_Bootstrap partition:
</p>
<pre caption="Activating HFS support">
File Systems --->
[*] HFS Support
</pre>
<p>
At this time, kernel preemption is still unstable on PPC and may cause
compilation failures and random segfaults. It is <e>strongly</e> suggested
that you do not use this feature.
</p>
<pre caption="Ensure the Preemptible Kernel Option is Off">
Platform options --->
[ ] Preemptible Kernel
</pre>
<p>
If you're booting from Firewire, you'll need to enable these options. If you do
not want to compile in support, you'll need to include these modules and their
dependencies in an initrd.
</p>
<pre caption="Enable support for firewire devices on boot">
Device Drivers --->
IEEE 1394 (FireWire) support --->
<*> IEEE 1394 (FireWire) support
<*> OHCI-1394 support
<*> SBP-2 support (Harddisks etc.)
</pre>
<p>
If you're booting from USB, you'll need to enable these options. If you do not
want to compile in support, you'll need to include these modules and their
dependencies in an initrd.
</p>
<pre caption="Enable support for USB devices on boot">
Device Drivers --->
USB support --->
<*> Support for Host-side USB
<*> OHCI HCD support
<*> USB Mass Storage support
</pre>
<p>
Do not turn off kernel framebuffer support as it is required for a successful
boot. If you are using an NVIDIA based chipset, you should use the OpenFirmware
framebuffer. If you are using an ATI based chipset, you should select the
framebuffer driver based upon your chipset (Mach64, Rage128 or Radeon).
</p>
<pre caption="Chosing a Framebuffer Driver">
Device Drivers --->
Graphics support --->
<*> Support for frame buffer devices
[*] Open Firmware frame buffer device support
<*> ATI Radeon display support
<*> ATI Rage128 display support
<*> ATI Mach64 display support
Console display driver support --->
<*> Framebuffer Console support
</pre>
<note>
If you select more than one framebuffer device, it may default to a less than
optimal driver. Either use only one framebuffer device or specify which
to use by passing the driver to use to the kernel on boot such as
<c>video=radeonfb</c>.
</note>
<p>
When you're done configuring your kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and run the commands which will compile the kernel:
</p>
<pre caption="Compiling the kernel">
# <i>make && make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path> (be sure that it is mounted properly on the Pegasos).
</p>
<pre caption="Installing the kernel">
<comment>replace <kernel-version> with your kernel version</comment>
(Apple/IBM) # <i>cp vmlinux /boot/<kernel-version></i>
(Pegasos) # <i>cp arch/ppc/boot/images/zImage.chrp /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Installing Separate Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="kernel_modules">
<title>Installing Separate Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.6</path>.
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> file and enter the module
name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because genkernel
doesn't require any manual kernel configuration, it is an ideal solution for
those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Next, copy over the kernel configuration used by the Installation CD to the
location where genkernel looks for the default kernel configuration:
</p>
<pre caption="Copying over the Installation CD kernel config">
# <i>zcat /proc/config.gz > /usr/share/genkernel/ppc/kernel-config-2.6</i>
</pre>
<p>
If you are using firewire or USB to boot, you'll need to add modules to the
initrd. Edit <path>/usr/share/genkernel/ppc/modules_load</path> and change
<c>MODULES_FIREWIRE="ieee1394 ohci1394 sbp2"</c> for firewire support or
<c>MODULES_USB="usbcore ohci-hcd ehci-hcd usb-storage"</c> for USB support.
</p>
<p>
Now, compile your kernel sources by running <c>genkernel --genzimage all</c>.
For Pegasos, we will need to use a different config and create a zImage instead
of the vmlinux kernel used on Apple machines. Be aware, as <c>genkernel</c>
compiles a kernel that supports almost all hardware, this compilation can take
quite a while to finish!
</p>
<p>
Note that, if your partition where the kernel should be located doesn't use ext2
or ext3 as filesystem you might need to manually configure your kernel using
<c>genkernel --menuconfig --genzimage all</c> and add support for your
filesystem <e>in</e> the kernel (i.e. <e>not</e> as a module). Users of EVMS2 or
LVM2 will probably want to add <c>--evms2</c> or <c>--lvm2</c> as argument as
well.
</p>
<pre caption="Running genkernel">
# <i>genkernel --genzimage all</i>
</pre>
<pre caption="Running genkernel on the Pegasos">
# <i>genkernel --genzimage --kernel-config=/usr/share/genkernel/ppc/Pegasos all</i>
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD)
before your "real" system starts up. Be sure to also copy down the required
boot arguments, these are required for a sucessful boot with genkernel.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
If you want your system to be more like the Installation CD you should,
when your Gentoo installation is over, emerge <c>coldplug</c>. While the
initrd autodetects hardware that is needed to boot your system,
<c>coldplug</c> autodetects everything else. <c>coldplug</c> is available as one
of the packages on the Package CD.
</p>
<pre caption="Emerging and enabling coldplug">
<comment>(Do this after the installation, during the GRP installation instructions)</comment>
# <i>emerge -k coldplug</i>
# <i>rc-update add coldplug boot</i>
</pre>
<p>
If you want your system to react to hotplugging events, you will need to install
and setup <c>hotplug</c> as well:
</p>
<pre caption="Emerging and enabling hotplug">
# <i>emerge hotplug</i>
# <i>rc-update add hotplug default</i>
</pre>
<p>
Now continue with <uri link="?part=1&chap=8">Configuring your System</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-ppc-medium.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>Apple NewWorld Machines</th>
<ti>
Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
PowerBook, Xserver, PowerMac
</ti>
</tr>
<tr>
<th>Apple OldWorld machines</th>
<ti>
Apple Machines with an OpenFirmware revision less than 3, such as the Beige
G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also
be supported.
</ti>
</tr>
<tr>
<th>Genesi's Pegasos</th>
<ti>
Pegasos I/II, Open Desktop Workstation
</ti>
</tr>
<tr>
<th>IBM</th>
<ti>
RS/6000, iSeries, pSeries
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>At least 64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo
PPC FAQ</uri> before you begin.
</p>
</body>
</subsection>
</section>
<!-- Copy/paste of hb-install-x86-medium.xml, with s/x86/ppc/ -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can succesfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located
in the <path>releases/ppc/2006.0/installcd</path> directory;
the Package CDs are located in the
<path>releases/ppc/2006.0/packagecd</path> directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows).
Verifying MD5 checksums with Mac OS X is described in the <uri
link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (0x17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Default: Booting the Installation CD with Yaboot</title>
<body>
<p>
On NewWorld machines place the Installation CD in the CD-ROM and reboot the
system. When the system-start-bell sounds, simply hold down the 'C' until the
CD loads.
</p>
<p>
After the Installation CD loaded, you will be greeted by a friendly welcome
message and a <e>boot:</e> prompt at the bottom of the screen.
</p>
<p>
At this prompt you are able to select a kernel for the subarchitecture you use.
We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with
support for multiple CPUs, but they will boot on single processor machines as
well.
</p>
<p>
You are also able to tweak some kernel options at this prompt. The following
table lists some of the available boot options you can add:
</p>
<table>
<tr>
<th>Boot Option</th>
<th>Description</th>
</tr>
<tr>
<ti><c>video</c></ti>
<ti>
This option takes one of the following vendor-specific tags:
<c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or
<c>ofonly</c>. You can follow this tag with the resolution and refreshrate
you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are
uncertain what to choose, <c>ofonly</c> will most certainly work.
</ti>
</tr>
<tr>
<ti><c>nol3</c></ti>
<ti>
Disables level 3 cache on some PowerBooks (needed for at least the 17")
</ti>
</tr>
<tr>
<ti><c>dofirewire</c></ti>
<ti>
Enables support for IEEE1394 (FireWire) devices, like external harddisks.
</ti>
</tr>
<tr>
<ti><c>dopcmcia</c></ti>
<ti>
If you want to use PCMCIA devices during your installation (like PCMCIA
network cards) you have to enable this option.
</ti>
</tr>
</table>
<p>
At this prompt, hit enter, and a complete Gentoo Linux environment will be
loaded from the CD. Continue with <uri link="#booted">And When You're
Booted...</uri>.
</p>
</body>
</subsection>
<subsection>
<title>Alternative: Booting the Installation CD on a Pegasos</title>
<body>
<p>
On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
between several preconfigured video configs. If you need any special boot
options you can append them to the command-line. For instance <c>boot cd
/boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. The complete list of
kernel appends (in case something goes wrong and you need it) is preconfigured
in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>.
</p>
</body>
</subsection>
<subsection>
<title>Alternative: Booting the Installation CD with BootX</title>
<body>
<p>
If you have an OldWorld Mac the bootable portion of the livecd can't be used.
The most simple solution is to use MacOS to bootstrap into a Linux environment
with a tool called BootX. Boot floppies are being prepared for Macs without
MacOS, but they are not available at this time.
</p>
<p>
First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
archive into <c>Extensions Folder</c> and the BootX App Control Panel into
<c>Control Panels</c>, both of which are located in your MacOS System Folder.
Next, create a folder called "Linux Kernels" in your System folder and copy the
<c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c>
from the Installation CD <path>boot</path> folder into the MacOS
<c>System Folder</c>.
</p>
<p>
To prepare BootX, start the BootX App Control Panel. First select the Options
dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from
your System Folder. Continue back to the initial screen and ensure that the
ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
shown below:
</p>
<pre caption="BootX kernel arguments">
cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev
</pre>
<note>
The kernel parameters in the yaboot section above are also applicable here.
</note>
<p>
Check once more to make sure the settings are correct and then save the
configuration. This saves typing just in case it doesn't boot or something is
missing. Press the Linux button at the top of the window to boot into the
Installation CD and continue with <uri link="#booted">And When
You're Booted...</uri>
</p>
</body>
</subsection>
<subsection id="booted">
<title>And When You're Booted...</title>
<body>
<p>
You will be greeted by a root ("#") prompt on the current console. You can also
switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
back to the one you started on by pressing Alt-F1. Probably you have to hit
Alt-fn-Fx on Apple machines.
</p>
<p>
If you are installing Gentoo on a system with a non-US keyboard, use
<c>loadkeys</c> to load the keymap for your keyboard. To list the available
keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
are for ADB-based OldWorld machines.
</p>
<pre caption="Listing available keymaps">
<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
on the Installation CD are ADB keymaps and unusable with the Installation CD
kernel)</comment>
# <i>ls /usr/share/keymaps/i386</i>
</pre>
<p>
Now load the keymap of your choice:
</p>
<pre caption="Loading a keymap">
# <i>loadkeys be-latin1</i>
</pre>
<p>
Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases, it may
not auto-load the kernel modules you need. If the PCI auto-detection missed some
of your system's hardware, you will have to load the appropriate kernel modules
manually.
</p>
<p>
In the next example we try to load the <c>airport</c> module. This module
supports only the old Airport cards (b-net). AirportExtreme is not supported
under Linux:
</p>
<pre caption="Loading kernel modules">
# <i>modprobe airport</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> or even <c>links -g</c> for a graphical framebuffer browser to
read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc64-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-bootloader.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2006-01-20</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
<p>
On Linux/PPC64 we have only yaBoot as a bootloader until grub2 is
finished.
</p>
</body>
</subsection>
</section>
<section id="yaboot">
<title>Using yaBoot</title>
<subsection>
<title>Introduction</title>
<body>
<impo>
For a 64bit userland use yaboot-static instead of yaboot, because yaboot won't
compile on 64bit userland systems. For a 32bit userland use yaboot as you
normally would.
</impo>
<p>
There are two ways to configure yaBoot for your system. You can use the
new and improved <c>yabootconfig</c> included with
<path>yaboot-1.3.8-r1</path> and later to automatically set up yaboot. If
for some reason you do not want to run <c>yabootconfig</c> to
automatically set up <path>/etc/yaboot.conf</path> or you are installing Gentoo
on a G5 (on which <c>yabootconfig</c> does not always work), you can just edit
the sample file already installed on your system.
</p>
<impo>
If you are installing on a G5 using an online install and have not used the
G5 optimized stages you must change what profile you are linked to now. If you
do not you will not get dependencies necessary for yaboot to run on Apple
equipment. In the command below replace <c>(userland)</c> with your chosen
userland bit level. If you are installing on a G5 using an offline install
you have to install these packages by hand.
</impo>
<pre caption = "(ONLINE INSTALL FOR G5 USERS ONLY) Changing your profile">
# <i>rm /etc/make.profile</i>
# <i>ln -sf /usr/portage/profiles/default-linux/ppc/2006.0/ppc64/(userland)/970/pmac /etc/make.profile</i>
</pre>
<pre caption = "(OFFLINE INSTALL FOR G5 USERS ONLY) Installing Necessary File System Tools">
# <i>emerge hfsutils hfsplusutils</i>
</pre>
<pre caption = "Installing the bootloader">
<comment>(64bit userland)</comment>
# <i>emerge --update yaboot-static</i>
<comment>(32bit userland)</comment>
# <i>emerge --update yaboot</i>
</pre>
<impo>
yabootconfig/ybin won't work on IBM. You have to install yaboot another way:
<uri link="#yaboot-ibm">Using yaboot on IBM hardware</uri>
</impo>
<note>
If your root filesystem uses the JFS filesystem, be sure to add <c>ro</c> as a
kernel parameter. JFS must be able to replay its log in read-only mode before it
gets mounted read-write.
</note>
<ul>
<li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li>
<li>
<uri link="#manual_yaboot">Alternative: Manual yaBoot Configuration</uri>
</li>
</ul>
</body>
</subsection>
<subsection id="yabootconfig">
<title>Default: Using yabootconfig</title>
<body>
<p>
<c>yabootconfig</c> will auto-detect the partitions on your machine and will
set up dual and triple boot combinations with Linux, Mac OS, and Mac OS
X.
</p>
<p>
To use <c>yabootconfig</c>, your drive must have a bootstrap partition, and
<path>/etc/fstab</path> must be configured with your Linux partitions. Both of
these should have been done already in the steps above. To start, ensure that
you have the latest version of yaboot installed by running <c>emerge --update
yaboot-static</c>. This is necessary as the latest version will be available via
Portage, but it may not have made it into the stage files.
</p>
<p>
Now run <c>yabootconfig</c>. The program will run and it will confirm
the location of the bootstrap partition. Type <c>Y</c> if it is correct. If
not, double check <path>/etc/fstab</path>. yabootconfig will then scan your
system setup, create <path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for
you. <c>mkofboot</c> is used to format the bootstrap partition, and install
the yaboot configuration file into it.
</p>
<p>
You might want to verify the contents of <path>/etc/yaboot.conf</path>. If
you make changes to <path>/etc/yaboot.conf</path> (like setting the
default/boot OS), make sure to rerun <c>ybin -v</c> to apply changes to the
bootstrap partition.
</p>
<p>
Now continue with <uri link="#reboot">Rebooting your System</uri>.
</p>
</body>
</subsection>
<subsection id="manual_yaboot">
<title>Alternative: Manual yaBoot Configuration</title>
<body>
<p>
Below you find a completed <path>yaboot.conf</path> file. Alter it at
will.
</p>
<pre caption = "/etc/yaboot.conf">
<comment>## /etc/yaboot.conf
##
## run: "man yaboot.conf" for details. Do not make changes until you have!!
## see also: /usr/share/doc/yaboot/examples for example configurations.
##
## For a dual-boot menu, add one or more of:
## bsd=/dev/hdaX, macos=/dev/hdaY, macosx=/dev/hdaZ
## our bootstrap partition:</comment>
boot=/dev/hda2
<comment>## ofboot is the openfirmware way to specify the bootstrap partition.
## If this isn't defined, yaboot fails on the G5 and some G4s (unless
## you pass the necessary arguments to the mkofboot/ybin program).
## hd:X means /dev/sdaX (or /dev/hdaX).</comment>
ofboot=hd:2
<comment>## hd: is open firmware speak for hda</comment>
device=hd:
delay=5
defaultos=macosx
timeout=30
install=/usr/lib/yaboot/yaboot
magicboot=/usr/lib/yaboot/ofboot
<comment>#################
## This section can be duplicated if you have more than one kernel or set of
## boot options - replace 2.6.12-gentoo-r10 with your kernel-version
#################</comment>
image=/boot/kernel-2.6.12-gentoo-r10
label=Linux
root=/dev/hda3
partition=3
read-only
macos=hd:13
macosx=hd:12
enablecdboot
enableofboot
</pre>
<p>
Once <path>yaboot.conf</path> is set up the way you want it, you run
<c>mkofboot -v</c> to install the settings in the bootstrap partition.
<e>Don't forget this!</e> Confirm when <c>mkofboot</c> asks you to create a new
filesystem.
</p>
<p>
If all goes well, and you have the same
options as the sample above, your next reboot will give you a simple,
five-entry boot menu. If you update your yaboot config later on, you'll
just need to run <c>ybin -v</c> to update the bootstrap partition -
<c>mkofboot</c> is for initial setup only.
</p>
<p>
For more information on yaboot, take a look at the <uri
link="http://penguinppc.org/projects/yaboot">yaboot project</uri>. For
now, continue the installation with <uri link="#reboot">Rebooting your
System</uri>.
</p>
</body>
</subsection>
</section>
<section id="yaboot-ibm">
<title>Using yaboot on IBM hardware</title>
<body>
<p>
On IBM hardware you cannot run yabootconfig or ybin. You must proceed with the
following steps:
</p>
<ul>
<li>Install yaboot-static</li>
<li>Run 'dd if=/usr/lib/yaboot/yaboot.chrp of=/dev/sdXX' (fill in XX
with your disk and partition for the PReP partition; this was in our
example /dev/sda1)</li>
<li>Next construct your own yaboot.conf file and place into /etc.
(Take a look at the config above, look into the man page of
yaboot.conf or look at the below yaboot.conf example)</li>
<li>Assuming your boot device in OF is pointing to the harddrive you
prep boot partition is on then it'll just work, otherwise at IPL time,
go into the multiboot menu and set the boot device to the one with
your prep boot partition.</li>
<li>That's it!</li>
</ul>
<pre caption = "yaboot.conf for IBM hardware">
device=disk:
partition=2
root=/dev/sda2
default=2.6.12-gentoo-r10
timeout=50
image=/boot/kernel-2.6.12-gentoo-r10
label=Linux
append="console=ttyS0,9600"
read-only
</pre>
<p>
For POWER4, POWER5, and blade-based hardware where the PReP disk partition
and the disk partition that contains your kernel are on the same physical disk,
you can use a simplified yaboot.conf. The following should be sufficient:
</p>
<pre caption="yaboot.conf for PReP hardware">
default = linux
timeout = 100
image=/boot/kernel-2.6.12-gentoo-r10
label=linux
read-only
root = /dev/sda2
append="root=/dev/sda2"
</pre>
<p>
To verify that yaboot has been copied to the PReP partition:
</p>
<pre caption="Verifying the yaboot install on PReP">
# <i>dd if=/dev/sda1 count=10 | grep ELF</i>
Binary file (standard input) matches
10+0 records in
10+0 records out
</pre>
<p>
A match signifies that yaboot was installed correctly.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
~# <i>cd</i>
~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc64-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-ppc64-disk.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2006-01-20</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI drives, then your first hard
drive would be <path>/dev/sda</path>. Serial ATA drives are also
<path>/dev/sda</path> even if they are IDE drives.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions and Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On most systems,
these are called <e>partitions</e>. Other architectures use a similar technique,
called <e>slices</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Partition map</ti>
<ti>31.5k</ti>
<ti>Partition map</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>(bootstrap)</ti>
<ti>800k</ti>
<ti>Apple_Bootstrap</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/sda4</path></ti>
<ti>ext3</ti>
<ti>Rest of the disk</ti>
<ti>Root partition</ti>
</tr>
</table>
<note>
There are some partitions named like this: <path>Apple_Driver43,
Apple_Driver_ATA, Apple_FWDriver, Apple_Driver_IOKit,
Apple_Patches</path>. If you are not planning to use MacOS 9 you can
delete them, because MacOS X and Linux don't need them.
You might have to use parted in order to delete them, as mac-fdisk can't delete them yet.
</note>
<p>
If you are interested in knowing how big a partition should be, or even how
many partitions you need, read on. Otherwise continue now with
<uri link="#mac-fdisk">Apple G5: Using mac-fdisk to Partition your
Disk</uri> or <uri link="#fdisk">IBM pSeries: using fdisk to Partition
your Disk</uri>
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
</body>
</subsection>
</section>
<section id="mac-fdisk">
<title>Default: Using mac-fdisk (Apple G5) Partition your Disk</title>
<body>
<p>
At this point, create your partitions using <c>mac-fdisk</c>:
</p>
<pre caption="Starting mac-fdisk">
# <i>mac-fdisk /dev/sda</i>
</pre>
<p>
First delete the partitions you have cleared previously to make room for your
Linux partitions. Use <c>d</c> in <c>mac-fdisk</c> to delete those partition(s).
It will ask for the partition number to delete.
</p>
<p>
Second, create an <e>Apple_Bootstrap</e> partition by using <c>b</c>. It will
ask for what block you want to start. Enter the number of your first free
partition, followed by a <c>p</c>. For instance this is <c>2p</c>.
</p>
<note>
This partition is <e>not</e> a "boot" partition. It is not used by Linux at all;
you don't have to place any filesystem on it and you should never mount it. PPC
users don't need an extra partition for <path>/boot</path>.
</note>
<p>
Now create a swap partition by pressing <c>c</c>. Again <c>mac-fdisk</c> will
ask for what block you want to start this partition from. As we used <c>2</c>
before to create the Apple_Bootstrap partition, you now have to enter
<c>3p</c>. When you're asked for the size, enter <c>512M</c> (or whatever size
you want). When asked for a name, enter <c>swap</c> (mandatory).
</p>
<p>
To create the root partition, enter <c>c</c>, followed by <c>4p</c> to select
from what block the root partition should start. When asked for the size, enter
<c>4p</c> again. <c>mac-fdisk</c> will interpret this as "Use all available
space". When asked for the name, enter <c>root</c> (mandatory).
</p>
<p>
To finish up, write the partition to the disk using <c>w</c> and <c>q</c> to
quit <c>mac-fdisk</c>.
</p>
<note>
To make sure everything is ok, you should run mac-fdisk once more and check whether all the partitions are there.
If you don't see any of the partitions you created, or the changes you made, you should reinitialize your partitions by pressing "i" in mac-fdisk.
Note that this will recreate the partition map and thus remove all your partitions.
</note>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</section>
<section id="fdisk">
<title>IBM pSeries, iSeries and OpenPower: using fdisk to Partition your Disk</title>
<subsection>
<body>
<note>
If you are planning to use a RAID disk array for your gentoo installation and
you are using POWER5-based hardware, you should now run <c>iprutils</c> to
format the disks to Advanced Function format and create the disk array. You
should also consider emerging this package after your install is complete.
</note>
<p>
The following parts explain how to create the example partition layout
described previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>PPC PReP Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
Change your partition layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Viewing the Current Partition Layout</title>
<body>
<p>
<c>fdisk</c> is a popular and powerful tool to split your disk into
partitions. Fire up <c>fdisk</c> on your disk (in our example, we
use <path>/dev/sda</path>):
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/sda</i>
</pre>
<p>
Once in <c>fdisk</c>, you'll be greeted with a prompt that looks like
this:
</p>
<pre caption="fdisk prompt">
Command (m for help):
</pre>
<p>
Type <c>p</c> to display your disk's current partition configuration:
</p>
<pre caption="An example partition configuration">
Command (m for help): p
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 12 53266+ 83 Linux
/dev/sda2 13 233 981571+ 82 Linux swap
/dev/sda3 234 674 1958701+ 83 Linux
/dev/sda4 675 6761 27035410+ 5 Extended
/dev/sda5 675 2874 9771268+ 83 Linux
/dev/sda6 2875 2919 199836 83 Linux
/dev/sda7 2920 3008 395262 83 Linux
/dev/sda8 3009 6761 16668918 83 Linux
Command (m for help):
</pre>
<p>
This particular disk is configured to house six Linux filesystems
(each with a corresponding partition listed as "Linux") as well as a
swap partition (listed as "Linux swap").
</p>
</body>
</subsection>
<subsection>
<title>Removing all Partitions</title>
<body>
<p>
We will first remove all existing partitions from the disk. Type
<c>d</c> to delete a partition. For instance, to delete an existing
<path>/dev/sda1</path>:
</p>
<note>
If you don't want to delete all partitions just delete those you
want to delete. At this point the author recommends a backup of your
data to avoid the lose of it.
</note>
<pre caption="Deleting a partition">
Command (m for help): <i>d</i>
Partition number (1-4): <i>1</i>
</pre>
<p>
The partition has been scheduled for deletion. It will no longer show up
if you type <c>p</c>, but it will not be erased until your changes have
been saved. If you made a mistake and want to abort without saving your
changes, type <c>q</c> immediately and hit enter and your partition will
not be deleted.
</p>
<p>
Now, assuming that you do indeed want to wipe out all the partitions on
your system, repeatedly type <c>p</c> to print out a partition listing
and then type <c>d</c> and the number of the partition to delete it.
Eventually, you'll end up with a partition table with nothing in it:
</p>
<pre caption="An empty partition table">
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
Command (m for help):
</pre>
<p>
Now that the in-memory partition table is empty, we're ready to create
the partitions. We will use a default partitioning scheme as discussed
previously. Of course, don't follow these instructions to the letter if
you don't want the same partitioning scheme!
</p>
</body>
</subsection>
<subsection>
<title>Creating the PPC PReP boot partition</title>
<body>
<p>
We first create a small PReP boot partition. Type <c>n</c> to create a new
partition, then <c>p</c> to select a primary partition, followed by
<c>1</c> to select the first primary partition. When prompted for the
first cylinder, hit enter. When prompted for the last cylinder, type
<c>+7M</c> to create a partition 7 Mbyte in size. After you've done
this, type <c>t</c> to set the partition type, <c>1</c> to select the
partition you just created and then type in <c>41</c> to set the
partition type to "PPC PReP Boot". Finally, you'll need to mark the PReP
partition as bootable.
</p>
<note>
The PReP partition has to be smaller than 8 MByte!
</note>
<pre caption="Creating the PReP boot partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>1</i>
First cylinder (1-6761, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-6761, default
6761): <i>+8M</i>
Command (m for help): <i>t</i>
Selected partition 1
Hex code (type L to list codes): <i>41</i>
Changed system type of partition 1 to 41 (PPC PReP Boot)
Command (m for help): <i>a</i>
Partition number (1-4): <i>1</i>
Command (m for help):
</pre>
<p>
Now, when you type <c>p</c>, you should see the following partition information:
</p>
<pre caption="Created boot partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
/dev/sda1 * 1 3 13293 41 PPC PReP Boot
Command (m for help):
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Swap Partition</title>
<body>
<p>
Let's now create the swap partition. To do this, type <c>n</c> to create
a new partition, then <c>p</c> to tell fdisk that you want a primary
partition. Then type <c>2</c> to create the second primary 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 you've done
this, type <c>t</c> to set the partition type, <c>2</c> to select the
partition you just created 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 this:
</p>
<pre caption="Partition listing after creating a swap partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 3 13293 41 PPC PReP Boot
/dev/sda2 4 117 506331 82 Linux swap
Command (m for help):
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
Finally, let's create the root partition. To do this, type <c>n</c> to
create a new partition, then <c>p</c> to tell fdisk that you want a
primary partition. Then type <c>3</c> to create the third primary
partition, <path>/dev/sda3</path> in our case. When prompted for the
first cylinder, hit enter. When prompted for the last cylinder, hit
enter to create a partition that takes up the rest of the remaining
space on your disk. After completing these steps, typing <c>p</c> should
display a partition table that looks similar to this:
</p>
<pre caption="Partition listing after creating the root partition">
Command (m for help): p
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 3 13293 41 PPC PReP Boot
/dev/sda2 4 117 506331 82 Linux swap
/dev/sda3 118 6761 29509326 83 Linux
Command (m for help):
</pre>
</body>
</subsection>
<subsection>
<title>Saving the Partition Layout</title>
<body>
<p>
To save the partition layout and exit <c>fdisk</c>, type <c>w</c>.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<note>
Several filesystems are available.
</note>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling that is fully supported
under Gentoo Linux's xfs-sources kernel. It comes with a robust feature-set and
is optimized for scalability. We only recommend using this filesystem on Linux
systems with high-end SCSI and/or fibre channel storage and a uninterruptible
power supply. Because XFS aggressively caches in-transit data in RAM, improperly
designed programs (those that don't take proper precautions when writing files
to disk and there are quite a few of them) can lose a good deal of data if the
system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the root partition (<path>/dev/sda4</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs -j /dev/sda4</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/sda3</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/sda3</i>
</pre>
<p>
Create and activate the swap with the commands mentioned above.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we create a mount-point and mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mkdir /mnt/gentoo</i>
# <i>mount /dev/sda4 /mnt/gentoo</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc64-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-ppc64-kernel.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel.
It is the layer between the user programs and your system hardware.
Gentoo provides its users several possible kernel sources. A full
listing with description is available at the <uri
link="/doc/en/gentoo-kernel.xml">Gentoo Kernel Guide</uri>.
</p>
<p>
For PPC64 you should use <c>gentoo-sources</c>. So let's continue with
<c>emerge</c>'ing the kernel sources. The <c>USE="-doc"</c> is necessary to
avoid installing xorg-x11 or other dependencies at this point.
<c>USE="symlink"</c> is not necessary for a new install, but ensures proper
creation of the <path>/usr/src/linux</path> symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.12-gentoo-r10
</pre>
<p>
Now it is time to configure and compile your kernel source. There is the
ability to use "genkernel" which would create a generic kernel like the
ones used on the installation CDs, but it is not fully functional for PPC64 at
the moment.
</p>
<p>
Continue now with <uri link="#manual">Manual Configuration</uri>.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make
menuconfig</c>. This will fire up an ncurses-based configuration menu.
</p>
<p>
When compiling the kernel on a 32bit userland system add the following to
the bottom of /etc/profile:
</p>
<pre caption="32bit userland make alias">
# <i>echo 'alias ppc64make="make ARCH=ppc64 CROSS_COMPILE=powerpc64-unknown-linux-gnu-"' >> /etc/profile</i>
# <i>source /etc/profile</i>
</pre>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
(64bit userland) # <i>make menuconfig</i>
(32bit userland) # <i>ppc64make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first
list some options you must activate (otherwise Gentoo will not function,
or not function properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental
code/drivers. You need this, otherwise some very important code/drivers
won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you
use. <e>Don't</e> compile them as modules, otherwise your Gentoo system
will not be able to mount your partitions. Also select <c>Virtual
memory</c>, <c>/proc file system</c>, and <c>/dev/pts file system for
Unix98 PTYs</c>:
</p>
<pre caption="Selecting necessary file systems">
File systems --->
[*] Virtual memory file system support (former shm fs)
[*] /proc file system support
[*] /dev/pts file system for Unix98 PTYs
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<note>
You will find some of the mentioned options under <c>Pseudo
filesystems</c> which is a subpart of <c>File systems</c>.
</note>
<p>
If you are using PPPoE to connect to the Internet or you are using a
dial-up modem, you will need the following options in the kernel (you
will find the mentioned options under <c>Networking support</c> which is
a subpart of <c>Device Drivers</c>):
</p>
<pre caption="Selecting PPPoE necessary drivers">
Network device support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
Disable ADB raw keycodes:
</p>
<pre caption="Disabling ADB raw keycodes">
Macintosh Device Drivers --->
[ ] Support for ADB raw keycodes
</pre>
<p>
When you're done configuring your kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
(64bit userland) # <i>make && make modules_install</i>
(32bit userland) # <i>ppc64make && ppc64make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Remember to replace <path><kernel-version<</path>
with your actual kernel version:
</p>
<pre caption="Installing the kernel">
# <i>cp vmlinux /boot/<kernel-version<</i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Configuring the Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="kernel_modules">
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.6</path>. You can add extra
options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> file and enter the module name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc64-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc64-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-ppc64-medium.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>Any PowerPC64 CPU</ti>
</tr>
<tr>
<th>Systems</th>
<ti>
IBM RS/6000s, Power Macintosh G5, iMac G5, IBP pSeries and IBM OpenPower
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
For a full list of supported systems, please go to
<uri>http://www.linuxppc64.org/hardware.shtml</uri>.
</p>
</body>
</subsection>
</section>
<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can succesfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications immediately after the
Gentoo installation and right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot a Gentoo Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CDs</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located
in the <path>releases/ppc64/2006.0-r1/installcd</path> directory;
the Package CDs are located in the <path>releases/ppc64/2006.0/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows). How
to verify MD5 checksums with Mac OS X is described in the <uri
link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (0x17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Installation CD on an Apple</title>
<body>
<p>
Place the Installation CD in the CD-ROM and reboot the system. Hold down the
'C' key at bootup. You will be greeted by a friendly welcome message and a
<e>boot:</e> prompt at the bottom of the screen.
</p>
<p>
You are also able to tweak some kernel options at this prompt. The following
table lists the available boot options you can add:
</p>
<table>
<tr>
<th>Boot Option</th>
<th>Description</th>
</tr>
<tr>
<ti><c>video</c></ti>
<ti>
This option takes one of the following vendor-specific tags:
<c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or
<c>ofonly</c>. You can follow this tag with the resolution and refreshrate
you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are
uncertain what to choose, <c>ofonly</c> will most certainly work.
</ti>
</tr>
<tr>
<ti><c>nol3</c></ti>
<ti>
Disables level 3 cache on some powerbooks (needed for at least the 17'')
</ti>
</tr>
<tr>
<ti><c>debug</c></ti>
<ti>
Enables verbose booting, spawns an initrd shell that can be used to debug
the Installation CD
</ti>
</tr>
<tr>
<ti><c>sleep=X</c></ti>
<ti>
Wait X seconds before continuing; this can be needed by some very old SCSI
CD-ROMs which don't speed up the CD quick enough
</ti>
</tr>
<tr>
<ti><c>bootfrom=X</c></ti>
<ti>
Boot from a different device
</ti>
</tr>
</table>
<p>
At this prompt, hit enter, and a complete Gentoo Linux environment will be
loaded from the CD. Continue with <uri link="#booted">And When You're
Booted...</uri>.
</p>
</body>
</subsection>
<subsection>
<title>Booting the Installation CD on an IBM pSeries</title>
<body>
<p>
For pSeries boxes, sometimes the cds might not autoboot. You might have
to set up your cdrom as a bootable device in the multi-boot menu. (F1 at
startup) The other option is to jump into OF and do it from there:
</p>
<p>
1) Boot into OF (this is 8 from the serial cons or F8 from a graphics
cons, start hitting the key when you see the keyboard mouse etc etc
messages
</p>
<p>
2) run the command 0> boot cdrom:1,yaboot
</p>
<p>
3) stand back and enjoy!
</p>
</body>
</subsection>
<subsection id="booted">
<title>And When You're Booted...</title>
<body>
<p>
You will be greeted by a root ("#") prompt on the current console. You can also
switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
back to the one you started on by pressing Alt-fn-F1.
</p>
<p>
If you are installing Gentoo on a system with a non-US keyboard, use
<c>loadkeys</c> to load the keymap for your keyboard. To list the available
keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
</p>
<pre caption="Listing available keymaps">
<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
on the Installation CD are ADB keymaps and unusable with the
Installation CD kernel)</comment>
# <i>ls /usr/share/keymaps/i386</i>
</pre>
<p>
Now load the keymap of your choice:
</p>
<pre caption="Loading a keymap">
# <i>loadkeys be-latin1</i>
</pre>
<p>
Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases it may
not auto-load the kernel
modules you need. If the PCI auto-detection missed some of your system's
hardware, you will have to load the appropriate kernel modules manually.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook during the installation, make sure you
have created a user account (see <uri link="#useraccounts">Optional: User
Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD.
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-sparc-bootloader.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2006-01-19</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Installing the SPARC Bootloader: SILO</title>
<body>
<p>
It is now time to install and configure <uri
link="http://www.sparc-boot.org">SILO</uri>, the Sparc Improved boot
LOader.
</p>
<pre caption = "Installing SILO">
# <i>emerge silo</i>
</pre>
<p>
Now open up your favorite editor (we use <c>nano</c> as an example) and
create <path>/etc/silo.conf</path>.
</p>
<pre caption = "Creating /etc/silo.conf">
# <i>nano -w /etc/silo.conf</i>
</pre>
<p>
Below you'll find an example <path>silo.conf</path> file. It uses the
partitioning scheme we use throughout this book and
<path>kernel-2.4.31</path> as kernelimage.
</p>
<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>
image = /boot/kernel-2.4.31
label = linux
</pre>
<p>
If you use the example <path>silo.conf</path> delivered by Portage, be
sure to comment out <e>all</e> lines that you do not need.
</p>
<p>
If the physical disk on which you want to install SILO (as bootloader) differs
from the physical disk on which <path>/etc/silo.conf</path> resides, you must
copy over <path>/etc/silo.conf</path> to a partition on that disk. Assuming that
<path>/boot</path> is a separate partition on that disk, copy over the
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">
# <i>cp /etc/silo.conf /boot</i>
# <i>/sbin/silo -C /boot/silo.conf</i>
/boot/silo.conf appears to be valid
</pre>
<p>
Otherwise just run <c>/sbin/silo</c>:
</p>
<pre caption = "Run silo">
# <i>/sbin/silo</i>
/etc/silo.conf appears to be valid
</pre>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-sparc-disk.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-25</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at some of the disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions, and block
devices. Then, once you're familiar with the ins and outs of disks and
filesystems, you'll be guided through the process of setting up partitions
and filesystems for your Gentoo Linux installation.
</p>
<p>
To begin, we introduce <e>block devices</e>. The most typical block device is
probably the one that represents the first SCSI hard disk in a Linux system,
namely <path>/dev/sda</path>.
</p>
<p>
Block devices represent an abstract interface to the disk. User programs can
use these block devices to interact with your disk without worrying about
whether your drives are IDE, SCSI, or something else. The program can simply
address the storage on the disk as a bunch of contiguous, randomly-accessible
512-byte blocks.
</p>
<p>
Block devices show up as entries in <path>/dev/</path>. Typically, the first
SCSI drive is named <path>/dev/sda</path>, the second <path>/dev/sdb</path>,
and so on. IDE drives are named similarly, however, they are prefixed by hd-
instead of sd-. If you are using IDE drives, the first one will be named
<path>/dev/hda</path>, the second <path>/dev/hdb</path>, and so on.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Although it is theoretically possible to use the entire disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. These are known as
<e>partitions</e> or <e>slices</e>.
</p>
<p>
The first partition on the first SCSI disk is <path>/dev/sda1</path>, the second
<path>/dev/sda2</path> and so on. Similarly, the first two partitions on the
first IDE disk are <path>/dev/hda1</path> and <path>/dev/hda2</path>.
</p>
<p>
The third partition on Sun systems is set aside as a special "whole disk"
slice. This partition must not contain a file system.
</p>
<p>
Users who are used to the DOS partitioning scheme should note that Sun
disklabels do not have "primary" and "extended" partitions. Instead, up to
eight partitions are available per drive, with the third of these being
reserved.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme,
the table below suggests a suitable starting point for most systems. For
IDE-based systems, substitute <c>hda</c> for <c>sda</c> in the following.
</p>
<p>
Note that a separate <path>/boot</path> partition is generally <e>not</e>
recommended on SPARC, as it complicates the bootloader configuration.
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Mount Point</th>
<th>Description</th>
</tr>
<tr>
<ti>/dev/sda1</ti>
<ti>ext3</ti>
<ti><2 GByte</ti>
<ti>/</ti>
<ti>
Root partition. For all sparc32 systems, and 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>
</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>
</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>
</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>
</tr>
</table>
</body>
</subsection>
</section>
<section id="fdisk">
<title>Using fdisk to Partition your Disk</title>
<subsection>
<body>
<p>
The following parts explain how to create the example partition layout described
previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti>/dev/sda1</ti>
<ti>/</ti>
</tr>
<tr>
<ti>/dev/sda2</ti>
<ti>swap</ti>
</tr>
<tr>
<ti>/dev/sda3</ti>
<ti>whole disk slice</ti>
</tr>
<tr>
<ti>/dev/sda4</ti>
<ti>/usr</ti>
</tr>
<tr>
<ti>/dev/sda5</ti>
<ti>/var</ti>
</tr>
<tr>
<ti>/dev/sda6</ti>
<ti>/home</ti>
</tr>
</table>
<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
a 15-partition limit for SCSI and SATA.
</p>
</body>
</subsection>
<subsection>
<title>Firing up fdisk</title>
<body>
<p>
Start <c>fdisk</c> with your disk as argument:
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/sda</i>
</pre>
<p>
You should be greeted with the fdisk prompt:
</p>
<pre caption="The fdisk prompt">
Command (m for help):
</pre>
<p>
To view the available partitions, type in <c>p</c>:
</p>
<pre caption="Listing available partitions">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda1 0 488 499712 83 Linux native
/dev/sda2 488 976 499712 82 Linux swap
/dev/sda3 0 8635 8842240 5 Whole disk
/dev/sda4 976 1953 1000448 83 Linux native
/dev/sda5 1953 2144 195584 83 Linux native
/dev/sda6 2144 8635 6646784 83 Linux native
</pre>
<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:
</p>
<pre caption="Creating a Sun Disklabel">
Command (m for help): s
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.
Drive type
? auto configure
0 custom (with hardware detected defaults)
a Quantum ProDrive 80S
b Quantum ProDrive 105S
c CDC Wren IV 94171-344
d IBM DPES-31080
e IBM DORS-32160
f IBM DNES-318350
g SEAGATE ST34371
h SUN0104
i SUN0207
j SUN0327
k SUN0340
l SUN0424
m SUN0535
n SUN0669
o SUN1.0G
p SUN1.05
q SUN1.3G
r SUN2.1G
s IOMEGA Jaz
Select type (? for auto, 0 for custom): <i>0</i>
Heads (1-1024, default 64):
Using default value 64
Sectors/track (1-1024, default 32):
Using default value 32
Cylinders (1-65535, default 8635):
Using default value 8635
Alternate cylinders (0-65535, default 2):
Using default value 2
Physical cylinders (0-65535, default 8637):
Using default value 8637
Rotation speed (rpm) (1-100000, default 5400): <i>10000</i>
Interleave factor (1-32, default 1):
Using default value 1
Extra sectors per cylinder (0-32, default 0):
Using default value 0
</pre>
<p>
You can find the correct values in your disk's documentation. The
'auto configure' option does not usually work.
</p>
</body>
</subsection>
<subsection>
<title>Deleting Existing Partitions</title>
<body>
<p>
It's time to delete any existing partitions. To do this, type <c>d</c> and hit
Enter. You will then be prompted for the partition number you would like to
delete. To delete a pre-existing <path>/dev/sda1</path>, you would type:
</p>
<pre caption="Deleting a partition">
Command (m for help): <i>d</i>
Partition number (1-4): <i>1</i>
</pre>
<p>
<e>You should not delete partition 3 (whole disk).</e> This is required. If
this partition does not exist, follow the "Creating a Sun Disklabel"
instructions above.
</p>
<p>
After deleting all partitions except the Whole disk slice, you should have a
partition layout similar to the following:
</p>
<pre caption="View an empty partition scheme">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda3 0 8635 8842240 5 Whole disk
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
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
output from these steps below:
</p>
<pre caption="Creating a root partition">
Command (m for help): <i>n</i>
Partition number (1-8): <i>1</i>
First cylinder (0-8635): <i>(press Enter)</i>
Last cylinder or +size or +sizeM or +sizeK (0-8635, default 8635): <i>+512M</i>
</pre>
<p>
Now, when you type <c>p</c>, you should see the following partition printout:
</p>
<pre caption="Listing the partition layout">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda1 0 488 499712 83 Linux native
/dev/sda3 0 8635 8842240 5 Whole disk
</pre>
</body>
</subsection>
<subsection>
<title>Creating a swap partition</title>
<body>
<p>
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
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
this:
</p>
<pre caption="Listing of available partitions">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda1 0 488 499712 83 Linux native
/dev/sda2 488 976 499712 82 Linux swap
/dev/sda3 0 8635 8842240 5 Whole disk
</pre>
</body>
</subsection>
<subsection>
<title>Creating the /usr, /var and /home partitions</title>
<body>
<p>
Finally, let's create the /usr, /var and /home partitions. As before,
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
for <path>sda5</path> and <path>sda6</path>, using the desired sizes. Once
you're done, you should see something like this:
</p>
<pre caption="Listing complete partition table">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda1 0 488 499712 83 Linux native
/dev/sda2 488 976 499712 82 Linux swap
/dev/sda3 0 8635 8842240 5 Whole disk
/dev/sda4 976 1953 1000448 83 Linux native
/dev/sda5 1953 2144 195584 83 Linux native
/dev/sda6 2144 8635 6646784 83 Linux native
</pre>
</body>
</subsection>
<subsection>
<title>Save and Exit</title>
<body>
<p>
To save your partition layout and exit <c>fdisk</c>, type <c>w</c>:
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what is
used as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise, read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available, some are known to be stable on the
SPARC architecture. Ext2 and ext3, for example, are known to work well.
Alternate filesystems may not function correctly.
</p>
<p>
<b>ext2</b> is the tried-and-true Linux filesystem. It does not support
journaling, which means that periodic checks of ext2 filesystems at startup
can be quite time-consuming. There is quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly at
startup, and are therefore generally preferred over their non-journaled
counterparts. In general, journaled filesystems prevent long delays when a
system is booted and the filesystem is in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem. It provides
metadata journaling for fast recovery as well as other enhanced journaling
modes like full-data and ordered-data journaling. Ext3 has an additional hashed
b-tree indexing option that enables high performance in almost all situations.
You can enable this indexing by adding <c>-O dir_index</c> to the <c>mke2fs</c>
command. Ext3 makes an excellent and reliable alternative to ext2.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, tools specific to the chosen
filesystem are available:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>ext3 with hashed b-tree indexing (2.6 kernels only)</ti>
<ti><c>mke2fs -j -O dir_index</c></ti>
</tr>
</table>
<p>
For instance, to create the root partition (<path>/dev/sda1</path> in our
example) as ext2, and the <path>/usr</path>, <path>/var</path>, and
<path>/home</path> partitions (<path>/dev/sda4</path>, <path>5</path>
and <path>6</path> in our example, respectively) as ext3, you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs /dev/sda1</i>
# <i>mke2fs -j /dev/sda4</i>
# <i>mke2fs -j /dev/sda5</i>
# <i>mke2fs -j /dev/sda6</i>
</pre>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/sda2</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/sda2</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount them using the <c>mount</c> command. Don't forget to first
create the necessary mount directories for every partition you created. For
example:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/sda1 /mnt/gentoo</i>
# <i>mkdir /mnt/gentoo/usr</i>
# <i>mount /dev/sda4 /mnt/gentoo/usr</i>
# <i>mkdir /mnt/gentoo/var</i>
# <i>mount /dev/sda5 /mnt/gentoo/var</i>
# <i>mkdir /mnt/gentoo/home</i>
# <i>mount /dev/sda6 /mnt/gentoo/home</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure
to change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>.
This also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-sparc-kernel.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For sparc-based systems we have <c>sparc-sources</c> (kernel source optimized
for SPARC users) and <c>vanilla-sources</c> (the default kernel source as
developed by the linux-kernel developers).
</p>
<p>
In the next example we install the <c>sparc-sources</c>. Of course substitute
with your choice of sources, this is merely an example. The <c>USE="-doc"</c>
is necessary to avoid installing xorg-x11 or other dependencies at this point.
<c>USE="symlink"</c> is not necessary for a new install, but ensures proper
creation of the <path>/usr/src/linux</path> symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge sparc-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>sparc-sources-2.4.31</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.4.31-sparc
</pre>
<p>
Now it is time to configure and compile your kernel source.
</p>
</body>
</subsection>
</section>
<section>
<title>Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
file system</c>. If you are running a 2.4 kernel, you should also select
<c>/dev file system</c> + <c>Automatically mount at boot</c>:
</p>
<pre caption="Selecting necessary file systems">
File systems --->
[*] Virtual memory file system support (former shm fs)
[*] /proc file system support
[ ] /dev/pts file system for Unix98 PTYs
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Ext3 journalling file system support
<*> Second extended fs support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Network device support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
Now activate the correct bus-support:
</p>
<pre caption="Activating SBUS/UPA">
Console drivers --->
Frame-buffer support --->
[*] SBUS and UPA framebuffers
[*] Creator/Creator3D support <comment>(Only for UPA slot adapter used in many Ultras)</comment>
[*] CGsix (GX,TurboGX) support <comment>(Only for SBUS slot adapter used in many SPARCStations)</comment>
</pre>
<p>
Of course you want support for the OBP:
</p>
<pre caption="Activating OBP Support">
Misc Linux/SPARC drivers --->
[*] /dev/openprom device support
</pre>
<p>
You will also need SCSI-specific support:
</p>
<pre caption="Activating SCSI-specific support">
SCSI support --->
SCSI low-level drivers --->
<*> Sparc ESP Scsi Driver <comment>(Only for SPARC ESP on-board SCSI adapter)</comment>
<*> PTI Qlogic, ISP Driver <comment>(Only for SBUS SCSI controllers from PTI or QLogic)</comment>
<*> SYM53C8XX Version 2 SCSI support <comment>(Only for Ultra 60 on-board SCSI adapter)</comment>
</pre>
<p>
To support your network card, select one of the following:
</p>
<pre caption="Activating networking support">
Network device support --->
Ethernet (10 or 100Mbit) --->
<*> Sun LANCE support <comment>(Only for SPARCStation, older Ultra systems, and as Sbus option)</comment>
<*> Sun Happy Meal 10/100baseT support <comment>(Only for Ultra; also supports "qfe" quad-ethernet on PCI and Sbus)</comment>
<*> DECchip Tulip (dc21x4x) PCI support <comment>(For some Netras, like N1)</comment>
Ethernet (1000Mbit) --->
<*> Broadcom Tigon3 support <comment>(Modern Netra, Sun Fire machines)</comment>
</pre>
<p>
When you have a 4-port Ethernet machine (10/100 or 10/100/1000) the port order
is different from the one used by Solaris. You can use <c>sys-apps/ethtool</c>
or <c>mii-tool</c> to check the port link status.
</p>
<p>
When you're done configuring your kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>. However, after having
compiled the kernel, check its size:
</p>
<pre caption="Check kernel size">
# <i>ls -lh vmlinux</i>
-rw-r--r-- 1 root root 2.4M Oct 25 14:38 vmlinux
</pre>
<p>
If the (uncompressed) size is bigger than 2.5 MB (for Sparc32) or 3.5 MB (for
Sparc64), reconfigure your kernel until it doesn't exceed these limits. One way
of accomplishing this is by having most kernel drivers compiled as modules.
Ignoring this can lead to a non-booting kernel.
</p>
<p>
Also, if your kernel is just a tad too big, you can try stripping it using the
<c>strip</c> command:
</p>
<pre caption="Stripping the kernel">
# <i>strip -R .comment -R .note vmlinux</i>
</pre>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
<comment>(sparc32)</comment>
# <i>make dep && make clean vmlinux modules modules_install</i>
<comment>(sparc64)</comment>
# <i>make dep && make clean vmlinux image modules modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Remember to replace <path><kernel-version></path>
with your actual kernel version.
</p>
<pre caption="Installing the kernel">
<comment>(sparc32)</comment>
# <i>cp vmlinux /boot/<kernel-version></i>
<comment>(sparc64)</comment>
# <i>cp arch/sparc64/boot/image /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Installing Separate Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="kernel_modules">
<title>Installing Separate Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.4</path>.
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.4</path> file and enter the module name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.4">
# <i>nano -w /etc/modules.autoload.d/kernel-2.4</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.4">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-sparc-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-sparc-medium.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.4</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>Sparc System</th>
<ti>
Please check the <uri
link="http://www.ultralinux.org/faq.html#s_2">UltraLinux FAQ</uri>
</ti>
</tr>
<tr>
<th>CPU</th>
<ti>
Although sparc64 is the only officially supported platform, experimental
support for sparc32 is available as well
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
We currently only provide Installation CDs for the sparc64 architecture. Users
of sparc32 can use the experimental netboot images to install Gentoo from.
More information about netbooting can be found in our <uri
link="/doc/en/gentoo-sparc-netboot-howto.xml">Gentoo Linux based Netboot
HOWTO</uri>.
</p>
</body>
</subsection>
</section>
<!-- Copy/Paste from hb-install-x86-medium.xml -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can succesfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot a Gentoo Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CDs</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
the <path>releases/sparc/2006.0-r1/sparc64/installcd</path>
directory; the Package CDs are located in the
<path>releases/sparc/2006.0/sparc64/packagecd</path> directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded
iso></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<p>
Insert the Gentoo Installation CD in the CD-ROM and boot your system. During
startup, press Stop-A to enter OpenBootPROM (OBP). Once you are in the OBP,
boot from the CD-ROM:
</p>
<pre caption="Booting the Installation CD">
ok <i>boot cdrom</i>
</pre>
<p>
You will be greeted by the SILO boot manager (on the Installation CD). Type in
<c>gentoo-2.4</c> and press enter to continue booting the
system:
</p>
<pre caption="Continue booting from the Installation CD">
boot: <i>gentoo-2.4</i>
</pre>
<p>
Once the Installation CD is booted, you will be automatically logged on to the
system.
</p>
<p>
You should have a root ("#") prompt on the current console and can also switch
to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you
started on by pressing Alt-F1. You will also find a root prompt on the serial
console (<path>ttyS0</path>).
</p>
<p>
Continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
If not all hardware is supported out-of-the-box, you will need to load the
appropriate kernel modules.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-stage.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-stage.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-stage.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-stage.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-stage.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.8</version>
<date>2005-12-20</date>
<section>
<title>Installing a Stage Tarball</title>
<subsection>
<title>Setting the Date/Time Right</title>
<body>
<p>
Before you continue you need to check your date/time and update it. A
misconfigured clock may lead to strange results in the future!
</p>
<p>
To verify the current date/time, run <c>date</c>:
</p>
<pre caption="Verifying the date/time">
# <i>date</i>
Fri Mar 29 16:21:18 CEST 2005
</pre>
<p>
If the date/time displayed is wrong, update it using the <c>date
MMDDhhmmYYYY</c> syntax (<b>M</b>onth, <b>D</b>ay, <b>h</b>our, <b>m</b>inute
and <b>Y</b>ear). For instance, to set the date to Mar 29th, 16:21 in the
year 2005:
</p>
<pre caption="Setting the date/time">
# <i>date 032916212005</i>
</pre>
</body>
</subsection>
<subsection>
<title>Locating the Stage3 File</title>
<body>
<p>
If you have configured networking because you need to download a stage3 file for
your architecture, continue with <uri link="#download">Alternative: Using a
Stage3 from the Internet</uri>. Otherwise read <uri link="#available">Default:
Using a Stage3 from the Installation CD</uri>.
</p>
</body>
</subsection>
</section>
<section id="available">
<title>Default: Using a Stage from the Installation CD</title>
<subsection>
<title>Extracting the Stage Tarball</title>
<body>
<p>
The stages on the CD reside in the <path>/mnt/cdrom/stages</path> directory. To
see a listing of available stages, use <c>ls</c>:
</p>
<pre caption="List all available stages">
# <i>ls /mnt/cdrom/stages</i>
</pre>
<p>
If the system replies with an error, you may need to mount the CD-ROM first:
</p>
<pre caption="Mounting the CD-ROM">
# <i>ls /mnt/cdrom/stages</i>
ls: /mnt/cdrom/stages: No such file or directory
# <i>mount /dev/cdroms/cdrom0 /mnt/cdrom</i>
# <i>ls /mnt/cdrom/stages</i>
</pre>
<p>
Now go into your Gentoo mountpoint (usually <path>/mnt/gentoo</path>):
</p>
<pre caption="Changing directory to /mnt/gentoo">
# <i>cd /mnt/gentoo</i>
</pre>
<p>
We will now extract the stage tarball of your choice. We will do this with the
<c>tar</c> tool. Make sure you use the same options (<c>xvjpf</c>)! The
<c>x</c> stands for <e>Extract</e>, the <c>v</c> for <e>Verbose</e> to see what
happens during the extraction process (this one is optional), the <c>j</c> for
<e>Decompress with bzip2</e>, the <c>p</c> for <e>Preserve permissions</e> and
the <c>f</c> to denote that we want to extract a file, not standard input. In
the next example, we extract the stage tarball
<path>stage3-<subarch>-2006.0.tar.bz2</path>. Be sure to substitute
the tarball filename with your stage.
</p>
<pre caption="Extracting the stage tarball">
# <i>tar xvjpf /mnt/cdrom/stages/stage3-<subarch>-2006.0.tar.bz2</i>
</pre>
<p>
Now that the stage is installed, continue with <uri
link="#installing_portage">Installing Portage</uri>.
</p>
</body>
</subsection>
</section>
<section id="download">
<title>Alternative: Using a Stage from the Internet</title>
<subsection>
<title>Downloading the Stage Tarball</title>
<body>
<p>
Go to the Gentoo mountpoint at which you mounted your filesystems
(most likely <path>/mnt/gentoo</path>):
</p>
<pre caption="Going to the Gentoo mountpoint">
# <i>cd /mnt/gentoo</i>
</pre>
<p>
Depending on your installation medium, you have a couple of tools available to
download a stage. If you have <c>links2</c> available, then you can immediately
surf to <uri link="/main/en/mirrors.xml">the Gentoo mirrorlist</uri> and
choose a mirror close to you.
</p>
<p>
If you don't have <c>links2</c> available you should have <c>lynx</c> at your
disposal. If you need to go through a proxy, export the <c>http_proxy</c> and
<c>ftp_proxy</c> variables:
</p>
<pre caption="Setting proxy information for lynx">
# <i>export http_proxy="http://proxy.server.com:port"</i>
# <i>export ftp_proxy="http://proxy.server.com:port"</i>
</pre>
<p>
We will now assume that you have <c>links2</c> at your disposal.
</p>
<p>
Pick the <path>releases/</path> directory, followed by your architecture (for
instance <path>x86/</path>) and the Gentoo version (<path>2006.0/</path>) to
finish up with the <path>stages/</path> directory. There you should see all
available stage files for your architecture (they might be stored within
subdirectories named to the individual sub architectures). Select one and press
<c>D</c> to download. When you're finished, press <c>Q</c> to quit the browser.
</p>
<pre caption="Surfing to the mirror listing with links2">
# <i>links2 http://www.gentoo.org/main/en/mirrors.xml</i>
<comment>(If you need proxy support with links2:)</comment>
# <i>links2 -http-proxy proxy.server.com:8080 http://www.gentoo.org/main/en/mirrors.xml</i>
</pre>
<p>
Make sure you download a stage3 tarball - installations using a stage1 or stage2
tarball are not supported anymore.
</p>
<p>
If you want to check the integrity of the downloaded stage tarball, use
<c>md5sum</c> and compare the output with the MD5 checksum provided on the
mirror. For instance, to check the validity of the x86 stage tarball:
</p>
<pre caption="Example checking integrity of a stage tarball">
# <i>md5sum -c stage3-x86-2006.0.tar.bz2.md5</i>
stage3-x86-2006.0.tar.bz2: OK
</pre>
</body>
</subsection>
<subsection>
<title>Unpacking the Stage Tarball</title>
<body>
<p>
Now unpack your downloaded stage onto your system. We use <c>tar</c> to proceed
as it is the easiest method:
</p>
<pre caption="Unpacking the stage">
# <i>tar xvjpf stage3-*.tar.bz2</i>
</pre>
<p>
Make sure that you use the same options (<c>xvjpf</c>). The <c>x</c> stands
for <e>Extract</e>, the <c>v</c> for <e>Verbose</e> to see what happens during
the extraction process (this one is optional), the <c>j</c> for <e>Decompress
with bzip2</e>, the <c>p</c> for <e>Preserve permissions</e> and the <c>f</c>
to denote that we want to extract a file, not standard input.
</p>
<p>
Now that the stage is installed, continue with <uri
link="#installing_portage">Installing Portage</uri>.
</p>
</body>
</subsection>
</section>
<section id="installing_portage">
<title>Installing Portage</title>
<subsection>
<title>Unpacking a Portage Snapshot</title>
<body>
<p>
You now have to install a Portage snapshot, a collection of files that inform
Portage what software titles you can install, which profiles are available, etc.
</p>
</body>
</subsection>
<subsection id="installing_from_InstallCD">
<title>Unpack the Snapshot from the Installation CD</title>
<body>
<p>
To install the snapshot, take a look inside <path>/mnt/cdrom/snapshots/</path>
to see what snapshot is available:
</p>
<pre caption="Checking the /mnt/cdrom/snapshots content">
# <i>ls /mnt/cdrom/snapshots</i>
</pre>
<p>
Now extract the snapshot using the following construct. Again, make sure you
use the correct options with <c>tar</c>. Also, the <c>-C</c> is with a capital
<c>C</c>, not <c>c</c>. In the next example we use
<path>portage-<date>.tar.bz2</path> as the snapshot filename. Be sure to
substitute with the name of the snapshot that is on your Installation CD.
</p>
<pre caption="Extracting a Portage snapshot">
# <i>tar xvjf /mnt/cdrom/snapshots/portage-<date>.tar.bz2 -C /mnt/gentoo/usr</i>
</pre>
</body>
</subsection>
<subsection id="copysources">
<title>Copy Source Code Archives</title>
<body>
<p>
You also need to copy over all source code from the Universal Installation CD.
</p>
<pre caption="Copy over source code">
# <i>mkdir /mnt/gentoo/usr/portage/distfiles</i>
# <i>cp /mnt/cdrom/distfiles/* /mnt/gentoo/usr/portage/distfiles/</i>
</pre>
</body>
</subsection>
</section>
<section id="compile_options">
<title>Configuring the Compile Options</title>
<subsection>
<title>Introduction</title>
<body>
<p>
To optimize Gentoo, you can set a couple of variables which impact Portage
behaviour. All those variables can be set as environment variables (using
<c>export</c>) but that isn't permanent. To keep your settings, Portage provides
you with <path>/etc/make.conf</path>, a configuration file for Portage. It is
this file we will edit now.
</p>
<note>
A commented listing of all possible variables can be found in
<path>/mnt/gentoo/etc/make.conf.example</path>. For a successful Gentoo
installation you'll only need to set the variables which are mentioned beneath.
</note>
<p>
Fire up your favorite editor (in this guide we use <c>nano</c>) so we can alter
the optimization variables we will discuss hereafter.
</p>
<pre caption="Opening /etc/make.conf">
# <i>nano -w /mnt/gentoo/etc/make.conf</i>
</pre>
<p>
As you probably noticed, the <path>make.conf.example</path> file is
structured in a generic way: commented lines start with "#", other lines define
variables using the <c>VARIABLE="content"</c> syntax. The <path>make.conf</path>
file uses the same syntax. Several of those variables are discussed next.
</p>
<warn>
Do not make any modifications to the USE variable if you are performing a stage3
with GRP installation. You can alter the USE variable after having installed the
packages you want. Gremlins are known to attack your system if you ignore this
warning!
</warn>
</body>
</subsection>
<subsection>
<title>CHOST</title>
<body>
<p>
The <c>CHOST</c> variable declares the target build host for your system. This
variable should already be set to the correct value. <brite>Do not edit
it</brite> as that might break your system. If the <c>CHOST</c> variable does
not look correct to you, you might be using the wrong stage3 tarball.
</p>
</body>
</subsection>
<subsection>
<title>CFLAGS and CXXFLAGS</title>
<body>
<p>
The <c>CFLAGS</c> and <c>CXXFLAGS</c> variables define the optimization flags
for the <c>gcc</c> C and C++ compiler respectively. Although we define those
generally here, you will only have maximum performance if you optimize these
flags for each program separately. The reason for this is because every program
is different.
</p>
<p>
In <path>make.conf</path> you should define the optimization flags you think
will make your system the most responsive <e>generally</e>. Don't place
experimental settings in this variable; too much optimization can make
programs behave bad (crash, or even worse, malfunction).
</p>
<p>
We will not explain all possible optimization options. If you want to know
them all, read the <uri link="http://gcc.gnu.org/onlinedocs/">GNU
Online Manual(s)</uri> or the <c>gcc</c> info page (<c>info gcc</c> -- only
works on a working Linux system). The <path>make.conf.example</path> file
itself also contains lots of examples and information; don't forget to read it
too.
</p>
<p>
A first setting is the <c>-march=</c> flag, which specifies the name of the
target architecture. Possible options are described in the
<path>make.conf.example</path> file (as comments). For instance, for the x86
Athlon XP architecture:
</p>
<pre caption="The GCC march setting">
<comment># AMD64 users who want to use a native 64 bit system should use -march=k8</comment>
<comment># EM64T users should use -march=nocona</comment>
-march=athlon-xp
</pre>
<p>
A second one is the <c>-O</c> flag (that is a capital O, not a zero),
which specifies the <c>gcc</c> optimization
class flag. Possible classes are <c>s</c> (for size-optimized),
<c>0</c> (zero - for no optimizations), <c>1</c>, <c>2</c> or <c>3</c> for more
speed-optimization flags (every class has the same flags as the one before, plus
some extras). For instance, for a class-2 optimization:
</p>
<pre caption="The GCC O setting">
-O2
</pre>
<p>
Another popular optimization flag is <c>-pipe</c> (use pipes rather than
temporary files for communication between the various stages of compilation).
</p>
<p>
Mind you that using <c>-fomit-frame-pointer</c> (which doesn't keep the frame
pointer in a register for functions that don't need one) might have serious
repercussions on the debugging of applications!
</p>
<p>
When you define the <c>CFLAGS</c> and <c>CXXFLAGS</c>, you should combine
several optimization flags, like in the following example:
</p>
<pre caption="Defining the CFLAGS and CXXFLAGS variable">
CFLAGS="-march=athlon-xp -pipe -O2" <comment># AMD64 users use march=k8</comment>
<comment># EM64T users use march=nocona</comment>
CXXFLAGS="${CFLAGS}" <comment># Use the same settings for both variables</comment>
</pre>
</body>
</subsection>
<subsection>
<title>MAKEOPTS</title>
<body>
<p>
With <c>MAKEOPTS</c> you define how many parallel compilations should occur when
you install a package. A good choice is the number of CPUs in your system plus
one, but this guideline isn't always perfect.
</p>
<pre caption="MAKEOPTS for a regular, 1-CPU system">
MAKEOPTS="-j2"
</pre>
</body>
</subsection>
<subsection>
<title>Ready, Set, Go!</title>
<body>
<p>
Update your <path>/mnt/gentoo/etc/make.conf</path> to your own preference and
save (<c>nano</c> users would hit <c>Ctrl-X</c>). You are now ready to continue
with <uri link="?part=1&chap=6">Chrooting into the Gentoo Base System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-system.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-system.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-system.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-system.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-system.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2006-01-19</date>
<section>
<title>Chrooting</title>
<subsection>
<title>Mounting the /proc and /dev Filesystems</title>
<body>
<p>
Mount the <path>/proc</path> filesystem on <path>/mnt/gentoo/proc</path> to
allow the installation to use the kernel-provided information within the
chrooted environment, and then mount-bind the <path>/dev</path> filesystem.
</p>
<pre caption="Mounting /proc and /dev">
# <i>mount -t proc none /mnt/gentoo/proc</i>
# <i>mount -o bind /dev /mnt/gentoo/dev</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Copy over DNS Information</title>
<body>
<p>
If you configured your network to fetch the appropriate stage file later on from
the Internet, you need to copy over the DNS information stored in
<path>/etc/resolv.conf</path> to <path>/mnt/gentoo/etc/resolv.conf</path>. This
file contains the nameservers your system will use to resolve names to IP
addresses.
</p>
<pre caption="Copy over DNS Information">
# <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i>
</pre>
</body>
</subsection>
<subsection>
<title>Entering the new Environment</title>
<body>
<p>
Now that all partitions are initialized and the base environment
installed, it is time to enter our new installation environment by
<e>chrooting</e> into it. This means that we change from the current
installation environment to your installation system (namely the
initialized partitions).
</p>
<p>
This chrooting is done in three steps. First we will change the root
from <path>/</path> (on the installation medium) to <path>/mnt/gentoo</path>
(on your partitions) using <c>chroot</c>. Then we will create a new environment
using <c>env-update</c>, which essentially creates environment variables.
Finally, we load those variables into memory using <c>source</c>.
</p>
<pre caption="Chrooting into the new environment">
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>env-update</i>
* Caching service dependencies...
# <i>source /etc/profile</i>
# <i>export PS1="(chroot) $PS1"</i>
</pre>
<p>
Congratulations! You are now inside your own Gentoo Linux environment.
Of course it is far from finished, which is why the installation still
has some sections left :-)
</p>
</body>
</subsection>
<subsection>
<title>Creating the Portage cache</title>
<body>
<p>
You have already installed the Portage tree, but you should now build the
Portage cache to speed up future emerges. <c>emerge --metadata</c> does this
for you.
</p>
<pre caption="Creating the Portage cache">
# <i>emerge --metadata</i>
</pre>
</body>
</subsection>
</section>
<section id="configure_USE">
<title>Configuring the USE Variable</title>
<subsection>
<title>What is the USE Variable?</title>
<body>
<p>
<c>USE</c> is one of the most powerful variables Gentoo provides to its users.
Several programs can be compiled with or without optional support for certain
items. For instance, some programs can be compiled with gtk-support, or with
qt-support. Others can be compiled with or without SSL support. Some programs
can even be compiled with framebuffer support (svgalib) instead of X11 support
(X-server).
</p>
<p>
Most distributions compile their packages with support for as much as possible,
increasing the size of the programs and startup time, not to mention an enormous
amount of dependencies. With Gentoo you can define what options a package
should be compiled with. This is where <c>USE</c> comes into play.
</p>
<p>
In the <c>USE</c> variable you define keywords which are mapped onto
compile-options. For instance, <e>ssl</e> will compile ssl-support in the
programs that support it. <e>-X</e> will remove X-server support (note the minus
sign in front). <e>gnome gtk -kde -qt</e> will compile your programs with gnome
(and gtk) support, and not with kde (and qt) support, making your system fully
tweaked for GNOME.
</p>
</body>
</subsection>
<subsection>
<title>Modifying the USE Variable</title>
<body>
<warn>
Do not make any modifications to the USE variable yet if you plan to use our
prebuilt packages (GRP set). You can alter the USE variable after having
installed the packages you want. Gremlins are known to attack your system
if you ignore this warning!
</warn>
<p>
The default <c>USE</c> settings are placed in
<path>/etc/make.profile/make.defaults</path>. What you place in
<path>/etc/make.conf</path> is calculated against these defaults settings. If
you add something to the <c>USE</c> setting, it is added to the default list. If
you remove something from the <c>USE</c> setting (by placing a minus sign in
front of it) it is removed from the default list (if it was in the default list
at all). <e>Never</e> alter anything inside the <path>/etc/make.profile</path>
directory; it gets overwritten when you update Portage!
</p>
<p>
A full description on <c>USE</c> can be found in the second part of the Gentoo
Handbook, <uri link="?part=2&chap=2">USE flags</uri>. A full description on
the available USE flags can be found on your system in
<path>/usr/portage/profiles/use.desc</path>.
</p>
<pre caption="Viewing available USE flags">
# <i>less /usr/portage/profiles/use.desc</i>
<comment>(You can scroll using your arrow keys, exit by pressing 'q')</comment>
</pre>
<p>
As an example we show a <c>USE</c> setting for a KDE-based system with DVD, ALSA
and CD Recording support:
</p>
<pre caption="Opening /etc/make.conf">
# <i>nano -w /etc/make.conf</i>
</pre>
<pre caption="USE setting">
USE="-gtk -gnome qt kde dvd alsa cdr"
</pre>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-tools.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-tools.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-tools.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-tools.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-tools.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2005-11-21</date>
<section>
<title>System Logger</title>
<body>
<p>
Some tools are missing from the <e>stage3</e> archive because several packages
provide the same functionality. It is now up to you to choose which ones you
want to install.
</p>
<p>
The first tool you need to decide on has to provide logging facilities for your
system. Unix and Linux have an excellent history of logging capabilities -- if
you want you can log everything that happens on your system in logfiles. This
happens through the <e>system logger</e>.
</p>
<p>
Gentoo offers several system loggers to choose from. There are <c>sysklogd</c>,
which is the traditional set of system logging daemons, <c>syslog-ng</c>, an
advanced system logger, and <c>metalog</c> which is a highly-configurable
system logger. Others might be available through Portage as well - our number of
available packages increases on a daily basis.
</p>
<p>
If you plan on using <c>sysklogd</c> or <c>syslog-ng</c> you might want to
install <c>logrotate</c> afterwards as those system loggers don't provide any
rotation mechanism for the log files.
</p>
<!--
Even though syslog-ng does not rotate the logs, it does conform to the syslog
RFC (http://www.faqs.org/rfcs/rfc3164.html) and is far more powerful than most other system loggers. That and some architectures really prefer syslog-ng
above others (metalog for instance doesn't work nicely with sparc all the
time).
-->
<p>
To install the system logger of your choice, <c>emerge</c> it and have it added
to the default runlevel using <c>rc-update</c>. The following example installs
<c>syslog-ng</c>. Of course substitute with your system logger:
</p>
<pre caption="Installing a system logger">
# <i>emerge syslog-ng</i>
# <i>rc-update add syslog-ng default</i>
</pre>
</body>
</section>
<section>
<title>Optional: Cron Daemon</title>
<body>
<p>
Next is the cron daemon. Although it is optional and not required for your
system, it is wise to install one. But what is a cron daemon? A cron daemon
executes scheduled commands. It is very handy if you need to execute some
command regularly (for instance daily, weekly or monthly).
</p>
<p>
We only provide <c>vixie-cron</c> for networkless installations. If you want
another cron daemon you can wait and install it later on.
</p>
<pre caption="Installing a cron daemon">
# <i>emerge vixie-cron</i>
# <i>rc-update add vixie-cron default</i>
</pre>
</body>
</section>
<section>
<title>Optional: File Indexing</title>
<body>
<p>
If you want to index your system's files so you are able to quickly
locate them using the <c>locate</c> tool, you need to install
<c>sys-apps/slocate</c>.
</p>
<pre caption="Installing slocate">
# <i>emerge slocate</i>
</pre>
</body>
</section>
<section>
<title>File System Tools</title>
<body>
<p>
Depending on what file systems you are using, you need to install the necessary
file system utilities (for checking the filesystem integrity, creating
additional file systems etc.).
</p>
<p>
The following table lists the tools you need to install if you use a certain
file system. Not all filesystems are available for each and every architecture
though.
</p>
<table>
<tr>
<th>File System</th>
<th>Tool</th>
<th>Install Command</th>
</tr>
<tr>
<ti>XFS</ti>
<ti>xfsprogs</ti>
<ti><c>emerge xfsprogs</c></ti>
</tr>
<tr>
<ti>ReiserFS</ti>
<ti>reiserfsprogs</ti>
<ti><c>emerge reiserfsprogs</c></ti>
</tr>
<tr>
<ti>JFS</ti>
<ti>jfsutils</ti>
<ti><c>emerge jfsutils</c></ti>
</tr>
</table>
<p>
If you are an EVMS user, you need to install <c>emvs</c>:
</p>
<pre caption="Installing EVMS utilities">
# <i>USE="-gtk" emerge evms</i>
</pre>
<p>
The <c>USE="-gtk"</c> will prevent the installation of dependencies. If you
want to enable the <c>evms</c> graphical tools, you can recompile <c>evms</c>
later on.
</p>
<p>
If you don't require any additional networking-related tools (such as rp-pppoe
or a dhcp client) continue with <uri link="?part=1&chap=10">Configuring the
Bootloader</uri>.
</p>
</body>
</section>
<section>
<title>Networking Tools</title>
<subsection>
<title>Optional: Installing a DHCP Client</title>
<body>
<p>
If you require Gentoo to automatically obtain an IP address for your network
interface(s), you need to install <c>dhcpcd</c> (or any other DHCP Client)
on your system. If you don't do this now, you might not be able to connect
to the internet after the installation!
</p>
<pre caption="Installing dhcpcd">
# <i>emerge dhcpcd</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Installing a PPPoE Client</title>
<body>
<p>
If you need <c>rp-pppoe</c> to connect to the net, you need to install it.
</p>
<pre caption="Installing rp-pppoe">
# <i>USE="-X" emerge rp-pppoe</i>
</pre>
<p>
The <c>USE="-X"</c> will prohibit xorg-x11 to be installed as a dependency
(<c>rp-pppoe</c> has graphical tools; if you want those enabled, you can
recompile <c>rp-pppoe</c> later on or have xorg-x11 installed now -- which takes a
long time to compile).
</p>
<p>
Now continue with <uri link="?part=1&chap=10">Configuring the
Bootloader</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-bootloader.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.4</version>
<date>2006-01-19</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>. For x86, Gentoo Linux provides <uri
link="#grub">GRUB</uri> and <uri link="#lilo">LILO</uri>. But before we
install one of these two bootloaders, we inform you how to configure framebuffer
(assuming you want it of course). With framebuffer you can run the Linux command
line with (limited) graphical features (such as using the nice bootsplash
image Gentoo provides).
</p>
</body>
</subsection>
<subsection>
<title>Optional: Framebuffer</title>
<body>
<p>
<e>If</e> you have configured your kernel with framebuffer support (or you used
<c>genkernel</c>'s default kernel configuration), you can activate it by adding
a <c>vga</c> and/or a <c>video</c> statement to your bootloader configuration
file.
</p>
<p>
First of all you need to know what type of framebuffer device you're using. If
you use a Gentoo patched kernel tree (such as <c>gentoo-sources</c>) you will
have had the possibility of selecting <c>vesafb-tng</c> as the <e>VESA driver
type</e> (which is default for these kernel sources). If this is the case, you
are using <c>vesafb-tng</c> and do not need to set a <c>vga</c> statement.
Otherwise you are using the <c>vesafb</c> driver and need to set the <c>vga</c>
statement.
</p>
<p>
The <c>vga</c> statement controls the resolution and color depth of your
framebuffer screen for <c>vesafb</c>. As stated in
<path>/usr/src/linux/Documentation/fb/vesafb.txt</path> (which gets installed
when you install a kernel source package), you need to pass the VESA number
corresponding to the requested resolution and color depth to it.
</p>
<p>
The following table lists the available resolutions and colordepths and matches
those against the value that you need to pass on to the <c>vga</c> statement.
</p>
<table>
<tr>
<ti></ti>
<th>640x480</th>
<th>800x600</th>
<th>1024x768</th>
<th>1280x1024</th>
</tr>
<tr>
<th>256</th>
<ti>0x301</ti>
<ti>0x303</ti>
<ti>0x305</ti>
<ti>0x307</ti>
</tr>
<tr>
<th>32k</th>
<ti>0x310</ti>
<ti>0x313</ti>
<ti>0x316</ti>
<ti>0x319</ti>
</tr>
<tr>
<th>64k</th>
<ti>0x311</ti>
<ti>0x314</ti>
<ti>0x317</ti>
<ti>0x31A</ti>
</tr>
<tr>
<th>16M</th>
<ti>0x312</ti>
<ti>0x315</ti>
<ti>0x318</ti>
<ti>0x31B</ti>
</tr>
</table>
<p>
The <c>video</c> statement controls framebuffer display options. It needs to be
given the framebuffer driver (<c>vesafb</c> for 2.6 kernels, or <c>vesa</c> for
2.4 kernels) followed by the control statements you wish to enable. All
variables are listed in <path>/usr/src/linux/Documentation/fb/vesafb.txt</path>,
but we'll inform you about three most-used options:
</p>
<table>
<tr>
<th>Control</th>
<th>Description</th>
</tr>
<tr>
<ti>ywrap</ti>
<ti>
Assume that the graphical card can wrap around its memory (i.e. continue at
the beginning when it has approached the end)
</ti>
</tr>
<tr>
<ti>mtrr</ti>
<ti>
Setup MTRR registers
</ti>
</tr>
<tr>
<ti><c>mode</c></ti>
<ti>
(<c>vesafb-tng</c> only)<br/>
Set up the resolution, color depth and refresh rate. For instance,
<c>1024x768-32@85</c> for a resolution of 1024x768, 32 bit color depth and a
refresh rate of 85 Hz.
</ti>
</tr>
</table>
<p>
The result of those two statements could be something like <c>vga=0x318
video=vesafb:mtrr,ywrap</c> or <c>video=vesafb:mtrr,ywrap,1024x768-32@85</c>.
Remember (or write down) this setting; you will need it shortly.
</p>
<p>
Now continue by installing <uri link="#grub">GRUB</uri> <e>or</e> <uri
link="#lilo">LILO</uri>.
</p>
</body>
</subsection>
</section>
<section id="grub">
<title>Default: Using GRUB</title>
<subsection>
<title>Understanding GRUB's terminology</title>
<body>
<p>
The most critical part of understanding GRUB is getting comfortable with
how GRUB refers to hard drives and partitions. Your Linux partition
<path>/dev/hda1</path> will most likely be called <path>(hd0,0)</path> under
GRUB. Notice the parenthesis around the <path>hd0,0</path> - they are required.
</p>
<p>
Hard drives count from zero rather than "a" and partitions start at zero
rather than one. Be aware too that with the hd devices, only hard drives are
counted, not atapi-ide devices such as cdrom players and burners. Also, the
same construct is used with SCSI drives. (Normally they get higher numbers
than IDE drives except when the BIOS is configured to boot from SCSI devices.)
When you ask the BIOS to boot from a different hard disk (for instance your
primary slave), <e>that</e> harddisk is seen as <path>hd0</path>.
</p>
<p>
Assuming you have a hard drive on <path>/dev/hda</path>, a cdrom player on
<path>/dev/hdb</path>, a burner on <path>/dev/hdc</path>, a second hard drive
on <path>/dev/hdd</path> and no SCSI hard drive, <path>/dev/hdd7</path> gets
translated to <path>(hd1,6)</path>. It might sound tricky and tricky it is
indeed, but as we will see, GRUB offers a tab completion mechanism
that comes handy for those of you having a lot of hard drives and
partitions and who are a little lost in the GRUB numbering scheme.
</p>
<p>
Having gotten the feel for that, it is time to install GRUB.
</p>
</body>
</subsection>
<subsection>
<title>Installing GRUB</title>
<body>
<p>
To install GRUB, let's first emerge it:
</p>
<pre caption="Installing GRUB">
# <i>emerge grub</i>
</pre>
<p>
Although GRUB is now installed, we still need to write up a
configuration file for it and place GRUB in our MBR so that GRUB automatically
boots your newly created kernel. Create <path>/boot/grub/grub.conf</path> with
<c>nano</c> (or, if applicable, another editor):
</p>
<pre caption="Creating /boot/grub/grub.conf">
# <i>nano -w /boot/grub/grub.conf</i>
</pre>
<p>
Now we are going to write up a <path>grub.conf</path>. Below you'll
find two possible <path>grub.conf</path> for the partitioning example we use
in this guide. We've
only extensively commented the first <path>grub.conf</path>. Make sure you use
<e>your</e> kernel image filename and, if appropriate, <e>your</e> initrd image
filename.
</p>
<ul>
<li>
The first <path>grub.conf</path> is for people who have not used
<c>genkernel</c> to build their kernel
</li>
<li>
The second <path>grub.conf</path> is for people who have used
<c>genkernel</c> to build their kernel
</li>
</ul>
<note>
If your root filesystem is JFS, you <e>must</e> add " ro" to the <c>kernel</c>
line since JFS needs to replay its log before it allows read-write mounting.
</note>
<pre caption="grub.conf for non-genkernel users">
<comment># Which listing to boot as default. 0 is the first, 1 the second etc.</comment>
default 0
<comment># How many seconds to wait before the default listing is booted.</comment>
timeout 30
<comment># Nice, fat splash-image to spice things up :)
# Comment out if you don't have a graphics card installed</comment>
splashimage=(hd0,0)/boot/grub/splash.xpm.gz
title=Gentoo Linux 2.6.12-r10
<comment># Partition where the kernel image (or operating system) is located</comment>
root (hd0,0)
kernel /boot/kernel-2.6.12-gentoo-r10 root=/dev/hda3
<comment># The next four lines are only if you dualboot with a Windows system.</comment>
<comment># In this case, Windows is hosted on /dev/hda6.</comment>
title=Windows XP
rootnoverify (hd0,5)
makeactive
chainloader +1
</pre>
<pre caption="grub.conf for genkernel users">
default 0
timeout 30
splashimage=(hd0,0)/boot/grub/splash.xpm.gz
title=Gentoo Linux 2.6.12-r10
root (hd0,0)
kernel /boot/kernel-genkernel-x86-2.6.12-gentoo-r10 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
initrd /boot/initramfs-genkernel-x86-2.6.12-gentoo-r10
<comment># Only in case you want to dual-boot</comment>
title=Windows XP
root (hd0,5)
makeactive
chainloader +1
</pre>
<p>
If you used a different partitioning scheme and/or kernel image, adjust
accordingly. However, make sure that anything that follows a GRUB-device (such
as <path>(hd0,0)</path>) is relative to the mountpoint, not the root. In other
words, <path>(hd0,0)/grub/splash.xpm.gz</path> is in reality
<path>/boot/grub/splash.xpm.gz</path> since <path>(hd0,0)</path> is
<path>/boot</path>.
</p>
<p>
Besides, if you chose to use a different partitioning scheme and did not put
<path>/boot</path> in a separate partition, the <path>/boot</path> prefix used
in the above code samples is really <e>required</e>. If you followed our
suggested partitioning plan, the <path>/boot</path> prefix it not required, but
a <path>boot</path> symlink makes it work. In short, the above examples should
work whether you defined a separate <path>/boot</path> partition or not.
</p>
<p>
If you need to pass any additional options to the kernel, simply add
them to the end of the kernel command. We're already passing one option
(<c>root=/dev/hda3</c> or <c>real_root=/dev/hda3</c>), but you can pass others
as well, such as the <c>video</c> and/or <c>vga</c> statements for framebuffer
as we discussed previously.
</p>
<p>
If you're using a 2.6.7 or higher kernel and you jumpered your harddrive
because the BIOS can't handle large harddrives you'll need to append
<c>hdx=stroke</c>.
</p>
<p>
<c>genkernel</c> users should know that their kernels use the same boot options
as is used for the Installation CD. For instance, if you have SCSI devices, you
should add <c>doscsi</c> as kernel option.
</p>
<p>
Now save the <path>grub.conf</path> file and exit. You still need to install
GRUB in the MBR (Master Boot Record) so that GRUB is automatically executed when
you boot your system.
</p>
<p>
The GRUB developers recommend the use of <c>grub-install</c>. However, if for
some reason <c>grub-install</c> fails to work correctly you still have the
option to manually install GRUB.
</p>
<p>
Continue with <uri link="#grub-install-auto">Default: Setting up GRUB using
grub-install</uri> or <uri link="#grub-install-manual">Alternative: Setting up
GRUB using manual instructions</uri>.
</p>
</body>
</subsection>
<subsection id="grub-install-auto">
<title>Default: Setting up GRUB using grub-install</title>
<body>
<p>
To install GRUB you will need to issue the <c>grub-install</c> command.
However, <c>grub-install</c> won't work off-the-shelf since we are inside a
chrooted environment. We need to create <path>/etc/mtab</path> which lists all
mounted filesystems. Fortunately, there is an easy way to accomplish this -
just copy over <path>/proc/mounts</path> to <path>/etc/mtab</path>, excluding
the <c>rootfs</c> line if you haven't created a separate boot partition. The
following command will work in both cases:
</p>
<pre caption="Creating /etc/mtab">
# <i>grep -v rootfs /proc/mounts > /etc/mtab</i>
</pre>
<p>
Now we can install GRUB using <c>grub-install</c>:
</p>
<pre caption="Running grub-install">
# <i>grub-install /dev/hda</i>
</pre>
<p>
If you have more questions regarding GRUB, please consult the <uri
link="http://www.gnu.org/software/grub/grub-faq.html">GRUB FAQ</uri> or the <uri
link="http://www.gnu.org/software/grub/manual/">GRUB Manual</uri>.
</p>
<p>
Continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
<subsection id="grub-install-manual">
<title>Alternative: Setting up GRUB using manual instructions</title>
<body>
<p>
To start configuring GRUB, you type in <c>grub</c>. You'll be presented
with the <path>grub></path> grub command-line prompt. Now, you need to type
in the right commands to install the GRUB boot record onto your hard drive.
</p>
<pre caption =" Starting the GRUB shell">
# <i>grub</i>
</pre>
<note>
If your system does not have any floppy drives, add the <c>--no-floppy</c>
option to the above command to prevent grub from probing the (non-existing)
floppy drives.
</note>
<p>
In the example configuration we want to install GRUB so that it reads its
information from the boot-partition <path>/dev/hda1</path>, and installs the
GRUB boot record on the hard drive's MBR (master boot record) so that the first
thing we see when we turn on the computer is the GRUB prompt. Of course, if you
haven't followed the example configuration during the installation,
change the commands accordingly.
</p>
<p>
The tab completion mechanism of GRUB can be used from within GRUB.
For instance, if you type in "<c>root (</c>" followed by a TAB, you will
be presented with a list of devices (such as <path>hd0</path>). If you
type in "<c>root (hd0,</c>" followed by a TAB, you will receive a list
of available partitions to choose from (such as <path>hd0,0</path>).
</p>
<p>
By using the tab completion, setting up GRUB should be not that hard.
Now go on, configure GRUB, shall we? :-)
</p>
<pre caption =" Installing GRUB in the MBR">
grub> <i>root (hd0,0)</i> <comment>(Specify where your /boot partition resides)</comment>
grub> <i>setup (hd0)</i> <comment>(Install GRUB in the MBR)</comment>
grub> <i>quit</i> <comment>(Exit the GRUB shell)</comment>
</pre>
<note>
If you want to install GRUB in a certain partition instead of the MBR,
you have to alter the <c>setup</c> command so it points to the right
partition. For instance, if you want GRUB installed in
<path>/dev/hda3</path>, then the command becomes <c>setup (hd0,2)</c>.
Few users however want to do this.
</note>
<p>
If you have more questions regarding GRUB, please consult the <uri
link="http://www.gnu.org/software/grub/grub-faq.html">GRUB FAQ</uri> or the <uri
link="http://www.gnu.org/software/grub/manual/">GRUB Manual</uri>.
</p>
<note>
When you reinstall a kernel, you do not need to copy over the files anymore.
Just run <c>make install</c> after compiling the kernel; it will automatically
copy the necessary files and adjust the GRUB configuration.
</note>
<p>
Continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
</section>
<section id="lilo">
<title>Alternative: Using LILO</title>
<subsection>
<title>Installing LILO</title>
<body>
<p>
LILO, the LInuxLOader, is the tried and true workhorse of Linux
bootloaders. However, it lacks some features that GRUB has (which is
also the reason why GRUB is currently gaining popularity). The reason
why LILO is still used is that, on some systems, GRUB doesn't work and
LILO does. Of course, it is also used because some people know LILO and
want to stick with it. Either way, Gentoo supports both, and apparently
you have chosen to use LILO.
</p>
<p>
Installing LILO is a breeze; just use <c>emerge</c>.
</p>
<pre caption = "Installing LILO">
# <i>emerge lilo</i>
</pre>
</body>
</subsection>
<subsection>
<title>Configuring LILO</title>
<body>
<p>
To configure LILO, you must create <path>/etc/lilo.conf</path>. Fire up
your favorite editor (in this handbook we use <c>nano</c> for
consistency) and create the file.
</p>
<pre caption = "Creating /etc/lilo.conf">
# <i>nano -w /etc/lilo.conf</i>
</pre>
<p>
Some sections ago we have asked you to remember the kernel-image name
you have created. In the next example <path>lilo.conf</path> we also use the
example partitioning scheme. There are two separate parts:
</p>
<ul>
<li>
One for those who have not used <c>genkernel</c> to build their kernel
</li>
<li>
One for those who have used <c>genkernel</c> to build their kernel
</li>
</ul>
<p>
Make sure you use <e>your</e> kernel image filename and, if appropriate,
<e>your</e> initrd image filename.
</p>
<note>
If your root filesystem is JFS, you <e>must</e> add an <c>append="ro"</c> line
to each boot image since JFS needs to replay its log before it allows
read-write mounting.
</note>
<pre caption="Example /etc/lilo.conf">
boot=/dev/hda <comment># Install LILO in the MBR</comment>
prompt <comment># Give the user the chance to select another section</comment>
timeout=50 <comment># Wait 5 (five) seconds before booting the default section</comment>
default=gentoo <comment># When the timeout has passed, boot the "gentoo" section</comment>
<comment># For non-genkernel users</comment>
image=/boot/kernel-2.6.12-gentoo-r10
label=gentoo <comment># Name we give to this section</comment>
read-only <comment># Start with a read-only root. Do not alter!</comment>
root=/dev/hda3 <comment># Location of the root filesystem</comment>
<comment># For genkernel users</comment>
image=/boot/kernel-genkernel-x86-2.6.12-gentoo-r10
label=gentoo
read-only
root=/dev/ram0
append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev"
initrd=/boot/initramfs-genkernel-x86-2.6.12-gentoo-r10
<comment># The next two lines are only if you dualboot with a Windows system.</comment>
<comment># In this case, Windows is hosted on /dev/hda6.</comment>
other=/dev/hda6
label=windows
</pre>
<note>
If you use a different partitioning scheme and/or kernel image, adjust
accordingly.
</note>
<p>
If you need to pass any additional options to the kernel, add an
<c>append</c> statement to the section. As an example, we add the
<c>video</c> statement to enable framebuffer:
</p>
<pre caption="Using append to add kernel options">
image=/boot/kernel-2.6.12-gentoo-r10
label=gentoo
read-only
root=/dev/hda3
<i>append="video=vesafb:mtrr,ywrap,1024x768-32@85"</i>
</pre>
<p>
If you're using a 2.6.7 or higher kernel and you jumpered your harddrive
because the BIOS can't handle large harddrives you'll need to append
<c>hdx=stroke</c>.
</p>
<p>
<c>genkernel</c> users should know that their kernels use the same boot options
as is used for the Installation CD. For instance, if you have SCSI devices, you
should add <c>doscsi</c> as kernel option.
</p>
<p>
Now save the file and exit. To finish up, you have to run <c>/sbin/lilo</c> so
LILO can apply the <path>/etc/lilo.conf</path> to your system (i.e. install
itself on the disk). Keep in mind that you'll also have to rerun
<c>/sbin/lilo</c> every time you install a new kernel or make any changes to
the menu.
</p>
<pre caption = "Finishing the LILO installation">
# <i>/sbin/lilo</i>
</pre>
<note>
When you reinstall a kernel, you do not need to copy over the files anymore.
Just run <c>make install</c> after compiling the kernel; it will automatically
copy the necessary files and adjust the LILO configuration.
</note>
<p>
You can now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-x86-disk.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2006-01-01</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI or SATA drives, then your
first hard drive would be <path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On x86 systems,
these are called <e>partitions</e>.
</p>
<p>
Partitions are divided in three types:
<e>primary</e>, <e>extended</e> and <e>logical</e>.
</p>
<p>
A <e>primary</e> partition is a partition which has its information stored in
the MBR (master boot record). As an MBR is very small (512 bytes) only four
primary partitions can be defined (for instance, <path>/dev/hda1</path> to
<path>/dev/hda4</path>).
</p>
<p>
An <e>extended</e> partition is a special primary partition (meaning the
extended partition must be one of the four possible primary partitions) which
contains more partitions. Such a partition didn't exist originally, but as
four partitions were too few, it was brought to life to extend the formatting
scheme without losing backward compatibility.
</p>
<p>
A <e>logical</e> partition is a partition inside the extended partition. Their
definitions aren't placed inside the MBR, but are declared inside the extended
partition.
</p>
</body>
</subsection>
<subsection>
<title>Advanced Storage</title>
<body>
<p>
The x86 Installation CDs provide support for EVMS and LVM2. EVMS and LVM2
increase the flexibility offered by your partitioning setup. During the
installation instructions, we will focus on "regular" partitions, but it is
still good to know EVMS and LVM2 are supported as well.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>ext2</ti>
<ti>32M</ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>ext3</ti>
<ti>Rest of the disk</ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
If you are interested in knowing how big a partition should be, or even how
many partitions you need, read on. Otherwise continue now with partitioning
your disk by reading <uri link="#fdisk">Using fdisk to Partition your
Disk</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
<p>
As an example partitioning, we show you one for a 20GB disk, used as a
demonstration laptop (containing webserver, mailserver, gnome, ...):
</p>
<pre caption="Filesystem usage example">
Filesystem Type Size Used Avail Use% Mounted on
/dev/hda5 ext3 509M 132M 351M 28% /
/dev/hda2 ext3 5.0G 3.0G 1.8G 63% /home
/dev/hda7 ext3 7.9G 6.2G 1.3G 83% /usr
/dev/hda8 ext3 1011M 483M 477M 51% /opt
/dev/hda9 ext3 2.0G 607M 1.3G 32% /var
/dev/hda1 ext2 51M 17M 31M 36% /boot
/dev/hda6 swap 516M 12M 504M 2% <not mounted>
<comment>(Unpartitioned space for future usage: 2 GB)</comment>
</pre>
<p>
<path>/usr</path> is rather full (83% used) here, but once
all software is installed, <path>/usr</path> doesn't tend to grow that much.
Although allocating a few gigabytes of disk space for <path>/var</path> may
seem excessive, remember that Portage uses this partition by default for
compiling packages. If you want to keep <path>/var</path> at a more reasonable
size, such as 1GB, you will need to alter your <c>PORTAGE_TMPDIR</c> variable
in <path>/etc/make.conf</path> to point to the partition with enough free space
for compiling extremely large packages such as OpenOffice.
</p>
</body>
</subsection>
</section>
<section id="fdisk">
<title>Using fdisk to Partition your Disk</title>
<subsection>
<body>
<p>
The following parts explain how to create the example partition layout
described previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
Change your partition layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Viewing the Current Partition Layout</title>
<body>
<p>
<c>fdisk</c> is a popular and powerful tool to split your disk into partitions.
Fire up <c>fdisk</c> on your disk (in our example, we use
<path>/dev/hda</path>):
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/hda</i>
</pre>
<p>
Once in <c>fdisk</c>, you'll be greeted with a prompt that looks like this:
</p>
<pre caption="fdisk prompt">
Command (m for help):
</pre>
<p>
Type <c>p</c> to display your disk's current partition configuration:
</p>
<pre caption="An example partition configuration">
Command (m for help): <i>p</i>
Disk /dev/hda: 240 heads, 63 sectors, 2184 cylinders
Units = cylinders of 15120 * 512 bytes
Device Boot Start End Blocks Id System
/dev/hda1 1 14 105808+ 83 Linux
/dev/hda2 15 49 264600 82 Linux swap
/dev/hda3 50 70 158760 83 Linux
/dev/hda4 71 2184 15981840 5 Extended
/dev/hda5 71 209 1050808+ 83 Linux
/dev/hda6 210 348 1050808+ 83 Linux
/dev/hda7 349 626 2101648+ 83 Linux
/dev/hda8 627 904 2101648+ 83 Linux
/dev/hda9 905 2184 9676768+ 83 Linux
Command (m for help):
</pre>
<p>
This particular disk is configured to house seven Linux filesystems (each with a
corresponding partition listed as "Linux") as well as a swap partition (listed
as "Linux swap").
</p>
</body>
</subsection>
<subsection>
<title>Removing all Partitions</title>
<body>
<p>
We will first remove all existing partitions from the disk. Type <c>d</c> to
delete a partition. For instance, to delete an existing <path>/dev/hda1</path>:
</p>
<pre caption="Deleting a partition">
Command (m for help): <i>d</i>
Partition number (1-4): <i>1</i>
</pre>
<p>
The partition has been scheduled for deletion. It will no longer show up if you
type <c>p</c>, but it will not be erased until your changes have been saved. If
you made a mistake and want to abort without saving your changes, type <c>q</c>
immediately and hit enter and your partition will not be deleted.
</p>
<p>
Now, assuming that you do indeed want to wipe out all the partitions on your
system, repeatedly type <c>p</c> to print out a partition listing and then type
<c>d</c> and the number of the partition to delete it. Eventually, you'll end
up with a partition table with nothing in it:
</p>
<pre caption="An empty partition table">
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
Command (m for help):
</pre>
<p>
Now that the in-memory partition table is empty, we're ready to create the
partitions. We will use a default partitioning scheme as discussed previously.
Of course, don't follow these instructions to the letter if you don't want the
same partitioning scheme!
</p>
</body>
</subsection>
<subsection>
<title>Creating the Boot Partition</title>
<body>
<p>
We first create a small boot partition. Type <c>n</c> to create a new partition,
then <c>p</c> to select a primary partition, followed by <c>1</c> to select the
first primary partition. When prompted for the first cylinder, hit enter. When
prompted for the last cylinder, type <c>+32M</c> to create a partition 32 Mbyte
in size:
</p>
<pre caption="Creating the boot partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>1</i>
First cylinder (1-3876, default 1): <comment>(Hit Enter)</comment>
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-3876, default 3876): <i>+32M</i>
</pre>
<p>
Now, when you type <c>p</c>, you should see the following partition printout:
</p>
<pre caption="Created boot partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 1 14 105808+ 83 Linux
</pre>
<p>
We need to make this partition bootable. Type <c>a</c> to toggle the bootable
flag on a partition and select <c>1</c>. If you press <c>p</c> again, you will
notice that an <path>*</path> is placed in the "Boot" column.
</p>
</body>
</subsection>
<subsection>
<title>Creating the Swap Partition</title>
<body>
<p>
Let's now create the swap partition. To do this, type <c>n</c> to create a new
partition, then <c>p</c> to tell fdisk that you want a primary partition. Then
type <c>2</c> to create the second primary partition, <path>/dev/hda2</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
you've done this, type <c>t</c> to set the partition type, <c>2</c> to select
the partition you just created 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 this:
</p>
<pre caption="Partition listing after creating a swap partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 * 1 14 105808+ 83 Linux
/dev/hda2 15 81 506520 82 Linux swap
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
Finally, let's create the root partition. To do this, type <c>n</c> to create a
new partition, then <c>p</c> to tell fdisk that you want a primary partition.
Then type <c>3</c> to create the third primary partition, <path>/dev/hda3</path>
in our case. When prompted for the first cylinder, hit enter. When prompted for
the last cylinder, hit enter to create a partition that takes up the rest of the
remaining space on your disk. After completing these steps, typing <c>p</c>
should display a partition table that looks similar to this:
</p>
<pre caption="Partition listing after creating the root partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 * 1 14 105808+ 83 Linux
/dev/hda2 15 81 506520 82 Linux swap
/dev/hda3 82 3876 28690200 83 Linux
</pre>
</body>
</subsection>
<subsection>
<title>Saving the Partition Layout</title>
<body>
<p>
To save the partition layout and exit <c>fdisk</c>, type <c>w</c>.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
The Linux kernel supports various filesystems. We'll explain ext2, ext3,
ReiserFS, XFS and JFS as these are the most commonly used filesystems on Linux
systems.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready and there hasn't been a sufficient track record to
comment positively nor negatively on its general stability at this point.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the boot partition (<path>/dev/hda1</path> in our
example) in ext2 and the root partition (<path>/dev/hda3</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs /dev/hda1</i>
# <i>mke2fs -j /dev/hda3</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/hda2</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/hda2</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/hda3 /mnt/gentoo</i>
# <i>mkdir /mnt/gentoo/boot</i>
# <i>mount /dev/hda1 /mnt/gentoo/boot</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-x86-kernel.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For x86-based systems, our main supported kernel is named
<c>gentoo-sources</c>. This kernel is based on the official Linux sources, but
has security, stability, compatibility and bug fixes applied on top.
Alternatively, the plain and unpatched Linux sources are supplied through the
<c>vanilla-sources</c> package.
</p>
<p>
Both kernel sources are based on the official 2.6 kernel sources. If you
want to install a 2.4-based kernel, you will need to install Gentoo with a
working Internet connection as we do not supply these sources on our
Installation CD.
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>. The
<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.12-gentoo-r10
</pre>
<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
Make sure that every driver that is vital to the booting of your system (such as
SCSI controller, ...) is compiled <e>in</e> the kernel and not as a module,
otherwise your system will not be able to boot completely.
</p>
<p>
Now select the correct processor family:
</p>
<pre caption="General Support and processor family">
General setup --->
[*] Support for hot-pluggable devices
Processor type and features --->
Subarchitecture Type (PC-compatible) --->
<comment>(Change according to your system)</comment>
(<i>Athlon/Duron/K7</i>) Processor family
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>/proc file system</c> and
<c>Virtual memory</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
<*> /proc file system support
<*> Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
Do not forget to enable DMA for your drives:
</p>
<pre caption="Activating DMA">
Device Drivers --->
ATA/ATAPI/MFM/RLL support --->
[*] Generic PCI bus-master DMA support
[*] Use PCI DMA by default when available
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
If you have an Intel CPU that supports HyperThreading (tm), or you have a
multi-CPU system, you should activate "Symmetric multi-processing support":
</p>
<pre caption="Activating SMP support">
Processor type and features --->
<*> Symmetric multi-processing support
</pre>
<p>
If you use USB Input Devices (like Keyboard or Mouse) don't forget to enable
those as well:
</p>
<pre caption="Activating USB Support for Input Devices">
Device Drivers --->
USB Support --->
<*> USB Human Interface Device (full HID) support
[*] HID input layer support
</pre>
<p>
If you are a laptop user and require PCMCIA support, remember to compile it
into the kernel. As well as the option below, be sure to enable support for
the PCMCIA card bridge present in your system (found in the same menu of the
configuration).
</p>
<pre caption="Activating PCMCIA support">
Bus options (PCI, PCMCIA, EISA, MCA, ISA) --->
PCCARD (PCMCIA/CardBus) support --->
<*> PCCard (PCMCIA/CardBus) support
<comment>(select 16 bit if you need support for older PCMCIA cards. Most people want this.)</comment>
<*> 16-bit PCMCIA support
[*] 32-bit CardBus support
<comment>(select the relevant bridges below)</comment>
--- PC-card bridges
<*> CardBus yenta-compatible bridge support (NEW)
<*> Cirrus PD6729 compatible bridge support (NEW)
<*> i82092 compatible bridge support (NEW)
<*> i82365 compatible bridge support (NEW)
<*> Databook TCIC host bridge support (NEW)
</pre>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
# <i>make && make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
choice and remember it as you will need it later on when you configure your
bootloader. Remember to replace <path><kernel-version></path> with the
name and version of your kernel.
</p>
<pre caption="Installing the kernel">
# <i>cp arch/i386/boot/bzImage /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Configuring Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because genkernel
doesn't require any manual kernel configuration, it is an ideal solution for
those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Now, compile your kernel sources by running <c>genkernel all</c>.
Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware, this compilation will take quite a while to finish!
</p>
<p>
Note that, if your boot partition doesn't use ext2 or ext3 as filesystem you
might need to manually configure your kernel using <c>genkernel --menuconfig
all</c> and add support for your filesystem <e>in</e> the kernel (i.e.
<e>not</e> as a module). Users of EVMS2 or LVM2 will probably want to add
<c>--evms2</c> or <c>--lvm2</c> as argument as well.
</p>
<pre caption="Running genkernel">
# <i>genkernel all</i>
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD)
before your "real" system starts up.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
If you want your system to be more like the Installation CD you should
emerge <c>coldplug</c>. While the initrd autodetects hardware that is
needed to boot your system, <c>coldplug</c> autodetects everything
else.
</p>
<pre caption="Emerging and enabling coldplug">
# <i>emerge coldplug</i>
# <i>rc-update add coldplug boot</i>
</pre>
</body>
</section>
<section id="kernel_modules">
<title>Configuring Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.6</path> (or <path>kernel-2.4</path>).
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> (or <path>kernel-2.4</path>) file and enter the module
name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
<comment>(Example for 2.6 kernels)</comment>
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Now continue with <uri link="?part=1&chap=8">Configuring your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/draft/2006.0/hb-install-x86-medium.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>i486 or later</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- General description, propagated to other architectures as well -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can succesfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CDs (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
the <path>releases/x86/2006.0-r1/installcd</path> directory;
the Package CDs are located in the <path>releases/x86/2006.0/packagecd</path>
directory.
</p>
<p>
i686, athlon-xp, pentium3 and pentium4 Package CDs are available via
<uri link="http://tracker.netdomination.org">BitTorrent</uri>.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<impo>
Read this whole subsection before continuing, as you will probably not have the
opportunity to read it before doing things later.
</impo>
<p>
Once you have burned your installation CD, it is time to boot it.
Remove all CDs from your CD drives, reboot your system and enter the BIOS.
This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside
the BIOS, change the boot order so that the CD-ROM is tried before the hard
disk. This is often found under "CMOS Setup". If you don't do this, your system
will just reboot from the hard disk, ignoring the CD-ROM.
</p>
<p>
Now place the installation CD in the CD-ROM drive and reboot. You
should see a boot prompt. At this screen, you can hit Enter to begin the
boot process with the default boot options, or boot the Installation CD with
custom boot options by specifying a kernel followed by boot options and then
hitting Enter.
</p>
<p>
Specifying a kernel? Yes, we provide several kernels on our Installation CDs.
The default one is <c>gentoo</c>. Other kernels are for specific hardware needs
and the <c>-nofb</c> variants which disable framebuffer.
</p>
<p>
Below you'll find a short overview on the available kernels:
</p>
<table>
<tr>
<th>Kernel</th>
<th>Description</th>
</tr>
<tr>
<ti>gentoo</ti>
<ti>Default 2.6 kernel with support for multiple CPUs</ti>
</tr>
<tr>
<ti>gentoo-nofb</ti>
<ti>Same as <c>gentoo</c> but without framebuffer support</ti>
</tr>
<tr>
<ti>memtest86</ti>
<ti>Test your local RAM for errors</ti>
</tr>
</table>
<p>
You can also provide kernel options. They represent optional settings you can
(de)activate at will. The following list is the same as the one you receive
when you press F2 at the bootscreen.
</p>
<pre caption="Options available to pass to your kernel of choice">
- agpgart loads agpgart (use if you have graphic problems,lockups)
- acpi=on loads support for ACPI firmware
- ide=nodma force disabling of DMA for malfunctioning IDE devices
- doscsi scan for scsi devices (breaks some ethernet cards)
- dopcmcia starts pcmcia service for PCMCIA cdroms
- nofirewire disables firewire modules in initrd (for firewire cdroms,etc)
- nokeymap disables keymap selection for non-us keyboard layouts
- docache cache the entire runtime portion of cd in RAM, allows you
to umount /mnt/cdrom to mount another cdrom.
- nodetect causes hwsetup/kudzu and hotplug not to run
- nousb disables usb module load from initrd, disables hotplug
- nodhcp dhcp does not automatically start if nic detected
- nohotplug disables loading hotplug service
- noapic disable apic (try if having hardware problems nics,scsi,etc)
- noevms2 disable loading of EVMS2 modules
- nolvm2 disable loading of LVM2 modules
- hdx=stroke allows you to partition the whole harddrive even when your BIOS
can't handle large harddrives
- noload=module1[,module2[,...]]
disable loading of specific kernel modules
</pre>
<p>
Now boot your CD, select a kernel (if you are not happy with the default
<c>gentoo</c> kernel) and boot options. As an example, we show you how
to boot the <c>gentoo</c> kernel, with <c>dopcmcia</c> as kernel
parameters:
</p>
<pre caption="Booting an Installation CD">
boot: <i>gentoo dopcmcia</i>
</pre>
<p>
You will then be greeted with a boot screen and progress bar. If you are
installing Gentoo on a system with a non-US keyboard, make sure you
immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
selection is made in 10 seconds the default (US keyboard) will be accepted and
the boot process will continue. Once the boot process completes, you will be
automatically logged in to the "Live" Gentoo Linux as
"root", the super user. You should have a root ("#") prompt
on the current console and can also switch to other consoles by pressing Alt-F2,
Alt-F3 and Alt-F4. Get back to the one you started on by pressing Alt-F1.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases, it
may not auto-load the kernel modules you need. If the PCI auto-detection
missed some of your system's hardware, you will have to load the appropriate
kernel modules manually.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
<p>
If you need PCMCIA support, you should start the <c>pcmcia</c> init script:
</p>
<pre caption="Starting the PCMCIA init script">
# <i>/etc/init.d/pcmcia start</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate Safe Performance Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-x86.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2006-02-05 9:51 Shyam Mani
0 siblings, 0 replies; 25+ messages in thread
From: Shyam Mani @ 2006-02-05 9:51 UTC (permalink / raw
To: gentoo-doc-cvs
fox2mike 06/02/05 09:51:43
Modified: xml/htdocs/doc/en/handbook/draft/2006.0 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-ppc64.xml
handbook-sparc.xml handbook-x86.xml
Log:
Fixing non install links
Revision Changes Path
1.2 +18 -18 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-alpha.xml 1 Feb 2006 18:38:17 -0000 1.1
+++ handbook-alpha.xml 5 Feb 2006 09:51:43 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2006.0 Alpha Handbook</title>
@@ -254,7 +254,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -263,7 +263,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -272,7 +272,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -282,7 +282,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -292,7 +292,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -309,7 +309,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -318,7 +318,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -329,7 +329,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -338,7 +338,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -348,7 +348,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -358,7 +358,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -372,7 +372,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -381,7 +381,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -390,7 +390,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -398,7 +398,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -406,7 +406,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -414,7 +414,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +18 -18 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-amd64.xml 1 Feb 2006 18:38:17 -0000 1.1
+++ handbook-amd64.xml 5 Feb 2006 09:51:43 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2006.0 AMD64 Handbook</title>
@@ -253,7 +253,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -262,7 +262,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -281,7 +281,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -291,7 +291,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -308,7 +308,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -317,7 +317,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -328,7 +328,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -337,7 +337,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -347,7 +347,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -357,7 +357,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -371,7 +371,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -380,7 +380,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -389,7 +389,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -397,7 +397,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -405,7 +405,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -413,7 +413,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +18 -18 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-hppa.xml 1 Feb 2006 18:38:17 -0000 1.1
+++ handbook-hppa.xml 5 Feb 2006 09:51:43 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2006.0 HPPA Handbook</title>
@@ -253,7 +253,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -262,7 +262,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -281,7 +281,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -291,7 +291,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -308,7 +308,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -317,7 +317,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -328,7 +328,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -337,7 +337,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -347,7 +347,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -357,7 +357,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -371,7 +371,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -380,7 +380,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -389,7 +389,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -397,7 +397,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -405,7 +405,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -413,7 +413,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +18 -18 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-ppc.xml 1 Feb 2006 18:38:17 -0000 1.1
+++ handbook-ppc.xml 5 Feb 2006 09:51:43 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2006.0 PPC Handbook</title>
@@ -257,7 +257,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -266,7 +266,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -275,7 +275,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -285,7 +285,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -295,7 +295,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -312,7 +312,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -321,7 +321,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -332,7 +332,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -341,7 +341,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -351,7 +351,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -361,7 +361,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -375,7 +375,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -384,7 +384,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -393,7 +393,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -401,7 +401,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -409,7 +409,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -417,7 +417,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +18 -18 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-ppc64.xml 1 Feb 2006 18:38:17 -0000 1.1
+++ handbook-ppc64.xml 5 Feb 2006 09:51:43 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux 2006.0 PPC64 Handbook</title>
@@ -255,7 +255,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -264,7 +264,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -273,7 +273,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -283,7 +283,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -293,7 +293,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -310,7 +310,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -319,7 +319,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -330,7 +330,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -339,7 +339,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -349,7 +349,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -359,7 +359,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -373,7 +373,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -382,7 +382,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -391,7 +391,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -399,7 +399,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -407,7 +407,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -415,7 +415,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +18 -18 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-sparc.xml 1 Feb 2006 18:38:17 -0000 1.1
+++ handbook-sparc.xml 5 Feb 2006 09:51:43 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2006.0 SPARC Handbook</title>
@@ -253,7 +253,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -262,7 +262,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -281,7 +281,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -291,7 +291,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -308,7 +308,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -317,7 +317,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -328,7 +328,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -337,7 +337,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -347,7 +347,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -357,7 +357,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -371,7 +371,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -380,7 +380,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -389,7 +389,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -397,7 +397,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -405,7 +405,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -413,7 +413,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
1.2 +18 -18 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- handbook-x86.xml 1 Feb 2006 18:38:17 -0000 1.1
+++ handbook-x86.xml 5 Feb 2006 09:51:43 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2006.0 x86 Handbook</title>
@@ -253,7 +253,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../hb-working-portage.xml"/>
+ <include href="../../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -262,7 +262,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../hb-working-use.xml"/>
+ <include href="../../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../hb-working-features.xml"/>
+ <include href="../../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -281,7 +281,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../hb-working-rcscripts.xml"/>
+ <include href="../../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -291,7 +291,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../hb-working-variables.xml"/>
+ <include href="../../hb-working-variables.xml"/>
</chapter>
</part>
@@ -308,7 +308,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../hb-portage-files.xml"/>
+ <include href="../../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -317,7 +317,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../hb-portage-configuration.xml"/>
+ <include href="../../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -328,7 +328,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../hb-portage-branches.xml"/>
+ <include href="../../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -337,7 +337,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../hb-portage-tools.xml"/>
+ <include href="../../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -347,7 +347,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../hb-portage-diverttree.xml"/>
+ <include href="../../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -357,7 +357,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../hb-portage-ebuild.xml"/>
+ <include href="../../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -371,7 +371,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../hb-net-start.xml"/>
+<include href="../../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -380,7 +380,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../hb-net-advanced.xml"/>
+<include href="../../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -389,7 +389,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../hb-net-modules.xml"/>
+<include href="../../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -397,7 +397,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../hb-net-wireless.xml"/>
+<include href="../../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -405,7 +405,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../hb-net-functions.xml"/>
+<include href="../../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -413,7 +413,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../hb-net-management.xml"/>
+<include href="../../hb-net-management.xml"/>
</chapter>
</part>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2006-02-10 17:45 Shyam Mani
0 siblings, 0 replies; 25+ messages in thread
From: Shyam Mani @ 2006-02-10 17:45 UTC (permalink / raw
To: gentoo-doc-cvs
fox2mike 06/02/10 17:45:04
Modified: xml/htdocs/doc/en/handbook/draft/2006.0 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc64.xml handbook-ppc.xml
handbook-sparc.xml handbook-x86.xml
Log:
It's *not* about choice - wolf31o2 circa 2006
Revision Changes Path
1.3 +2 -2 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-alpha.xml 5 Feb 2006 09:51:43 -0000 1.2
+++ handbook-alpha.xml 10 Feb 2006 17:45:04 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-alpha.xml,v 1.3 2006/02/10 17:45:04 fox2mike Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2006.0 Alpha Handbook</title>
@@ -206,7 +206,7 @@
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
-As mentioned before, Gentoo is about choices. In this chapter we help you
+As mentioned before, Gentoo is about customization. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
1.3 +2 -2 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-amd64.xml 5 Feb 2006 09:51:43 -0000 1.2
+++ handbook-amd64.xml 10 Feb 2006 17:45:04 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-amd64.xml,v 1.3 2006/02/10 17:45:04 fox2mike Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2006.0 AMD64 Handbook</title>
@@ -206,7 +206,7 @@
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
-As mentioned before, Gentoo is about choices. In this chapter we help you
+As mentioned before, Gentoo is about customization. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
1.3 +2 -2 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-hppa.xml 5 Feb 2006 09:51:43 -0000 1.2
+++ handbook-hppa.xml 10 Feb 2006 17:45:04 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-hppa.xml,v 1.3 2006/02/10 17:45:04 fox2mike Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2006.0 HPPA Handbook</title>
@@ -206,7 +206,7 @@
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
-As mentioned before, Gentoo is about choices. In this chapter we help you
+As mentioned before, Gentoo is about customization. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
1.3 +2 -2 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-ppc64.xml 5 Feb 2006 09:51:43 -0000 1.2
+++ handbook-ppc64.xml 10 Feb 2006 17:45:04 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc64.xml,v 1.3 2006/02/10 17:45:04 fox2mike Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux 2006.0 PPC64 Handbook</title>
@@ -206,7 +206,7 @@
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
-As mentioned before, Gentoo is about choices. In this chapter we help you
+As mentioned before, Gentoo is about customization. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
1.3 +2 -2 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-ppc.xml 5 Feb 2006 09:51:43 -0000 1.2
+++ handbook-ppc.xml 10 Feb 2006 17:45:04 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v 1.3 2006/02/10 17:45:04 fox2mike Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2006.0 PPC Handbook</title>
@@ -209,7 +209,7 @@
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
-As mentioned before, Gentoo is about choices. In this chapter we help you
+As mentioned before, Gentoo is about customization. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
1.3 +2 -2 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-sparc.xml 5 Feb 2006 09:51:43 -0000 1.2
+++ handbook-sparc.xml 10 Feb 2006 17:45:04 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml,v 1.2 2006/02/05 09:51:43 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-sparc.xml,v 1.3 2006/02/10 17:45:04 fox2mike Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2006.0 SPARC Handbook</title>
@@ -206,7 +206,7 @@
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
-As mentioned before, Gentoo is about choices. In this chapter we help you
+As mentioned before, Gentoo is about customization. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
1.4 +3 -3 xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-x86.xml 9 Feb 2006 19:15:44 -0000 1.3
+++ handbook-x86.xml 10 Feb 2006 17:45:04 -0000 1.4
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml,v 1.3 2006/02/09 19:15:44 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-x86.xml,v 1.4 2006/02/10 17:45:04 fox2mike Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2006.0 x86 Handbook</title>
@@ -157,7 +157,7 @@
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
- <include href="hb-install-network.xml"/>
+ <include href="hb-install-x86-network.xml"/>
</chapter>
<chapter>
@@ -209,7 +209,7 @@
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
-As mentioned before, Gentoo is about choices. In this chapter we help you
+As mentioned before, Gentoo is about customization. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2006-02-22 5:32 Shyam Mani
0 siblings, 0 replies; 25+ messages in thread
From: Shyam Mani @ 2006-02-22 5:32 UTC (permalink / raw
To: gentoo-doc-cvs
fox2mike 06/02/22 05:32:32
Modified: xml/htdocs/doc/en/handbook/2005.1 handbook-alpha.xml
handbook-amd64.xml
Log:
s/prebuild/prebuilt. Thanks to Borges for noticing
Revision Changes Path
1.5 +2 -2 xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- handbook-alpha.xml 13 Oct 2005 15:08:01 -0000 1.4
+++ handbook-alpha.xml 22 Feb 2006 05:32:32 -0000 1.5
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v 1.4 2005/10/13 15:08:01 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-alpha.xml,v 1.5 2006/02/22 05:32:32 fox2mike Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2005.1 Alpha Handbook</title>
@@ -227,7 +227,7 @@
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
-system and (optionally) install the prebuild packages.
+system and (optionally) install the prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
1.5 +2 -2 xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- handbook-amd64.xml 13 Oct 2005 15:08:01 -0000 1.4
+++ handbook-amd64.xml 22 Feb 2006 05:32:32 -0000 1.5
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v 1.4 2005/10/13 15:08:01 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/handbook-amd64.xml,v 1.5 2006/02/22 05:32:32 fox2mike Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2005.1 AMD64 Handbook</title>
@@ -226,7 +226,7 @@
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
-system and (optionally) install the prebuild packages.
+system and (optionally) install the prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2006-02-27 0:11 Shyam Mani
0 siblings, 0 replies; 25+ messages in thread
From: Shyam Mani @ 2006-02-27 0:11 UTC (permalink / raw
To: gentoo-doc-cvs
fox2mike 06/02/27 00:11:36
Added: xml/htdocs/doc/en/handbook/2006.0 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-ppc64.xml
handbook-sparc.xml handbook-x86.xml
hb-install-about.xml
hb-install-alpha-bootloader.xml
hb-install-alpha-disk.xml
hb-install-alpha-kernel.xml
hb-install-alpha-medium.xml
hb-install-amd64-bootloader.xml
hb-install-amd64-disk.xml
hb-install-amd64-kernel.xml
hb-install-amd64-medium.xml hb-install-config.xml
hb-install-finalise.xml
hb-install-hppa-bootloader.xml
hb-install-hppa-disk.xml hb-install-hppa-kernel.xml
hb-install-hppa-medium.xml hb-install-network.xml
hb-install-next.xml hb-install-ppc-bootloader.xml
hb-install-ppc-disk.xml hb-install-ppc-kernel.xml
hb-install-ppc-medium.xml
hb-install-ppc64-bootloader.xml
hb-install-ppc64-disk.xml
hb-install-ppc64-kernel.xml
hb-install-ppc64-medium.xml
hb-install-sparc-bootloader.xml
hb-install-sparc-disk.xml
hb-install-sparc-kernel.xml
hb-install-sparc-medium.xml hb-install-stage.xml
hb-install-system.xml hb-install-tools.xml
hb-install-x86-bootloader.xml
hb-install-x86-disk.xml hb-install-x86-kernel.xml
hb-install-x86-medium.xml
Log:
Prep for 2006.0
Revision Changes Path
1.1 xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2005.1 Alpha Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on Alpha systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-alpha-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-alpha-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-alpha-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
Several bootloaders exist. Each one of them has its own way of
configuration. In this chapter we'll describe all possibilities for you
and step you through the process of configuring a bootloader to your
needs.
</abstract>
<include href="hb-install-alpha-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install the prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2005.1 AMD64 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on AMD64 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-amd64-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-amd64-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-amd64-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
In this chapter we'll describe the GRUB bootloader
and step you through the process of configuring GRUB to your
needs.
</abstract>
<include href="hb-install-amd64-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install the prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2005.1 HPPA Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on HPPA systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-hppa-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-hppa-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
Gentoo installs work through so-called stage-files. In this chapter we
describe how you extract a stage-file and configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-hppa-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
In this chapter we'll describe the PALO bootloader
and step you through the process of configuring PALO to your
needs.
</abstract>
<include href="hb-install-hppa-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2005.1 PPC Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<author title="Editor">
<mail link="sejo@gentoo.org">Jochen Maes </mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on PPC systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-ppc-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-ppc-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-ppc-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
Several bootloaders exist. Each one of them has its own way of
configuration. In this chapter we'll describe all possibilities for you
and step you through the process of configuring a bootloader to your
needs.
</abstract>
<include href="hb-install-ppc-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux 2005.1 PPC64 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on PPC64 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-ppc64-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-ppc64-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-ppc64-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
Several bootloaders exist. Each one of them has its own way of
configuration. In this chapter we'll describe all possibilities for you
and step you through the process of configuring a bootloader to your
needs.
</abstract>
<include href="hb-install-ppc64-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2005.1 SPARC Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on Sparc systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-sparc-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-sparc-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and how to configure
Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and modify
the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-sparc-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
The SPARC architecture uses the SILO bootloader to fire up your Linux system. In
this chapter we step you through the process of configuring this bootloader to
your needs.
</abstract>
<include href="hb-install-sparc-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2005.1 x86 Handbook</title>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
<mail link="uberlord@gentoo.org">Roy Marples</mail>
</author>
<author title="Author">
<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
<mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author><!-- Does not want to be listed on the rendered page
<author title="Gentoo Developer">
Aron Griffis
</author>
-->
<author title="Gentoo AMD64 Developer">
<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
<mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
<mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
<mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
<mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
<mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
<mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
<mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
<mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
<mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
<mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
<mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Editor">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Reviewer">
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
<mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
<mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>
<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information.
This handbook contains the installation instructions for a networkless
installation on x86 systems and parts about working with Gentoo and Portage.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>5.2</version>
<date>2005-10-13</date>
<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>
<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about.
</abstract>
<include href="hb-install-about.xml"/>
</chapter>
<chapter>
<title>Booting the Universal Installation CD</title>
<abstract>
Using our Universal Installation CD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
<include href="hb-install-x86-medium.xml"/>
</chapter>
<chapter>
<title>Configuring your Network</title>
<abstract>
If you need networking, this is the place where the network (and Internet
connection) is configured.
</abstract>
<include href="hb-install-network.xml"/>
</chapter>
<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
<include href="hb-install-x86-disk.xml"/>
</chapter>
<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
In this chapter we describe how you extract a stage3 file and
how to configure Portage.
</abstract>
<include href="hb-install-stage.xml"/>
</chapter>
<chapter>
<title>Chrooting into the Gentoo Base System</title>
<abstract>
Now that the stage3 file is extracted, we chroot into the new system and
modify the USE variable.
</abstract>
<include href="hb-install-system.xml"/>
</chapter>
<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
<include href="hb-install-x86-kernel.xml"/>
</chapter>
<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
<include href="hb-install-config.xml"/>
</chapter>
<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
<include href="hb-install-tools.xml"/>
</chapter>
<chapter>
<title>Configuring the Bootloader</title>
<abstract>
Several bootloaders exist for the x86 architecture. Each one of them has its
own way of configuration. We step you through the process of configuring a
bootloader to your needs.
</abstract>
<include href="hb-install-x86-bootloader.xml"/>
</chapter>
<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
<include href="hb-install-finalise.xml"/>
</chapter>
<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
</part>
<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc.
</abstract>
<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
<include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
<include href="../hb-working-use.xml"/>
</chapter>
<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
<include href="../hb-working-features.xml"/>
</chapter>
<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
<include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
<include href="../hb-working-variables.xml"/>
</chapter>
</part>
<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>
<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
<include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
<include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
<include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
<include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
<include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
<include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
<part>
<title>Gentoo Network Configuration</title>
<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
<chapter>
<title>Getting Started</title>
<abstract>
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
<title>Advanced Configuration</title>
<abstract>
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
<title>Modular Networking</title>
<abstract>
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
<title>Wireless Networking</title>
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
<title>Adding Functionality</title>
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
<title>Network Management</title>
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
<include href="../hb-net-management.xml"/>
</chapter>
</part>
</book>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-about.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-about.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-about.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-about.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-about.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.0</version>
<date>2005-08-08</date>
<section>
<title>Introduction</title>
<subsection>
<title>Welcome!</title>
<body>
<p>
First of all, <e>welcome</e> to Gentoo. You are about to enter the world
of choices and performance. Gentoo is all about choices. When
installing Gentoo, this is made clear to you several times -- you can
choose how much you want to compile yourself, how to install Gentoo,
what system logger you want, etc.
</p>
<p>
Gentoo is a fast, modern metadistribution with a clean and flexible
design. Gentoo is built around free software and doesn't hide from its
users what is beneath the hood. Portage, the package maintenance system
which Gentoo uses, is written in Python, meaning you can easily view and
modify the source code. Gentoo's packaging system uses source code
(although support for precompiled packages is included too) and
configuring Gentoo happens through regular textfiles. In other words,
openness everywhere.
</p>
<p>
It is very important that you understand that <e>choices</e> are what
makes Gentoo run. We try not to force you onto anything you don't like.
If you feel like we do, please <uri
link="http://bugs.gentoo.org">bugreport</uri> it.
</p>
</body>
</subsection>
<subsection>
<title>How is the Installation Structured?</title>
<body>
<p>
The Gentoo Installation can be seen as a 10-step procedure,
corresponding to chapters 2 - 11. Every step results in
a certain state:
</p>
<ul>
<li>
After step 1, you are in a working environment ready to install Gentoo
</li>
<li>
After step 2, your internet connection is prepared in case you need it (this
is however optional)
</li>
<li>
After step 3, your hard disks are initialized to house your Gentoo
installation
</li>
<li>
After step 4, your installation environment is prepared and you are
ready to chroot into the new environment
</li>
<li>
After step 5, core packages, which are the same on all Gentoo
installations, are installed
</li>
<li>
After step 6, you have compiled your Linux kernel
</li>
<li>
After step 7, you have written most of your Gentoo system
configuration files
</li>
<li>
After step 8, necessary system tools (which you can choose from a nice
list) are installed
</li>
<li>
After step 9, your choice of bootloader has been installed and
configured and you are logged in into your new Gentoo installation
</li>
<li>
After step 10, your Gentoo Linux environment is ready to be explored
</li>
</ul>
<p>
When you are given a certain choice, we try our best to explain what the pros
and cons are. We will continue then with a default
choice, identified by "Default: " in the title. The other
possibilities are marked by "Alternative: ". Do <e>not</e>
think that the default is what we recommend. It is however what we
believe most users will use.
</p>
<p>
Sometimes you can pursue an optional step. Such steps are marked as
"Optional: " and are therefore not needed to install Gentoo.
However, some optional steps are dependant on a previous decision you
made. We will inform you when this happens, both when you make the
decision, and right before the optional step is described.
</p>
</body>
</subsection>
<subsection>
<title>What are my Options?</title>
<body>
<p>
You can install Gentoo in many different ways. You can download and install from
one of our Installation CDs, from an existing distribution,
from a bootable CD (such as Knoppix), from a netbooted environment, from a
rescue floppy, etc.
</p>
<p>
This document covers the installation using the Universal Installation CD, a
bootable CD that contains everything you need to get Gentoo Linux up and
running. You can optionally use one of our Package CDs as well to install a
complete system in a matter of minutes after having installed the Gentoo base
system.
</p>
<p>
This installation approach however does not immediately use the latest version
of the available packages; if you want this you should check out the
Installation Instructions inside our <uri
link="/doc/en/handbook/index.xml">Gentoo Linux Handbooks</uri>.
</p>
<p>
For help on the other installation approaches,
please read our <uri link="/doc/en/altinstall.xml">Alternative Installation
Guide</uri>. We also provide a <uri
link="/doc/en/gentoo-x86-tipsntricks.xml">Gentoo Installation Tips &
Tricks</uri> document that might be useful to read as well. If you feel that
the current installation instructions are too elaborate, feel free to use our
Quick Installation Guide available from our <uri
link="/doc/en/index.xml">Documentation Resources</uri> if your architecture
has such a document available.
</p>
</body>
</subsection>
<subsection>
<title>Troubles?</title>
<body>
<p>
If you find a problem in the installation (or in the installation
documentation), please check the errata from our <uri
link="/proj/en/releng/">Gentoo Release Engineering Project</uri>,
visit our <uri link="http://bugs.gentoo.org">bugtracking
system</uri> and check if the bug is known. If not, please create a bugreport
for it so we can take care of it. Do not be afraid of the developers who are
assigned to (your) bugs -- they generally don't eat people.
</p>
<p>
Note though that, although the document you are now reading is
architecture-specific, it will contain references to other architectures as
well. This is due to the fact that large parts of the Gentoo Handbook use source
code that is common for all architectures (to avoid duplication of efforts and
starvation of development resources). We will try to keep this to a minimum
to avoid confusion.
</p>
<p>
If you are uncertain if the problem is a user-problem (some error you
made despite having read the documentation carefully) or a
software-problem (some error we made despite having tested the
installation/documentation carefully) you are free to join #gentoo on
irc.freenode.net. Of course, you are welcome otherwise too :)
</p>
<p>
If you have a question regarding Gentoo, check out our <uri
link="/doc/en/faq.xml">Frequently Asked
Questions</uri>, available from the <uri
link="/doc/en/">Gentoo Documentation</uri>. You can
also view the <uri
link="http://forums.gentoo.org/viewforum.php?f=40">FAQs</uri> on our
<uri link="http://forums.gentoo.org">forums</uri>. If you can't find the answer
there ask on #gentoo, our IRC-channel on irc.freenode.net. Yes, several of
us are freaks who sit on IRC :-)
</p>
</body>
</subsection>
</section>
<section>
<title>Fast Installation using the Gentoo Reference Platform</title>
<subsection>
<title>What is the Gentoo Reference Platform?</title>
<body>
<p>
The Gentoo Reference Platform, from now on abbreviated to GRP, is a snapshot of
prebuilt packages users (that means you!) can install during the installation
of Gentoo to speed up the installation process. The GRP consists of all
packages required to have a fully functional Gentoo installation. They are not
just the ones you need to have a base installation up to speed in no time, but
all lengthier builds (such as KDE, xorg-x11, GNOME, OpenOffice, Mozilla, ...)
are available as GRP packages too.
</p>
<p>
However, these prebuilt packages aren't maintained during the lifetime of the
Gentoo distribution. They are snapshots released at every Gentoo release and
make it possible to have a functional environment in a short amount of time. You
can then upgrade your system in the background while working in your Gentoo
environment.
</p>
</body>
</subsection>
<subsection>
<title>How Portage Handles GRP Packages</title>
<body>
<p>
Your Portage tree - the collection of <e>ebuilds</e> (files that contain all
information about a package, such as its description, homepage, sourcecode URLs,
compilation instructions, dependencies, etc.) - must be synchronised with the
GRP set: the versions of the available ebuilds and their accompanying GRP
packages must match.
</p>
<p>
For this reason you can only benefit from the GRP packages Gentoo provides while
performing the current installation approach. GRP is not available for those
interested in performing an installation using the latest versions of all
available packages.
</p>
</body>
</subsection>
<subsection>
<title>Is GRP Available?</title>
<body>
<p>
Not all architectures provide GRP packages. That doesn't mean GRP isn't
supported on the other architectures, but it means that we don't have the
resources to build and test the GRP packages.
</p>
<p>
At present we provide GRP packages for the following architectures:
</p>
<ul>
<li>
The <b>x86</b> architecture (x86, athlon-xp, pentium3, pentium4)
Note: The x86 packages (packages-x86-2005.1.iso) are available on
our mirrors, while pentium3, pentium4 and athlon-xp are only available
via bittorrent.
</li>
<li>
The <b>amd64</b> architecture (amd64)
</li>
<li>
The <b>sparc</b> architecture (sparc64)
</li>
<li>
The <b>ppc</b> architecture (G3, G4, G5)
</li>
<li>
The <b>alpha</b> architecture
</li>
</ul>
<p>
If your architecture (or subarchitecture) isn't on this list, you are not
able to opt for a GRP installation.
</p>
<p>
Now that this introduction is over, let's continue with <uri
link="?part=1&chap=2">Booting the Universal Installation CD</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-bootloader.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2006-01-19</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
<p>
Several bootloaders exist for Linux/Alpha. You must choose one of the supported
bootloaders, not all. You have the choice between <uri link="#aboot">aBoot</uri>
and <uri link="#milo">MILO</uri>.
</p>
</body>
</subsection>
</section>
<section id="aboot">
<title>Default: Using aboot</title>
<body>
<p>
We first install aboot on our system. Of course we use <c>emerge</c> to
do so:
</p>
<pre caption = "Installing aboot">
# <i>emerge --usepkg aboot</i>
</pre>
<p>
The next step is to make our bootdisk bootable. This will start
<c>aboot</c> when you boot your system. We make our bootdisk bootable by
writing the <c>aboot</c> bootloader to the start of the disk.
</p>
<pre caption = "Making your bootdisk bootable">
# <i>swriteboot -f3 /dev/sda /boot/bootlx</i>
# <i>abootconf /dev/sda 2</i>
</pre>
<note>
If you use a different partitioning scheme than the one we use
throughout this chapter, you have to change the commands accordingly.
Please read the appropriate manual pages (<c>man 8 swriteboot</c> and
<c>man 8 abootconf</c>). Also, if your root filesystem uses the JFS filesystem,
make sure to pass the <c>ro</c> kernel option so that it can replay its log
before it gets mounted read-write.
</note>
<p>
Additionally, you can make Gentoo boot automatically by setting up the
aboot configuration file and some SRM variables. You can try setting
these variables from Linux, but it may be easier to do so from the SRM
console itself.
</p>
<pre caption = "Automatically booting Gentoo">
# <i>echo '0:2/boot/vmlinux.gz root=/dev/sda2' > /etc/aboot.conf</i>
# <i>cd /proc/srm_environment/named_variables</i>
# <i>echo -n 0 > boot_osflags</i>
# <i>echo -n '' > boot_file</i>
# <i>echo -n 'BOOT' > auto_action</i>
# <i>echo -n 'dkc100' > bootdef_dev</i>
<comment>(Substitute dkc100 with whatever your boot device is)</comment>
</pre>
<p>
If you need to get into the SRM console again in the future (to recover
your Gentoo install, play with some variables, or whatever), just hit
CTRL+C to abort the automatic loading process.
</p>
<p>
If you're installing using a serial console, don't forget to include
the serial console boot flag in <path>aboot.conf</path>. See
<path>/etc/aboot.conf.example</path> for some further information.
</p>
<p>
Aboot is now configured and ready to use. Continue with <uri
link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="milo">
<title>Alternative: Using MILO</title>
<body>
<p>
Before continuing, you should decide on how to use MILO. In this
section, we will assume that you want to make a MILO boot floppy. If you
are going to boot from an MS-DOS partition on your hard disk, you should
amend the commands appropriately.
</p>
<p>
To install MILO, we use <c>emerge</c>.
</p>
<pre caption = "Installing MILO">
# <i>emerge --usepkg milo</i>
</pre>
<p>
After MILO has been installed, the MILO images should be in
<path>/opt/milo</path>. The commands below make a bootfloppy for use
with MILO. Remember to use the correct image for your Alpha-system.
</p>
<pre caption = "Installing MILO on a floppy">
<comment>(First insert a blank floppy)</comment>
# <i>fdformat /dev/fd0</i>
# <i>mformat a:</i>
# <i>mcopy /opt/milo/milo-2.2-18-gentoo-ruffian a:\milo</i>
# <i>mcopy /opt/milo/linload.exe a:\lilnload.exe</i>
<comment>(Only if you have a Ruffian:</comment>
# <i>mcopy /opt/milo/ldmilo.exe a:\ldmilo.exe</i>
<comment>)</comment>
# <i>echo -ne '\125\252' | dd of=/dev/fd0 bs=1 seek=510 count=2</i>
</pre>
<p>
Your MILO boot floppy is now ready to boot Gentoo Linux. You may need to
set environment variables in your ARCS Firmware to get MILO to start;
this is all explained in the <uri
link="http://tldp.org/HOWTO/MILO-HOWTO/">MILO-HOWTO</uri> with some examples
on common systems, and examples of the commands to use in interactive mode.
</p>
<p>
Not reading the <uri link="http://tldp.org/HOWTO/MILO-HOWTO/">MILO-HOWTO</uri>
is a <e>bad</e> idea.
</p>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-alpha-disk.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-25</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first SCSI HD in a Linux system, namely
<path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On Alpha systems,
these are called <e>slices</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
As an example we use the following slice layout:
</p>
<table>
<tr>
<th>Slice</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Swap slice</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Root slice</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Full disk (required)</ti>
</tr>
</table>
<p>
If you are interested in knowing how big a partition should be, or even how
many partitions (or volumes) you need, read on. Otherwise continue now with
<uri link="#fdisk_SRM">Using fdisk to Partition your Disk (SRM only)</uri>
or <uri link="#fdisk_ARC">Using fdisk to Partition your Disk (ARC/AlphaBIOS
only)</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another.
</p>
</body>
</subsection>
</section>
<section id="fdisk_SRM">
<title>Using fdisk to Partition your Disk (SRM only)</title>
<subsection>
<body>
<p>
The following parts explain how to create the example slice layout described
previously, namely:
</p>
<table>
<tr>
<th>Slice</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Swap slice</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Root slice</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Full disk (required)</ti>
</tr>
</table>
<p>
Change your slice layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Identifying Available Disks</title>
<body>
<p>
To figure out what disks you have running, use the following commands:
</p>
<pre caption="Identifying available disks">
# <i>dmesg | grep 'drive$'</i> <comment>(For IDE disks)</comment>
# <i>dmesg | grep 'scsi'</i> <comment>(For SCSI disks)</comment>
</pre>
<p>
>From this output you should be able to see what disks were detected and their
respective <path>/dev</path> entry. In the following parts we assume that the
disk is a SCSI disk on <path>/dev/sda</path>.
</p>
<p>
Now fire up <c>fdisk</c>:
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/sda</i>
</pre>
</body>
</subsection>
<subsection>
<title>Deleting All Slices</title>
<body>
<p>
If your hard drive is completely blank, then you'll have to first create
a BSD disklabel.
</p>
<pre caption="Creating a BSD disklabel">
Command (m for help): <i>b</i>
/dev/sda contains no disklabel.
Do you want to create a disklabel? (y/n) <i>y</i>
<comment>A bunch of drive-specific info will show here</comment>
3 partitions:
# start end size fstype [fsize bsize cpg]
c: 1 5290* 5289* unused 0 0
</pre>
<p>
We start with deleting all slices <e>except</e> the 'c'-slice (a requirement
for using BSD disklabels). The following shows how to delete a slice (in
the example we use 'a'). Repeat the process to delete all other slices
(again, except the 'c'-slice).
</p>
<p>
Use <c>p</c> to view all existing slices. <c>d</c> is used to delete a slice.
</p>
<pre caption="Deleting a slice">
BSD disklabel command (m for help): <i>p</i>
8 partitions:
# start end size fstype [fsize bsize cpg]
a: 1 235* 234* 4.2BSD 1024 8192 16
b: 235* 469* 234* swap
c: 1 5290* 5289* unused 0 0
d: 469* 2076* 1607* unused 0 0
e: 2076* 3683* 1607* unused 0 0
f: 3683* 5290* 1607* unused 0 0
g: 469* 1749* 1280 4.2BSD 1024 8192 16
h: 1749* 5290* 3541* unused 0 0
BSD disklabel command (m for help): <i>d</i>
Partition (a-h): <i>a</i>
</pre>
<p>
After repeating this process for all slices, a listing should show you something
similar to this:
</p>
<pre caption="Viewing an empty scheme">
BSD disklabel command (m for help): <i>p</i>
3 partitions:
# start end size fstype [fsize bsize cpg]
c: 1 5290* 5289* unused 0 0
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Swap Slice</title>
<body>
<p>
On Alpha based systems you don't need a separate boot partition. However, the
first cylinder cannot be used as the <c>aboot</c> image will be placed there.
</p>
<p>
We will create a swap slice starting at the third cylinder, with a total
size of 1 GB. Use <c>n</c> to create a new slice. After creating the slice,
we will change its type to <c>1</c> (one), meaning <e>swap</e>.
</p>
<pre caption="Creating the swap slice">
BSD disklabel command (m for help): <i>n</i>
Partition (a-p): <i>a</i>
First cylinder (1-5290, default 1): <i>3</i>
Last cylinder or +size or +sizeM or +sizeK (3-5290, default 5290): <i>+1024M</i>
BSD disklabel command (m for help): <i>t</i>
Partition (a-c): <i>a</i>
Hex code (type L to list codes): <i>1</i>
</pre>
<p>
After these steps you should see a layout similar to the following:
</p>
<pre caption="Slice layout after creating the swap slice">
BSD disklabel command (m for help): <i>p</i>
3 partitions:
# start end size fstype [fsize bsize cpg]
a: 3 1003 1001 swap
c: 1 5290* 5289* unused 0 0
</pre>
</body>
</subsection>
<subsection>
<title>Create the Root Slice</title>
<body>
<p>
We will now create the root slice, starting from the first cylinder <e>after</e>
the swap slice. Use the <c>p</c> command to view where the swap slice ends. In
our example, this is at 1003, making the root partition start at 1004.
</p>
<p>
Another problem is that there is currently a bug in <c>fdisk</c> making it think
the number of available cylinders is one above the real number of cylinders. In
other words, when you are asked for the last cylinder, decrease the cylinder
number (in this example: 5290) with one.
</p>
<p>
When the partition is created, we change the type to <c>8</c>, for <e>ext2</e>.
</p>
<pre caption="Creating the root slice">
D disklabel command (m for help): <i>n</i>
Partition (a-p): <i>b</i>
First cylinder (1-5290, default 1): <i>1004</i>
Last cylinder or +size or +sizeM or +sizeK (1004-5290, default 5290): <i>5289</i>
BSD disklabel command (m for help): <i>t</i>
Partition (a-c): <i>b</i>
Hex code (type L to list codes): <i>8</i>
</pre>
<p>
Your slice layout should now be similar to this:
</p>
<pre caption="Viewing the slice layout">
BSD disklabel command (m for help): <i>p</i>
3 partitions:
# start end size fstype [fsize bsize cpg]
a: 3 1003 1001 swap
b: 1004 5289 4286 ext2
c: 1 5290* 5289* unused 0 0
</pre>
</body>
</subsection>
<subsection>
<title>Save the Slice Layout and Exit</title>
<body>
<p>
Save <c>fdisk</c> by typing <c>w</c>. This will also save your slice layout.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your slices are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="fdisk_ARC">
<title>Using fdisk to Partition your Disk (ARC/AlphaBIOS only)</title>
<subsection>
<body>
<p>
The following parts explain how to partition the disk with a layout
similar to the one described previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
Change your partition layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Identifying Available Disks</title>
<body>
<p>
To figure out what disks you have running, use the following commands:
</p>
<pre caption="Identifying available disks">
# <i>dmesg | grep 'drive$'</i> <comment>(For IDE disks)</comment>
# <i>dmesg | grep 'scsi'</i> <comment>(For SCSI disks)</comment>
</pre>
<p>
>From this output you should be able to see what disks were detected and their
respective <path>/dev</path> entry. In the following parts we assume that the
disk is a SCSI disk on <path>/dev/sda</path>.
</p>
<p>
Now fire up <c>fdisk</c>:
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/sda</i>
</pre>
</body>
</subsection>
<subsection>
<title>Deleting All Partitions</title>
<body>
<p>
If your hard drive is completely blank, then you'll have to first create
a DOS disklabel.
</p>
<pre caption="Creating a DOS disklabel">
Command (m for help): <i>o</i>
Building a new DOS disklabel.
</pre>
<p>
We start with deleting all partitions. The following shows how to delete
a partition (in the example we use '1'). Repeat the process to delete all
other partitions.
</p>
<p>
Use <c>p</c> to view all existing partitions. <c>d</c> is used to delete a
partition.
</p>
<pre caption="Deleting a partition">
command (m for help): <i>p</i>
Disk /dev/sda: 9150 MB, 9150996480 bytes
64 heads, 32 sectors/track, 8727 cylinders
Units = cylinders of 2048 * 512 = 1048576 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 478 489456 83 Linux
/dev/sda2 479 8727 8446976 5 Extended
/dev/sda5 479 1433 977904 83 Linux Swap
/dev/sda6 1434 8727 7469040 83 Linux
command (m for help): <i>d</i>
Partition number (1-6): <i>1</i>
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Boot Partition</title>
<body>
<p>
On Alpha systems which use MILO to boot, we have to create a small vfat
boot partition.
</p>
<pre caption="Creating the boot partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>1</i>
First cylinder (1-8727, default 1): <i>1</i>
Last cylinder or +size or +sizeM or +sizeK (1-8727, default 8727): <i>+16M</i>
Command (m for help): <i>t</i>
Selected partition 1
Hex code (type L to list codes): <i>6</i>
Changed system type of partition 1 to 6 (FAT16)
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Swap Partition</title>
<body>
<p>
We will create a swap partition starting at the third cylinder, with a total
size of 1 GB. Use <c>n</c> to create a new partition.
</p>
<pre caption="Creating the swap partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>2</i>
First cylinder (17-8727, default 17): <i>17</i>
Last cylinder or +size or +sizeM or +sizeK (17-8727, default 8727): <i>+1000M</i>
Command (m for help): <i>t</i>
Partition number (1-4): <i>1</i>
Hex code (type L to list codes): <i>82</i>
Changed system type of partition 2 to 82 (Linux swap)
</pre>
<p>
After these steps you should see a layout similar to the following:
</p>
<pre caption="Partition listing after creating a swap partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 9150 MB, 9150996480 bytes
64 heads, 32 sectors/track, 8727 cylinders
Units = cylinders of 2048 * 512 = 1048576 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 16 16368 6 FAT16
/dev/sda2 17 971 977920 82 Linux swap
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
We will now create the root partition. Again, just use the <c>n</c> command.
</p>
<pre caption="Creating the root partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>3</i>
First cylinder (972-8727, default 972): <i>972</i>
Last cylinder or +size or +sizeM or +sizeK (972-8727, default 8727): <i>8727</i>
</pre>
<p>
After these steps you should see a layout similar to the following:
</p>
<pre caption="Partition listing after creating the root partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 9150 MB, 9150996480 bytes
64 heads, 32 sectors/track, 8727 cylinders
Units = cylinders of 2048 * 512 = 1048576 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 16 16368 6 FAT16
/dev/sda2 17 971 977920 82 Linux swap
/dev/sda3 972 8727 7942144 83 Linux
</pre>
</body>
</subsection>
<subsection>
<title>Save the Partition Layout and Exit</title>
<body>
<p>
Save <c>fdisk</c> by typing <c>w</c>. This will also save your partition layout.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available. Most of them are found stable on the
Alpha architecture.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready and there hasn't been a sufficient track record to
comment positively nor negatively on its general stability at this point.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the root partition (<path>/dev/sda2</path> in our example)
in ext3, you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs -j /dev/sda2</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/sda1</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/sda1</i>
</pre>
<p>
Create and activate the swap with the commands mentioned above.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/sda2 /mnt/gentoo</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-alpha-kernel.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For alpha-based systems we have <c>vanilla-sources</c> (the default 2.6 kernel source).
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>. The
<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<p>
In the next example we install the <c>vanilla-sources</c>.
Of course substitute with your choice of sources, this is merely an example:
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge vanilla-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>vanilla-sources-2.6.11.2</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.11.2
</pre>
<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as it is
the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. You can run <c>lsmod</c> to see what kernel
modules the Installation CD uses (it might provide you with a nice hint on
what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc
file system</c>, (<c>/dev file system</c> + <c>Automatically mount at boot</c> only for 2.4 kernel):
</p>
<pre caption="Selecting necessary file systems">
<comment>(With a 2.4.x kernel)</comment>
File systems --->
[*] Virtual memory file system support (former shm fs)
[*] /proc file system support
[*] /dev file system support (EXPERIMENTAL)
[*] Automatically mount at boot
[ ] /dev/pts file system for Unix98 PTYs
<comment>(With a 2.6.x kernel)</comment>
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
<comment>(With a 2.4.x kernel)</comment>
Network device support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
<comment>(With a 2.6.x kernel)</comment>
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
The following options are recommended as well:
</p>
<pre caption="Recommended Alpha options">
General setup --->
<*> SRM environment through procfs
<*> Configure uac policy via sysctl
Plug and Play configuration --->
<*> Plug and Play support
<M> ISA Plug and Play support
SCSI support --->
SCSI low-level drivers --->
<*> SYM53C8XX Version 2 SCSI support (NEW)
<*> Qlogic ISP SCSI support
Network device support --->
Ethernet (10 or 100 Mbit) --->
<M> DECchip Tulip (dc21x4x) PCI support
<M> Generic DECchip & DIGITAL EtherWORKS PCI/EISA
<M> EtherExpressPro/100 support (eepro100)
<M> EtherExpressPro/100 support (e100)
Ethernet (1000 Mbit) --->
<M> Alteon AceNIC
[*] Omit support for old Tigon I
<M> Broadcom Tigon3
[*] FDDI driver support
<M> Digital DEFEA and DEFPA
<*> PPP support
<*> PPP Deflate compression
Character devices --->
[*] Support for console on serial port
[*] Direct Rendering Manager
File systems --->
<*> Kernel automounter version 4 support
Network File Systems --->
<*> NFS
[*] NFSv3 client
<*> NFS server
[*] NFSv3 server
Partition Types --->
[*] Advanced partition selection
[*] Alpha OSF partition support
Native Language Support
<*> NLS ISO 8859-1
Sound --->
<M> Sound card support
<M> OSS sound modules
[*] Verbose initialisation
[*] Persistent DMA buffers
<M> 100% Sound Blaster compatibles
</pre>
<p>
When you've finished configuring the kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
<comment>(For 2.4 kernel)</comment>
# <i>make dep && make vmlinux modules modules_install</i>
<comment>(For 2.6 kernel)</comment>
# <i>make && make modules_install</i>
<comment>(For all kernels)</comment>
# <i>make boot</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Recent kernels might create <path>vmlinux</path> instead of
<path>vmlinux.gz</path>. Keep this in mind when you copy your kernel image.
</p>
<pre caption="Installing the kernel">
# <i>cp arch/alpha/boot/vmlinux.gz /boot/</i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Installing Separate Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because genkernel
doesn't require any manual kernel configuration, it is an ideal solution for
those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Now, compile your kernel sources by running <c>genkernel all</c>.
Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware, this compilation will take quite a while to finish!
</p>
<p>
Note that, if your boot partition doesn't use ext2 or ext3 as filesystem you
need to manually configure your kernel using <c>genkernel --menuconfig all</c>
and add support for your filesystem <e>in</e> the kernel (i.e. <e>not</e> as a
module).
</p>
<pre caption="Running genkernel">
# <i>genkernel all</i>
GenKernel v3.0.1_beta10
* ARCH: Alpha
* KERNEL VER: 2.6.11.2
* kernel: configuring source
* kernel: running mrproper
<comment>(Output removed to increase readability)</comment>
* Kernel compiled successfully!
* Required Kernel Params:
* : root=/dev/ram0 init=/linuxrc real_root=/dev/$ROOT
* where $ROOT is the devicenode for your root partition as
* you should have specified in /etc/fstab
*
* You MUST tell your bootloader to use the generated initrd
*
* Recommended Kernel Params:
* : vga=0x317 splash=verbose
*
* Do NOT report kernel bugs (configs included) as genkernel bugs.
* Make sure you have the latest genkernel before reporting bugs
*
* For more info see /usr/share/genkernel/README
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD) before
your "real" system starts up.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
Now, let's perform one more step to get our system to be more like the Installation CD -- let's emerge <c>coldplug</c>. While the initrd autodetects hardware that
is needed to boot your system, <c>coldplug</c> autodetects everything else.
To emerge and enable <c>coldplug</c>, type the following:
</p>
<pre caption="Emerging and enabling coldplug">
# <i>emerge coldplug</i>
# <i>rc-update add coldplug boot</i>
</pre>
</body>
</section>
<section id="kernel_modules">
<title>Installing Separate Kernel Modules</title>
<subsection>
<title>Installing Extra Modules</title>
<body>
<p>
If appropriate, you should emerge ebuilds for any additional hardware that is
on your system. Here is a list of kernel-related ebuilds that you could emerge:
</p>
<table>
<tcolumn width="1in"/>
<tcolumn width="4in"/>
<tcolumn width="2in"/>
<tr>
<th>Ebuild</th>
<th>Purpose</th>
<th>Command</th>
</tr>
<tr>
<ti>x11-drm</ti>
<ti>
Accelerated graphics for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and
other cards for xorg-x11. Please check the <c>IUSE_VIDEO_CARDS</c> variable
in the <path>/usr/portage/x11-base/x11-drm</path> ebuilds to see what you
need to fill in as <c>yourcard</c>.
</ti>
<ti><c>VIDEO_CARDS="yourcard" emerge x11-drm</c></ti>
</tr>
</table>
<p>
Beware though, some of these ebuilds might deal with big dependencies. To verify
what packages will be installed by emerging an ebuild, use <c>emerge
--pretend</c>. For instance, for the <c>x11-drm</c> package:
</p>
<pre caption="View full installation package listing">
# <i>emerge --pretend x11-drm</i>
</pre>
</body>
</subsection>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.4</path> (or <path>kernel-2.6</path>).
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.4</path> or <path>kernel-2.6</path> file and enter the module
name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.4">
<comment>(Example for 2.4 kernels)</comment>
# <i>nano -w /etc/modules.autoload.d/kernel-2.4</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.4 or kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-alpha-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-alpha-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-alpha-medium.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>
Please check with the <uri
link="http://www.alphalinux.org/faq/FAQ-5.html">Alpha/Linux FAQ</uri>
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- Copy/paste from the hb-install-x86-medium.xml file but no Universal
Installation CD.
Also s/x86/alpha -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can successfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
the <path>releases/alpha/2005.1/installcd</path> directory;
the Package CD is located in the <path>releases/alpha/2005.1/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<p>
When your Alpha is powered on, the first thing that gets started is the
firmware. It is loosely synonymous with the BIOS software on PC systems. There
are two types of firmware on Alpha systems: SRM (<e>Systems Reference
Manual</e>) and ARC (<e>Advanced Risc Console</e>).
</p>
<p>
SRM is based on the Alpha Console Subsystem specification, which provides an
operating environment for OpenVMS, Tru64 UNIX, and Linux operating systems. ARC
is based on the Advanced RISC Computing (ARC) specification, which provides
an operating environment for Windows NT. You can find a
<uri link="http://www.alphalinux.org/faq/SRM-HOWTO/">detailed guide</uri> on
using SRM over at the Alpha Linux website.
</p>
<p>
If your Alpha system supports both SRC and ARCs (ARC, AlphaBIOS, ARCSBIOS) you
should follow <uri link="http://www.alphalinux.org/faq/x31.html">these
instructions</uri> for switching to SRM. If your system already uses SRM, you
are all set. If your system can only use ARCs (Ruffian, nautilus, xl, etc.) you
will need to choose <c>MILO</c> later on when we are talking about bootloaders.
</p>
<p>
Now to boot an Alpha Installation CD, put the CD-ROM in the tray and reboot the system.
You can use SRM to boot the Installation CD. If you cannot do that, you will have to use
<c>MILO</c>. If you don't have <c>MILO</c> installed already, use one of the
precompiled <c>MILO</c> images available on <uri
link="http://dev.gentoo.org/~taviso/milo/">taviso's homepage</uri>.
</p>
<pre caption="Booting a CD-ROM using SRM">
<comment>(List available hardware drives)</comment>
>>> <i>show device</i>
dkb0.0.1.4.0 DKB0 TOSHIBA CDROM
<comment>(...)</comment>
<comment>(Substitute dkb0 with your CD-ROM drive device)</comment>
>>> <i>boot dkb0 -flags 0</i>
<comment>To boot the 2.4 kernel instead of the default 2.6 kernel use:</comment>
>>> <i>boot dkb -flags 1</i>
</pre>
<pre caption="Booting a CD-ROM using MILO">
<comment>(Substitute hdb with your CD-ROM drive device)</comment>
MILO> <i>boot hdb:/boot/gentoo_2.6 initrd=/boot/gentoo_2_6.igz root=/dev/ram0 init=/linuxrc looptype=zisofs loop=/zisofs cdroot</i>
<comment>To boot the 2.4 kernel instead of the default 2.6 kernel use:</comment>
MILO> <i>boot hdb:/boot/gentoo_2.4 initrd=/boot/gentoo_2_4.igz root=/dev/ram0 init=/linuxrc looptype=zisofs loop=/zisofs cdroot</i>
</pre>
<p>
You should have a root ("#") prompt on the current console and can also switch
to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you
started on by pressing Alt-F1.
</p>
<p>
Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases (the
SPARC Installation CDs don't even do autodetection), it may not auto-load the kernel
modules you need. If the PCI auto-detection missed some of your system's
hardware, you will have to load the appropriate kernel modules manually.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
<p>
If you need PCMCIA support, you should start the <c>pcmcia</c> init script:
</p>
<pre caption="Starting the PCMCIA init script">
# <i>/etc/init.d/pcmcia start</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>lynx</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>lynx /mnt/cdrom/docs/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>lynx</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>lynx http://www.gentoo.org/doc/en/handbook/handbook-alpha.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-bootloader.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.9</version>
<date>2006-02-02</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Framebuffer</title>
<body>
<!--
Verbatim copy from x86 bootloader framebuffer explanation, minus the section on
vesafb-tng
-->
<p>
<e>If</e> you have configured your kernel with framebuffer support (or you used
<c>genkernel</c>'s default kernel configuration), you can activate it by adding
a <c>vga</c> and/or a <c>video</c> statement to your bootloader configuration
file.
</p>
<p>
64-bit systems must use the the <c>vesafb</c> driver, and so will need to set
the <c>vga</c> statement. The <c>vga</c> statement controls the resolution and
color depth of your framebuffer screen for <c>vesafb</c>. As stated in
<path>/usr/src/linux/Documentation/fb/vesafb.txt</path> (which gets installed
when you install a kernel source package), you need to pass the VESA number
corresponding to the requested resolution and color depth to it.
</p>
<p>
The following table lists the available resolutions and colordepths and matches
those against the value that you need to pass on to the <c>vga</c> statement.
</p>
<table>
<tr>
<ti></ti>
<th>640x480</th>
<th>800x600</th>
<th>1024x768</th>
<th>1280x1024</th>
</tr>
<tr>
<th>256</th>
<ti>0x301</ti>
<ti>0x303</ti>
<ti>0x305</ti>
<ti>0x307</ti>
</tr>
<tr>
<th>32k</th>
<ti>0x310</ti>
<ti>0x313</ti>
<ti>0x316</ti>
<ti>0x319</ti>
</tr>
<tr>
<th>64k</th>
<ti>0x311</ti>
<ti>0x314</ti>
<ti>0x317</ti>
<ti>0x31A</ti>
</tr>
<tr>
<th>16M</th>
<ti>0x312</ti>
<ti>0x315</ti>
<ti>0x318</ti>
<ti>0x31B</ti>
</tr>
</table>
<p>
The <c>video</c> statement controls framebuffer display options. It needs to be
given the framebuffer driver (<c>vesafb</c> for 2.6 kernels, or <c>vesa</c> for
2.4 kernels) followed by the control statements you wish to enable. All
variables are listed in <path>/usr/src/linux/Documentation/fb/vesafb.txt</path>,
but we'll inform you about three most-used options:
</p>
<table>
<tr>
<th>Control</th>
<th>Description</th>
</tr>
<tr>
<ti>ywrap</ti>
<ti>
Assume that the graphical card can wrap around its memory (i.e. continue at
the beginning when it has approached the end)
</ti>
</tr>
<tr>
<ti>mtrr</ti>
<ti>
Setup MTRR registers
</ti>
</tr>
</table>
<p>
The result of those two statements could be something like <c>vga=0x318
video=vesafb:mtrr,ywrap</c> or <c>video=vesafb:mtrr,ywrap,1024x768-32@85</c>.
Remember (or write down) this setting; you will need it shortly.
</p>
<p>
While LILO does work on AMD64, Gentoo only supports using GRUB. Now continue by
its installation.
</p>
</body>
</subsection>
</section>
<section>
<title>Using GRUB</title>
<subsection>
<title>Understanding GRUB's terminology</title>
<body>
<p>
The most critical part of understanding GRUB is getting comfortable with
how GRUB refers to hard drives and partitions. Your Linux partition
<path>/dev/hda1</path> will most likely be called <path>(hd0,0)</path> under
GRUB. Notice the parenthesis around the <path>hd0,0</path> - they are required.
</p>
<p>
Hard drives count from zero rather than "a" and partitions start at zero
rather than one. Be aware too that with the hd devices, only hard drives are
counted, not atapi-ide devices such as cdrom players and burners. Also, the
same construct is used with SCSI drives. (Normally they get higher numbers
than IDE drives except when the BIOS is configured to boot from SCSI devices.)
When you ask the BIOS to boot from a different hard disk (for instance your
primary slave), <e>that</e> harddisk is seen as <path>hd0</path>.
</p>
<p>
Assuming you have a hard drive on <path>/dev/hda</path>, a cdrom player on
<path>/dev/hdb</path>, a burner on <path>/dev/hdc</path>, a second hard drive
on <path>/dev/hdd</path> and no SCSI hard drive, <path>/dev/hdd7</path> gets
translated to <path>(hd1,6)</path>. It might sound tricky and tricky it is
indeed, but as we will see, GRUB offers a tab completion mechanism
that comes handy for those of you having a lot of hard drives and
partitions and who are a little lost in the GRUB numbering scheme.
</p>
<p>
Having gotten the feel for that, it is time to install GRUB.
</p>
</body>
</subsection>
<subsection>
<title>Installing GRUB</title>
<body>
<p>
To install GRUB, let's first emerge it.
</p>
<pre caption="Installing GRUB">
# <i>emerge grub</i>
</pre>
<p>
Although GRUB is now installed, we still need to write up a
configuration file for it and install GRUB in the MBR so that GRUB
automatically boots your newly created kernel. Create
<path>/boot/grub/grub.conf</path> with <c>nano</c> (or, if applicable, another
editor):
</p>
<pre caption="Creating /boot/grub/grub.conf">
# <i>nano -w /boot/grub/grub.conf</i>
</pre>
<p>
Now we are going to write up a <path>grub.conf</path>. Below you'll
find two possible <path>grub.conf</path> for the partitioning example we use
in this guide, with kernel image <path>kernel-2.6.12-gentoo-r10</path>. We've
only extensively commented the first <path>grub.conf</path>.
</p>
<ul>
<li>
The first <path>grub.conf</path> is for people who have not used
<c>genkernel</c> to build their kernel
</li>
<li>
The second <path>grub.conf</path> is for people who have used
<c>genkernel</c> to build their kernel
</li>
</ul>
<note>
If your root filesystem is JFS, you <e>must</e> add " ro" to the <c>kernel</c>
line since JFS needs to replay its log before it allows read-write mounting.
</note>
<pre caption="grub.conf for non-genkernel users">
<comment># Which listing to boot as default. 0 is the first, 1 the second etc.</comment>
default 0
<comment># How many seconds to wait before the default listing is booted.</comment>
timeout 30
<comment># Nice, fat splash-image to spice things up :)
# Comment out if you don't have a graphics card installed</comment>
splashimage=(hd0,0)/boot/grub/splash.xpm.gz
title=Gentoo Linux 2.6.12
<comment># Partition where the kernel image (or operating system) is located</comment>
root (hd0,0)
kernel /boot/kernel-2.6.12-gentoo-r10 root=/dev/hda3
<comment># The next four lines are only if you dualboot with a Windows system.</comment>
<comment># In this case, Windows is hosted on /dev/hda6.</comment>
title=Windows XP
rootnoverify (hd0,5)
makeactive
chainloader +1
</pre>
<pre caption="grub.conf for genkernel users">
default 0
timeout 30
splashimage=(hd0,0)/boot/grub/splash.xpm.gz
title=Gentoo Linux 2.6.12
root (hd0,0)
kernel /boot/kernel-2.6.12-gentoo-r10 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
initrd /boot/initramfs-genkernel-amd64-2.6.12-gentoo-r10
<comment># Only in case you want to dual-boot</comment>
title=Windows XP
rootnoverify (hd0,5)
makeactive
chainloader +1
</pre>
<p>
If you used a different partitioning scheme and/or kernel image, adjust
accordingly. However, make sure that anything that follows a GRUB-device (such
as <path>(hd0,0)</path>) is relative to the mountpoint, not the root. In other
words, <path>(hd0,0)/grub/splash.xpm.gz</path> is in reality
<path>/boot/grub/splash.xpm.gz</path> since <path>(hd0,0)</path> is
<path>/boot</path>.
</p>
<p>
Besides, if you chose to use a different partitioning scheme and did not put
<path>/boot</path> in a separate partition, the <path>/boot</path> prefix used
in the above code samples is really <e>required</e>. If you followed our
suggested partitioning plan, the <path>/boot</path> prefix it not required, but
a <path>boot</path> symlink makes it work. In short, the above examples should
work whether you defined a separate <path>/boot</path> partition or not.
</p>
<p>
If you need to pass any additional options to the kernel, simply add
them to the end of the kernel command. We're already passing one option
(<c>root=/dev/hda3</c> or <c>real_root=/dev/hda3</c>), but you can pass others
as well, such as the <c>video</c> statement for framebuffer as we discussed
previously.
</p>
<p>
<c>genkernel</c> users should know that their kernels use the same boot options
as is used for the Installation CD. For instance, if you have SCSI devices, you
should add <c>doscsi</c> as kernel option.
</p>
<p>
Now save the <path>grub.conf</path> file and exit. We still need to install GRUB
in the MBR (Master Boot Record) though.
</p>
<p>
The GRUB developers recommend the use of <c>grub-install</c>. However, if for
some reason <c>grub-install</c> fails to work correctly you still have the
option to manually install GRUB.
</p>
<p>
Continue with <uri link="#grub-install-auto">Default: Setting up GRUB using
grub-install</uri> or <uri link="#grub-install-manual">Alternative: Setting up
GRUB using manual instructions</uri>.
</p>
</body>
</subsection>
<subsection id="grub-install-auto">
<title>Default: Setting up GRUB using grub-install</title>
<body>
<p>
To install GRUB you will need to issue the <c>grub-install</c> command.
However, <c>grub-install</c> won't work off-the-shelf since we are inside a
chrooted environment. We need to create <path>/etc/mtab</path> which lists all
mounted filesystems. Fortunately, there is an easy way to accomplish this -
just copy over <path>/proc/mounts</path> to <path>/etc/mtab</path>, excluding
the <c>rootfs</c> line if you haven't created a separate boot partition. The
following command will work in both cases:
</p>
<pre caption="Creating /etc/mtab">
# <i>grep -v rootfs /proc/mounts > /etc/mtab</i>
</pre>
<p>
Now we can install GRUB using <c>grub-install</c>:
</p>
<pre caption="Running grub-install">
# <i>grub-install /dev/hda</i>
</pre>
<p>
If you have more questions regarding GRUB, please consult the <uri
link="http://www.gnu.org/software/grub/grub-faq.html">GRUB FAQ</uri> or the <uri
link="http://www.gnu.org/software/grub/manual/">GRUB Manual</uri>.
</p>
<p>
Continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
<subsection id="grub-install-manual">
<title>Alternative: Setting up GRUB using manual instructions</title>
<body>
<p>
To start configuring GRUB, you type in <c>grub</c>. You'll be presented
with the <path>grub></path> grub command-line prompt. Now, you need to type
in the right commands to install the GRUB boot record onto your hard drive.
</p>
<pre caption=" Starting the GRUB shell">
# <i>grub</i>
</pre>
<note>
If your system does not have any floppy drives, add the <c>--no-floppy</c>
option to the above command to prevent grub from probing the (non-existing)
floppy drives.
</note>
<p>
In the example configuration we want to install GRUB so that it reads its
information from the boot-partition <path>/dev/hda1</path>, and installs the
GRUB boot record on the hard drive's MBR (master boot record) so that the first
thing we see when we turn on the computer is the GRUB prompt. Of course, if you
haven't followed the example configuration during the installation,
change the commands accordingly.
</p>
<p>
The tab completion mechanism of GRUB can be used from within GRUB.
For instance, if you type in "<c>root (</c>" followed by a TAB, you will
be presented with a list of devices (such as <path>hd0</path>). If you
type in "<c>root (hd0,</c>" followed by a TAB, you will receive a list
of available partitions to choose from (such as <path>hd0,0</path>).
</p>
<p>
By using the tab completion, setting up GRUB should be not that hard.
Now go on, configure GRUB, shall we? :-)
</p>
<pre caption=" Installing GRUB in the MBR">
grub> <i>root (hd0,0)</i> <comment>(Specify where your /boot partition resides)</comment>
grub> <i>setup (hd0)</i> <comment>(Install GRUB in the MBR)</comment>
grub> <i>quit</i> <comment>(Exit the GRUB shell)</comment>
</pre>
<note>
If you want to install GRUB in a certain partition instead of the MBR,
you have to alter the <c>setup</c> command so it points to the right
partition. For instance, if you want GRUB installed in
<path>/dev/hda3</path>, then the command becomes <c>setup (hd0,2)</c>.
Few users however want to do this.
</note>
<p>
If you have more questions regarding GRUB, please consult the <uri
link="http://www.gnu.org/software/grub/grub-faq.html">GRUB FAQ</uri> or the <uri
link="http://www.gnu.org/software/grub/manual/">GRUB Manual</uri>.
</p>
<p>
Continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Unmounting all partitions and rebooting">
# <i>exit</i>
# <i>cd</i>
# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-amd64-disk.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2006-01-01</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI drives, then your first hard
drive would be <path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions and Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On amd64 systems,
these are called <e>partitions</e>.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Partitions are divided in three types:
<e>primary</e>, <e>extended</e> and <e>logical</e>.
</p>
<p>
A <e>primary</e> partition is a partition which has its information stored in
the MBR (master boot record). As an MBR is very small (512 bytes) only four
primary partitions can be defined (for instance, <path>/dev/hda1</path> to
<path>/dev/hda4</path>).
</p>
<p>
An <e>extended</e> partition is a special primary partition (meaning the
extended partition must be one of the four possible primary partitions) which
contains more partitions. Such a partition didn't exist originally, but as
four partitions were too few, it was brought to life to extend the formatting
scheme without losing backward compatibility.
</p>
<p>
A <e>logical</e> partition is a partition inside the extended partition. Their
definitions aren't placed inside the MBR, but are declared inside the extended
partition.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>ext2</ti>
<ti>32M</ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>ext3</ti>
<ti>Rest of the disk</ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
If you are interested in knowing how big a partition (or logical
volume) should be, or even how many partitions (or volumes) you need, read on.
Otherwise continue with <uri link="#fdisk">Using fdisk to Partition your
Disk</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
<p>
As an example partitioning, we show you one for a 20GB disk, used as a
demonstration laptop (containing webserver, mailserver, gnome, ...):
</p>
<pre caption="Filesystem usage example">
Filesystem Type Size Used Avail Use% Mounted on
/dev/hda5 ext3 509M 132M 351M 28% /
/dev/hda2 ext3 5.0G 3.0G 1.8G 63% /home
/dev/hda7 ext3 7.9G 6.2G 1.3G 83% /usr
/dev/hda8 ext3 1011M 483M 477M 51% /opt
/dev/hda9 ext3 2.0G 607M 1.3G 32% /var
/dev/hda1 ext2 51M 17M 31M 36% /boot
/dev/hda6 swap 516M 12M 504M 2% <not mounted>
<comment>(Unpartitioned space for future usage: 2 GB)</comment>
</pre>
<p>
<path>/usr</path> is rather full (83% used) here, but once
all software is installed, <path>/usr</path> doesn't tend to grow that much.
Although allocating a few gigabytes of disk space for <path>/var</path> may
seem excessive, remember that Portage uses this partition by default for
compiling packages. If you want to keep <path>/var</path> at a more reasonable
size, such as 1GB, you will need to alter your <c>PORTAGE_TMPDIR</c> variable
in <path>/etc/make.conf</path> to point to the partition with enough free space
for compiling extremely large packages such as OpenOffice.
</p>
</body>
</subsection>
</section>
<section id="fdisk">
<title>Using fdisk to Partition your Disk</title>
<subsection>
<body>
<p>
The following parts explain how to create the example partition layout
described previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
Change your partition layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Viewing the Current Partition Layout</title>
<body>
<p>
<c>fdisk</c> is a popular and powerful tool to split your disk into partitions.
Fire up <c>fdisk</c> on your disk (in our example, we use
<path>/dev/hda</path>):
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/hda</i>
</pre>
<p>
Once in <c>fdisk</c>, you'll be greeted with a prompt that looks like this:
</p>
<pre caption="fdisk prompt">
Command (m for help):
</pre>
<p>
Type <c>p</c> to display your disk's current partition configuration:
</p>
<pre caption="An example partition configuration">
Command (m for help): <i>p</i>
Disk /dev/hda: 240 heads, 63 sectors, 2184 cylinders
Units = cylinders of 15120 * 512 bytes
Device Boot Start End Blocks Id System
/dev/hda1 1 14 105808+ 83 Linux
/dev/hda2 15 49 264600 82 Linux swap
/dev/hda3 50 70 158760 83 Linux
/dev/hda4 71 2184 15981840 5 Extended
/dev/hda5 71 209 1050808+ 83 Linux
/dev/hda6 210 348 1050808+ 83 Linux
/dev/hda7 349 626 2101648+ 83 Linux
/dev/hda8 627 904 2101648+ 83 Linux
/dev/hda9 905 2184 9676768+ 83 Linux
Command (m for help):
</pre>
<p>
This particular disk is configured to house seven Linux filesystems (each with a
corresponding partition listed as "Linux") as well as a swap partition (listed
as "Linux swap").
</p>
</body>
</subsection>
<subsection>
<title>Removing all Partitions</title>
<body>
<p>
We will first remove all existing partitions from the disk. Type <c>d</c> to
delete a partition. For instance, to delete an existing <path>/dev/hda1</path>:
</p>
<pre caption="Deleting a partition">
Command (m for help): <i>d</i>
Partition number (1-4): <i>1</i>
</pre>
<p>
The partition has been scheduled for deletion. It will no longer show up if you
type <c>p</c>, but it will not be erased until your changes have been saved. If
you made a mistake and want to abort without saving your changes, type <c>q</c>
immediately and hit enter and your partition will not be deleted.
</p>
<p>
Now, assuming that you do indeed want to wipe out all the partitions on your
system, repeatedly type <c>p</c> to print out a partition listing and then type
<c>d</c> and the number of the partition to delete it. Eventually, you'll end
up with a partition table with nothing in it:
</p>
<pre caption="An empty partition table">
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
Command (m for help):
</pre>
<p>
Now that the in-memory partition table is empty, we're ready to create the
partitions. We will use a default partitioning scheme as discussed previously.
Of course, don't follow these instructions to the letter if you don't want the
same partitioning scheme!
</p>
</body>
</subsection>
<subsection>
<title>Creating the Boot Partition</title>
<body>
<p>
We first create a small boot partition. Type <c>n</c> to create a new partition,
then <c>p</c> to select a primary partition, followed by <c>1</c> to select the
first primary partition. When prompted for the first cylinder, hit enter. When
prompted for the last cylinder, type <c>+32M</c> to create a partition 32 Mbyte
in size:
</p>
<pre caption="Creating the boot partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>1</i>
First cylinder (1-3876, default 1): <comment>(Hit Enter)</comment>
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-3876, default 3876): <i>+32M</i>
</pre>
<p>
Now, when you type <c>p</c>, you should see the following partition printout:
</p>
<pre caption="Created boot partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 1 14 105808+ 83 Linux
</pre>
<p>
We need to make this partition bootable. Type <c>a</c> to toggle the bootable
flag on a partition and select <c>1</c>. If you press <c>p</c> again, you will
notice that an <path>*</path> is placed in the "Boot" column.
</p>
</body>
</subsection>
<subsection>
<title>Creating the Swap Partition</title>
<body>
<p>
Let's now create the swap partition. To do this, type <c>n</c> to create a new
partition, then <c>p</c> to tell fdisk that you want a primary partition. Then
type <c>2</c> to create the second primary partition, <path>/dev/hda2</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
you've done this, type <c>t</c> to set the partition type, <c>2</c> to select
the partition you just created 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 this:
</p>
<pre caption="Partition listing after creating a swap partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 * 1 14 105808+ 83 Linux
/dev/hda2 15 81 506520 82 Linux swap
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
Finally, let's create the root partition. To do this, type <c>n</c> to create a
new partition, then <c>p</c> to tell fdisk that you want a primary partition.
Then type <c>3</c> to create the third primary partition, <path>/dev/hda3</path>
in our case. When prompted for the first cylinder, hit enter. When prompted for
the last cylinder, hit enter to create a partition that takes up the rest of the
remaining space on your disk. After completing these steps, typing <c>p</c>
should display a partition table that looks similar to this:
</p>
<pre caption="Partition listing after creating the root partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 * 1 14 105808+ 83 Linux
/dev/hda2 15 81 506520 82 Linux swap
/dev/hda3 82 3876 28690200 83 Linux
</pre>
</body>
</subsection>
<subsection>
<title>Saving the Partition Layout</title>
<body>
<p>
To save the partition layout and exit <c>fdisk</c>, type <c>w</c>.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available. Some of them are found stable on the amd64
architecture, others aren't. The following filesystems are found to be stable:
ext2 and ext3. jfs and reiserfs may work but need more testing. If you're really
adventurous you can try the unsupported filesystems.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready and there hasn't been a sufficient track record to
comment positively nor negatively on its general stability at this point.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the boot partition (<path>/dev/hda1</path> in our
example) in ext2 and the root partition (<path>/dev/hda3</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs /dev/hda1</i>
# <i>mke2fs -j /dev/hda3</i>
</pre>
<p>
Now create the filesystems on your newly created partitions.
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/hda2</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/hda2</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/hda3 /mnt/gentoo</i>
# <i>mkdir /mnt/gentoo/boot</i>
# <i>mount /dev/hda1 /mnt/gentoo/boot</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-amd64-kernel.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.6</version>
<date>2006-02-15</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For AMD64-based systems we have <c>gentoo-sources</c> (kernel v2.6 source
patched with amd64 specific fixes for stability, performance and hardware
support).
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>. The
<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Jul 28 11:04 /usr/src/linux -> linux-2.6.12-gentoo-r10
</pre>
<p>
Now it is time to configure and compile your kernel source.
You can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Then we select the exact processor type.
</p>
<pre caption="Selecting processor type and features">
Processor type and features --->
Processor family (AMD-Opteron/Athlon64) --->
( ) AMD-Opteron/Athlon64
( ) Intel EM64T
( ) Generic-x86-64"
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
file system</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
<*> /proc file system support
<*> Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking Support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
If you have a multi-CPU Opteron or a multi-core (e.g. AMD64 X2) system, you
should activate "Symmetric multi-processing support":
</p>
<pre caption="Activating SMP support">
Processor type and features --->
[*] Symmetric multi-processing support
</pre>
<p>
If you use USB Input Devices (like Keyboard or Mouse) don't forget to enable
those as well:
</p>
<pre caption="Activating USB Support for Input Devices">
Device Drivers --->
USB Support --->
<*> USB Human Interface Device (full HID) support
[*] HID input layer support
</pre>
<p>
When you've finished configuring the kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
# <i>make && make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
choice and remember it as you will need it later on when you configure your
bootloader. Remember to replace <path><kernel-version></path> with the
name and version of your kernel.
</p>
<pre caption="Installing the kernel">
# <i>cp arch/x86_64/boot/bzImage /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Configuring Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because
genkernel doesn't require any manual kernel configuration, it is an ideal
solution for those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Now, compile your kernel sources by running <c>genkernel all</c>.
Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware, this compilation will take quite a while to finish!
</p>
<p>
Note that, if your boot partition doesn't use ext2 or ext3 as filesystem you
need to manually configure your kernel using <c>genkernel --menuconfig all</c>
and add support for your filesystem <e>in</e> the kernel (i.e. <e>not</e> as a
module).
</p>
<pre caption="Running genkernel">
# <i>genkernel all</i>
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD)
before your "real" system starts up.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
Now, let's perform one more step to get our system to be more like the
Installation CD -- let's emerge <c>coldplug</c>. While the initrd autodetects
hardware that is needed to boot your system, <c>coldplug</c> autodetects
everything else. To emerge and enable <c>coldplug</c>, type the following:
</p>
<pre caption="Emerging and enabling coldplug">
# <i>emerge coldplug</i>
# <i>rc-update add coldplug boot</i>
</pre>
</body>
</section>
<section id="kernel_modules">
<title>Configuring Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.4</path> (or <path>kernel-2.6</path>).
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> file and enter the module name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-amd64-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-amd64-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-amd64-medium.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>Any AMD64 CPU *</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
You should check the <uri link="http://amd64.gentoo.org">Gentoo
AMD64 Project Page</uri> before proceeding.
</p>
</body>
</subsection>
</section>
<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/amd64/) -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can successfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
the <path>releases/amd64/2005.1-r1/installcd</path> directory;
the Package CD is located in the <path>releases/amd64/2005.1/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<p>
Once you have burned your installation CDs, it is time to boot them.
Remove all CDs from the CD drives, reboot your system and enter the BIOS.
This is usually done by hitting DEL, F1
or ESC, depending on your BIOS. Inside the BIOS, change the boot
order so that the CD-ROM is tried before the hard disk. This is often found
under "CMOS Setup". If you don't do this, your system will just reboot from the
hard disk, ignoring the CD-ROM.
</p>
<p>
Now place the installation CD in the CD-ROM drive and reboot. You
should see a boot prompt. At this
screen, you can hit Enter to begin the boot process with the default
boot options, or boot the Installation CD with custom boot options by specifying
a kernel followed by boot options and then hitting Enter.
</p>
<p>
Specifying a kernel? Yes, we provide several kernels on our Installation CD. The
default one is <c>gentoo</c>. Other kernels are for specific hardware needs and
the <c>-nofb</c> variants which disable framebuffer.
</p>
<p>
Below you'll find a short overview on the available kernels:
</p>
<table>
<tr>
<th>Kernel</th>
<th>Description</th>
</tr>
<tr>
<ti>gentoo</ti>
<ti>Default kernel with support for K8 CPUs with NUMA</ti>
</tr>
</table>
<p>
You can also provide kernel options. They represent optional settings
you can (de)activate at will. The following code listing explains all available
kernel options.
</p>
<pre caption="Available boot options">
- agpgart loads agpgart (use if you have graphic problems,lockups)
- acpi=on loads support for ACPI firmware
- ide=nodma force disabling of DMA for malfunctioning IDE devices
- doscsi scan for scsi devices (breaks some ethernet cards)
- dopcmcia starts pcmcia service for PCMCIA cdroms
- nofirewire disables firewire modules in initrd (for firewire cdroms,etc)
- nokeymap disables keymap selection for non-us keyboard layouts
- docache cache the entire runtime portion of cd in RAM, allows you
to umount /mnt/cdrom to mount another cdrom.
- nodetect causes hwsetup/kudzu and hotplug not to run
- nousb disables usb module load from initrd, disables hotplug
- nodhcp dhcp does not automatically start if nic detected
- nohotplug disables loading hotplug service
- noapic disable apic (try if having hardware problems nics,scsi,etc)
- noevms2 disable loading of EVMS2 modules
- nolvm2 disable loading of LVM2 modules
- hdx=stroke allows you to partition the whole harddrive even when your BIOS
can't handle large harddrives
- noload=module1[,module2[,...]]
disable loading of specific kernel modules
</pre>
<p>
Now boot your CD, select a kernel (if you are not happy with the default
<c>gentoo</c> kernel) and boot options. As an example, we show you how
to boot the <c>gentoo</c> kernel, with <c>dopcmcia</c> as kernel
parameters:
</p>
<pre caption="Booting an Installation CD">
boot: <i>gentoo dopcmcia</i>
</pre>
<p>
You will then be greeted with a boot screen and progress bar. If you are
installing Gentoo on a system with a non-US keyboard, make sure you
immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
selection is made in 10 seconds, the default (US keyboard) will be accepted and
the boot process will continue. Once the boot process completes, you will be
automatically logged in to the "Live" Gentoo Linux as
"root", the super user. You should have a root ("#") prompt
on the current console and can also switch to other consoles by pressing Alt-F2,
Alt-F3 and Alt-F4. Get back to the one you started on by pressing Alt-F1.
</p>
<p>
Now continue with <uri link="#hardware">Extra Hardware
Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases it may
not auto-load the kernel modules you need. If the PCI auto-detection missed
some of your system's hardware, you will have to load the appropriate kernel
modules manually.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
<p>
If you need PCMCIA support, you should start the <c>pcmcia</c> init script:
</p>
<pre caption="Starting the PCMCIA init script">
# <i>/etc/init.d/pcmcia start</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-config.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-config.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-config.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-config.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-config.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2005-11-19</date>
<section>
<title>Filesystem Information</title>
<subsection>
<title>What is fstab?</title>
<body>
<p>
Under Linux, all partitions used by the system must be listed in
<path>/etc/fstab</path>. This file contains the mountpoints of those partitions
(where they are seen in the file system structure), how they should be mounted
and with what special options (automatically or not, whether users can mount
them or not, etc.)
</p>
</body>
</subsection>
<subsection>
<title>Creating /etc/fstab</title>
<body>
<p>
<path>/etc/fstab</path> uses a special syntax. Every line consists of six
fields, separated by whitespace (space(s), tabs or a mixture). Each field has
its own meaning:
</p>
<ul>
<li>
The first field shows the <b>partition</b> described (the path to the device
file)
</li>
<li>
The second field shows the <b>mountpoint</b> at which the partition should be
mounted
</li>
<li>
The third field shows the <b>filesystem</b> used by the partition
</li>
<li>
The fourth field shows the <b>mountoptions</b> used by <c>mount</c> when it
wants to mount the partition. As every filesystem has its own mountoptions,
you are encouraged to read the mount man page (<c>man mount</c>) for a full
listing. Multiple mountoptions are comma-separated.
</li>
<li>
The fifth field is used by <c>dump</c> to determine if the partition needs to
be <b>dump</b>ed or not. You can generally leave this as <c>0</c> (zero).
</li>
<li>
The sixth field is used by <c>fsck</c> to determine the order in which
filesystems should be <b>check</b>ed if the system wasn't shut down properly.
The root filesystem should have <c>1</c> while the rest should have <c>2</c>
(or <c>0</c> if a filesystem check isn't necessary).
</li>
</ul>
<p>
The default <path>/etc/fstab</path> file provided by Gentoo <e>is no valid fstab
file</e>, so start <c>nano</c> (or your favorite editor) to create your
<path>/etc/fstab</path>:
</p>
<pre caption="Opening /etc/fstab">
# <i>nano -w /etc/fstab</i>
</pre>
<p>
Let us take a look at how we write down the options for the <path>/boot</path>
partition. This is just an example, so if your architecture doesn't require a
<path>/boot</path> partition (such as <b>PPC</b>), don't copy it verbatim.
</p>
<p>
In our default x86 partitioning example <path>/boot</path> is the
<path>/dev/hda1</path> partition, with <c>ext2</c> as filesystem.
It needs to be checked during boot, so we would write down:
</p>
<pre caption="An example /boot line for /etc/fstab">
/dev/hda1 /boot ext2 defaults 1 2
</pre>
<p>
Some users don't want their <path>/boot</path> partition to be mounted
automatically to improve their system's security. Those people should
substitute <c>defaults</c> with <c>noauto</c>. This does mean that you need to
manually mount this partition every time you want to use it.
</p>
<p>
Now, to improve performance, most users would want to add the <c>noatime</c>
option as mountoption, which results in a faster system since access times
aren't registered (you don't need those generally anyway):
</p>
<pre caption="An improved /boot line for /etc/fstab">
/dev/hda1 /boot ext2 defaults,noatime 1 2
</pre>
<p>
If we continue with this, we would end up with the following three lines (for
<path>/boot</path>, <path>/</path> and the swap partition):
</p>
<pre caption="Three /etc/fstab lines">
/dev/hda1 /boot ext2 defaults,noatime 1 2
/dev/hda2 none swap sw 0 0
/dev/hda3 / ext3 noatime 0 1
</pre>
<p>
To finish up, you should add a rule for <path>/proc</path>, <c>tmpfs</c>
(required) and for your CD-ROM drive (and of course, if you have other
partitions or drives, for those too):
</p>
<pre caption="A full /etc/fstab example">
/dev/hda1 /boot ext2 defaults,noatime 1 2
/dev/hda2 none swap sw 0 0
/dev/hda3 / ext3 noatime 0 1
none /proc proc defaults 0 0
none /dev/shm tmpfs nodev,nosuid,noexec 0 0
/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
</pre>
<p>
<c>auto</c> makes <c>mount</c> guess for the filesystem (recommended for
removable media as they can be created with one of many filesystems) and
<c>user</c> makes it possible for non-root users to mount the CD.
</p>
<p>
Now use the above example to create your <path>/etc/fstab</path>. If you are a
<b>SPARC</b>-user, you should add the following line to your
<path>/etc/fstab</path>
too:
</p>
<pre caption="Adding openprom filesystem to /etc/fstab">
none /proc/openprom openpromfs defaults 0 0
</pre>
<p>
Double-check your <path>/etc/fstab</path>, save and quit to continue.
</p>
</body>
</subsection>
</section>
<section>
<title>Networking Information</title>
<subsection>
<title>Hostname, Domainname etc.</title>
<body>
<p>
One of the choices the user has to make is name his/her PC. This seems to be
quite easy, but <e>lots</e> of users are having difficulties finding the
appropriate name for their Linux-pc. To speed things up, know that any name you
choose can be changed afterwards. For all we care, you can just call your system
<c>tux</c> and domain <c>homenetwork</c>.
</p>
<p>
We use these values in the next examples. First we set the hostname:
</p>
<pre caption="Setting the hostname">
# <i>nano -w /etc/conf.d/hostname</i>
<comment>(Set the HOSTNAME variable to your hostname)</comment>
HOSTNAME="<i>tux</i>"
</pre>
<p>
Second we set the domainname:
</p>
<pre caption="Setting the domainname">
# <i>nano -w /etc/conf.d/domainname</i>
<comment>(Set the DNSDOMAIN variable to your domain name)</comment>
DNSDOMAIN="<i>homenetwork</i>"
</pre>
<p>
If you have a NIS domain (if you don't know what that is, then you don't have
one), you need to define that one too:
</p>
<pre caption="Setting the NIS domainname">
# <i>nano -w /etc/conf.d/domainname</i>
<comment>(Set the NISDOMAIN variable to your NIS domain name)</comment>
NISDOMAIN="<i>my-nisdomain</i>"
</pre>
<p>
Now add the <c>domainname</c> script to the default runlevel:
</p>
<pre caption="Adding domainname to the default runlevel">
# <i>rc-update add domainname default</i>
</pre>
</body>
</subsection>
<subsection>
<title>Configuring your Network</title>
<body>
<p>
Before you get that "Hey, we've had that already"-feeling, you should remember
that the networking you set up in the beginning of the Gentoo installation was
just for the installation. Right now you are going to configure networking for
your Gentoo system permanently.
</p>
<note>
More detailed information about networking, including advanced topics like
bonding, bridging, 802.1Q VLANs or wireless networking is covered in the <uri
link="?part=4">Gentoo Network Configuration</uri> section.
</note>
<p>
All networking information is gathered in <path>/etc/conf.d/net</path>. It uses
a straightforward yet not intuitive syntax if you don't know how to set up
networking manually. But don't fear, we'll explain everything. A fully
commented example that covers many different configurations is available in
<path>/etc/conf.d/net.example</path>.
</p>
<p>
DHCP is used by default and does not require any further configuration.
</p>
<p>
If you need to configure your network connection either because you need
specific DHCP options or because you do not use DHCP at all, open
<path>/etc/conf.d/net</path> with your favorite editor (<c>nano</c> is used in
this example):
</p>
<pre caption="Opening /etc/conf.d/net for editing">
# <i>nano -w /etc/conf.d/net</i>
</pre>
<p>
You will see the following file:
</p>
<pre caption="Default /etc/conf.d/net">
# This blank configuration will automatically use DHCP for any net.*
# scripts in /etc/init.d. To create a more complete configuration,
# please review /etc/conf.d/net.example and save your configuration
# in /etc/conf.d/net (this file :]!).
</pre>
<p>
To enter your own IP address, netmask and gateway, you need
to set both <c>config_eth0</c> and <c>routes_eth0</c>:
</p>
<pre caption="Manually setting IP information for eth0">
config_eth0=( "192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" )
routes_eth0=( "default gw 192.168.0.1" )
</pre>
<p>
To use DHCP and add specific DHCP options, define <c>config_eth0</c> and
<c>dhcp_eth0</c>:
</p>
<pre caption="Automatically obtaining an IP address for eth0">
config_eth0=( "dhcp" )
dhcp_eth0="nodns nontp nonis"
</pre>
<p>
Please read <path>/etc/conf.d/net.example</path> for a list of all available
options.
</p>
<p>
If you have several network interfaces repeat the above steps for
<c>config_eth1</c>, <c>config_eth2</c>, etc.
</p>
<p>
Now save the configuration and exit to continue.
</p>
</body>
</subsection>
<subsection>
<title>Automatically Start Networking at Boot</title>
<body>
<p>
To have your network interfaces activated at boot, you need to add them to the
default runlevel. If you have PCMCIA interfaces you should skip this action as
the PCMCIA interfaces are started by the PCMCIA init script.
</p>
<pre caption="Adding net.eth0 to the default runlevel">
# <i>rc-update add net.eth0 default</i>
</pre>
<p>
If you have several network interfaces, you need to create the appropriate
<path>net.eth1</path>, <path>net.eth2</path> etc. initscripts for those. You can
use <c>ln</c> to do this:
</p>
<pre caption="Creating extra initscripts">
# <i>cd /etc/init.d</i>
# <i>ln -s net.eth0 net.eth1</i>
# <i>rc-update add net.eth1 default</i>
</pre>
</body>
</subsection>
<subsection>
<title>Writing Down Network Information</title>
<body>
<p>
You now need to inform Linux about your network. This is defined in
<path>/etc/hosts</path> and helps in resolving hostnames to IP addresses
for hosts that aren't resolved by your nameserver. For instance, if your
internal network consists of three PCs called <c>jenny</c> (192.168.0.5),
<c>benny</c> (192.168.0.6) and <c>tux</c> (192.168.0.7 - this system) you would
open <path>/etc/hosts</path> and fill in the values:
</p>
<pre caption="Opening /etc/hosts">
# <i>nano -w /etc/hosts</i>
</pre>
<pre caption="Filling in the networking information">
127.0.0.1 localhost
192.168.0.5 jenny.homenetwork jenny
192.168.0.6 benny.homenetwork benny
192.168.0.7 tux.homenetwork tux
</pre>
<p>
If your system is the only system (or the nameservers handle all name
resolution) a single line is sufficient. For instance, if you want to call your
system <c>tux</c>:
</p>
<pre caption="/etc/hosts for lonely or fully integrated PCs">
127.0.0.1 localhost tux
</pre>
<p>
Save and exit the editor to continue.
</p>
<p>
If you don't have PCMCIA, you can now continue with <uri
link="#doc_chap3">System Information</uri>. PCMCIA-users should read the
following topic on PCMCIA.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Get PCMCIA Working</title>
<body>
<note>
pcmcia-cs is only available for x86, amd64 and ppc platforms.
</note>
<p>
PCMCIA-users should first install the <c>pcmcia-cs</c> package. This also
includes users who will be working with a 2.6 kernel (even though they won't be
using the PCMCIA drivers from this package). The <c>USE="-X"</c> is necessary
to avoid installing xorg-x11 at this moment:
</p>
<pre caption="Installing pcmcia-cs">
# <i>USE="-X" emerge pcmcia-cs</i>
</pre>
<p>
When <c>pcmcia-cs</c> is installed, add <c>pcmcia</c> to the <e>default</e>
runlevel:
</p>
<pre caption="Adding pcmcia to the default runlevel">
# <i>rc-update add pcmcia default</i>
</pre>
</body>
</subsection>
</section>
<section>
<title>System Information</title>
<subsection>
<title>Root Password</title>
<body>
<p>
First we set the root password by typing:
</p>
<pre caption="Setting the root password">
# <i>passwd</i>
</pre>
<p>
If you want root to be able to log on through the serial console, add
<c>tts/0</c> to <path>/etc/securetty</path>:
</p>
<pre caption="Adding tts/0 to /etc/securetty">
# <i>echo "tts/0" >> /etc/securetty</i>
</pre>
</body>
</subsection>
<subsection>
<title>System Information</title>
<body>
<p>
Gentoo uses <path>/etc/rc.conf</path> for general, system-wide configuration.
Open up <path>/etc/rc.conf</path> and enjoy all the comments in that file :)
</p>
<pre caption="Opening /etc/rc.conf">
# <i>nano -w /etc/rc.conf</i>
</pre>
<p>
When you're finished configuring <path>/etc/rc.conf</path>, save and exit.
</p>
<p>
As you can see, this file is well commented to help you set up the necessary
configuration variables. You can configure your system to use unicode and
define your default editor and your display manager (like gdm or kdm).
</p>
<p>
Gentoo uses <path>/etc/conf.d/keymaps</path> to handle keyboard configuration.
Edit it to configure your keyboard.
</p>
<pre caption="Opening /etc/conf.d/keymaps">
# <i>nano -w /etc/conf.d/keymaps</i>
</pre>
<p>
Take special care with the <c>KEYMAP</c> variable. If you select the wrong
<c>KEYMAP</c>, you will get weird results when typing on your keyboard.
</p>
<note>
Users of USB-based <b>SPARC</b> systems and <b>SPARC</b> clones might need to
select an i386 keymap (such as "us") instead of "sunkeymap". <b>PPC</b> uses x86
keymaps on most systems. Users who want to be able to use ADB keymaps on boot
have to enable ADB keycode sendings in their kernel and have to set a mac/ppc
keymap in <path>/etc/conf.d/keymaps</path>.
</note>
<p>
When you're finished configuring <path>/etc/conf.d/keymaps</path>, save and
exit.
</p>
<p>
Gentoo uses <path>/etc/conf.d/clock</path> to set clock options. Edit it
according to your needs.
</p>
<pre caption="Opening /etc/conf.d/clock">
# <i>nano -w /etc/conf.d/clock</i>
</pre>
<p>
If your hardware clock is not using UTC, you need to add <c>CLOCK="local"</c> to
the file. Otherwise you will notice some clock skew.
</p>
<p>
When you're finished configuring <path>/etc/conf.d/clock</path>, save and
exit.
</p>
<p>
If you are not installing Gentoo on IBM PPC64 hardware, continue with
<uri link="?part=1&chap=9">Installing Necessary System Tools</uri>.
</p>
</body>
</subsection>
<subsection>
<title>Configuring the Console</title>
<body>
<note>
The following section applies to the IBM PPC64 hardware platforms.
</note>
<p>
If you are running Gentoo on IBM PPC64 hardware and using a virtual console
you must uncomment the appropriate line in <path>/etc/inittab</path> for the
virtual console to spawn a login prompt.
</p>
<pre caption="Enabling hvc or hvsi support in /etc/inittab">
hvc0:12345:respawn:/sbin/agetty -L 9600 hvc0
hvsi:12345:respawn:/sbin/agetty -L 19200 hvsi0
</pre>
<p>
You should also take this time to verify that the appropriate console is
listed in <path>/etc/securetty</path>.
</p>
<p>
You may now continue with <uri link="?part=1&chap=9">Installing Necessary
System Tools</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-finalise.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-finalise.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-finalise.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-finalise.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-finalise.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2006-01-23</date>
<section>
<title>User Administration</title>
<subsection>
<title>Adding a User for Daily Use</title>
<body>
<p>
Working as root on a Unix/Linux system is <e>dangerous</e> and should be avoided
as much as possible. Therefore it is <e>strongly</e> recommended to add a user
for day-to-day use.
</p>
<p>
The groups the user is member of define what activities the user can perform.
The following table lists a number of important groups you might wish to use:
</p>
<table>
<tr>
<th>Group</th>
<th>Description</th>
</tr>
<tr>
<ti>audio</ti>
<ti>be able to access the audio devices</ti>
</tr>
<tr>
<ti>cdrom</ti>
<ti>be able to directly access optical devices</ti>
</tr>
<tr>
<ti>floppy</ti>
<ti>be able to directly access floppy devices</ti>
</tr>
<tr>
<ti>games</ti>
<ti>be able to play games</ti>
</tr>
<tr>
<ti>portage</ti>
<ti>be able to use <c>emerge --pretend</c> as a normal user</ti>
</tr>
<tr>
<ti>usb</ti>
<ti>be able to access USB devices</ti>
</tr>
<tr>
<ti>plugdev</ti>
<ti>
Be able to mount and use pluggable devices such as cameras and USB sticks
</ti>
</tr>
<tr>
<ti>video</ti>
<ti>
be able to access video capturing hardware and doing hardware
acceleration
</ti>
</tr>
<tr>
<ti>wheel</ti>
<ti>be able to use <c>su</c></ti>
</tr>
</table>
<p>
For instance, to create a user called <c>john</c> who is member of the
<c>wheel</c>, <c>users</c> and <c>audio</c> groups, log in as root first
(only root can create users) and run <c>useradd</c>:
</p>
<pre caption="Adding a user for day-to-day use">
Login: <i>root</i>
Password: <comment>(Your root password)</comment>
# <i>useradd -m -G users,wheel,audio -s /bin/bash john</i>
# <i>passwd john</i>
Password: <comment>(Enter the password for john)</comment>
Re-enter password: <comment>(Re-enter the password to verify)</comment>
</pre>
<p>
If a user ever needs to perform some task as root, they can use <c>su -</c>
to temporarily receive root privileges. Another way is to use the <c>sudo</c>
package which is, if correctly configured, very secure.
</p>
</body>
</subsection>
</section>
<section>
<title>Optional: Install GRP Packages</title>
<body>
<impo>
This part is for GRP users only. Other users should skip this part and continue
with <uri link="?part=1&chap=12">Where to go from here?</uri>.
</impo>
<p>
Now that your system is booted, log on as the user you created (for instance,
<c>john</c>) and use <c>su -</c> to gain root privileges:
</p>
<pre caption="Gaining root privileges">
$ <i>su -</i>
Password: <comment>(Enter your root password)</comment>
</pre>
<p>
Now we need to change the Portage configuration to look for the prebuilt
binaries from the second CD (Gentoo Packages CD). First mount this CD:
</p>
<pre caption="Mount the Packages CD">
<comment>(Put the Gentoo Packages CD in the CD tray)</comment>
# <i>mount /mnt/cdrom</i>
</pre>
<p>
Now configure Portage to use <path>/mnt/cdrom</path> for its prebuilt packages:
</p>
<pre caption="Configuring Portage to use /mnt/cdrom">
# <i>ls /mnt/cdrom</i>
<comment>(If there is a /mnt/cdrom/packages directory:)</comment>
# <i>export PKGDIR="/mnt/cdrom/packages"</i>
<comment>(Otherwise:)</comment>
# <i>export PKGDIR="/mnt/cdrom"</i>
</pre>
<p>
Now install the packages you want. The Packages CD contains several prebuilt
binaries, for instance KDE and GNOME.
</p>
<pre caption="Installing GNOME">
# <i>emerge --usepkg gnome</i>
</pre>
<p>
To find out what prebuilt packages are available, do a quick listing of all
the files in <path>/mnt/cdrom/All</path>. For instance, to find out if KDE is
emergeable:
</p>
<pre caption="Finding out if KDE is installable">
# <i>ls /mnt/cdrom/All/kde*</i>
</pre>
<p>
Be sure to install the binaries now. When you do an <c>emerge --sync</c> to
update Portage (as you will learn later), the prebuilt binaries might not match
against the ebuilds in your updated Portage. You can try to circumvent this by
using <c>emerge --usepkgonly</c> instead of <c>emerge --usepkg</c>.
</p>
<p>
Congratulations, your system is now fully equipped! Continue with <uri
link="?part=1&chap=12">Where to go from here?</uri> to learn more about
Gentoo.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-bootloader.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2006-01-19</date>
<section>
<title>Installing PALO</title>
<body>
<p>
On the PA-RISC platform, the boot loader is called palo. You can find
the configuration file in <path>/etc/palo.conf</path>. Here is a sample
configuration:
</p>
<pre caption = "/etc/palo.conf example">
--commandline=2/kernel-2.6.12.2-pa2 root=/dev/sda4
--recoverykernel=/vmlinux.old
--init-partitioned=/dev/sda
</pre>
<p>
The first line tells palo the location of the kernel and which boot
parameters it must use. <c>2/kernel-2.6.12.2-pa2</c> means the kernel named
<c>kernel-2.6.12.2-pa2</c> resides on the second partition. Beware, the path
to the kernel is relative to the partition, not to the root of your filesystem.
</p>
<p>
The second line indicates which recovery kernel to use. If it is your
first install and you do not have a recovery kernel, please comment this
out. The third line indicates on which disk palo will reside.
</p>
<p>
When configuration is done, just run <c>palo</c>.
</p>
<pre caption = "Applying the PALO configuration">
# <i>palo</i>
</pre>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-hppa-disk.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-25</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first SCSI HD in a Linux system, namely
<path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions and Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On most systems,
these are called <e>partitions</e>. Other architectures use a similar technique,
called <e>slices</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
</body>
</subsection>
</section>
<section>
<title>Using fdisk on HPPA to Partition your Disk</title>
<body>
<p>
Use <c>fdisk</c> to create the partitions you want:
</p>
<pre caption="Partitioning the disk">
# <i>fdisk /dev/sda</i>
</pre>
<p>
HPPA machines use the PC standard DOS partition tables. To create a new
DOS partition table, simply use the <c>o</c> command.
</p>
<pre caption="Creating a DOS partition table">
# <i>fdisk /dev/sda</i>
Command (m for help): <i>o</i>
Building a new DOS disklabel.
</pre>
<p>
PALO (the HPPA bootloader) needs a special partition to work. You have
to create a partition of at least 16MB at the beginning of your disk.
The partition type must be of type <e>f0</e> (Linux/PA-RISC boot).
</p>
<impo>
If you ignore this and continue without a special PALO partition, your system
will stop loving you and fail to start. Also, if your disk is larger than 2GB,
make sure that the boot partition is in the first 2GB of your disk. PALO is
unable to read a kernel after the 2GB limit.
</impo>
<pre caption="A simple default partition schema">
# <i>cat /etc/fstab</i>
/dev/sda2 /boot ext3 noauto,noatime 1 1
/dev/sda3 none swap sw 0 0
/dev/sda4 / ext3 noatime 0 0
# <i>fdisk /dev/sda</i>
Command (m for help): <i>p</i>
Disk /dev/sda: 4294 MB, 4294816768 bytes
133 heads, 62 sectors/track, 1017 cylinders
Units = cylinders of 8246 * 512 = 4221952 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 8 32953 f0 Linux/PA-RISC boot
/dev/sda2 9 20 49476 83 Linux
/dev/sda3 21 70 206150 82 Linux swap
/dev/sda4 71 1017 3904481 83 Linux
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available. Ext2, ext3, XFS and reiserfs are found stable on
the HPPA architecture. The others are very experimental.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready and there hasn't been a sufficient track record to
comment positively nor negatively on its general stability at this point.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the boot partition (<path>/dev/sda2</path> in our
example) in ext2 and the root partition (<path>/dev/sda4</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs /dev/sda2</i>
# <i>mke2fs -j /dev/sda4</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/sda3</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/sda3</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/sda4 /mnt/gentoo</i>
# <i>mkdir /mnt/gentoo/boot</i>
# <i>mount /dev/sda2 /mnt/gentoo/boot</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-hppa-kernel.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For HPPA we have <c>hppa-sources</c>. Default these sources are based on the
2.6 kernel sources. If you want to install a 2.4 kernel, you will need to
install Gentoo from a working Internet connection as we do not supply those
sources on our Installation CD. Continue by installing the kernel source. The
<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge hppa-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>hppa-sources-2.6.12.2-pa2</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.12.2-pa2
</pre>
<p>
Now it is time to configure and compile your kernel source. All architectures
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
file system</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
If you have a HIL mouse or keyboard, do not forget to compile in support for
them.
</p>
<pre caption="Activating HIL support">
Input core support --->
[*] Keyboard support
[*] Mouse support
[*] Event interface support
</pre>
<p>
If you have no mouse on your HIL port, only use the basic support:
</p>
<pre caption="Basic HIL support">
HIL support --->
[*] HIL Keyboard (basic) support
</pre>
<p>
If you however want <e>full</e> HIL support, select the following options:
</p>
<pre caption="Full HIL support">
HIL support --->
[*] HP System Device Controller i8042 Support
[*] HIL MLC Support
[*] HIL Keyboard (full) support
[*] HIL Mouse & Pointer support
</pre>
<p>
Also include display driver support:
</p>
<pre caption="Display Driver support">
Graphics support --->
[*] Support for frame buffer devices
[*] HP STI frame buffer device support
Console display driver support --->
[*] STI text console
</pre>
<p>
When you're done configuring your kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
# <i>make && make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
choice and remember it as you will need it later on when you configure your
bootloader. Remember to replace <path><kernel-version></path> with the
name and version of your kernel.
</p>
<pre caption="Installing the kernel">
# <i>cp vmlinux /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Configuring Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because genkernel
doesn't require any manual kernel configuration, it is an ideal solution for
those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Now, compile your kernel sources by running <c>genkernel all</c>.
Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware, this compilation will take quite a while to finish!
</p>
<p>
Note that, if your boot partition doesn't use ext2 or ext3 as filesystem you
need to manually configure your kernel using <c>genkernel --menuconfig all</c>
and add support for your filesystem <e>in</e> the kernel (i.e. <e>not</e> as a
module).
</p>
<pre caption="Running genkernel">
# <i>genkernel all</i>
<comment>(Output removed to increase readability)</comment>
* Kernel compiled successfully!
* Required Kernel Params:
* : root=/dev/ram0 init=/linuxrc real_root=/dev/$ROOT
* where $ROOT is the devicenode for your root partition as
* you should have specified in /etc/fstab
*
* You MUST tell your bootloader to use the generated initrd
*
* Recommended Kernel Params:
* : vga=0x317 splash=verbose
*
* Do NOT report kernel bugs (configs included) as genkernel bugs.
* Make sure you have the latest genkernel before reporting bugs
*
* For more info see /usr/share/genkernel/README
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD)
before your "real" system starts up.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
Now, let's perform one more step to get our system to be more like the
Installation CD -- let's emerge <c>coldplug</c>. While the initrd autodetects
hardware that is needed to boot your system, <c>coldplug</c> autodetects
everything else. To emerge and enable <c>coldplug</c>, type the following:
</p>
<pre caption="Emerging and enabling coldplug">
# <i>emerge coldplug</i>
# <i>rc-update add coldplug default</i>
</pre>
</body>
</section>
<section id="kernel_modules">
<title>Configuring Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.6</path>.
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> file and enter the module
name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-hppa-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-hppa-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-hppa-medium.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<p>
A list of supported hardware can be found on the
<uri link="http://www.pateam.org/list.html">PA Team website</uri>.
You may find additional information about your box in the <uri
link="http://hwdb.parisc-linux.org">Parisc-Linux Hardware Database</uri>.
</p>
<table>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- Copy/paste from hb-install-x86-medium.xml -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can successfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
the <path>releases/hppa/2005.1/installcd</path> directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<note>
If you have problems booting the Installation CD or any other media, please
read the <uri
link="http://www.tldp.org/HOWTO/PA-RISC-Linux-Boot-HOWTO/index.html">
PA-RISC Linux Boot HOWTO</uri>.
</note>
<p>
Boot your HPPA system. During the boot process, you will see a message similar
to the following:
</p>
<pre caption="HPPA boot message">
Searching for Potential Boot Devices.
To terminate search, press and hold the ESCAPE key.
</pre>
<p>
When this message appears, press and hold the Esc-key until an option menu
appears. This can take a while, be patient. By default, you should enter the
BOOT_ADMIN console. If you receive an option menu, choose <c>Enter Boot
Administration mode</c> to enter the BOOT_ADMIN console. You should now have an
'>' prompt.
</p>
<p>
Put the Gentoo Installation CD in the CD-ROM. If you do not know the SCSI ID of
your CD-ROM drive, your PA-RISC station will search for it when you issue the
<c>search</c> command.
</p>
<pre caption="Searching for SCSI ID">
> <i>search</i>
Searching for Devices with Bootable Media.
To terminate search, please press and hold the ESCAPE key.
</pre>
<p>
Your PA-RISC station will now display all the available boot media. This is an
example result of this command:
</p>
<pre caption="Available boot media">
Device Selection Device Path Device Type and Utilities
---------------------------------------------------------------------------
P0 scsi.5.0 TOSHIBA CD-ROM XM-3301TA
IPL
P1 scsi.2.0 COMPAQ ST32550N
IPL
P2 lan.0010a7-06d1b6.3.6 server
IPL
</pre>
<p>
To boot from a CD-ROM you need the accompanying Device Path. For instance, if we
want to boot from the TOSHIBA CD-ROM in the above example, we would need to type
the following command:
</p>
<pre caption="Booting from a CD-ROM">
> <i>boot scsi.5.0 ipl</i>
Trying scsi.5.0
</pre>
<p>
The <c>ipl</c> keyword (Initial Program Loader) tells palo (the PA-RISC boot
LOader) to enter interactive mode. This will allow you to change, for example,
the kernel boot parameters.
</p>
<p>
When the boot is successful, palo will start in interactive mode:
</p>
<pre caption="PALO Interactive Mode">
Boot path initialized.
Attempting to load IPL.
HARD Booted.
palo ipl 1.5 root@hope Sat Apr 23 18:06:47 CEST 2005
Boot image contains:
0/vmlinux32 6241293 bytes @ 0x3904000
0/vmlinux64 8352719 bytes @ 0x3ef8000
0/ramdisk 1007589 bytes @ 0x105800
Information: No console specified on kernel command line. This is normal.
PALO will choose the console currently used by firmware (serial).Current command line:
0/vmlinux initrd=initrd TERM=linux root=/dev/ram0 init=/linuxrc cdroot looptype=squashfs loop=/livecd.squashfs hda=scsi console=ttyS0
0: 0/vmlinux
1: initrd=initrd
2: TERM=linux
3: root=/dev/ram0
4: init=/linuxrc
5: cdroot
6: looptype=squashfs
7: loop=/livecd.squashfs
8: hda=scsi
9: console=ttyS0
<#> edit the numbered field
'b' boot with this command line
'r' restore command line
'l' list dir
</pre>
<p>
These parameters are suitable for most situations.
</p>
<p>
If you need extra features you must add the appropriate keyword(s) to the end of
the command line. To add a keyword, edit the last field, add a space and type
your keyword. The only implemented keywords as of now are <c>cdcache</c> which
tells the Installation CD to load itself into RAM, allowing you to unmount the
CD, and <c>noload=module1[,module2[,...]]</c> which allows you to explicitly
disable loading of particular modules.
</p>
<pre caption="Adding hdb=scsi as boot option">
(or 'b' to boot with this command line)? <i>9</i>
console=ttyS0 <i>hdb=scsi</i>
</pre>
<p>
Now that you have tweaked your kernel boot params, boot it.
</p>
<pre caption="Booting the kernel">
(or 'b' to boot with this command line)? <i>b</i>
</pre>
<p>
You should have a root ("#") prompt on the current console and can also switch
to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you
started on by pressing Alt-F1.
</p>
<p>
Now continue with <uri link="#hardware">Extra Hardware
Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
Most hppa machines have an onboard ethernet card. Old ones use the lasi driver
which is compiled in the kernel. Newer ones need the tulip driver which is
compiled as a module. To use the latter, you need to load its driver.
</p>
<p>
In the next example, we try to load the <c>tulip</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe tulip</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-hppa.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-network.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-network.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-network.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-network.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-network.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-08</date>
<section>
<title>Do you need Networking?</title>
<subsection>
<title>Who can do without?</title>
<body>
<p>
Generally, you don't need a working network connection to install Gentoo using
the Universal Installation CD. However, there are some circumstances where you
do want to have a working Internet connection:
</p>
<ul>
<li>
The stage3 files that are stored in the Universal Installation CD do not
match your architecture and you need to download the correct stage3 file
</li>
<li>
You need to install a specific networking application that will allow you to
connect to the Internet which isn't available on the Universal Installation
CD but is supported by the Installation CD (i.e. you can connect to the
Internet using the Installation CD but the necessary sources are not
available on the Installation CD)
</li>
<li>
You want remote assistance during the installation (using SSH or through
direct conversations using IRC)
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Do I need Networking?</title>
<body>
<p>
To find out if the stage3 file for your architecture is available, take a look
inside <path>/mnt/cdrom/stages</path> and check if one of the available stages
matches your architecture. If not, you can still opt for a stage3 file of an
architecture compatible with yours.
</p>
<p>
If you on the other hand want to use a stage3 file optimized for your
architecture and the stage3 file of your choice is not available, then you will
need networking to download the appropriate stage3 file.
</p>
<p>
So, if you don't need networking, you can skip the rest of this chapter and
continue with <uri link="?part=1&chap=4">Preparing the Disks</uri>.
Otherwise, continue with the networking configuration sections below.
</p>
</body>
</subsection>
</section>
<section>
<title>Automatic Network Detection</title>
<subsection>
<title>Maybe it just works?</title>
<body>
<p>
If your system is plugged into an Ethernet network with a DHCP server, it is
very likely that your networking configuration has already been set up
automatically for you. If so, you should be able to take advantage of the many
included network-aware commands on the Installation CD such as <c>ssh</c>,
<c>scp</c>, <c>ping</c>, <c>irssi</c>, <c>wget</c> and <c>links</c>, among
others.
</p>
<p>
If networking has been configured for you, the <c>/sbin/ifconfig</c> command
should list some network interfaces besides lo, such as eth0:
</p>
<pre caption="/sbin/ifconfig for a working network configuration">
# <i>/sbin/ifconfig</i>
<comment>(...)</comment>
eth0 Link encap:Ethernet HWaddr 00:50:BA:8F:61:7A
inet addr:192.168.0.2 Bcast:192.168.0.255 Mask:255.255.255.0
inet6 addr: fe80::50:ba8f:617a/10 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:1498792 errors:0 dropped:0 overruns:0 frame:0
TX packets:1284980 errors:0 dropped:0 overruns:0 carrier:0
collisions:1984 txqueuelen:100
RX bytes:485691215 (463.1 Mb) TX bytes:123951388 (118.2 Mb)
Interrupt:11 Base address:0xe800
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Configure any Proxies</title>
<body>
<p>
If you access the Internet through a proxy, you might need to set up proxy
information during the installation. It is very easy to define a proxy: you just
need to define a variable which contains the proxy server information.
</p>
<p>
In most cases, you can just define the variables using the server hostname. As
an example, we assume the proxy is called <c>proxy.gentoo.org</c> and the port
is <c>8080</c>.
</p>
<pre caption="Defining proxy servers">
<comment>(If the proxy filters HTTP traffic)</comment>
# <i>export http_proxy="http://proxy.gentoo.org:8080"</i>
<comment>(If the proxy filters FTP traffic)</comment>
# <i>export ftp_proxy="ftp://proxy.gentoo.org:8080"</i>
<comment>(If the proxy filters RSYNC traffic)</comment>
# <i>export RSYNC_PROXY="proxy.gentoo.org:8080"</i>
</pre>
<p>
If your proxy requires a username and password, you should use the following
syntax for the variable:
</p>
<pre caption="Adding username/password to the proxy variable">
http://<i>username</i>:<i>password</i>@proxy.gentoo.org:8080
</pre>
</body>
</subsection>
<subsection>
<title>Testing the Network</title>
<body>
<p>
You may want to try pinging your ISP's DNS server (found in
<path>/etc/resolv.conf</path>) and a Web site of your choice, just to make sure
that your packets are reaching the net, DNS name resolution is working
correctly, etc.
</p>
<pre caption="Further network testing">
# <i>ping -c 3 www.yahoo.com</i>
</pre>
<p>
If you are now able to use your network, you can skip the rest of this
section and continue with <uri link="?part=1&chap=4">Preparing the
Disks</uri>. If not, read on.
</p>
</body>
</subsection>
</section>
<section>
<title>Automatic Network Configuration</title>
<subsection>
<body>
<p>
If the network doesn't work immediately, some installation media allow you to
use <c>net-setup</c> (for regular or wireless networks), <c>adsl-setup</c>
(for ADSL-users) or <c>pptp</c> (for PPTP-users - only available on x86).
</p>
<p>
If your installation medium does not contain any of these tools or your network
doesn't function yet, continue with <uri link="#doc_chap3">Manual Network
Configuration</uri>.
</p>
<ul>
<li>
Regular Ethernet users should continue with <uri
link="#net-setup">Default: Using net-setup</uri>
</li>
<li>
ADSL users should continue with <uri link="#rp-pppoe">Alternative:
Using RP-PPPoE</uri>
</li>
<li>
PPTP users should continue with <uri link="#pptp">Alternative:
Using PPTP</uri>
</li>
</ul>
</body>
</subsection>
<subsection id="net-setup">
<title>Default: Using net-setup</title>
<body>
<p>
The simplest way to set up networking if it didn't get configured
automatically is to run the <c>net-setup</c> script:
</p>
<pre caption="Running the net-setup script">
# <i>net-setup eth0</i>
</pre>
<p>
<c>net-setup</c> will ask you some questions about your network
environment. When all is done, you should have a working network
connection. Test your network connection as stated before. If the tests
are positive, congratulations! You are now ready to install Gentoo. Skip
the rest of this section and continue with <uri
link="?part=1&chap=4">Preparing the Disks</uri>.
</p>
<p>
If your network still doesn't work, continue with <uri link="#doc_chap3">Manual
Network Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="rp-pppoe">
<title>Alternative: Using RP-PPPoE</title>
<body>
<p>
Assuming you need PPPoE to connect to the internet, the Installation CD (any
version) has made things easy for you by including <c>rp-pppoe</c>. Use the
provided <c>adsl-setup</c> script to configure your connection. You will be
prompted for the ethernet device that is connected to your adsl modem, your
username and password, the IPs of your DNS servers and if you need a basic
firewall or not.
</p>
<pre caption="Using rp-pppoe">
# <i>adsl-setup</i>
# <i>adsl-start</i>
</pre>
<p>
If something goes wrong, double-check that you correctly typed your username and
password by looking at <path>/etc/ppp/pap-secrets</path> or
<path>/etc/ppp/chap-secrets</path> and make sure you are using the right
ethernet device. If your ethernet device doesn't exist, you will have to load
the appropriate network modules. In that case you should continue with
<uri link="#doc_chap3">Manual Network Configuration</uri> as we explain how to
load the appropriate network modules there.
</p>
<p>
If everything worked, continue with <uri link="?part=1&chap=4">Preparing the
Disks</uri>.
</p>
</body>
</subsection>
<subsection id="pptp">
<title>Alternative: Using PPTP</title>
<body>
<note>
PPTP support is only available for x86
</note>
<p>
If you need PPTP support, you can use <c>pptpclient</c> which is provided by our
Installation CDs. But first you need to make sure that your configuration is
correct. Edit <path>/etc/ppp/pap-secrets</path> or
<path>/etc/ppp/chap-secrets</path> so it contains the correct username/password
combination:
</p>
<pre caption="Editing /etc/ppp/chap-secrets">
# <i>nano -w /etc/ppp/chap-secrets</i>
</pre>
<p>
Then adjust <path>/etc/ppp/options.pptp</path> if necessary:
</p>
<pre caption="Editing /etc/ppp/options.pptp">
# <i>nano -w /etc/ppp/options.pptp</i>
</pre>
<p>
When all that is done, just run <c>pptp</c> (along with the options you couldn't
set in <path>options.pptp</path>) to connect the server:
</p>
<pre caption="Connection to a dial-in server">
# <i>pptp <server ip></i>
</pre>
<p>
Now continue with <uri link="?part=1&chap=4">Preparing the Disks</uri>.
</p>
</body>
</subsection>
</section>
<section>
<title>Manual Network Configuration</title>
<subsection>
<title>Loading the Appropriate Network Modules</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules (drivers) to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases,
it may not auto-load the kernel modules you need.
</p>
<p>
If <c>net-setup</c> or <c>adsl-setup</c> failed, then it is possible that
your network card wasn't found immediately. This means you may have to load
the appropriate kernel modules manually.
</p>
<p>
To find out what kernel modules we provide for networking, use
<c>ls</c>:
</p>
<pre caption="Searching for provided modules">
# <i>ls /lib/modules/`uname -r`/kernel/drivers/net</i>
</pre>
<p>
If you find a driver for your network card, use <c>modprobe</c> to load
the kernel module:
</p>
<pre caption="Using modprobe to load a kernel module">
<comment>(As an example, we load the pcnet32 module)</comment>
# <i>modprobe pcnet32</i>
</pre>
<p>
To check if your network card is now detected, use <c>ifconfig</c>. A
detected network card would result in something like this:
</p>
<pre caption="Testing availability of your network card, successful">
# <i>ifconfig eth0</i>
eth0 Link encap:Ethernet HWaddr FE:FD:00:00:00:00
BROADCAST NOARP MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)
</pre>
<p>
If however you receive the following error, the network card is not
detected:
</p>
<pre caption="Testing availability of your network card, failed">
# <i>ifconfig eth0</i>
eth0: error fetching interface information: Device not found
</pre>
<p>
If you have multiple network cards in your system they are named <e>eth0</e>,
<e>eth1</e>, etc. Make sure that the network card you want to use works well and
remember to use the correct naming throughout this document. We will assume that
the network card <e>eth0</e> is used.
</p>
<p>
Assuming that you now have a detected network card, you can
retry <c>net-setup</c> or <c>adsl-setup</c> again (which should work
now), but for the hardcore people amongst you we explain how to configure your
network manually.
</p>
<p>
Select one of the following sections based on your network setup:
</p>
<ul>
<li><uri link="#install-dhcp">Using DHCP</uri> for automatic IP retrieval</li>
<li>
<uri link="#wireless">Preparing for Wireless Access</uri> if you have a
wireless card
</li>
<li>
<uri link="#network_term">Understanding Network Terminology</uri> explains
what you need to know about networking
</li>
<li>
<uri link="#ifconfig_route">Using ifconfig and route</uri> explains how to
set up your networking manually
</li>
</ul>
</body>
</subsection>
<subsection id="install-dhcp">
<title>Using DHCP</title>
<body>
<p>
DHCP (Dynamic Host Configuration Protocol) makes it possible to
automatically receive networking information (IP address, netmask,
broadcast address, gateway, nameservers etc.). This only works if you
have a DHCP server in your network (or if your provider provides a DHCP
service). To have a network interface receive this information automatically,
use <c>dhcpcd</c>:
</p>
<pre caption="Using dhcpcd">
# <i>dhcpcd eth0</i>
<comment>Some network admins require that you use the</comment>
<comment>hostname and domainname provided by the DHCP server.</comment>
<comment>In that case, use</comment>
# <i>dhcpcd -HD eth0</i>
</pre>
<p>
If this works (try pinging some internet server, like <uri
link="http://www.google.com">Google</uri>), then you are all set and
ready to continue. Skip the rest of this section and continue with <uri
link="?part=1&chap=4">Preparing the Disks</uri>.
</p>
</body>
</subsection>
<subsection id="wireless">
<title>Preparing for Wireless Access</title>
<body>
<note>
Support for the <c>iwconfig</c> command is only available on x86, amd64 and ppc
Installation CDs. You can still get the extensions working otherwise
by following the instructions of the
<uri link="ftp://ftp.linux-wlan.org/pub/linux-wlan-ng/README">linux-wlan-ng
project</uri>.
</note>
<p>
If you are using a wireless (802.11) card, you may need to configure your
wireless settings before going any further. To see the current wireless settings
on your card, you can use <c>iwconfig</c>. Running <c>iwconfig</c> might show
something like:
</p>
<pre caption="Showing the current wireless settings">
# <i>iwconfig eth0</i>
eth0 IEEE 802.11-DS ESSID:"GentooNode"
Mode:Managed Frequency:2.442GHz Access Point: 00:09:5B:11:CC:F2
Bit Rate:11Mb/s Tx-Power=20 dBm Sensitivity=0/65535
Retry limit:16 RTS thr:off Fragment thr:off
Power Management:off
Link Quality:25/10 Signal level:-51 dBm Noise level:-102 dBm
Rx invalid nwid:5901 Rx invalid crypt:0 Rx invalid frag:0 Tx
excessive retries:237 Invalid misc:350282 Missed beacon:84
</pre>
<note>
Some wireless cards may have a device name of <c>wlan0</c> or <c>ra0</c> instead
of <c>eth0</c>. Run <c>iwconfig</c> without any command-line parameters to
determine the correct device name.
</note>
<p>
For most users, there are only two settings that might be important to change,
the ESSID (aka wireless network name) or the WEP key. If the ESSID and Access
Point address listed are already that of your access point and you are not using
WEP, then your wireless is working. If you need to change your ESSID, or add a
WEP key, you can issue the following commands:
</p>
<pre caption="Changing ESSID and/or adding WEP key">
<comment>(This sets the network name to "GentooNode")</comment>
# <i>iwconfig eth0 essid GentooNode</i>
<comment>(This sets a hex WEP key)</comment>
# <i>iwconfig eth0 key 1234123412341234abcd</i>
<comment>(This sets an ASCII key - prefix it with "s:")</comment>
# <i>iwconfig eth0 key s:some-password</i>
</pre>
<p>
You can then confirm your wireless settings again by using <c>iwconfig</c>.
Once you have wireless working, you can continue configuring the IP level
networking options as described in the next section (<uri
link="#network_term">Understanding Network Terminology</uri>) or use the
<c>net-setup</c> tool as described previously.
</p>
</body>
</subsection>
<subsection id="network_term">
<title>Understanding Network Terminology</title>
<body>
<note>
If you know your IP address, broadcast address, netmask and nameservers,
then you can skip this subsection and continue with <uri
link="#ifconfig_route">Using ifconfig and route</uri>.
</note>
<p>
If all of the above fails, you will have to configure your network manually.
This is not difficult at all. However, you need to be familiar with some
network terminology, as you will need it to be able to
configure your network to your satisfaction. After reading this, you
will know what a <e>gateway</e> is, what a <e>netmask</e> serves for,
how a <e>broadcast</e> address is formed and why you need
<e>nameservers</e>.
</p>
<p>
In a network, hosts are identified by their <e>IP address</e> (Internet
Protocol address). Such an address is a combination of four numbers
between 0 and 255. Well, at least that is how we perceive it. In
reality, such an IP address consists of 32 bits (ones and zeros). Let's
view an example:
</p>
<pre caption="Example of an IP address">
IP Address (numbers): 192.168.0.2
IP Address (bits): 11000000 10101000 00000000 00000010
-------- -------- -------- --------
192 168 0 2
</pre>
<p>
Such an IP address is unique to a host as far as all accessible networks are
concerned (i.e. every host that you are able to reach must have a unique IP
address). In order to distinguish between hosts inside and outside a
network, the IP address is divided in two parts: the
<e>network</e> part and the <e>host</e> part.
</p>
<p>
The separation is written down with the <e>netmask</e>, a collection of
ones followed by a collection of zeros. The part of the IP that can be
mapped on the ones is the network-part, the other one is the host-part.
As usual, the netmask can be written down as an IP-address.
</p>
<pre caption="Example of network/host separation">
IP-address: 192 168 0 2
11000000 10101000 00000000 00000010
Netmask: 11111111 11111111 11111111 00000000
255 255 255 0
+--------------------------+--------+
Network Host
</pre>
<p>
In other words, 192.168.0.14 is still part of our example network, but
192.168.1.2 is not.
</p>
<p>
The <e>broadcast</e> address is an IP-address with the same network-part
as your network, but with only ones as host-part. Every host on your
network listens to this IP address. It is truly meant for broadcasting
packets.
</p>
<pre caption="Broadcast address">
IP-address: 192 168 0 2
11000000 10101000 00000000 00000010
Broadcast: 11000000 10101000 00000000 11111111
192 168 0 255
+--------------------------+--------+
Network Host
</pre>
<p>
To be able to surf on the internet, you must know which host shares the
Internet connection. This host is called the <e>gateway</e>. Since it is
a regular host, it has a regular IP address (for instance 192.168.0.1).
</p>
<p>
We previously stated that every host has its own IP address. To be able
to reach this host by a name (instead of an IP address) you need a
service that translates a name (such as <e>dev.gentoo.org</e>) to an IP
address (such as <e>64.5.62.82</e>). Such a service is called a name
service. To use such a service, you must define the necessary <e>name
servers</e> in <path>/etc/resolv.conf</path>.
</p>
<p>
In some cases, your gateway also serves as nameserver. Otherwise you
will have to enter the nameservers provided by your ISP.
</p>
<p>
To summarise, you will need the following information before continuing:
</p>
<table>
<tr>
<th>Network Item</th>
<th>Example</th>
</tr>
<tr>
<ti>Your IP address</ti>
<ti>192.168.0.2</ti>
</tr>
<tr>
<ti>Netmask</ti>
<ti>255.255.255.0</ti>
</tr>
<tr>
<ti>Broadcast</ti>
<ti>192.168.0.255</ti>
</tr>
<tr>
<ti>Gateway</ti>
<ti>192.168.0.1</ti>
</tr>
<tr>
<ti>Nameserver(s)</ti>
<ti>195.130.130.5, 195.130.130.133</ti>
</tr>
</table>
</body>
</subsection>
<subsection id="ifconfig_route">
<title>Using ifconfig and route</title>
<body>
<p>
Setting up your network consists of three steps. First we assign
ourselves an IP address using <c>ifconfig</c>. Then we set up routing to
the gateway using <c>route</c>. Then we finish up by placing the
nameserver IPs in <path>/etc/resolv.conf</path>.
</p>
<p>
To assign an IP address, you will need your IP address, broadcast
address and netmask. Then execute the following command, substituting
<c>${IP_ADDR}</c> with your IP address, <c>${BROADCAST}</c> with your
broadcast address and <c>${NETMASK}</c> with your netmask:
</p>
<pre caption="Using ifconfig">
# <i>ifconfig eth0 ${IP_ADDR} broadcast ${BROADCAST} netmask ${NETMASK} up</i>
</pre>
<p>
Now set up routing using <c>route</c>. Substitute <c>${GATEWAY}</c> with
your gateway IP address:
</p>
<pre caption="Using route">
# <i>route add default gw ${GATEWAY}</i>
</pre>
<p>
Now open <path>/etc/resolv.conf</path> with your favorite editor (in our
example, we use <c>nano</c>):
</p>
<pre caption="Creating /etc/resolv.conf">
# <i>nano -w /etc/resolv.conf</i>
</pre>
<p>
Now fill in your nameserver(s) using the following as a template. Make
sure you substitute <c>${NAMESERVER1}</c> and <c>${NAMESERVER2}</c> with
the appropriate nameserver addresses:
</p>
<pre caption="/etc/resolv.conf template">
nameserver ${NAMESERVER1}
nameserver ${NAMESERVER2}
</pre>
<p>
That's it. Now test your network by pinging some Internet server (like
<uri link="http://www.google.com">Google</uri>). If this works,
congratulations then. You are now ready to install Gentoo. Continue with <uri
link="?part=1&chap=4">Preparing the Disks</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-next.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-next.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-next.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-next.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-next.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-22</date>
<section>
<title>Documentation</title>
<subsection>
<body>
<p>
Congratulations! You now have a working Gentoo system. But where to go from
here? What are your options now? What to explore first? Gentoo provides its
users with lots of possibilities, and therefore lots of documented (and less
documented) features.
</p>
<p>
You should definitely take a look at the next part of the Gentoo Handbook
entitled <uri link="?part=2">Working with Gentoo</uri> which explains
how to keep your software up to date, how to install more software, what USE
flags are, how the Gentoo Init system works, etc.
</p>
<p>
If you are interested in optimizing your system for desktop use, or you want to
learn how to configure your system to be a full working desktop system, consult
our extensive <uri link="/doc/en/index.xml?catid=desktop">Gentoo Desktop
Documentation Resources</uri>. Besides, you might want to use our <uri
link="/doc/en/guide-localization.xml">localization guide</uri> to make your
system feel more at home.
</p>
<p>
We also have a <uri link="/doc/en/security/">Gentoo Security Handbook</uri>
which is worth reading.
</p>
<p>
For a full listing of all our available documentation check out our <uri
link="/doc/en/index.xml">Documentation Resources</uri> page.
</p>
</body>
</subsection>
</section>
<section>
<title>Gentoo Online</title>
<body>
<p>
You are of course always welcome on our <uri
link="http://forums.gentoo.org">Gentoo Forums</uri> or on one of our many
<uri link="/main/en/irc.xml">Gentoo IRC channels</uri>.
</p>
<p>
We also have several <uri
link="/main/en/lists.xml">mailinglists</uri> open to all
our users. Information on how to join is contained in that page.
</p>
<p>
We'll shut up now and let you enjoy your installation :)
</p>
</body>
</section>
<section>
<title>Gentoo Changes since 2005.1</title>
<subsection>
<title>Changes?</title>
<body>
<p>
Gentoo is a fast-moving target. The following sections describe important
changes that affect a Gentoo installation. We only list those that have anything
in common with the installation, not with package changes that did not occur
during the installation.
</p>
<p>
There have been no significant changes since.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-bootloader.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2006-01-19</date>
<section>
<title>Choosing a Bootloader</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that the kernel is configured and compiled, you'll need a <e>bootloader</e>
to start your new linux installation. The <e>bootloader</e> that you use will
depend upon the type of PPC machine you have.
</p>
<p>
If you are using a NewWorld Apple or IBM machine, you need to use
<uri link="#yaboot">yaboot</uri>. OldWorld Apple machines have two options,
<uri link="#bootx">BootX</uri> (recommended) and <uri link="#quik">quik</uri>.
The Pegasos does not require a bootloader, but you will need to emerge
<uri link="#bootcreator">BootCreator</uri> to create SmartFirmware bootmenus.
</p>
</body>
</subsection>
</section>
<section id="yaboot">
<title>Default: Using yaboot</title>
<subsection>
<title>Introduction</title>
<body>
<impo>
yaboot can only be used on NewWorld Apple and IBM systems!
</impo>
<p>
In order to find the boot devices, yaboot needs access to the <path>/dev</path>
filesystem. To do this, you will need to "bind-map" the <path>/dev</path>
filesystem from the Installation CD to <path>/dev</path> inside of the chroot.
</p>
<pre caption="Bind-mounting the /dev-filesystem">
# <i>exit </i> # this will exit the chroot
# <i>mount -o bind /dev /mnt/gentoo/dev</i>
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>/usr/sbin/env-update && source /etc/profile </i>
</pre>
<p>
To set up yaboot, you can use <c>yabootconfig</c> to automatically create a
configuration file for you. If you are installing Gentoo on a G5 (where
<c>yabootconfig</c> does not always work), or you plan to boot from firewire
or USB, you will need to manually configure yaboot.
</p>
<note>
You will need to manually edit the yaboot.conf when using genkernel, even if
yabootconfig is used. The kernel image section of yaboot.conf should be
modified as follows:
</note>
<pre caption="Adding genkernel boot arguments to yaboot.conf">
<comment>###########################################################
## This section can be duplicated if you have more than one
## kernel or set of boot options - replace kernel-2.6.12
## with the exact filename of your kernel.
###########################################################</comment>
image=/boot/kernel-2.6.12
label=Linux
root=/dev/ram0 <comment># If using genkernel this is /dev/ram0</comment>
partition=3
append="real_root=/dev/hda3 init=/linuxrc"
<comment># You can add additional kernel arguments to append such as
# rootdelay=10 for a USB/Firewire Boot</comment>
read-only
<comment>##########################################################</comment>
</pre>
<ul>
<li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li>
<li>
<uri link="#manual_yaboot">Alternative: Manual yaboot Configuration</uri>
</li>
</ul>
</body>
</subsection>
<subsection id="yabootconfig">
<title>Default: Using yabootconfig</title>
<body>
<p>
<c>yabootconfig</c> will auto-detect the partitions on your machine and will
set up dual and triple boot combinations with Linux, Mac OS, and Mac OS X.
</p>
<p>
To use <c>yabootconfig</c>, your drive must have an Apple_Bootstrap partition,
and <path>/etc/fstab</path> must be configured with your Linux partitions. Both
of these should have been done already in the steps above. To start, ensure that
you have the latest <c>yaboot</c> installed.
</p>
<pre caption = "Installing yaboot with GRP">
# <i>emerge --usepkg --update yaboot</i>
</pre>
<p>
Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. The
program will run and it will confirm the location of the bootstrap partition.
Type <c>Y</c> if it is correct. If not, double check <path>/etc/fstab</path>.
yabootconfig will then scan your system setup, create
<path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for you. <c>mkofboot</c>
is used to format the Apple_Bootstrap partition, and install the yaboot
configuration file into it. After this enter the chroot again.
</p>
<pre caption="enter chroot">
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>/usr/sbin/env-update && source /etc/profile</i>
</pre>
<p>
You might want to verify the contents of <path>/etc/yaboot.conf</path>. If you
make changes to <path>/etc/yaboot.conf</path> (like setting the default/boot
OS), make sure to rerun <c>ybin -v</c> to apply changes to the Apple_Bootstrap
partition.
</p>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
<subsection id="manual_yaboot">
<title>Alternative: Manual yaboot Configuration</title>
<body>
<p>
First make sure you have the latest <c>yaboot</c> installed on your
system:
</p>
<pre caption = "Installing yaboot">
# <i>emerge --usepkg --update yaboot</i>
</pre>
<p>
An example <path>yaboot.conf</path> file is given below, but you will need to
alter it to fit your needs. G5 users and users booting from firewire and USB
should be aware that their disks are seen as SCSI disks by the Linux kernel, so
you will need to substitute <path>/dev/hda</path> with <path>/dev/sda</path>).
</p>
<pre caption = "/etc/yaboot.conf">
<comment>## /etc/yaboot.conf
##
## run: "man yaboot.conf" for details. Do not make changes until you have!!
## see also: /usr/share/doc/yaboot/examples for example configurations.
##
## For a dual-boot menu, add one or more of:
## bsd=/dev/hdaX, macos=/dev/hdaY, macosx=/dev/hdaZ
## our bootstrap partition:</comment>
boot=/dev/hda2
<comment>## ofboot is the openfirmware way to specify the bootstrap partition.
## If this isn't defined, yaboot fails on the G5 and some G4s (unless
## you pass the necessary arguments to the mkofboot/ybin program).
## hd:X means /dev/sdaX (or /dev/hdaX).
##
## G5 users should uncomment this line!!
#ofboot=hd:2
## Users booting from firewire should use something like this line:
# ofboot=fw/node/sbp-2/disk@0:
## Users booting from USB should use something like this line:
# ofboot=usb/disk@0:
## hd: is shorthand for the first hard drive OpenFirmware sees</comment>
device=hd:
<comment>## Firewire and USB users will need to specify the whole OF device name
## This can be found using ofpath, which is included with yaboot.
# device=fw/node@0001d200e00d0207/sbp-2@c000/disk@0:
</comment>
delay=5
defaultos=macosx
timeout=30
install=/usr/lib/yaboot/yaboot
magicboot=/usr/lib/yaboot/ofboot
<comment>#################
## This section can be duplicated if you have more than one kernel or set of
## boot options - replace 2.6.9 with your kernel-version
#################</comment>
image=/boot/kernel-2.6.9
label=Linux
root=/dev/hda3
partition=3
<comment># append="rootdelay=10" # Required for booting USB/Firewire</comment>
read-only
<comment>##################
## G5 users and some G4 users should set
## macos=hd:13
## macosx=hd:12
## instead of the example values.</comment>
macos=/dev/hda13
macosx=/dev/hda12
enablecdboot
enableofboot
</pre>
<p>
Once <path>yaboot.conf</path> is configured, run <c>mkofboot -v</c> to format
the Apple_bootstrap partition and install the settings. If you change
yaboot.conf after the Apple_bootstrap partition has been created, you can
update the settings by running <c>ybin -v</c>
</p>
<p>
For more information on yaboot, take a look at the <uri
link="http://penguinppc.org/bootloaders/yaboot">yaboot project</uri>. For
now, continue the installation with <uri link="#reboot">Rebooting the
System</uri>.
</p>
</body>
</subsection>
</section>
<section id="bootx">
<title>Alternative: BootX</title>
<body>
<impo>
BootX can only be used on OldWorld Apple systems!
</impo>
<p>
Since BootX boots Linux from within MacOS, the kernel will need to be copied
from the Linux Partition to the MacOS partition. First, mount the MacOS
partition from outside of the chroot. Use <c>mac-fdisk -l</c> to find the
MacOS partition number, sda6 is used as an example here. Once the partition is
mounted, we'll copy the kernel to the system folder so BootX can find it.
</p>
<pre caption="Copying the kernel to the MacOS partition">
# <i>exit</i>
cdimage ~# <i>mkdir /mnt/mac</i>
cdimage ~# <i>mount /dev/sda6 /mnt/mac -t hfs</i>
cdimage ~# <i>cp /mnt/gentoo/usr/src/linux/vmlinux "/mnt/mac/System Folder/Linux Kernels"</i>
</pre>
<p>
If genkernel is used, both the kernel and initrd will need to be copied to the
MacOS partition.
</p>
<pre caption="Copying the Genkernel kernel and initrd to the MacOS partition">
# <i>exit</i>
cdimage ~# <i>mkdir /mnt/mac</i>
cdimage ~# <i>mount /dev/sda6 /mnt/mac -t hfs</i>
cdimage ~# <i>cp /mnt/gentoo/boot/kernel-* "/mnt/mac/System Folder/Linux Kernels"</i>
cdimage ~# <i>cp /mnt/gentoo/boot/initramfs-* "/mnt/mac/System Folder"</i>
</pre>
<p>
Now that the kernel is copied over, we'll need to reboot to set up BootX.
</p>
<pre caption="Unmounting all partitions and rebooting">
cdimage ~# <i>cd /</i>
cdimage ~# <i>umount /mnt/gentoo/proc /mnt/gentoo/dev /mnt/gentoo /mnt/mac</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of MacOS.
</p>
<p>
Once the machine has booted into MacOS, open the BootX control panel. If you're
not using genkernel, select <c>Options</c> and uncheck <c>Use specified RAM
disk</c>. If you are using genkernel, ensure that the genkernel initrd is
selected instead of the Installation CD initrd. If not using genkernel,
there is now an option to specify the machine's Linux root disk and partition.
Fill these in with the appropriate values. Depending upon the kernel
configuration, additional boot arguments may need to be applied.
</p>
<p>
BootX can be configured to start Linux upon boot. If you do this, you will first
see your machine boot into MacOS then, during startup, BootX will load and start
Linux. See the <uri link="http://penguinppc.org/bootloaders/bootx/">BootX home
page</uri> for more information.
</p>
<p>
Now reboot again and boot into Linux, then continue with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</section>
<section id="quik">
<title>Alternative: quik</title>
<body>
<p>
quik allows OldWorld Macs to boot without MacOS. However, it isn't well
supported and has a number of quirks. If you have the option, it is recommended
that you use BootX instead since it is much more reliable and easier to set up
than quik.
</p>
<p>
First, we'll need to install quik:
</p>
<pre caption="Emerge quik">
# <i>emerge quik</i>
</pre>
<p>
Next, we'll need to set it up. Edit /etc/quik.conf and set your image to the
kernel that we copied to your boot partition.
</p>
<pre caption="Configuring quik.conf">
# Example of quik.conf
init-message = "Gentoo 2005.1\n"
partition = 2 <comment># This is the boot partition</comment>
root = /dev/hda4
timeout = 30
default = gentoo
image = /vmlinux-2.6.12
label = gentoo
</pre>
<p>
Your quik.conf file <e>must</e> be on the same disk as the quik boot images,
however it can be on a different partition on the same disk, although it is
recommended to move it to your boot partition.
</p>
<pre caption="Moving quik.conf to /boot">
# <i>mv /etc/quik.conf /boot/quik.conf</i>
</pre>
<p>
We will now set your boot variables so that quik loads on boot. To do this,
we'll use a program called <c>nvsetenv</c>. The variables that you want to
set vary from machine to machine, it's best to find your machine's
<uri link="http://penguinppc.org/bootloaders/quik/quirks.php">quirks</uri>
before attempting this.
</p>
<pre caption="Setting the boot variables">
# <i>nvsetenv auto-boot true</i> <comment># Set to false if you want to boot into OF, not all models can display the OF output</comment>
# <i>nvsetenv output-device video</i> <comment># Check the quirks page, there are many variations here</comment>
# <i>nvsetenv input-device kbd</i>
# <i>nvsetenv boot-device scsi/sd@1:0</i> <comment># For SCSI</comment>
# <i>nvsetenv boot-device ata/ata-disk@0:0</i> <comment># For ATA</comment>
# <i>nvsetenv boot-file /boot/vmlinux-2.6.12 root=/dev/hda4</i> <comment>First item is the path to the kernel, the second is the root partition. You may append any kernel options to the end of this line.</comment>
# <i>nvsetenv boot-command boot</i> <comment># Set this to bye for MacOS and boot for Linux</comment>
</pre>
<note>
It is also possible to change your boot variables from MacOS. Depending
upon the model, either
<uri link="http://penguinppc.org/bootloaders/quik/BootVars.sit.hqx">bootvars</uri> or
<uri link="ftp://ftp.apple.com/developer/macosxserver/utilities/SystemDisk2.3.1.smi.bin">
Apple System Disk</uri> should be used. Please see the quik quirks page
above for more information.
</note>
<p>
Now that we've set up our machine to boot, we'll need to make sure the boot
images are installed correctly. Run <c>quik -v -C /boot/quik.conf</c>. It
should tell you that it has installed the first stage QUIK boot block.
</p>
<note>
If something has gone wrong, you can always reset your PRAM back to the default
values by holding down <c>command + option + p + r</c> before powering on your
machine. This will clear the values you set with nvsetenv and should allow you
to boot either a MacOS bootdisk or a Linux bootdisk.
</note>
<p>
Now, continue the installation with
<uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="bootcreator">
<title>Alternative: BootCreator</title>
<body>
<impo>
BootCreator will build a nice SmartFirmware bootmenu written in Forth for the
Pegasos.
</impo>
<p>
First make sure you have the latest <c>bootcreator</c> installed on your
system:
</p>
<pre caption = "Installing bootcreator">
# <i>emerge --usepkg --update bootcreator</i>
</pre>
<p>
Now copy the file <path>/etc/bootmenu.example</path> into
<path>/etc/bootmenu</path> and edit it to your needs:
</p>
<pre caption = "Edit the bootcreator config file">
# <i>cp /etc/bootmenu.example /etc/bootmenu</i>
# <i>nano -w /etc/bootmenu</i>
</pre>
<p>
Below you find a completed <path>/etc/bootmenu</path> config file. Alter it at
will.
</p>
<pre caption = "bootcreator config file">
<comment>#
# Example description file for bootcreator 1.1
#</comment>
[VERSION]
1
[TITLE]
Boot Menu
[SETTINGS]
AbortOnKey = false
Timeout = 9
Default = 1
[SECTION]
Local HD -> Morphos (Normal)
ide:0 boot2.img ramdebug edebugflags="logkprintf"
[SECTION]
Local HD -> Linux 2.6.12 (Normal)
ide:0 linux-2.6.12 video=radeonfb:1024x768@70 root=/dev/hda3
[SECTION]
Local HD -> Genkernel (Normal)
ide:0 kernelz-2.6.12 root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc
</pre>
<p>
Finally the <path>bootmenu</path> must be transfered into Forth and copied to
your boot partition, so that the SmartFirmware can read it. Therefore you have
to call <c>bootcreator</c>:
</p>
<pre caption = "Install the bootmenu">
# <i>bootcreator /etc/bootmenu /boot/menu</i>
</pre>
<note>
Be sure to have a look into the SmartFirmware's settings when you reboot, that
<path>menu</path> is the file that will be loaded by default.
</note>
<p>
For now, continue the installation with <uri link="#reboot">Rebooting the
System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
livecd ~# <i>umount /mnt/gentoo/proc /mnt/gentoo/dev /mnt/gentoo</i>
livecd ~# <i>reboot</i>
</pre>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-ppc-disk.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-25</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI or SATA drives, then your first
hard drive would be <path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On most systems,
these are called <e>partitions</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition NewWorld</th>
<th>Partition OldWorld</th>
<th>Partition Pegasos</th>
<th>Partition RS/6000</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti><path>/dev/hda1</path></ti>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti>(Partition Map)</ti>
<ti>32k</ti>
<ti>Apple_partition_map</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>(Not needed)</ti>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti>(bootstrap)</ti>
<ti>800k</ti>
<ti>Apple_Bootstrap</ti>
</tr>
<tr>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti>(Not applicable)</ti>
<ti><path>/dev/sda1</path></ti>
<ti>(PReP Boot)</ti>
<ti>800k</ti>
<ti>Type 0x41</ti>
</tr>
<tr>
<ti>(Not applicable)</ti>
<ti><path>/dev/hda2</path> (If using quik)</ti>
<ti><path>/dev/hda1</path></ti>
<ti>(Not needed)</ti>
<ti>ext2</ti>
<ti>32MB</ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti><path>/dev/hda2</path> (<path>/dev/hda3</path> if using quik)</ti>
<ti><path>/dev/hda2</path></ti>
<ti><path>/dev/sda2</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition, Type 0x82</ti>
</tr>
<tr>
<ti><path>/dev/hda4</path></ti>
<ti><path>/dev/hda3</path> (<path>/dev/hda4</path> if using quik)</ti>
<ti><path>/dev/hda3</path></ti>
<ti><path>/dev/sda3</path></ti>
<ti>ext3, xfs</ti>
<ti>Rest of the disk</ti>
<ti>Root partition, Type 0x83</ti>
</tr>
</table>
<note>
There are some partitions named: <path>Apple_Driver63, Apple_Driver_ATA,
Apple_FWDriver, Apple_Driver_IOKit, Apple_Patches</path>. If you are not
planning to use MacOS 9 you can delete them, because MacOS X and Linux don't
need them. To delete them, either use parted or erase the whole disk by
initialing the partition map.
</note>
<warn>
<c>parted</c> is able to resize partitions. On the Installation CD there
are patches included to resize HFS+ filesystem. Unfortunately it is not
possible to resize HFS+ journaled filesystems, even if the journaling has been
switchedoff in Mac OS X. Everything you do with resizing in parted you do it
on your own risk! Be sure to have a backup of your data!
</warn>
<p>
If you are interested in knowing how big a partition should be, or even how many
partitions you need, read on. Otherwise continue now with
<uri link="#mac-fdisk"> Default: Using mac-fdisk (Apple) to Partition your Disk
</uri> or <uri link="#parted">Alternative: Using parted (IBM/Pegasos) to
Partition your Disk</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your <path>/var</path>
should be separate as all mails are stored inside <path>/var</path>. A good
choice of filesystem will then maximise your performance. Gameservers will have
a separate <path>/opt</path> as most gaming servers are installed there. The
reason is similar for <path>/home</path>: security and backups. You will
definitely want to keep <path>/usr</path> big: not only will it contain the
majority of applications, the Portage tree alone takes around 500 Mbyte
excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots of free space on one
partition and none on another. There is also a 15-partition limit for SCSI and
SATA.
</p>
</body>
</subsection>
</section>
<section id="mac-fdisk">
<title>Default: Using mac-fdisk (Apple) Partition your Disk</title>
<body>
<p>
At this point, create your partitions using <c>mac-fdisk</c>:
</p>
<pre caption="Starting mac-fdisk">
# <i>mac-fdisk /dev/hda</i>
</pre>
<p>
First delete the partitions you have cleared previously to make room for your
Linux partitions. Use <c>d</c> in <c>mac-fdisk</c> to delete those partition(s).
It will ask for the partition number to delete. Usually the first partition on
NewWorld machines (Apple_partition_map) could not be deleted.
</p>
<p>
Second, create an <e>Apple_Bootstrap</e> partition by using <c>b</c>. It will
ask for what block you want to start. Enter the number of your first free
partition, followed by a <c>p</c>. For instance this is <c>2p</c>.
</p>
<note>
This partition is <e>not</e> a <path>/boot</path> partition. It is not used by
Linux at all; you don't have to place any filesystem on it and you should never
mount it. Apple users don't need an extra partition for <path>/boot</path>.
</note>
<p>
Now create a swap partition by pressing <c>c</c>. Again <c>mac-fdisk</c> will
ask for what block you want to start this partition from. As we used <c>2</c>
before to create the Apple_Bootstrap partition, you now have to enter
<c>3p</c>. When you're asked for the size, enter <c>512M</c> (or whatever size
you want -- 512MB is recommended though). When asked for a name, enter <c>swap</c>
(mandatory).
</p>
<p>
To create the root partition, enter <c>c</c>, followed by <c>4p</c> to select
from what block the root partition should start. When asked for the size, enter
<c>4p</c> again. <c>mac-fdisk</c> will interpret this as "Use all available
space". When asked for the name, enter <c>root</c> (mandatory).
</p>
<p>
To finish up, write the partition to the disk using <c>w</c> and <c>q</c> to
quit <c>mac-fdisk</c>.
</p>
<note>
To make sure everything is ok, you should run mac-fdisk once more and check
whether all the partitions are there. If you don't see any of the partitions
you created, or the changes you made, you should reinitialize your partitions
by pressing "i" in mac-fdisk. Note that this will recreate the partition map
and thus remove all your partitions.
</note>
<p>
Now that your partitions are created, you can continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</section>
<section id="parted">
<title>Using parted (especially Pegasos) to Partition your Disk</title>
<body>
<p>
<c>parted</c>, the Partition Editor, can now handle HFS+ partitions used by
Mac OS and Mac OS X. With this tool you can resize your Mac-partitions and
create space for your Linux partitions. Nevertheless, the example below
describes partitioning for Pegasos machines only.
</p>
<p>
To begin let's fire up <c>parted</c>:
</p>
<pre caption="Starting parted">
# <i>parted /dev/hda</i>
</pre>
<p>
If the drive is unpartitioned, run <c>mklabel amiga</c> to create a new
disklabel for the drive.
</p>
<p>
You can type <c>print</c> at any time in parted to display the current partition
table. If at any time you change your mind or made a mistake you can press
<c>Ctrl-c</c> to abort parted.
</p>
<p>
If you intend to also install MorphOS on your Pegasos create an affs1 filesystem
named "BI0" (BI zero) at the start of the drive. 32MB should be more than enough
to store the MorphOS kernel. If you have a Pegasos I or intend to use reiserfs or
xfs, you will also have to store your Linux kernel on this partition (the
Pegasos II can only boot from ext2/ext3 or affs1 partitions). To create the partition run
<c>mkpart primary affs1 START END</c> where <c>START</c> and <c>END</c> should
be replaced with the megabyte range (e.g. <c>0 32</c> creates a 32 MB partition
starting at 0MB and ending at 32MB.
</p>
<p>
You need to create two partitions for Linux, one root filesystem for all your
program files etc, and one swap partition. To create the root filesystem you
must first decide which filesystem to use. Possible options are ext2, ext3,
reiserfs and xfs. Unless you know what you are doing, use ext3. Run
<c>mkpart primary ext3 START END</c> to create an ext3 partition. Again, replace
<c>START</c> and <c>END</c> with the megabyte start and stop marks for the
partition.
</p>
<p>
It is generally recommended that you create a swap partition the same size as
the amount of RAM in your computer times two. You will probably get away with a
smaller swap partition unless you intend to run a lot of applications at the
same time (although at least 512MB is recommended). To create the swap
partition, run <c>mkpart primary linux-swap START END</c>.
</p>
<p>
Write down the partition minor numbers as they are required during the
installation process. To display the minor numbers run <c>print</c>. Your drives
are accessed as <path>/dev/hdaX</path> where X is replaced with the minor number
of the partition.
</p>
<p>
When you are done in parted simply run <c>quit</c>.
</p>
</body>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available. ext2, ext3, ReiserFS and XFS have been found
stable on the PPC architecture.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mkfs.ext2</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mkfs.ext3</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkfs.reiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
</table>
<p>
For instance, to have the root partition (<path>/dev/hda4</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mkfs.ext3 /dev/hda4</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
<note>
On the PegasosII your partition which holds the kernel must be ext2 or ext3.
NewWorld machines can boot from any of ext2, ext3, XFS, ReiserFS or even
HFS/HFS+ filesystems. On OldWorld machines booting with BootX, the kernel must
be placed on an HFS partition, but this will be completed when you configure
your bootloader.
</note>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/hda3</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/hda3</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we create a mount-point and mount the root partition:
</p>
<pre caption="Mounting partitions">
# <i>mkdir /mnt/gentoo</i>
# <i>mount /dev/hda4 /mnt/gentoo</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the
partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-ppc-kernel.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.4</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
We suggest using either <c>vanilla-sources</c> or <c>gentoo-sources</c> on PPC,
which are both 2.6 kernels. The latter is available when you perform a
networkless installation. So let's continue with <c>emerge</c>'ing the kernel
sources. The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or
other dependencies at this point. <c>USE="symlink"</c> is not necessary for a
new install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<!-- Removed, as we're trying to avoid specific kernel versions to improve HB
maintainability
<note>
The suggested sources at the time of the 2005.1 release are
<c>gentoo-sources-2.6.12-r6</c> and <c>vanilla-sources-2.6.12.2</c>.
</note>
-->
<p>
If you take a look in <path>/usr/src</path> you should see a symlink named
<path>linux</path> pointing to your current kernel source. In this case, the
installed kernel source points to <c>gentoo-sources-2.6.12-r6</c>. Your version
may be different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 22 Mar 18 16:23 /usr/src/linux -> linux-2.6.12-gentoo-r6
</pre>
<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable). Another place
to look for clues as to what components to enable is to check the kernel
message logs from the successful boot that got you this far. Type <c>dmesg</c>
to see the kernel messages.
</p>
<p>
Now, go to your kernel source directory, it's time to configure your kernel.
It is recommended that you add the default settings to your configuration by
first running <c>make defconfig</c>. After the default configuration has been
generated, run <c>make menuconfig</c> which will fire up an ncurses-based
configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make defconfig</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>/proc file system</c> and
<c>Virtual memory</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
Users of NewWorld and OldWorld machines will want HFS support as well. OldWorld
users require it for copying compiled kernels to the MacOS partition. NewWorld
users require it for configuring the special Apple_Bootstrap partition:
</p>
<pre caption="Activating HFS support">
File Systems --->
[*] HFS Support
</pre>
<p>
At this time, kernel preemption is still unstable on PPC and may cause
compilation failures and random segfaults. It is <e>strongly</e> suggested
that you do not use this feature.
</p>
<pre caption="Ensure the Preemptible Kernel Option is Off">
Platform options --->
[ ] Preemptible Kernel
</pre>
<p>
If you're booting from Firewire, you'll need to enable these options. If you do
not want to compile in support, you'll need to include these modules and their
dependencies in an initrd.
</p>
<pre caption="Enable support for firewire devices on boot">
Device Drivers --->
IEEE 1394 (FireWire) support --->
<*> IEEE 1394 (FireWire) support
<*> OHCI-1394 support
<*> SBP-2 support (Harddisks etc.)
</pre>
<p>
If you're booting from USB, you'll need to enable these options. If you do not
want to compile in support, you'll need to include these modules and their
dependencies in an initrd.
</p>
<pre caption="Enable support for USB devices on boot">
Device Drivers --->
USB support --->
<*> Support for Host-side USB
<*> OHCI HCD support
<*> USB Mass Storage support
</pre>
<p>
Do not turn off kernel framebuffer support as it is required for a successful
boot. If you are using an NVIDIA based chipset, you should use the OpenFirmware
framebuffer. If you are using an ATI based chipset, you should select the
framebuffer driver based upon your chipset (Mach64, Rage128 or Radeon).
</p>
<pre caption="Chosing a Framebuffer Driver">
Device Drivers --->
Graphics support --->
<*> Support for frame buffer devices
[*] Open Firmware frame buffer device support
<*> ATI Radeon display support
<*> ATI Rage128 display support
<*> ATI Mach64 display support
Console display driver support --->
<*> Framebuffer Console support
</pre>
<note>
If you select more than one framebuffer device, it may default to a less than
optimal driver. Either use only one framebuffer device or specify which
to use by passing the driver to use to the kernel on boot such as
<c>video=radeonfb</c>.
</note>
<p>
When you're done configuring your kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and run the commands which will compile the kernel:
</p>
<pre caption="Compiling the kernel">
# <i>make && make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path> (be sure that it is mounted properly on the Pegasos).
</p>
<pre caption="Installing the kernel">
<comment>replace <kernel-version> with your kernel version</comment>
(Apple/IBM) # <i>cp vmlinux /boot/<kernel-version></i>
(Pegasos) # <i>cp arch/ppc/boot/images/zImage.chrp /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Installing Separate Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="kernel_modules">
<title>Installing Separate Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.6</path>.
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> file and enter the module
name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because genkernel
doesn't require any manual kernel configuration, it is an ideal solution for
those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Next, copy over the kernel configuration used by the Installation CD to the
location where genkernel looks for the default kernel configuration:
</p>
<pre caption="Copying over the Installation CD kernel config">
# <i>zcat /proc/config.gz > /usr/share/genkernel/ppc/kernel-config-2.6</i>
</pre>
<p>
If you are using firewire or USB to boot, you'll need to add modules to the
initrd. Edit <path>/usr/share/genkernel/ppc/modules_load</path> and change
<c>MODULES_FIREWIRE="ieee1394 ohci1394 sbp2"</c> for firewire support or
<c>MODULES_USB="usbcore ohci-hcd ehci-hcd usb-storage"</c> for USB support.
</p>
<p>
Now, compile your kernel sources by running <c>genkernel --genzimage all</c>.
For Pegasos, we will need to use a different config and create a zImage instead
of the vmlinux kernel used on Apple machines. Be aware, as <c>genkernel</c>
compiles a kernel that supports almost all hardware, this compilation can take
quite a while to finish!
</p>
<p>
Note that, if your partition where the kernel should be located doesn't use ext2
or ext3 as filesystem you might need to manually configure your kernel using
<c>genkernel --menuconfig --genzimage all</c> and add support for your
filesystem <e>in</e> the kernel (i.e. <e>not</e> as a module). Users of EVMS2 or
LVM2 will probably want to add <c>--evms2</c> or <c>--lvm2</c> as argument as
well.
</p>
<pre caption="Running genkernel">
# <i>genkernel --genzimage all</i>
</pre>
<pre caption="Running genkernel on the Pegasos">
# <i>genkernel --genzimage --kernel-config=/usr/share/genkernel/ppc/Pegasos all</i>
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD)
before your "real" system starts up. Be sure to also copy down the required
boot arguments, these are required for a sucessful boot with genkernel.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
If you want your system to be more like the Installation CD you should,
when your Gentoo installation is over, emerge <c>coldplug</c>. While the
initrd autodetects hardware that is needed to boot your system,
<c>coldplug</c> autodetects everything else. <c>coldplug</c> is available as one
of the packages on the Package CD.
</p>
<pre caption="Emerging and enabling coldplug">
<comment>(Do this after the installation, during the GRP installation instructions)</comment>
# <i>emerge -k coldplug</i>
# <i>rc-update add coldplug boot</i>
</pre>
<p>
If you want your system to react to hotplugging events, you will need to install
and setup <c>hotplug</c> as well:
</p>
<pre caption="Emerging and enabling hotplug">
# <i>emerge hotplug</i>
# <i>rc-update add hotplug default</i>
</pre>
<p>
Now continue with <uri link="?part=1&chap=8">Configuring your System</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-ppc-medium.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>Apple NewWorld Machines</th>
<ti>
Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
PowerBook, Xserver, PowerMac
</ti>
</tr>
<tr>
<th>Apple OldWorld machines</th>
<ti>
Apple Machines with an OpenFirmware revision less than 3, such as the Beige
G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also
be supported.
</ti>
</tr>
<tr>
<th>Genesi's Pegasos</th>
<ti>
Pegasos I/II, Open Desktop Workstation
</ti>
</tr>
<tr>
<th>IBM</th>
<ti>
RS/6000, iSeries, pSeries
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>At least 64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo
PPC FAQ</uri> before you begin.
</p>
</body>
</subsection>
</section>
<!-- Copy/paste of hb-install-x86-medium.xml, with s/x86/ppc/ -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can successfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located
in the <path>releases/ppc/2005.1/installcd</path> directory;
the Package CDs are located in the
<path>releases/ppc/2005.1/packagecd</path> directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows).
Verifying MD5 checksums with Mac OS X is described in the <uri
link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (0x17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Default: Booting the Installation CD with Yaboot</title>
<body>
<p>
On NewWorld machines place the Installation CD in the CD-ROM and reboot the
system. When the system-start-bell sounds, simply hold down the 'C' until the
CD loads.
</p>
<p>
After the Installation CD loaded, you will be greeted by a friendly welcome
message and a <e>boot:</e> prompt at the bottom of the screen.
</p>
<p>
At this prompt you are able to select a kernel for the subarchitecture you use.
We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with
support for multiple CPUs, but they will boot on single processor machines as
well.
</p>
<p>
You are also able to tweak some kernel options at this prompt. The following
table lists some of the available boot options you can add:
</p>
<table>
<tr>
<th>Boot Option</th>
<th>Description</th>
</tr>
<tr>
<ti><c>video</c></ti>
<ti>
This option takes one of the following vendor-specific tags:
<c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or
<c>ofonly</c>. You can follow this tag with the resolution and refreshrate
you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are
uncertain what to choose, <c>ofonly</c> will most certainly work.
</ti>
</tr>
<tr>
<ti><c>nol3</c></ti>
<ti>
Disables level 3 cache on some PowerBooks (needed for at least the 17")
</ti>
</tr>
<tr>
<ti><c>dofirewire</c></ti>
<ti>
Enables support for IEEE1394 (FireWire) devices, like external harddisks.
</ti>
</tr>
<tr>
<ti><c>dopcmcia</c></ti>
<ti>
If you want to use PCMCIA devices during your installation (like PCMCIA
network cards) you have to enable this option.
</ti>
</tr>
</table>
<p>
At this prompt, hit enter, and a complete Gentoo Linux environment will be
loaded from the CD. Continue with <uri link="#booted">And When You're
Booted...</uri>.
</p>
</body>
</subsection>
<subsection>
<title>Alternative: Booting the Installation CD on a Pegasos</title>
<body>
<p>
On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
between several preconfigured video configs. If you need any special boot
options you can append them to the command-line. For instance <c>boot cd
/boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. The complete list of
kernel appends (in case something goes wrong and you need it) is preconfigured
in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>.
</p>
</body>
</subsection>
<subsection>
<title>Alternative: Booting the Installation CD with BootX</title>
<body>
<p>
If you have an OldWorld Mac the bootable portion of the livecd can't be used.
The most simple solution is to use MacOS to bootstrap into a Linux environment
with a tool called BootX. Boot floppies are being prepared for Macs without
MacOS, but they are not available at this time.
</p>
<p>
First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
archive into <c>Extensions Folder</c> and the BootX App Control Panel into
<c>Control Panels</c>, both of which are located in your MacOS System Folder.
Next, create a folder called "Linux Kernels" in your System folder and copy the
<c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c>
from the Installation CD <path>boot</path> folder into the MacOS
<c>System Folder</c>.
</p>
<p>
To prepare BootX, start the BootX App Control Panel. First select the Options
dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from
your System Folder. Continue back to the initial screen and ensure that the
ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
shown below:
</p>
<pre caption="BootX kernel arguments">
cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev
</pre>
<note>
The kernel parameters in the yaboot section above are also applicable here.
</note>
<p>
Check once more to make sure the settings are correct and then save the
configuration. This saves typing just in case it doesn't boot or something is
missing. Press the Linux button at the top of the window to boot into the
Installation CD and continue with <uri link="#booted">And When
You're Booted...</uri>
</p>
</body>
</subsection>
<subsection id="booted">
<title>And When You're Booted...</title>
<body>
<p>
You will be greeted by a root ("#") prompt on the current console. You can also
switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
back to the one you started on by pressing Alt-F1. Probably you have to hit
Alt-fn-Fx on Apple machines.
</p>
<p>
If you are installing Gentoo on a system with a non-US keyboard, use
<c>loadkeys</c> to load the keymap for your keyboard. To list the available
keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
are for ADB-based OldWorld machines.
</p>
<pre caption="Listing available keymaps">
<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
on the Installation CD are ADB keymaps and unusable with the Installation CD
kernel)</comment>
# <i>ls /usr/share/keymaps/i386</i>
</pre>
<p>
Now load the keymap of your choice:
</p>
<pre caption="Loading a keymap">
# <i>loadkeys be-latin1</i>
</pre>
<p>
Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases, it may
not auto-load the kernel modules you need. If the PCI auto-detection missed some
of your system's hardware, you will have to load the appropriate kernel modules
manually.
</p>
<p>
In the next example we try to load the <c>airport</c> module. This module
supports only the old Airport cards (b-net). AirportExtreme is not supported
under Linux:
</p>
<pre caption="Loading kernel modules">
# <i>modprobe airport</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> or even <c>links -g</c> for a graphical framebuffer browser to
read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc64-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-bootloader.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2006-01-20</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
<p>
On Linux/PPC64 we have only yaBoot as a bootloader until grub2 is
finished.
</p>
</body>
</subsection>
</section>
<section id="yaboot">
<title>Using yaBoot</title>
<subsection>
<title>Introduction</title>
<body>
<impo>
For a 64bit userland use yaboot-static instead of yaboot, because yaboot won't
compile on 64bit userland systems. For a 32bit userland use yaboot as you
normally would.
</impo>
<p>
There are two ways to configure yaBoot for your system. You can use the
new and improved <c>yabootconfig</c> included with
<path>yaboot-1.3.8-r1</path> and later to automatically set up yaboot. If
for some reason you do not want to run <c>yabootconfig</c> to
automatically set up <path>/etc/yaboot.conf</path> or you are installing Gentoo
on a G5 (on which <c>yabootconfig</c> does not always work), you can just edit
the sample file already installed on your system.
</p>
<impo>
If you are installing on a G5 using an online install and have not used the
G5 optimized stages you must change what profile you are linked to now. If you
do not you will not get dependencies necessary for yaboot to run on Apple
equipment. In the command below replace <c>(userland)</c> with your chosen
userland bit level. If you are installing on a G5 using an offline install
you have to install these packages by hand.
</impo>
<pre caption = "(ONLINE INSTALL FOR G5 USERS ONLY) Changing your profile">
# <i>rm /etc/make.profile</i>
# <i>ln -sf /usr/portage/profiles/default-linux/ppc/2005.1/ppc64/(userland)/970/pmac /etc/make.profile</i>
</pre>
<pre caption = "(OFFLINE INSTALL FOR G5 USERS ONLY) Installing Necessary File System Tools">
# <i>emerge hfsutils hfsplusutils</i>
</pre>
<pre caption = "Installing the bootloader">
<comment>(64bit userland)</comment>
# <i>emerge --update yaboot-static</i>
<comment>(32bit userland)</comment>
# <i>emerge --update yaboot</i>
</pre>
<impo>
yabootconfig/ybin won't work on IBM. You have to install yaboot another way:
<uri link="#yaboot-ibm">Using yaboot on IBM hardware</uri>
</impo>
<note>
If your root filesystem uses the JFS filesystem, be sure to add <c>ro</c> as a
kernel parameter. JFS must be able to replay its log in read-only mode before it
gets mounted read-write.
</note>
<ul>
<li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li>
<li>
<uri link="#manual_yaboot">Alternative: Manual yaBoot Configuration</uri>
</li>
</ul>
</body>
</subsection>
<subsection id="yabootconfig">
<title>Default: Using yabootconfig</title>
<body>
<p>
<c>yabootconfig</c> will auto-detect the partitions on your machine and will
set up dual and triple boot combinations with Linux, Mac OS, and Mac OS
X.
</p>
<p>
To use <c>yabootconfig</c>, your drive must have a bootstrap partition, and
<path>/etc/fstab</path> must be configured with your Linux partitions. Both of
these should have been done already in the steps above. To start, ensure that
you have the latest version of yaboot installed by running <c>emerge --update
yaboot-static</c>. This is necessary as the latest version will be available via
Portage, but it may not have made it into the stage files.
</p>
<p>
Now run <c>yabootconfig</c>. The program will run and it will confirm
the location of the bootstrap partition. Type <c>Y</c> if it is correct. If
not, double check <path>/etc/fstab</path>. yabootconfig will then scan your
system setup, create <path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for
you. <c>mkofboot</c> is used to format the bootstrap partition, and install
the yaboot configuration file into it.
</p>
<p>
You might want to verify the contents of <path>/etc/yaboot.conf</path>. If
you make changes to <path>/etc/yaboot.conf</path> (like setting the
default/boot OS), make sure to rerun <c>ybin -v</c> to apply changes to the
bootstrap partition.
</p>
<p>
Now continue with <uri link="#reboot">Rebooting your System</uri>.
</p>
</body>
</subsection>
<subsection id="manual_yaboot">
<title>Alternative: Manual yaBoot Configuration</title>
<body>
<p>
Below you find a completed <path>yaboot.conf</path> file. Alter it at
will.
</p>
<pre caption = "/etc/yaboot.conf">
<comment>## /etc/yaboot.conf
##
## run: "man yaboot.conf" for details. Do not make changes until you have!!
## see also: /usr/share/doc/yaboot/examples for example configurations.
##
## For a dual-boot menu, add one or more of:
## bsd=/dev/hdaX, macos=/dev/hdaY, macosx=/dev/hdaZ
## our bootstrap partition:</comment>
boot=/dev/hda2
<comment>## ofboot is the openfirmware way to specify the bootstrap partition.
## If this isn't defined, yaboot fails on the G5 and some G4s (unless
## you pass the necessary arguments to the mkofboot/ybin program).
## hd:X means /dev/sdaX (or /dev/hdaX).</comment>
ofboot=hd:2
<comment>## hd: is open firmware speak for hda</comment>
device=hd:
delay=5
defaultos=macosx
timeout=30
install=/usr/lib/yaboot/yaboot
magicboot=/usr/lib/yaboot/ofboot
<comment>#################
## This section can be duplicated if you have more than one kernel or set of
## boot options - replace 2.6.12-gentoo-r10 with your kernel-version
#################</comment>
image=/boot/kernel-2.6.12-gentoo-r10
label=Linux
root=/dev/hda3
partition=3
read-only
macos=hd:13
macosx=hd:12
enablecdboot
enableofboot
</pre>
<p>
Once <path>yaboot.conf</path> is set up the way you want it, you run
<c>mkofboot -v</c> to install the settings in the bootstrap partition.
<e>Don't forget this!</e> Confirm when <c>mkofboot</c> asks you to create a new
filesystem.
</p>
<p>
If all goes well, and you have the same
options as the sample above, your next reboot will give you a simple,
five-entry boot menu. If you update your yaboot config later on, you'll
just need to run <c>ybin -v</c> to update the bootstrap partition -
<c>mkofboot</c> is for initial setup only.
</p>
<p>
For more information on yaboot, take a look at the <uri
link="http://penguinppc.org/projects/yaboot">yaboot project</uri>. For
now, continue the installation with <uri link="#reboot">Rebooting your
System</uri>.
</p>
</body>
</subsection>
</section>
<section id="yaboot-ibm">
<title>Using yaboot on IBM hardware</title>
<body>
<p>
On IBM hardware you cannot run yabootconfig or ybin. You must proceed with the
following steps:
</p>
<ul>
<li>Install yaboot-static</li>
<li>Run 'dd if=/usr/lib/yaboot/yaboot.chrp of=/dev/sdXX' (fill in XX
with your disk and partition for the PReP partition; this was in our
example /dev/sda1)</li>
<li>Next construct your own yaboot.conf file and place into /etc.
(Take a look at the config above, look into the man page of
yaboot.conf or look at the below yaboot.conf example)</li>
<li>Assuming your boot device in OF is pointing to the harddrive you
prep boot partition is on then it'll just work, otherwise at IPL time,
go into the multiboot menu and set the boot device to the one with
your prep boot partition.</li>
<li>That's it!</li>
</ul>
<pre caption = "yaboot.conf for IBM hardware">
device=disk:
partition=2
root=/dev/sda2
default=2.6.12-gentoo-r10
timeout=50
image=/boot/kernel-2.6.12-gentoo-r10
label=Linux
append="console=ttyS0,9600"
read-only
</pre>
<p>
For POWER4, POWER5, and blade-based hardware where the PReP disk partition
and the disk partition that contains your kernel are on the same physical disk,
you can use a simplified yaboot.conf. The following should be sufficient:
</p>
<pre caption="yaboot.conf for PReP hardware">
default = linux
timeout = 100
image=/boot/kernel-2.6.12-gentoo-r10
label=linux
read-only
root = /dev/sda2
append="root=/dev/sda2"
</pre>
<p>
To verify that yaboot has been copied to the PReP partition:
</p>
<pre caption="Verifying the yaboot install on PReP">
# <i>dd if=/dev/sda1 count=10 | grep ELF</i>
Binary file (standard input) matches
10+0 records in
10+0 records out
</pre>
<p>
A match signifies that yaboot was installed correctly.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
~# <i>cd</i>
~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc64-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-ppc64-disk.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2006-01-20</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI drives, then your first hard
drive would be <path>/dev/sda</path>. Serial ATA drives are also
<path>/dev/sda</path> even if they are IDE drives.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions and Slices</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On most systems,
these are called <e>partitions</e>. Other architectures use a similar technique,
called <e>slices</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>Partition map</ti>
<ti>31.5k</ti>
<ti>Partition map</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>(bootstrap)</ti>
<ti>800k</ti>
<ti>Apple_Bootstrap</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/sda4</path></ti>
<ti>ext3</ti>
<ti>Rest of the disk</ti>
<ti>Root partition</ti>
</tr>
</table>
<note>
There are some partitions named like this: <path>Apple_Driver43,
Apple_Driver_ATA, Apple_FWDriver, Apple_Driver_IOKit,
Apple_Patches</path>. If you are not planning to use MacOS 9 you can
delete them, because MacOS X and Linux don't need them.
You might have to use parted in order to delete them, as mac-fdisk can't delete them yet.
</note>
<p>
If you are interested in knowing how big a partition should be, or even how
many partitions you need, read on. Otherwise continue now with
<uri link="#mac-fdisk">Apple G5: Using mac-fdisk to Partition your
Disk</uri> or <uri link="#fdisk">IBM pSeries: using fdisk to Partition
your Disk</uri>
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
</body>
</subsection>
</section>
<section id="mac-fdisk">
<title>Default: Using mac-fdisk (Apple G5) Partition your Disk</title>
<body>
<p>
At this point, create your partitions using <c>mac-fdisk</c>:
</p>
<pre caption="Starting mac-fdisk">
# <i>mac-fdisk /dev/sda</i>
</pre>
<p>
First delete the partitions you have cleared previously to make room for your
Linux partitions. Use <c>d</c> in <c>mac-fdisk</c> to delete those partition(s).
It will ask for the partition number to delete.
</p>
<p>
Second, create an <e>Apple_Bootstrap</e> partition by using <c>b</c>. It will
ask for what block you want to start. Enter the number of your first free
partition, followed by a <c>p</c>. For instance this is <c>2p</c>.
</p>
<note>
This partition is <e>not</e> a "boot" partition. It is not used by Linux at all;
you don't have to place any filesystem on it and you should never mount it. PPC
users don't need an extra partition for <path>/boot</path>.
</note>
<p>
Now create a swap partition by pressing <c>c</c>. Again <c>mac-fdisk</c> will
ask for what block you want to start this partition from. As we used <c>2</c>
before to create the Apple_Bootstrap partition, you now have to enter
<c>3p</c>. When you're asked for the size, enter <c>512M</c> (or whatever size
you want). When asked for a name, enter <c>swap</c> (mandatory).
</p>
<p>
To create the root partition, enter <c>c</c>, followed by <c>4p</c> to select
from what block the root partition should start. When asked for the size, enter
<c>4p</c> again. <c>mac-fdisk</c> will interpret this as "Use all available
space". When asked for the name, enter <c>root</c> (mandatory).
</p>
<p>
To finish up, write the partition to the disk using <c>w</c> and <c>q</c> to
quit <c>mac-fdisk</c>.
</p>
<note>
To make sure everything is ok, you should run mac-fdisk once more and check whether all the partitions are there.
If you don't see any of the partitions you created, or the changes you made, you should reinitialize your partitions by pressing "i" in mac-fdisk.
Note that this will recreate the partition map and thus remove all your partitions.
</note>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</section>
<section id="fdisk">
<title>IBM pSeries, iSeries and OpenPower: using fdisk to Partition your Disk</title>
<subsection>
<body>
<note>
If you are planning to use a RAID disk array for your gentoo installation and
you are using POWER5-based hardware, you should now run <c>iprutils</c> to
format the disks to Advanced Function format and create the disk array. You
should also consider emerging this package after your install is complete.
</note>
<p>
The following parts explain how to create the example partition layout
described previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/sda1</path></ti>
<ti>PPC PReP Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/sda2</path></ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/sda3</path></ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
Change your partition layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Viewing the Current Partition Layout</title>
<body>
<p>
<c>fdisk</c> is a popular and powerful tool to split your disk into
partitions. Fire up <c>fdisk</c> on your disk (in our example, we
use <path>/dev/sda</path>):
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/sda</i>
</pre>
<p>
Once in <c>fdisk</c>, you'll be greeted with a prompt that looks like
this:
</p>
<pre caption="fdisk prompt">
Command (m for help):
</pre>
<p>
Type <c>p</c> to display your disk's current partition configuration:
</p>
<pre caption="An example partition configuration">
Command (m for help): p
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 12 53266+ 83 Linux
/dev/sda2 13 233 981571+ 82 Linux swap
/dev/sda3 234 674 1958701+ 83 Linux
/dev/sda4 675 6761 27035410+ 5 Extended
/dev/sda5 675 2874 9771268+ 83 Linux
/dev/sda6 2875 2919 199836 83 Linux
/dev/sda7 2920 3008 395262 83 Linux
/dev/sda8 3009 6761 16668918 83 Linux
Command (m for help):
</pre>
<p>
This particular disk is configured to house six Linux filesystems
(each with a corresponding partition listed as "Linux") as well as a
swap partition (listed as "Linux swap").
</p>
</body>
</subsection>
<subsection>
<title>Removing all Partitions</title>
<body>
<p>
We will first remove all existing partitions from the disk. Type
<c>d</c> to delete a partition. For instance, to delete an existing
<path>/dev/sda1</path>:
</p>
<note>
If you don't want to delete all partitions just delete those you
want to delete. At this point the author recommends a backup of your
data to avoid the lose of it.
</note>
<pre caption="Deleting a partition">
Command (m for help): <i>d</i>
Partition number (1-4): <i>1</i>
</pre>
<p>
The partition has been scheduled for deletion. It will no longer show up
if you type <c>p</c>, but it will not be erased until your changes have
been saved. If you made a mistake and want to abort without saving your
changes, type <c>q</c> immediately and hit enter and your partition will
not be deleted.
</p>
<p>
Now, assuming that you do indeed want to wipe out all the partitions on
your system, repeatedly type <c>p</c> to print out a partition listing
and then type <c>d</c> and the number of the partition to delete it.
Eventually, you'll end up with a partition table with nothing in it:
</p>
<pre caption="An empty partition table">
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
Command (m for help):
</pre>
<p>
Now that the in-memory partition table is empty, we're ready to create
the partitions. We will use a default partitioning scheme as discussed
previously. Of course, don't follow these instructions to the letter if
you don't want the same partitioning scheme!
</p>
</body>
</subsection>
<subsection>
<title>Creating the PPC PReP boot partition</title>
<body>
<p>
We first create a small PReP boot partition. Type <c>n</c> to create a new
partition, then <c>p</c> to select a primary partition, followed by
<c>1</c> to select the first primary partition. When prompted for the
first cylinder, hit enter. When prompted for the last cylinder, type
<c>+7M</c> to create a partition 7 Mbyte in size. After you've done
this, type <c>t</c> to set the partition type, <c>1</c> to select the
partition you just created and then type in <c>41</c> to set the
partition type to "PPC PReP Boot". Finally, you'll need to mark the PReP
partition as bootable.
</p>
<note>
The PReP partition has to be smaller than 8 MByte!
</note>
<pre caption="Creating the PReP boot partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>1</i>
First cylinder (1-6761, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-6761, default
6761): <i>+8M</i>
Command (m for help): <i>t</i>
Selected partition 1
Hex code (type L to list codes): <i>41</i>
Changed system type of partition 1 to 41 (PPC PReP Boot)
Command (m for help): <i>a</i>
Partition number (1-4): <i>1</i>
Command (m for help):
</pre>
<p>
Now, when you type <c>p</c>, you should see the following partition information:
</p>
<pre caption="Created boot partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
/dev/sda1 * 1 3 13293 41 PPC PReP Boot
Command (m for help):
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Swap Partition</title>
<body>
<p>
Let's now create the swap partition. To do this, type <c>n</c> to create
a new partition, then <c>p</c> to tell fdisk that you want a primary
partition. Then type <c>2</c> to create the second primary 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 you've done
this, type <c>t</c> to set the partition type, <c>2</c> to select the
partition you just created 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 this:
</p>
<pre caption="Partition listing after creating a swap partition">
Command (m for help): <i>p</i>
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 3 13293 41 PPC PReP Boot
/dev/sda2 4 117 506331 82 Linux swap
Command (m for help):
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
Finally, let's create the root partition. To do this, type <c>n</c> to
create a new partition, then <c>p</c> to tell fdisk that you want a
primary partition. Then type <c>3</c> to create the third primary
partition, <path>/dev/sda3</path> in our case. When prompted for the
first cylinder, hit enter. When prompted for the last cylinder, hit
enter to create a partition that takes up the rest of the remaining
space on your disk. After completing these steps, typing <c>p</c> should
display a partition table that looks similar to this:
</p>
<pre caption="Partition listing after creating the root partition">
Command (m for help): p
Disk /dev/sda: 30.7 GB, 30750031872 bytes
141 heads, 63 sectors/track, 6761 cylinders
Units = cylinders of 8883 * 512 = 4548096 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 3 13293 41 PPC PReP Boot
/dev/sda2 4 117 506331 82 Linux swap
/dev/sda3 118 6761 29509326 83 Linux
Command (m for help):
</pre>
</body>
</subsection>
<subsection>
<title>Saving the Partition Layout</title>
<body>
<p>
To save the partition layout and exit <c>fdisk</c>, type <c>w</c>.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<note>
Several filesystems are available.
</note>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling that is fully supported
under Gentoo Linux's xfs-sources kernel. It comes with a robust feature-set and
is optimized for scalability. We only recommend using this filesystem on Linux
systems with high-end SCSI and/or fibre channel storage and a uninterruptible
power supply. Because XFS aggressively caches in-transit data in RAM, improperly
designed programs (those that don't take proper precautions when writing files
to disk and there are quite a few of them) can lose a good deal of data if the
system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the root partition (<path>/dev/sda4</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs -j /dev/sda4</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/sda3</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/sda3</i>
</pre>
<p>
Create and activate the swap with the commands mentioned above.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we create a mount-point and mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mkdir /mnt/gentoo</i>
# <i>mount /dev/sda4 /mnt/gentoo</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc64-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-ppc64-kernel.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel.
It is the layer between the user programs and your system hardware.
Gentoo provides its users several possible kernel sources. A full
listing with description is available at the <uri
link="/doc/en/gentoo-kernel.xml">Gentoo Kernel Guide</uri>.
</p>
<p>
For PPC64 you should use <c>gentoo-sources</c>. So let's continue with
<c>emerge</c>'ing the kernel sources. The <c>USE="-doc"</c> is necessary to
avoid installing xorg-x11 or other dependencies at this point.
<c>USE="symlink"</c> is not necessary for a new install, but ensures proper
creation of the <path>/usr/src/linux</path> symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.12-gentoo-r10
</pre>
<p>
Now it is time to configure and compile your kernel source. There is the
ability to use "genkernel" which would create a generic kernel like the
ones used on the installation CDs, but it is not fully functional for PPC64 at
the moment.
</p>
<p>
Continue now with <uri link="#manual">Manual Configuration</uri>.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make
menuconfig</c>. This will fire up an ncurses-based configuration menu.
</p>
<p>
When compiling the kernel on a 32bit userland system add the following to
the bottom of /etc/profile:
</p>
<pre caption="32bit userland make alias">
# <i>echo 'alias ppc64make="make ARCH=ppc64 CROSS_COMPILE=powerpc64-unknown-linux-gnu-"' >> /etc/profile</i>
# <i>source /etc/profile</i>
</pre>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
(64bit userland) # <i>make menuconfig</i>
(32bit userland) # <i>ppc64make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first
list some options you must activate (otherwise Gentoo will not function,
or not function properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental
code/drivers. You need this, otherwise some very important code/drivers
won't show up:
</p>
<pre caption="Selecting experimental code/drivers, General setup">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
General setup --->
[*] Support for hot-pluggable devices
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you
use. <e>Don't</e> compile them as modules, otherwise your Gentoo system
will not be able to mount your partitions. Also select <c>Virtual
memory</c>, <c>/proc file system</c>, and <c>/dev/pts file system for
Unix98 PTYs</c>:
</p>
<pre caption="Selecting necessary file systems">
File systems --->
[*] Virtual memory file system support (former shm fs)
[*] /proc file system support
[*] /dev/pts file system for Unix98 PTYs
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<note>
You will find some of the mentioned options under <c>Pseudo
filesystems</c> which is a subpart of <c>File systems</c>.
</note>
<p>
If you are using PPPoE to connect to the Internet or you are using a
dial-up modem, you will need the following options in the kernel (you
will find the mentioned options under <c>Networking support</c> which is
a subpart of <c>Device Drivers</c>):
</p>
<pre caption="Selecting PPPoE necessary drivers">
Network device support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
Disable ADB raw keycodes:
</p>
<pre caption="Disabling ADB raw keycodes">
Macintosh Device Drivers --->
[ ] Support for ADB raw keycodes
</pre>
<p>
When you're done configuring your kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>.
</p>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
(64bit userland) # <i>make && make modules_install</i>
(32bit userland) # <i>ppc64make && ppc64make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Remember to replace <path><kernel-version<</path>
with your actual kernel version:
</p>
<pre caption="Installing the kernel">
# <i>cp vmlinux /boot/<kernel-version<</i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Configuring the Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="kernel_modules">
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.6</path>. You can add extra
options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> file and enter the module name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-ppc64-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-ppc64-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-ppc64-medium.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>Any PowerPC64 CPU</ti>
</tr>
<tr>
<th>Systems</th>
<ti>
IBM RS/6000s, Power Macintosh G5, iMac G5, IBP pSeries and IBM OpenPower
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
For a full list of supported systems, please go to
<uri>http://www.linuxppc64.org/hardware.shtml</uri>.
</p>
</body>
</subsection>
</section>
<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can successfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications immediately after the
Gentoo installation and right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot a Gentoo Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CDs</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located
in the <path>releases/ppc64/2005.1-r1/installcd</path> directory;
the Package CDs are located in the <path>releases/ppc64/2005.1/packagecd</path>
directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows). How
to verify MD5 checksums with Mac OS X is described in the <uri
link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (0x17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Installation CD on an Apple</title>
<body>
<p>
Place the Installation CD in the CD-ROM and reboot the system. Hold down the
'C' key at bootup. You will be greeted by a friendly welcome message and a
<e>boot:</e> prompt at the bottom of the screen.
</p>
<p>
You are also able to tweak some kernel options at this prompt. The following
table lists the available boot options you can add:
</p>
<table>
<tr>
<th>Boot Option</th>
<th>Description</th>
</tr>
<tr>
<ti><c>video</c></ti>
<ti>
This option takes one of the following vendor-specific tags:
<c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or
<c>ofonly</c>. You can follow this tag with the resolution and refreshrate
you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are
uncertain what to choose, <c>ofonly</c> will most certainly work.
</ti>
</tr>
<tr>
<ti><c>nol3</c></ti>
<ti>
Disables level 3 cache on some powerbooks (needed for at least the 17'')
</ti>
</tr>
<tr>
<ti><c>debug</c></ti>
<ti>
Enables verbose booting, spawns an initrd shell that can be used to debug
the Installation CD
</ti>
</tr>
<tr>
<ti><c>sleep=X</c></ti>
<ti>
Wait X seconds before continuing; this can be needed by some very old SCSI
CD-ROMs which don't speed up the CD quick enough
</ti>
</tr>
<tr>
<ti><c>bootfrom=X</c></ti>
<ti>
Boot from a different device
</ti>
</tr>
</table>
<p>
At this prompt, hit enter, and a complete Gentoo Linux environment will be
loaded from the CD. Continue with <uri link="#booted">And When You're
Booted...</uri>.
</p>
</body>
</subsection>
<subsection>
<title>Booting the Installation CD on an IBM pSeries</title>
<body>
<p>
For pSeries boxes, sometimes the cds might not autoboot. You might have
to set up your cdrom as a bootable device in the multi-boot menu. (F1 at
startup) The other option is to jump into OF and do it from there:
</p>
<p>
1) Boot into OF (this is 8 from the serial cons or F8 from a graphics
cons, start hitting the key when you see the keyboard mouse etc etc
messages
</p>
<p>
2) run the command 0> boot cdrom:1,yaboot
</p>
<p>
3) stand back and enjoy!
</p>
</body>
</subsection>
<subsection id="booted">
<title>And When You're Booted...</title>
<body>
<p>
You will be greeted by a root ("#") prompt on the current console. You can also
switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
back to the one you started on by pressing Alt-fn-F1.
</p>
<p>
If you are installing Gentoo on a system with a non-US keyboard, use
<c>loadkeys</c> to load the keymap for your keyboard. To list the available
keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
</p>
<pre caption="Listing available keymaps">
<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
on the Installation CD are ADB keymaps and unusable with the
Installation CD kernel)</comment>
# <i>ls /usr/share/keymaps/i386</i>
</pre>
<p>
Now load the keymap of your choice:
</p>
<pre caption="Loading a keymap">
# <i>loadkeys be-latin1</i>
</pre>
<p>
Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases it may
not auto-load the kernel
modules you need. If the PCI auto-detection missed some of your system's
hardware, you will have to load the appropriate kernel modules manually.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook during the installation, make sure you
have created a user account (see <uri link="#useraccounts">Optional: User
Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD.
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-sparc-bootloader.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.3</version>
<date>2006-01-19</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>.
</p>
</body>
</subsection>
</section>
<section>
<title>Installing the SPARC Bootloader: SILO</title>
<body>
<p>
It is now time to install and configure <uri
link="http://www.sparc-boot.org">SILO</uri>, the Sparc Improved boot
LOader.
</p>
<pre caption = "Installing SILO">
# <i>emerge silo</i>
</pre>
<p>
Now open up your favorite editor (we use <c>nano</c> as an example) and
create <path>/etc/silo.conf</path>.
</p>
<pre caption = "Creating /etc/silo.conf">
# <i>nano -w /etc/silo.conf</i>
</pre>
<p>
Below you'll find an example <path>silo.conf</path> file. It uses the
partitioning scheme we use throughout this book and
<path>kernel-2.4.31</path> as kernelimage.
</p>
<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>
image = /boot/kernel-2.4.31
label = linux
</pre>
<p>
If you use the example <path>silo.conf</path> delivered by Portage, be
sure to comment out <e>all</e> lines that you do not need.
</p>
<p>
If the physical disk on which you want to install SILO (as bootloader) differs
from the physical disk on which <path>/etc/silo.conf</path> resides, you must
copy over <path>/etc/silo.conf</path> to a partition on that disk. Assuming that
<path>/boot</path> is a separate partition on that disk, copy over the
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">
# <i>cp /etc/silo.conf /boot</i>
# <i>/sbin/silo -C /boot/silo.conf</i>
/boot/silo.conf appears to be valid
</pre>
<p>
Otherwise just run <c>/sbin/silo</c>:
</p>
<pre caption = "Run silo">
# <i>/sbin/silo</i>
/etc/silo.conf appears to be valid
</pre>
<p>
Now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-sparc-disk.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.1</version>
<date>2005-08-25</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at some of the disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions, and block
devices. Then, once you're familiar with the ins and outs of disks and
filesystems, you'll be guided through the process of setting up partitions
and filesystems for your Gentoo Linux installation.
</p>
<p>
To begin, we introduce <e>block devices</e>. The most typical block device is
probably the one that represents the first SCSI hard disk in a Linux system,
namely <path>/dev/sda</path>.
</p>
<p>
Block devices represent an abstract interface to the disk. User programs can
use these block devices to interact with your disk without worrying about
whether your drives are IDE, SCSI, or something else. The program can simply
address the storage on the disk as a bunch of contiguous, randomly-accessible
512-byte blocks.
</p>
<p>
Block devices show up as entries in <path>/dev/</path>. Typically, the first
SCSI drive is named <path>/dev/sda</path>, the second <path>/dev/sdb</path>,
and so on. IDE drives are named similarly, however, they are prefixed by hd-
instead of sd-. If you are using IDE drives, the first one will be named
<path>/dev/hda</path>, the second <path>/dev/hdb</path>, and so on.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Although it is theoretically possible to use the entire disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. These are known as
<e>partitions</e> or <e>slices</e>.
</p>
<p>
The first partition on the first SCSI disk is <path>/dev/sda1</path>, the second
<path>/dev/sda2</path> and so on. Similarly, the first two partitions on the
first IDE disk are <path>/dev/hda1</path> and <path>/dev/hda2</path>.
</p>
<p>
The third partition on Sun systems is set aside as a special "whole disk"
slice. This partition must not contain a file system.
</p>
<p>
Users who are used to the DOS partitioning scheme should note that Sun
disklabels do not have "primary" and "extended" partitions. Instead, up to
eight partitions are available per drive, with the third of these being
reserved.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme,
the table below suggests a suitable starting point for most systems. For
IDE-based systems, substitute <c>hda</c> for <c>sda</c> in the following.
</p>
<p>
Note that a separate <path>/boot</path> partition is generally <e>not</e>
recommended on SPARC, as it complicates the bootloader configuration.
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Mount Point</th>
<th>Description</th>
</tr>
<tr>
<ti>/dev/sda1</ti>
<ti>ext3</ti>
<ti><2 GByte</ti>
<ti>/</ti>
<ti>
Root partition. For all sparc32 systems, and 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>
</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>
</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>
</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>
</tr>
</table>
</body>
</subsection>
</section>
<section id="fdisk">
<title>Using fdisk to Partition your Disk</title>
<subsection>
<body>
<p>
The following parts explain how to create the example partition layout described
previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti>/dev/sda1</ti>
<ti>/</ti>
</tr>
<tr>
<ti>/dev/sda2</ti>
<ti>swap</ti>
</tr>
<tr>
<ti>/dev/sda3</ti>
<ti>whole disk slice</ti>
</tr>
<tr>
<ti>/dev/sda4</ti>
<ti>/usr</ti>
</tr>
<tr>
<ti>/dev/sda5</ti>
<ti>/var</ti>
</tr>
<tr>
<ti>/dev/sda6</ti>
<ti>/home</ti>
</tr>
</table>
<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
a 15-partition limit for SCSI and SATA.
</p>
</body>
</subsection>
<subsection>
<title>Firing up fdisk</title>
<body>
<p>
Start <c>fdisk</c> with your disk as argument:
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/sda</i>
</pre>
<p>
You should be greeted with the fdisk prompt:
</p>
<pre caption="The fdisk prompt">
Command (m for help):
</pre>
<p>
To view the available partitions, type in <c>p</c>:
</p>
<pre caption="Listing available partitions">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda1 0 488 499712 83 Linux native
/dev/sda2 488 976 499712 82 Linux swap
/dev/sda3 0 8635 8842240 5 Whole disk
/dev/sda4 976 1953 1000448 83 Linux native
/dev/sda5 1953 2144 195584 83 Linux native
/dev/sda6 2144 8635 6646784 83 Linux native
</pre>
<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:
</p>
<pre caption="Creating a Sun Disklabel">
Command (m for help): s
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.
Drive type
? auto configure
0 custom (with hardware detected defaults)
a Quantum ProDrive 80S
b Quantum ProDrive 105S
c CDC Wren IV 94171-344
d IBM DPES-31080
e IBM DORS-32160
f IBM DNES-318350
g SEAGATE ST34371
h SUN0104
i SUN0207
j SUN0327
k SUN0340
l SUN0424
m SUN0535
n SUN0669
o SUN1.0G
p SUN1.05
q SUN1.3G
r SUN2.1G
s IOMEGA Jaz
Select type (? for auto, 0 for custom): <i>0</i>
Heads (1-1024, default 64):
Using default value 64
Sectors/track (1-1024, default 32):
Using default value 32
Cylinders (1-65535, default 8635):
Using default value 8635
Alternate cylinders (0-65535, default 2):
Using default value 2
Physical cylinders (0-65535, default 8637):
Using default value 8637
Rotation speed (rpm) (1-100000, default 5400): <i>10000</i>
Interleave factor (1-32, default 1):
Using default value 1
Extra sectors per cylinder (0-32, default 0):
Using default value 0
</pre>
<p>
You can find the correct values in your disk's documentation. The
'auto configure' option does not usually work.
</p>
</body>
</subsection>
<subsection>
<title>Deleting Existing Partitions</title>
<body>
<p>
It's time to delete any existing partitions. To do this, type <c>d</c> and hit
Enter. You will then be prompted for the partition number you would like to
delete. To delete a pre-existing <path>/dev/sda1</path>, you would type:
</p>
<pre caption="Deleting a partition">
Command (m for help): <i>d</i>
Partition number (1-4): <i>1</i>
</pre>
<p>
<e>You should not delete partition 3 (whole disk).</e> This is required. If
this partition does not exist, follow the "Creating a Sun Disklabel"
instructions above.
</p>
<p>
After deleting all partitions except the Whole disk slice, you should have a
partition layout similar to the following:
</p>
<pre caption="View an empty partition scheme">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda3 0 8635 8842240 5 Whole disk
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
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
output from these steps below:
</p>
<pre caption="Creating a root partition">
Command (m for help): <i>n</i>
Partition number (1-8): <i>1</i>
First cylinder (0-8635): <i>(press Enter)</i>
Last cylinder or +size or +sizeM or +sizeK (0-8635, default 8635): <i>+512M</i>
</pre>
<p>
Now, when you type <c>p</c>, you should see the following partition printout:
</p>
<pre caption="Listing the partition layout">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda1 0 488 499712 83 Linux native
/dev/sda3 0 8635 8842240 5 Whole disk
</pre>
</body>
</subsection>
<subsection>
<title>Creating a swap partition</title>
<body>
<p>
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
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
this:
</p>
<pre caption="Listing of available partitions">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda1 0 488 499712 83 Linux native
/dev/sda2 488 976 499712 82 Linux swap
/dev/sda3 0 8635 8842240 5 Whole disk
</pre>
</body>
</subsection>
<subsection>
<title>Creating the /usr, /var and /home partitions</title>
<body>
<p>
Finally, let's create the /usr, /var and /home partitions. As before,
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
for <path>sda5</path> and <path>sda6</path>, using the desired sizes. Once
you're done, you should see something like this:
</p>
<pre caption="Listing complete partition table">
Command (m for help): <i>p</i>
Disk /dev/sda (Sun disk label): 64 heads, 32 sectors, 8635 cylinders
Units = cylinders of 2048 * 512 bytes
Device Flag Start End Blocks Id System
/dev/sda1 0 488 499712 83 Linux native
/dev/sda2 488 976 499712 82 Linux swap
/dev/sda3 0 8635 8842240 5 Whole disk
/dev/sda4 976 1953 1000448 83 Linux native
/dev/sda5 1953 2144 195584 83 Linux native
/dev/sda6 2144 8635 6646784 83 Linux native
</pre>
</body>
</subsection>
<subsection>
<title>Save and Exit</title>
<body>
<p>
To save your partition layout and exit <c>fdisk</c>, type <c>w</c>:
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what is
used as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise, read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
Several filesystems are available, some are known to be stable on the
SPARC architecture. Ext2 and ext3, for example, are known to work well.
Alternate filesystems may not function correctly.
</p>
<p>
<b>ext2</b> is the tried-and-true Linux filesystem. It does not support
journaling, which means that periodic checks of ext2 filesystems at startup
can be quite time-consuming. There is quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly at
startup, and are therefore generally preferred over their non-journaled
counterparts. In general, journaled filesystems prevent long delays when a
system is booted and the filesystem is in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem. It provides
metadata journaling for fast recovery as well as other enhanced journaling
modes like full-data and ordered-data journaling. Ext3 has an additional hashed
b-tree indexing option that enables high performance in almost all situations.
You can enable this indexing by adding <c>-O dir_index</c> to the <c>mke2fs</c>
command. Ext3 makes an excellent and reliable alternative to ext2.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, tools specific to the chosen
filesystem are available:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>ext3 with hashed b-tree indexing (2.6 kernels only)</ti>
<ti><c>mke2fs -j -O dir_index</c></ti>
</tr>
</table>
<p>
For instance, to create the root partition (<path>/dev/sda1</path> in our
example) as ext2, and the <path>/usr</path>, <path>/var</path>, and
<path>/home</path> partitions (<path>/dev/sda4</path>, <path>5</path>
and <path>6</path> in our example, respectively) as ext3, you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs /dev/sda1</i>
# <i>mke2fs -j /dev/sda4</i>
# <i>mke2fs -j /dev/sda5</i>
# <i>mke2fs -j /dev/sda6</i>
</pre>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/sda2</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/sda2</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount them using the <c>mount</c> command. Don't forget to first
create the necessary mount directories for every partition you created. For
example:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/sda1 /mnt/gentoo</i>
# <i>mkdir /mnt/gentoo/usr</i>
# <i>mount /dev/sda4 /mnt/gentoo/usr</i>
# <i>mkdir /mnt/gentoo/var</i>
# <i>mount /dev/sda5 /mnt/gentoo/var</i>
# <i>mkdir /mnt/gentoo/home</i>
# <i>mount /dev/sda6 /mnt/gentoo/home</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure
to change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>.
This also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-sparc-kernel.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For sparc-based systems we have <c>sparc-sources</c> (kernel source optimized
for SPARC users) and <c>vanilla-sources</c> (the default kernel source as
developed by the linux-kernel developers).
</p>
<p>
In the next example we install the <c>sparc-sources</c>. Of course substitute
with your choice of sources, this is merely an example. The <c>USE="-doc"</c>
is necessary to avoid installing xorg-x11 or other dependencies at this point.
<c>USE="symlink"</c> is not necessary for a new install, but ensures proper
creation of the <path>/usr/src/linux</path> symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge sparc-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>sparc-sources-2.4.31</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.4.31-sparc
</pre>
<p>
Now it is time to configure and compile your kernel source.
</p>
</body>
</subsection>
</section>
<section>
<title>Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
First of all, activate the use of development and experimental code/drivers.
You need this, otherwise some very important code/drivers won't show up:
</p>
<pre caption="Selecting experimental code/drivers">
Code maturity level options --->
[*] Prompt for development and/or incomplete code/drivers
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
file system</c>. If you are running a 2.4 kernel, you should also select
<c>/dev file system</c> + <c>Automatically mount at boot</c>:
</p>
<pre caption="Selecting necessary file systems">
File systems --->
[*] Virtual memory file system support (former shm fs)
[*] /proc file system support
[ ] /dev/pts file system for Unix98 PTYs
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Ext3 journalling file system support
<*> Second extended fs support
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Network device support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
Now activate the correct bus-support:
</p>
<pre caption="Activating SBUS/UPA">
Console drivers --->
Frame-buffer support --->
[*] SBUS and UPA framebuffers
[*] Creator/Creator3D support <comment>(Only for UPA slot adapter used in many Ultras)</comment>
[*] CGsix (GX,TurboGX) support <comment>(Only for SBUS slot adapter used in many SPARCStations)</comment>
</pre>
<p>
Of course you want support for the OBP:
</p>
<pre caption="Activating OBP Support">
Misc Linux/SPARC drivers --->
[*] /dev/openprom device support
</pre>
<p>
You will also need SCSI-specific support:
</p>
<pre caption="Activating SCSI-specific support">
SCSI support --->
SCSI low-level drivers --->
<*> Sparc ESP Scsi Driver <comment>(Only for SPARC ESP on-board SCSI adapter)</comment>
<*> PTI Qlogic, ISP Driver <comment>(Only for SBUS SCSI controllers from PTI or QLogic)</comment>
<*> SYM53C8XX Version 2 SCSI support <comment>(Only for Ultra 60 on-board SCSI adapter)</comment>
</pre>
<p>
To support your network card, select one of the following:
</p>
<pre caption="Activating networking support">
Network device support --->
Ethernet (10 or 100Mbit) --->
<*> Sun LANCE support <comment>(Only for SPARCStation, older Ultra systems, and as Sbus option)</comment>
<*> Sun Happy Meal 10/100baseT support <comment>(Only for Ultra; also supports "qfe" quad-ethernet on PCI and Sbus)</comment>
<*> DECchip Tulip (dc21x4x) PCI support <comment>(For some Netras, like N1)</comment>
Ethernet (1000Mbit) --->
<*> Broadcom Tigon3 support <comment>(Modern Netra, Sun Fire machines)</comment>
</pre>
<p>
When you have a 4-port Ethernet machine (10/100 or 10/100/1000) the port order
is different from the one used by Solaris. You can use <c>sys-apps/ethtool</c>
or <c>mii-tool</c> to check the port link status.
</p>
<p>
When you're done configuring your kernel, continue with <uri
link="#compiling">Compiling and Installing</uri>. However, after having
compiled the kernel, check its size:
</p>
<pre caption="Check kernel size">
# <i>ls -lh vmlinux</i>
-rw-r--r-- 1 root root 2.4M Oct 25 14:38 vmlinux
</pre>
<p>
If the (uncompressed) size is bigger than 2.5 MB (for Sparc32) or 3.5 MB (for
Sparc64), reconfigure your kernel until it doesn't exceed these limits. One way
of accomplishing this is by having most kernel drivers compiled as modules.
Ignoring this can lead to a non-booting kernel.
</p>
<p>
Also, if your kernel is just a tad too big, you can try stripping it using the
<c>strip</c> command:
</p>
<pre caption="Stripping the kernel">
# <i>strip -R .comment -R .note vmlinux</i>
</pre>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
<comment>(sparc32)</comment>
# <i>make dep && make clean vmlinux modules modules_install</i>
<comment>(sparc64)</comment>
# <i>make dep && make clean vmlinux image modules modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Remember to replace <path><kernel-version></path>
with your actual kernel version.
</p>
<pre caption="Installing the kernel">
<comment>(sparc32)</comment>
# <i>cp vmlinux /boot/<kernel-version></i>
<comment>(sparc64)</comment>
# <i>cp arch/sparc64/boot/image /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Installing Separate Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="kernel_modules">
<title>Installing Separate Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.4</path>.
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.4</path> file and enter the module name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.4">
# <i>nano -w /etc/modules.autoload.d/kernel-2.4</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.4">
3c59x
</pre>
<p>
Continue the installation with <uri link="?part=1&chap=8">Configuring
your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-sparc-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-sparc-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-sparc-medium.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.4</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>Sparc System</th>
<ti>
Please check the <uri
link="http://www.ultralinux.org/faq.html#s_2">UltraLinux FAQ</uri>
</ti>
</tr>
<tr>
<th>CPU</th>
<ti>
Although sparc64 is the only officially supported platform, experimental
support for sparc32 is available as well
</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
<p>
We currently only provide Installation CDs for the sparc64 architecture. Users
of sparc32 can use the experimental netboot images to install Gentoo from.
More information about netbooting can be found in our <uri
link="/doc/en/gentoo-sparc-netboot-howto.xml">Gentoo Linux based Netboot
HOWTO</uri>.
</p>
</body>
</subsection>
</section>
<!-- Copy/Paste from hb-install-x86-medium.xml -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can successfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot a Gentoo Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CDs</title>
<body>
<p>
You can download the Universal Installation CD (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
the <path>releases/sparc/2005.1-r1/sparc64/installcd</path>
directory; the Package CDs are located in the
<path>releases/sparc/2005.1/sparc64/packagecd</path> directory.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded
iso></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<p>
Insert the Gentoo Installation CD in the CD-ROM and boot your system. During
startup, press Stop-A to enter OpenBootPROM (OBP). Once you are in the OBP,
boot from the CD-ROM:
</p>
<pre caption="Booting the Installation CD">
ok <i>boot cdrom</i>
</pre>
<p>
You will be greeted by the SILO boot manager (on the Installation CD). Type in
<c>gentoo-2.4</c> and press enter to continue booting the
system:
</p>
<pre caption="Continue booting from the Installation CD">
boot: <i>gentoo-2.4</i>
</pre>
<p>
Once the Installation CD is booted, you will be automatically logged on to the
system.
</p>
<p>
You should have a root ("#") prompt on the current console and can also switch
to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you
started on by pressing Alt-F1. You will also find a root prompt on the serial
console (<path>ttyS0</path>).
</p>
<p>
Continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
If not all hardware is supported out-of-the-box, you will need to load the
appropriate kernel modules.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-stage.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-stage.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-stage.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-stage.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-stage.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.8</version>
<date>2005-12-20</date>
<section>
<title>Installing a Stage Tarball</title>
<subsection>
<title>Setting the Date/Time Right</title>
<body>
<p>
Before you continue you need to check your date/time and update it. A
misconfigured clock may lead to strange results in the future!
</p>
<p>
To verify the current date/time, run <c>date</c>:
</p>
<pre caption="Verifying the date/time">
# <i>date</i>
Fri Mar 29 16:21:18 CEST 2005
</pre>
<p>
If the date/time displayed is wrong, update it using the <c>date
MMDDhhmmYYYY</c> syntax (<b>M</b>onth, <b>D</b>ay, <b>h</b>our, <b>m</b>inute
and <b>Y</b>ear). For instance, to set the date to Mar 29th, 16:21 in the
year 2005:
</p>
<pre caption="Setting the date/time">
# <i>date 032916212005</i>
</pre>
</body>
</subsection>
<subsection>
<title>Locating the Stage3 File</title>
<body>
<p>
If you have configured networking because you need to download a stage3 file for
your architecture, continue with <uri link="#download">Alternative: Using a
Stage3 from the Internet</uri>. Otherwise read <uri link="#available">Default:
Using a Stage3 from the Installation CD</uri>.
</p>
</body>
</subsection>
</section>
<section id="available">
<title>Default: Using a Stage from the Installation CD</title>
<subsection>
<title>Extracting the Stage Tarball</title>
<body>
<p>
The stages on the CD reside in the <path>/mnt/cdrom/stages</path> directory. To
see a listing of available stages, use <c>ls</c>:
</p>
<pre caption="List all available stages">
# <i>ls /mnt/cdrom/stages</i>
</pre>
<p>
If the system replies with an error, you may need to mount the CD-ROM first:
</p>
<pre caption="Mounting the CD-ROM">
# <i>ls /mnt/cdrom/stages</i>
ls: /mnt/cdrom/stages: No such file or directory
# <i>mount /dev/cdroms/cdrom0 /mnt/cdrom</i>
# <i>ls /mnt/cdrom/stages</i>
</pre>
<p>
Now go into your Gentoo mountpoint (usually <path>/mnt/gentoo</path>):
</p>
<pre caption="Changing directory to /mnt/gentoo">
# <i>cd /mnt/gentoo</i>
</pre>
<p>
We will now extract the stage tarball of your choice. We will do this with the
<c>tar</c> tool. Make sure you use the same options (<c>xvjpf</c>)! The
<c>x</c> stands for <e>Extract</e>, the <c>v</c> for <e>Verbose</e> to see what
happens during the extraction process (this one is optional), the <c>j</c> for
<e>Decompress with bzip2</e>, the <c>p</c> for <e>Preserve permissions</e> and
the <c>f</c> to denote that we want to extract a file, not standard input. In
the next example, we extract the stage tarball
<path>stage3-<subarch>-2005.1-r1.tar.bz2</path>. Be sure to substitute
the tarball filename with your stage.
</p>
<pre caption="Extracting the stage tarball">
# <i>tar xvjpf /mnt/cdrom/stages/stage3-<subarch>-2005.1-r1.tar.bz2</i>
</pre>
<p>
Now that the stage is installed, continue with <uri
link="#installing_portage">Installing Portage</uri>.
</p>
</body>
</subsection>
</section>
<section id="download">
<title>Alternative: Using a Stage from the Internet</title>
<subsection>
<title>Downloading the Stage Tarball</title>
<body>
<p>
Go to the Gentoo mountpoint at which you mounted your filesystems
(most likely <path>/mnt/gentoo</path>):
</p>
<pre caption="Going to the Gentoo mountpoint">
# <i>cd /mnt/gentoo</i>
</pre>
<p>
Depending on your installation medium, you have a couple of tools available to
download a stage. If you have <c>links2</c> available, then you can immediately
surf to <uri link="/main/en/mirrors.xml">the Gentoo mirrorlist</uri> and
choose a mirror close to you.
</p>
<p>
If you don't have <c>links2</c> available you should have <c>lynx</c> at your
disposal. If you need to go through a proxy, export the <c>http_proxy</c> and
<c>ftp_proxy</c> variables:
</p>
<pre caption="Setting proxy information for lynx">
# <i>export http_proxy="http://proxy.server.com:port"</i>
# <i>export ftp_proxy="http://proxy.server.com:port"</i>
</pre>
<p>
We will now assume that you have <c>links2</c> at your disposal.
</p>
<p>
Pick the <path>releases/</path> directory, followed by your architecture (for
instance <path>x86/</path>) and the Gentoo version (<path>2005.1/</path> or
<path>2005.1-r1/</path> if available) to finish up with the <path>stages/</path>
directory. There you should see all available stage files for your architecture
(they might be stored within subdirectories named to the individual sub
architectures). Select one and press <c>D</c> to download. When you're
finished, press <c>Q</c> to quit the browser.
</p>
<pre caption="Surfing to the mirror listing with links2">
# <i>links2 http://www.gentoo.org/main/en/mirrors.xml</i>
<comment>(If you need proxy support with links2:)</comment>
# <i>links2 -http-proxy proxy.server.com:8080 http://www.gentoo.org/main/en/mirrors.xml</i>
</pre>
<p>
Make sure you download a stage3 tarball - installations using a stage1 or stage2
tarball are not supported anymore.
</p>
<p>
If you want to check the integrity of the downloaded stage tarball, use
<c>md5sum</c> and compare the output with the MD5 checksum provided on the
mirror. For instance, to check the validity of the x86 stage tarball:
</p>
<pre caption="Example checking integrity of a stage tarball">
# <i>md5sum -c stage3-x86-2005.1-r1.tar.bz2.md5</i>
stage3-x86-2005.1-r1.tar.bz2: OK
</pre>
</body>
</subsection>
<subsection>
<title>Unpacking the Stage Tarball</title>
<body>
<p>
Now unpack your downloaded stage onto your system. We use <c>tar</c> to proceed
as it is the easiest method:
</p>
<pre caption="Unpacking the stage">
# <i>tar xvjpf stage3-*.tar.bz2</i>
</pre>
<p>
Make sure that you use the same options (<c>xvjpf</c>). The <c>x</c> stands
for <e>Extract</e>, the <c>v</c> for <e>Verbose</e> to see what happens during
the extraction process (this one is optional), the <c>j</c> for <e>Decompress
with bzip2</e>, the <c>p</c> for <e>Preserve permissions</e> and the <c>f</c>
to denote that we want to extract a file, not standard input.
</p>
<p>
Now that the stage is installed, continue with <uri
link="#installing_portage">Installing Portage</uri>.
</p>
</body>
</subsection>
</section>
<section id="installing_portage">
<title>Installing Portage</title>
<subsection>
<title>Unpacking a Portage Snapshot</title>
<body>
<p>
You now have to install a Portage snapshot, a collection of files that inform
Portage what software titles you can install, which profiles are available, etc.
</p>
</body>
</subsection>
<subsection id="installing_from_InstallCD">
<title>Unpack the Snapshot from the Installation CD</title>
<body>
<p>
To install the snapshot, take a look inside <path>/mnt/cdrom/snapshots/</path>
to see what snapshot is available:
</p>
<pre caption="Checking the /mnt/cdrom/snapshots content">
# <i>ls /mnt/cdrom/snapshots</i>
</pre>
<p>
Now extract the snapshot using the following construct. Again, make sure you
use the correct options with <c>tar</c>. Also, the <c>-C</c> is with a capital
<c>C</c>, not <c>c</c>. In the next example we use
<path>portage-<date>.tar.bz2</path> as the snapshot filename. Be sure to
substitute with the name of the snapshot that is on your Installation CD.
</p>
<pre caption="Extracting a Portage snapshot">
# <i>tar xvjf /mnt/cdrom/snapshots/portage-<date>.tar.bz2 -C /mnt/gentoo/usr</i>
</pre>
</body>
</subsection>
<subsection id="copysources">
<title>Copy Source Code Archives</title>
<body>
<p>
You also need to copy over all source code from the Universal Installation CD.
</p>
<pre caption="Copy over source code">
# <i>mkdir /mnt/gentoo/usr/portage/distfiles</i>
# <i>cp /mnt/cdrom/distfiles/* /mnt/gentoo/usr/portage/distfiles/</i>
</pre>
</body>
</subsection>
</section>
<section id="compile_options">
<title>Configuring the Compile Options</title>
<subsection>
<title>Introduction</title>
<body>
<p>
To optimize Gentoo, you can set a couple of variables which impact Portage
behaviour. All those variables can be set as environment variables (using
<c>export</c>) but that isn't permanent. To keep your settings, Portage provides
you with <path>/etc/make.conf</path>, a configuration file for Portage. It is
this file we will edit now.
</p>
<note>
A commented listing of all possible variables can be found in
<path>/mnt/gentoo/etc/make.conf.example</path>. For a successful Gentoo
installation you'll only need to set the variables which are mentioned beneath.
</note>
<p>
Fire up your favorite editor (in this guide we use <c>nano</c>) so we can alter
the optimization variables we will discuss hereafter.
</p>
<pre caption="Opening /etc/make.conf">
# <i>nano -w /mnt/gentoo/etc/make.conf</i>
</pre>
<p>
As you probably noticed, the <path>make.conf.example</path> file is
structured in a generic way: commented lines start with "#", other lines define
variables using the <c>VARIABLE="content"</c> syntax. The <path>make.conf</path>
file uses the same syntax. Several of those variables are discussed next.
</p>
<warn>
Do not make any modifications to the USE variable if you are performing a stage3
with GRP installation. You can alter the USE variable after having installed the
packages you want. Gremlins are known to attack your system if you ignore this
warning!
</warn>
</body>
</subsection>
<subsection>
<title>CHOST</title>
<body>
<p>
The <c>CHOST</c> variable declares the target build host for your system. This
variable should already be set to the correct value. <brite>Do not edit
it</brite> as that might break your system. If the <c>CHOST</c> variable does
not look correct to you, you might be using the wrong stage3 tarball.
</p>
</body>
</subsection>
<subsection>
<title>CFLAGS and CXXFLAGS</title>
<body>
<p>
The <c>CFLAGS</c> and <c>CXXFLAGS</c> variables define the optimization flags
for the <c>gcc</c> C and C++ compiler respectively. Although we define those
generally here, you will only have maximum performance if you optimize these
flags for each program separately. The reason for this is because every program
is different.
</p>
<p>
In <path>make.conf</path> you should define the optimization flags you think
will make your system the most responsive <e>generally</e>. Don't place
experimental settings in this variable; too much optimization can make
programs behave bad (crash, or even worse, malfunction).
</p>
<p>
We will not explain all possible optimization options. If you want to know
them all, read the <uri link="http://gcc.gnu.org/onlinedocs/">GNU
Online Manual(s)</uri> or the <c>gcc</c> info page (<c>info gcc</c> -- only
works on a working Linux system). The <path>make.conf.example</path> file
itself also contains lots of examples and information; don't forget to read it
too.
</p>
<p>
A first setting is the <c>-march=</c> flag, which specifies the name of the
target architecture. Possible options are described in the
<path>make.conf.example</path> file (as comments). For instance, for the x86
Athlon XP architecture:
</p>
<pre caption="The GCC march setting">
<comment># AMD64 users who want to use a native 64 bit system should use -march=k8</comment>
<comment># EM64T users should use -march=nocona</comment>
-march=athlon-xp
</pre>
<p>
A second one is the <c>-O</c> flag (that is a capital O, not a zero),
which specifies the <c>gcc</c> optimization
class flag. Possible classes are <c>s</c> (for size-optimized),
<c>0</c> (zero - for no optimizations), <c>1</c>, <c>2</c> or <c>3</c> for more
speed-optimization flags (every class has the same flags as the one before, plus
some extras). For instance, for a class-2 optimization:
</p>
<pre caption="The GCC O setting">
-O2
</pre>
<p>
Another popular optimization flag is <c>-pipe</c> (use pipes rather than
temporary files for communication between the various stages of compilation).
</p>
<p>
Mind you that using <c>-fomit-frame-pointer</c> (which doesn't keep the frame
pointer in a register for functions that don't need one) might have serious
repercussions on the debugging of applications!
</p>
<p>
When you define the <c>CFLAGS</c> and <c>CXXFLAGS</c>, you should combine
several optimization flags, like in the following example:
</p>
<pre caption="Defining the CFLAGS and CXXFLAGS variable">
CFLAGS="-march=athlon-xp -pipe -O2" <comment># AMD64 users use march=k8</comment>
<comment># EM64T users use march=nocona</comment>
CXXFLAGS="${CFLAGS}" <comment># Use the same settings for both variables</comment>
</pre>
</body>
</subsection>
<subsection>
<title>MAKEOPTS</title>
<body>
<p>
With <c>MAKEOPTS</c> you define how many parallel compilations should occur when
you install a package. A good choice is the number of CPUs in your system plus
one, but this guideline isn't always perfect.
</p>
<pre caption="MAKEOPTS for a regular, 1-CPU system">
MAKEOPTS="-j2"
</pre>
</body>
</subsection>
<subsection>
<title>Ready, Set, Go!</title>
<body>
<p>
Update your <path>/mnt/gentoo/etc/make.conf</path> to your own preference and
save (<c>nano</c> users would hit <c>Ctrl-X</c>). You are now ready to continue
with <uri link="?part=1&chap=6">Chrooting into the Gentoo Base System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-system.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-system.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-system.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-system.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-system.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.4</version>
<date>2006-02-22</date>
<section>
<title>Chrooting</title>
<subsection>
<title>Mounting the /proc and /dev Filesystems</title>
<body>
<p>
Mount the <path>/proc</path> filesystem on <path>/mnt/gentoo/proc</path> to
allow the installation to use the kernel-provided information within the
chrooted environment, and then mount-bind the <path>/dev</path> filesystem.
</p>
<pre caption="Mounting /proc and /dev">
# <i>mount -t proc none /mnt/gentoo/proc</i>
# <i>mount -o bind /dev /mnt/gentoo/dev</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Copy over DNS Information</title>
<body>
<p>
If you configured your network to fetch the appropriate stage file later on from
the Internet, you need to copy over the DNS information stored in
<path>/etc/resolv.conf</path> to <path>/mnt/gentoo/etc/resolv.conf</path>. This
file contains the nameservers your system will use to resolve names to IP
addresses.
</p>
<pre caption="Copy over DNS Information">
# <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i>
</pre>
</body>
</subsection>
<subsection>
<title>Entering the new Environment</title>
<body>
<p>
Now that all partitions are initialized and the base environment
installed, it is time to enter our new installation environment by
<e>chrooting</e> into it. This means that we change from the current
installation environment to your installation system (namely the
initialized partitions).
</p>
<p>
This chrooting is done in three steps. First we will change the root
from <path>/</path> (on the installation medium) to <path>/mnt/gentoo</path>
(on your partitions) using <c>chroot</c>. Then we will create a new environment
using <c>env-update</c>, which essentially creates environment variables.
Finally, we load those variables into memory using <c>source</c>.
</p>
<pre caption="Chrooting into the new environment">
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>env-update</i>
>>> Regenerating /etc/ld.so.cache...
# <i>source /etc/profile</i>
# <i>export PS1="(chroot) $PS1"</i>
</pre>
<p>
Congratulations! You are now inside your own Gentoo Linux environment.
Of course it is far from finished, which is why the installation still
has some sections left :-)
</p>
</body>
</subsection>
<subsection>
<title>Creating the Portage cache</title>
<body>
<p>
You have already installed the Portage tree, but you should now build the
Portage cache to speed up future emerges. <c>emerge --metadata</c> does this
for you.
</p>
<pre caption="Creating the Portage cache">
# <i>emerge --metadata</i>
</pre>
</body>
</subsection>
</section>
<section id="configure_USE">
<title>Configuring the USE Variable</title>
<subsection>
<title>What is the USE Variable?</title>
<body>
<p>
<c>USE</c> is one of the most powerful variables Gentoo provides to its users.
Several programs can be compiled with or without optional support for certain
items. For instance, some programs can be compiled with gtk-support, or with
qt-support. Others can be compiled with or without SSL support. Some programs
can even be compiled with framebuffer support (svgalib) instead of X11 support
(X-server).
</p>
<p>
Most distributions compile their packages with support for as much as possible,
increasing the size of the programs and startup time, not to mention an enormous
amount of dependencies. With Gentoo you can define what options a package
should be compiled with. This is where <c>USE</c> comes into play.
</p>
<p>
In the <c>USE</c> variable you define keywords which are mapped onto
compile-options. For instance, <e>ssl</e> will compile ssl-support in the
programs that support it. <e>-X</e> will remove X-server support (note the minus
sign in front). <e>gnome gtk -kde -qt</e> will compile your programs with gnome
(and gtk) support, and not with kde (and qt) support, making your system fully
tweaked for GNOME.
</p>
</body>
</subsection>
<subsection>
<title>Modifying the USE Variable</title>
<body>
<warn>
Do not make any modifications to the USE variable yet if you plan to use our
prebuilt packages (GRP set). You can alter the USE variable after having
installed the packages you want. Gremlins are known to attack your system
if you ignore this warning!
</warn>
<p>
The default <c>USE</c> settings are placed in
<path>/etc/make.profile/make.defaults</path>. What you place in
<path>/etc/make.conf</path> is calculated against these defaults settings. If
you add something to the <c>USE</c> setting, it is added to the default list. If
you remove something from the <c>USE</c> setting (by placing a minus sign in
front of it) it is removed from the default list (if it was in the default list
at all). <e>Never</e> alter anything inside the <path>/etc/make.profile</path>
directory; it gets overwritten when you update Portage!
</p>
<p>
A full description on <c>USE</c> can be found in the second part of the Gentoo
Handbook, <uri link="?part=2&chap=2">USE flags</uri>. A full description on
the available USE flags can be found on your system in
<path>/usr/portage/profiles/use.desc</path>.
</p>
<pre caption="Viewing available USE flags">
# <i>less /usr/portage/profiles/use.desc</i>
<comment>(You can scroll using your arrow keys, exit by pressing 'q')</comment>
</pre>
<p>
As an example we show a <c>USE</c> setting for a KDE-based system with DVD, ALSA
and CD Recording support:
</p>
<pre caption="Opening /etc/make.conf">
# <i>nano -w /etc/make.conf</i>
</pre>
<pre caption="USE setting">
USE="-gtk -gnome qt kde dvd alsa cdr"
</pre>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-tools.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-tools.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-tools.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-tools.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-tools.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2005-11-21</date>
<section>
<title>System Logger</title>
<body>
<p>
Some tools are missing from the <e>stage3</e> archive because several packages
provide the same functionality. It is now up to you to choose which ones you
want to install.
</p>
<p>
The first tool you need to decide on has to provide logging facilities for your
system. Unix and Linux have an excellent history of logging capabilities -- if
you want you can log everything that happens on your system in logfiles. This
happens through the <e>system logger</e>.
</p>
<p>
Gentoo offers several system loggers to choose from. There are <c>sysklogd</c>,
which is the traditional set of system logging daemons, <c>syslog-ng</c>, an
advanced system logger, and <c>metalog</c> which is a highly-configurable
system logger. Others might be available through Portage as well - our number of
available packages increases on a daily basis.
</p>
<p>
If you plan on using <c>sysklogd</c> or <c>syslog-ng</c> you might want to
install <c>logrotate</c> afterwards as those system loggers don't provide any
rotation mechanism for the log files.
</p>
<!--
Even though syslog-ng does not rotate the logs, it does conform to the syslog
RFC (http://www.faqs.org/rfcs/rfc3164.html) and is far more powerful than most other system loggers. That and some architectures really prefer syslog-ng
above others (metalog for instance doesn't work nicely with sparc all the
time).
-->
<p>
To install the system logger of your choice, <c>emerge</c> it and have it added
to the default runlevel using <c>rc-update</c>. The following example installs
<c>syslog-ng</c>. Of course substitute with your system logger:
</p>
<pre caption="Installing a system logger">
# <i>emerge syslog-ng</i>
# <i>rc-update add syslog-ng default</i>
</pre>
</body>
</section>
<section>
<title>Optional: Cron Daemon</title>
<body>
<p>
Next is the cron daemon. Although it is optional and not required for your
system, it is wise to install one. But what is a cron daemon? A cron daemon
executes scheduled commands. It is very handy if you need to execute some
command regularly (for instance daily, weekly or monthly).
</p>
<p>
We only provide <c>vixie-cron</c> for networkless installations. If you want
another cron daemon you can wait and install it later on.
</p>
<pre caption="Installing a cron daemon">
# <i>emerge vixie-cron</i>
# <i>rc-update add vixie-cron default</i>
</pre>
</body>
</section>
<section>
<title>Optional: File Indexing</title>
<body>
<p>
If you want to index your system's files so you are able to quickly
locate them using the <c>locate</c> tool, you need to install
<c>sys-apps/slocate</c>.
</p>
<pre caption="Installing slocate">
# <i>emerge slocate</i>
</pre>
</body>
</section>
<section>
<title>File System Tools</title>
<body>
<p>
Depending on what file systems you are using, you need to install the necessary
file system utilities (for checking the filesystem integrity, creating
additional file systems etc.).
</p>
<p>
The following table lists the tools you need to install if you use a certain
file system. Not all filesystems are available for each and every architecture
though.
</p>
<table>
<tr>
<th>File System</th>
<th>Tool</th>
<th>Install Command</th>
</tr>
<tr>
<ti>XFS</ti>
<ti>xfsprogs</ti>
<ti><c>emerge xfsprogs</c></ti>
</tr>
<tr>
<ti>ReiserFS</ti>
<ti>reiserfsprogs</ti>
<ti><c>emerge reiserfsprogs</c></ti>
</tr>
<tr>
<ti>JFS</ti>
<ti>jfsutils</ti>
<ti><c>emerge jfsutils</c></ti>
</tr>
</table>
<p>
If you are an EVMS user, you need to install <c>emvs</c>:
</p>
<pre caption="Installing EVMS utilities">
# <i>USE="-gtk" emerge evms</i>
</pre>
<p>
The <c>USE="-gtk"</c> will prevent the installation of dependencies. If you
want to enable the <c>evms</c> graphical tools, you can recompile <c>evms</c>
later on.
</p>
<p>
If you don't require any additional networking-related tools (such as rp-pppoe
or a dhcp client) continue with <uri link="?part=1&chap=10">Configuring the
Bootloader</uri>.
</p>
</body>
</section>
<section>
<title>Networking Tools</title>
<subsection>
<title>Optional: Installing a DHCP Client</title>
<body>
<p>
If you require Gentoo to automatically obtain an IP address for your network
interface(s), you need to install <c>dhcpcd</c> (or any other DHCP Client)
on your system. If you don't do this now, you might not be able to connect
to the internet after the installation!
</p>
<pre caption="Installing dhcpcd">
# <i>emerge dhcpcd</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Installing a PPPoE Client</title>
<body>
<p>
If you need <c>rp-pppoe</c> to connect to the net, you need to install it.
</p>
<pre caption="Installing rp-pppoe">
# <i>USE="-X" emerge rp-pppoe</i>
</pre>
<p>
The <c>USE="-X"</c> will prohibit xorg-x11 to be installed as a dependency
(<c>rp-pppoe</c> has graphical tools; if you want those enabled, you can
recompile <c>rp-pppoe</c> later on or have xorg-x11 installed now -- which takes a
long time to compile).
</p>
<p>
Now continue with <uri link="?part=1&chap=10">Configuring the
Bootloader</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-bootloader.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-bootloader.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-bootloader.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-bootloader.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-bootloader.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-02-02</date>
<section>
<title>Making your Choice</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your kernel is configured and compiled and the necessary system
configuration files are filled in correctly, it is time to install a
program that will fire up your kernel when you start the system. Such a
program is called a <e>bootloader</e>. For x86, Gentoo Linux provides <uri
link="#grub">GRUB</uri> and <uri link="#lilo">LILO</uri>. But before we
install one of these two bootloaders, we inform you how to configure framebuffer
(assuming you want it of course). With framebuffer you can run the Linux command
line with (limited) graphical features (such as using the nice bootsplash
image Gentoo provides).
</p>
</body>
</subsection>
<subsection>
<title>Optional: Framebuffer</title>
<body>
<p>
<e>If</e> you have configured your kernel with framebuffer support (or you used
<c>genkernel</c>'s default kernel configuration), you can activate it by adding
a <c>vga</c> and/or a <c>video</c> statement to your bootloader configuration
file.
</p>
<p>
First of all you need to know what type of framebuffer device you're using. If
you use a Gentoo patched kernel tree (such as <c>gentoo-sources</c>) you will
have had the possibility of selecting <c>vesafb-tng</c> as the <e>VESA driver
type</e> (which is default for these kernel sources). If this is the case, you
are using <c>vesafb-tng</c> and do not need to set a <c>vga</c> statement.
Otherwise you are using the <c>vesafb</c> driver and need to set the <c>vga</c>
statement.
</p>
<p>
The <c>vga</c> statement controls the resolution and color depth of your
framebuffer screen for <c>vesafb</c>. As stated in
<path>/usr/src/linux/Documentation/fb/vesafb.txt</path> (which gets installed
when you install a kernel source package), you need to pass the VESA number
corresponding to the requested resolution and color depth to it.
</p>
<p>
The following table lists the available resolutions and colordepths and matches
those against the value that you need to pass on to the <c>vga</c> statement.
</p>
<table>
<tr>
<ti></ti>
<th>640x480</th>
<th>800x600</th>
<th>1024x768</th>
<th>1280x1024</th>
</tr>
<tr>
<th>256</th>
<ti>0x301</ti>
<ti>0x303</ti>
<ti>0x305</ti>
<ti>0x307</ti>
</tr>
<tr>
<th>32k</th>
<ti>0x310</ti>
<ti>0x313</ti>
<ti>0x316</ti>
<ti>0x319</ti>
</tr>
<tr>
<th>64k</th>
<ti>0x311</ti>
<ti>0x314</ti>
<ti>0x317</ti>
<ti>0x31A</ti>
</tr>
<tr>
<th>16M</th>
<ti>0x312</ti>
<ti>0x315</ti>
<ti>0x318</ti>
<ti>0x31B</ti>
</tr>
</table>
<p>
The <c>video</c> statement controls framebuffer display options. It needs to be
given the framebuffer driver (<c>vesafb</c> for 2.6 kernels, or <c>vesa</c> for
2.4 kernels) followed by the control statements you wish to enable. All
variables are listed in <path>/usr/src/linux/Documentation/fb/vesafb.txt</path>,
but we'll inform you about three most-used options:
</p>
<table>
<tr>
<th>Control</th>
<th>Description</th>
</tr>
<tr>
<ti>ywrap</ti>
<ti>
Assume that the graphical card can wrap around its memory (i.e. continue at
the beginning when it has approached the end)
</ti>
</tr>
<tr>
<ti>mtrr</ti>
<ti>
Setup MTRR registers
</ti>
</tr>
<tr>
<ti><c>mode</c></ti>
<ti>
(<c>vesafb-tng</c> only)<br/>
Set up the resolution, color depth and refresh rate. For instance,
<c>1024x768-32@85</c> for a resolution of 1024x768, 32 bit color depth and a
refresh rate of 85 Hz.
</ti>
</tr>
</table>
<p>
The result of those two statements could be something like <c>vga=0x318
video=vesafb:mtrr,ywrap</c> or <c>video=vesafb:mtrr,ywrap,1024x768-32@85</c>.
Remember (or write down) this setting; you will need it shortly.
</p>
<p>
Now continue by installing <uri link="#grub">GRUB</uri> <e>or</e> <uri
link="#lilo">LILO</uri>.
</p>
</body>
</subsection>
</section>
<section id="grub">
<title>Default: Using GRUB</title>
<subsection>
<title>Understanding GRUB's terminology</title>
<body>
<p>
The most critical part of understanding GRUB is getting comfortable with
how GRUB refers to hard drives and partitions. Your Linux partition
<path>/dev/hda1</path> will most likely be called <path>(hd0,0)</path> under
GRUB. Notice the parenthesis around the <path>hd0,0</path> - they are required.
</p>
<p>
Hard drives count from zero rather than "a" and partitions start at zero
rather than one. Be aware too that with the hd devices, only hard drives are
counted, not atapi-ide devices such as cdrom players and burners. Also, the
same construct is used with SCSI drives. (Normally they get higher numbers
than IDE drives except when the BIOS is configured to boot from SCSI devices.)
When you ask the BIOS to boot from a different hard disk (for instance your
primary slave), <e>that</e> harddisk is seen as <path>hd0</path>.
</p>
<p>
Assuming you have a hard drive on <path>/dev/hda</path>, a cdrom player on
<path>/dev/hdb</path>, a burner on <path>/dev/hdc</path>, a second hard drive
on <path>/dev/hdd</path> and no SCSI hard drive, <path>/dev/hdd7</path> gets
translated to <path>(hd1,6)</path>. It might sound tricky and tricky it is
indeed, but as we will see, GRUB offers a tab completion mechanism
that comes handy for those of you having a lot of hard drives and
partitions and who are a little lost in the GRUB numbering scheme.
</p>
<p>
Having gotten the feel for that, it is time to install GRUB.
</p>
</body>
</subsection>
<subsection>
<title>Installing GRUB</title>
<body>
<p>
To install GRUB, let's first emerge it:
</p>
<pre caption="Installing GRUB">
# <i>emerge grub</i>
</pre>
<p>
Although GRUB is now installed, we still need to write up a
configuration file for it and place GRUB in our MBR so that GRUB automatically
boots your newly created kernel. Create <path>/boot/grub/grub.conf</path> with
<c>nano</c> (or, if applicable, another editor):
</p>
<pre caption="Creating /boot/grub/grub.conf">
# <i>nano -w /boot/grub/grub.conf</i>
</pre>
<p>
Now we are going to write up a <path>grub.conf</path>. Below you'll
find two possible <path>grub.conf</path> for the partitioning example we use
in this guide. We've
only extensively commented the first <path>grub.conf</path>. Make sure you use
<e>your</e> kernel image filename and, if appropriate, <e>your</e> initrd image
filename.
</p>
<ul>
<li>
The first <path>grub.conf</path> is for people who have not used
<c>genkernel</c> to build their kernel
</li>
<li>
The second <path>grub.conf</path> is for people who have used
<c>genkernel</c> to build their kernel
</li>
</ul>
<note>
If your root filesystem is JFS, you <e>must</e> add " ro" to the <c>kernel</c>
line since JFS needs to replay its log before it allows read-write mounting.
</note>
<pre caption="grub.conf for non-genkernel users">
<comment># Which listing to boot as default. 0 is the first, 1 the second etc.</comment>
default 0
<comment># How many seconds to wait before the default listing is booted.</comment>
timeout 30
<comment># Nice, fat splash-image to spice things up :)
# Comment out if you don't have a graphics card installed</comment>
splashimage=(hd0,0)/boot/grub/splash.xpm.gz
title=Gentoo Linux 2.6.12-r10
<comment># Partition where the kernel image (or operating system) is located</comment>
root (hd0,0)
kernel /boot/kernel-2.6.12-gentoo-r10 root=/dev/hda3
<comment># The next four lines are only if you dualboot with a Windows system.</comment>
<comment># In this case, Windows is hosted on /dev/hda6.</comment>
title=Windows XP
rootnoverify (hd0,5)
makeactive
chainloader +1
</pre>
<pre caption="grub.conf for genkernel users">
default 0
timeout 30
splashimage=(hd0,0)/boot/grub/splash.xpm.gz
title=Gentoo Linux 2.6.12-r10
root (hd0,0)
kernel /boot/kernel-genkernel-x86-2.6.12-gentoo-r10 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
initrd /boot/initramfs-genkernel-x86-2.6.12-gentoo-r10
<comment># Only in case you want to dual-boot</comment>
title=Windows XP
rootnoverify (hd0,5)
makeactive
chainloader +1
</pre>
<p>
If you used a different partitioning scheme and/or kernel image, adjust
accordingly. However, make sure that anything that follows a GRUB-device (such
as <path>(hd0,0)</path>) is relative to the mountpoint, not the root. In other
words, <path>(hd0,0)/grub/splash.xpm.gz</path> is in reality
<path>/boot/grub/splash.xpm.gz</path> since <path>(hd0,0)</path> is
<path>/boot</path>.
</p>
<p>
Besides, if you chose to use a different partitioning scheme and did not put
<path>/boot</path> in a separate partition, the <path>/boot</path> prefix used
in the above code samples is really <e>required</e>. If you followed our
suggested partitioning plan, the <path>/boot</path> prefix it not required, but
a <path>boot</path> symlink makes it work. In short, the above examples should
work whether you defined a separate <path>/boot</path> partition or not.
</p>
<p>
If you need to pass any additional options to the kernel, simply add
them to the end of the kernel command. We're already passing one option
(<c>root=/dev/hda3</c> or <c>real_root=/dev/hda3</c>), but you can pass others
as well, such as the <c>video</c> and/or <c>vga</c> statements for framebuffer
as we discussed previously.
</p>
<p>
If you're using a 2.6.7 or higher kernel and you jumpered your harddrive
because the BIOS can't handle large harddrives you'll need to append
<c>hdx=stroke</c>.
</p>
<p>
<c>genkernel</c> users should know that their kernels use the same boot options
as is used for the Installation CD. For instance, if you have SCSI devices, you
should add <c>doscsi</c> as kernel option.
</p>
<p>
Now save the <path>grub.conf</path> file and exit. You still need to install
GRUB in the MBR (Master Boot Record) so that GRUB is automatically executed when
you boot your system.
</p>
<p>
The GRUB developers recommend the use of <c>grub-install</c>. However, if for
some reason <c>grub-install</c> fails to work correctly you still have the
option to manually install GRUB.
</p>
<p>
Continue with <uri link="#grub-install-auto">Default: Setting up GRUB using
grub-install</uri> or <uri link="#grub-install-manual">Alternative: Setting up
GRUB using manual instructions</uri>.
</p>
</body>
</subsection>
<subsection id="grub-install-auto">
<title>Default: Setting up GRUB using grub-install</title>
<body>
<p>
To install GRUB you will need to issue the <c>grub-install</c> command.
However, <c>grub-install</c> won't work off-the-shelf since we are inside a
chrooted environment. We need to create <path>/etc/mtab</path> which lists all
mounted filesystems. Fortunately, there is an easy way to accomplish this -
just copy over <path>/proc/mounts</path> to <path>/etc/mtab</path>, excluding
the <c>rootfs</c> line if you haven't created a separate boot partition. The
following command will work in both cases:
</p>
<pre caption="Creating /etc/mtab">
# <i>grep -v rootfs /proc/mounts > /etc/mtab</i>
</pre>
<p>
Now we can install GRUB using <c>grub-install</c>:
</p>
<pre caption="Running grub-install">
# <i>grub-install /dev/hda</i>
</pre>
<p>
If you have more questions regarding GRUB, please consult the <uri
link="http://www.gnu.org/software/grub/grub-faq.html">GRUB FAQ</uri> or the <uri
link="http://www.gnu.org/software/grub/manual/">GRUB Manual</uri>.
</p>
<p>
Continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
<subsection id="grub-install-manual">
<title>Alternative: Setting up GRUB using manual instructions</title>
<body>
<p>
To start configuring GRUB, you type in <c>grub</c>. You'll be presented
with the <path>grub></path> grub command-line prompt. Now, you need to type
in the right commands to install the GRUB boot record onto your hard drive.
</p>
<pre caption =" Starting the GRUB shell">
# <i>grub</i>
</pre>
<note>
If your system does not have any floppy drives, add the <c>--no-floppy</c>
option to the above command to prevent grub from probing the (non-existing)
floppy drives.
</note>
<p>
In the example configuration we want to install GRUB so that it reads its
information from the boot-partition <path>/dev/hda1</path>, and installs the
GRUB boot record on the hard drive's MBR (master boot record) so that the first
thing we see when we turn on the computer is the GRUB prompt. Of course, if you
haven't followed the example configuration during the installation,
change the commands accordingly.
</p>
<p>
The tab completion mechanism of GRUB can be used from within GRUB.
For instance, if you type in "<c>root (</c>" followed by a TAB, you will
be presented with a list of devices (such as <path>hd0</path>). If you
type in "<c>root (hd0,</c>" followed by a TAB, you will receive a list
of available partitions to choose from (such as <path>hd0,0</path>).
</p>
<p>
By using the tab completion, setting up GRUB should be not that hard.
Now go on, configure GRUB, shall we? :-)
</p>
<pre caption =" Installing GRUB in the MBR">
grub> <i>root (hd0,0)</i> <comment>(Specify where your /boot partition resides)</comment>
grub> <i>setup (hd0)</i> <comment>(Install GRUB in the MBR)</comment>
grub> <i>quit</i> <comment>(Exit the GRUB shell)</comment>
</pre>
<note>
If you want to install GRUB in a certain partition instead of the MBR,
you have to alter the <c>setup</c> command so it points to the right
partition. For instance, if you want GRUB installed in
<path>/dev/hda3</path>, then the command becomes <c>setup (hd0,2)</c>.
Few users however want to do this.
</note>
<p>
If you have more questions regarding GRUB, please consult the <uri
link="http://www.gnu.org/software/grub/grub-faq.html">GRUB FAQ</uri> or the <uri
link="http://www.gnu.org/software/grub/manual/">GRUB Manual</uri>.
</p>
<note>
When you reinstall a kernel, you do not need to copy over the files anymore.
Just run <c>make install</c> after compiling the kernel; it will automatically
copy the necessary files and adjust the GRUB configuration.
</note>
<p>
Continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
</section>
<section id="lilo">
<title>Alternative: Using LILO</title>
<subsection>
<title>Installing LILO</title>
<body>
<p>
LILO, the LInuxLOader, is the tried and true workhorse of Linux
bootloaders. However, it lacks some features that GRUB has (which is
also the reason why GRUB is currently gaining popularity). The reason
why LILO is still used is that, on some systems, GRUB doesn't work and
LILO does. Of course, it is also used because some people know LILO and
want to stick with it. Either way, Gentoo supports both, and apparently
you have chosen to use LILO.
</p>
<p>
Installing LILO is a breeze; just use <c>emerge</c>.
</p>
<pre caption = "Installing LILO">
# <i>emerge lilo</i>
</pre>
</body>
</subsection>
<subsection>
<title>Configuring LILO</title>
<body>
<p>
To configure LILO, you must create <path>/etc/lilo.conf</path>. Fire up
your favorite editor (in this handbook we use <c>nano</c> for
consistency) and create the file.
</p>
<pre caption = "Creating /etc/lilo.conf">
# <i>nano -w /etc/lilo.conf</i>
</pre>
<p>
Some sections ago we have asked you to remember the kernel-image name
you have created. In the next example <path>lilo.conf</path> we also use the
example partitioning scheme. There are two separate parts:
</p>
<ul>
<li>
One for those who have not used <c>genkernel</c> to build their kernel
</li>
<li>
One for those who have used <c>genkernel</c> to build their kernel
</li>
</ul>
<p>
Make sure you use <e>your</e> kernel image filename and, if appropriate,
<e>your</e> initrd image filename.
</p>
<note>
If your root filesystem is JFS, you <e>must</e> add an <c>append="ro"</c> line
to each boot image since JFS needs to replay its log before it allows
read-write mounting.
</note>
<pre caption="Example /etc/lilo.conf">
boot=/dev/hda <comment># Install LILO in the MBR</comment>
prompt <comment># Give the user the chance to select another section</comment>
timeout=50 <comment># Wait 5 (five) seconds before booting the default section</comment>
default=gentoo <comment># When the timeout has passed, boot the "gentoo" section</comment>
<comment># For non-genkernel users</comment>
image=/boot/kernel-2.6.12-gentoo-r10
label=gentoo <comment># Name we give to this section</comment>
read-only <comment># Start with a read-only root. Do not alter!</comment>
root=/dev/hda3 <comment># Location of the root filesystem</comment>
<comment># For genkernel users</comment>
image=/boot/kernel-genkernel-x86-2.6.12-gentoo-r10
label=gentoo
read-only
root=/dev/ram0
append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev"
initrd=/boot/initramfs-genkernel-x86-2.6.12-gentoo-r10
<comment># The next two lines are only if you dualboot with a Windows system.</comment>
<comment># In this case, Windows is hosted on /dev/hda6.</comment>
other=/dev/hda6
label=windows
</pre>
<note>
If you use a different partitioning scheme and/or kernel image, adjust
accordingly.
</note>
<p>
If you need to pass any additional options to the kernel, add an
<c>append</c> statement to the section. As an example, we add the
<c>video</c> statement to enable framebuffer:
</p>
<pre caption="Using append to add kernel options">
image=/boot/kernel-2.6.12-gentoo-r10
label=gentoo
read-only
root=/dev/hda3
<i>append="video=vesafb:mtrr,ywrap,1024x768-32@85"</i>
</pre>
<p>
If you're using a 2.6.7 or higher kernel and you jumpered your harddrive
because the BIOS can't handle large harddrives you'll need to append
<c>hdx=stroke</c>.
</p>
<p>
<c>genkernel</c> users should know that their kernels use the same boot options
as is used for the Installation CD. For instance, if you have SCSI devices, you
should add <c>doscsi</c> as kernel option.
</p>
<p>
Now save the file and exit. To finish up, you have to run <c>/sbin/lilo</c> so
LILO can apply the <path>/etc/lilo.conf</path> to your system (i.e. install
itself on the disk). Keep in mind that you'll also have to rerun
<c>/sbin/lilo</c> every time you install a new kernel or make any changes to
the menu.
</p>
<pre caption = "Finishing the LILO installation">
# <i>/sbin/lilo</i>
</pre>
<note>
When you reinstall a kernel, you do not need to copy over the files anymore.
Just run <c>make install</c> after compiling the kernel; it will automatically
copy the necessary files and adjust the LILO configuration.
</note>
<p>
You can now continue with <uri link="#reboot">Rebooting the System</uri>.
</p>
</body>
</subsection>
</section>
<section id="reboot">
<title>Rebooting the System</title>
<subsection>
<body>
<p>
Exit the chrooted environment and unmount all mounted partitions. Then type in
that one magical command you have been waiting for: <c>reboot</c>.
</p>
<pre caption="Unmounting all partitions and rebooting">
# <i>exit</i>
cdimage ~# <i>cd</i>
cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo</i>
cdimage ~# <i>reboot</i>
</pre>
<p>
Of course, don't forget to remove the bootable CD, otherwise the CD will be
booted again instead of your new Gentoo system.
</p>
<p>
Once rebooted in your Gentoo installation, finish up with <uri
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-disk.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-disk.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-disk.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-disk.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-x86-disk.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.2</version>
<date>2006-01-01</date>
<section>
<title>Introduction to Block Devices</title>
<subsection>
<title>Block Devices</title>
<body>
<p>
We'll take a good look at disk-oriented aspects of Gentoo Linux
and Linux in general, including Linux filesystems, partitions and block devices.
Then, once you're familiar with the ins and outs of disks and filesystems,
you'll be guided through the process of setting up partitions and filesystems
for your Gentoo Linux installation.
</p>
<p>
To begin, we'll introduce <e>block devices</e>. The most famous block device is
probably the one that represents the first IDE drive in a Linux system, namely
<path>/dev/hda</path>. If your system uses SCSI or SATA drives, then your
first hard drive would be <path>/dev/sda</path>.
</p>
<p>
The block devices above represent an abstract interface to the disk. User
programs can use these block devices to interact with your disk without worrying
about whether your drives are IDE, SCSI or something else. The program can
simply address the storage on the disk as a bunch of contiguous,
randomly-accessible 512-byte blocks.
</p>
</body>
</subsection>
<subsection>
<title>Partitions</title>
<body>
<p>
Although it is theoretically possible to use a full disk to house your Linux
system, this is almost never done in practice. Instead, full disk block devices
are split up in smaller, more manageable block devices. On x86 systems,
these are called <e>partitions</e>.
</p>
<p>
Partitions are divided in three types:
<e>primary</e>, <e>extended</e> and <e>logical</e>.
</p>
<p>
A <e>primary</e> partition is a partition which has its information stored in
the MBR (master boot record). As an MBR is very small (512 bytes) only four
primary partitions can be defined (for instance, <path>/dev/hda1</path> to
<path>/dev/hda4</path>).
</p>
<p>
An <e>extended</e> partition is a special primary partition (meaning the
extended partition must be one of the four possible primary partitions) which
contains more partitions. Such a partition didn't exist originally, but as
four partitions were too few, it was brought to life to extend the formatting
scheme without losing backward compatibility.
</p>
<p>
A <e>logical</e> partition is a partition inside the extended partition. Their
definitions aren't placed inside the MBR, but are declared inside the extended
partition.
</p>
</body>
</subsection>
<subsection>
<title>Advanced Storage</title>
<body>
<p>
The x86 Installation CDs provide support for EVMS and LVM2. EVMS and LVM2
increase the flexibility offered by your partitioning setup. During the
installation instructions, we will focus on "regular" partitions, but it is
still good to know EVMS and LVM2 are supported as well.
</p>
</body>
</subsection>
</section>
<section>
<title>Designing a Partitioning Scheme</title>
<subsection>
<title>Default Partitioning Scheme</title>
<body>
<p>
If you are not interested in drawing up a partitioning scheme for your system,
you can use the partitioning scheme we use throughout this book:
</p>
<table>
<tr>
<th>Partition</th>
<th>Filesystem</th>
<th>Size</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>ext2</ti>
<ti>32M</ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>(swap)</ti>
<ti>512M</ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>ext3</ti>
<ti>Rest of the disk</ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
If you are interested in knowing how big a partition should be, or even how
many partitions you need, read on. Otherwise continue now with partitioning
your disk by reading <uri link="#fdisk">Using fdisk to Partition your
Disk</uri>.
</p>
</body>
</subsection>
<subsection>
<title>How Many and How Big?</title>
<body>
<p>
The number of partitions is highly dependent on your environment. For instance,
if you have lots of users, you will most likely want to have your
<path>/home</path> separate as it increases security and makes backups easier.
If you are installing Gentoo to perform as a mailserver, your
<path>/var</path> should be separate as all mails are stored inside
<path>/var</path>. A good choice of filesystem will then maximise your
performance. Gameservers will have a separate <path>/opt</path> as most gaming
servers are installed there. The reason is similar for <path>/home</path>:
security and backups. You will definitely want to keep <path>/usr</path> big:
not only will it contain the majority of applications, the Portage tree alone
takes around 500 Mbyte excluding the various sources that are stored in it.
</p>
<p>
As you can see, it very much depends on what you want to achieve. Separate
partitions or volumes have the following advantages:
</p>
<ul>
<li>
You can choose the best performing filesystem for each partition or volume
</li>
<li>
Your entire system cannot run out of free space if one defunct tool is
continuously writing files to a partition or volume
</li>
<li>
If necessary, file system checks are reduced in time, as multiple checks can
be done in parallel (although this advantage is more with multiple disks than
it is with multiple partitions)
</li>
<li>
Security can be enhanced by mounting some partitions or volumes read-only,
nosuid (setuid bits are ignored), noexec (executable bits are ignored) etc.
</li>
</ul>
<p>
However, multiple partitions have one big disadvantage: if not configured
properly, you might result in having a system with lots
of free space on one partition and none on another. There is also a 15-partition
limit for SCSI and SATA.
</p>
<p>
As an example partitioning, we show you one for a 20GB disk, used as a
demonstration laptop (containing webserver, mailserver, gnome, ...):
</p>
<pre caption="Filesystem usage example">
Filesystem Type Size Used Avail Use% Mounted on
/dev/hda5 ext3 509M 132M 351M 28% /
/dev/hda2 ext3 5.0G 3.0G 1.8G 63% /home
/dev/hda7 ext3 7.9G 6.2G 1.3G 83% /usr
/dev/hda8 ext3 1011M 483M 477M 51% /opt
/dev/hda9 ext3 2.0G 607M 1.3G 32% /var
/dev/hda1 ext2 51M 17M 31M 36% /boot
/dev/hda6 swap 516M 12M 504M 2% <not mounted>
<comment>(Unpartitioned space for future usage: 2 GB)</comment>
</pre>
<p>
<path>/usr</path> is rather full (83% used) here, but once
all software is installed, <path>/usr</path> doesn't tend to grow that much.
Although allocating a few gigabytes of disk space for <path>/var</path> may
seem excessive, remember that Portage uses this partition by default for
compiling packages. If you want to keep <path>/var</path> at a more reasonable
size, such as 1GB, you will need to alter your <c>PORTAGE_TMPDIR</c> variable
in <path>/etc/make.conf</path> to point to the partition with enough free space
for compiling extremely large packages such as OpenOffice.
</p>
</body>
</subsection>
</section>
<section id="fdisk">
<title>Using fdisk to Partition your Disk</title>
<subsection>
<body>
<p>
The following parts explain how to create the example partition layout
described previously, namely:
</p>
<table>
<tr>
<th>Partition</th>
<th>Description</th>
</tr>
<tr>
<ti><path>/dev/hda1</path></ti>
<ti>Boot partition</ti>
</tr>
<tr>
<ti><path>/dev/hda2</path></ti>
<ti>Swap partition</ti>
</tr>
<tr>
<ti><path>/dev/hda3</path></ti>
<ti>Root partition</ti>
</tr>
</table>
<p>
Change your partition layout according to your own preference.
</p>
</body>
</subsection>
<subsection>
<title>Viewing the Current Partition Layout</title>
<body>
<p>
<c>fdisk</c> is a popular and powerful tool to split your disk into partitions.
Fire up <c>fdisk</c> on your disk (in our example, we use
<path>/dev/hda</path>):
</p>
<pre caption="Starting fdisk">
# <i>fdisk /dev/hda</i>
</pre>
<p>
Once in <c>fdisk</c>, you'll be greeted with a prompt that looks like this:
</p>
<pre caption="fdisk prompt">
Command (m for help):
</pre>
<p>
Type <c>p</c> to display your disk's current partition configuration:
</p>
<pre caption="An example partition configuration">
Command (m for help): <i>p</i>
Disk /dev/hda: 240 heads, 63 sectors, 2184 cylinders
Units = cylinders of 15120 * 512 bytes
Device Boot Start End Blocks Id System
/dev/hda1 1 14 105808+ 83 Linux
/dev/hda2 15 49 264600 82 Linux swap
/dev/hda3 50 70 158760 83 Linux
/dev/hda4 71 2184 15981840 5 Extended
/dev/hda5 71 209 1050808+ 83 Linux
/dev/hda6 210 348 1050808+ 83 Linux
/dev/hda7 349 626 2101648+ 83 Linux
/dev/hda8 627 904 2101648+ 83 Linux
/dev/hda9 905 2184 9676768+ 83 Linux
Command (m for help):
</pre>
<p>
This particular disk is configured to house seven Linux filesystems (each with a
corresponding partition listed as "Linux") as well as a swap partition (listed
as "Linux swap").
</p>
</body>
</subsection>
<subsection>
<title>Removing all Partitions</title>
<body>
<p>
We will first remove all existing partitions from the disk. Type <c>d</c> to
delete a partition. For instance, to delete an existing <path>/dev/hda1</path>:
</p>
<pre caption="Deleting a partition">
Command (m for help): <i>d</i>
Partition number (1-4): <i>1</i>
</pre>
<p>
The partition has been scheduled for deletion. It will no longer show up if you
type <c>p</c>, but it will not be erased until your changes have been saved. If
you made a mistake and want to abort without saving your changes, type <c>q</c>
immediately and hit enter and your partition will not be deleted.
</p>
<p>
Now, assuming that you do indeed want to wipe out all the partitions on your
system, repeatedly type <c>p</c> to print out a partition listing and then type
<c>d</c> and the number of the partition to delete it. Eventually, you'll end
up with a partition table with nothing in it:
</p>
<pre caption="An empty partition table">
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
Command (m for help):
</pre>
<p>
Now that the in-memory partition table is empty, we're ready to create the
partitions. We will use a default partitioning scheme as discussed previously.
Of course, don't follow these instructions to the letter if you don't want the
same partitioning scheme!
</p>
</body>
</subsection>
<subsection>
<title>Creating the Boot Partition</title>
<body>
<p>
We first create a small boot partition. Type <c>n</c> to create a new partition,
then <c>p</c> to select a primary partition, followed by <c>1</c> to select the
first primary partition. When prompted for the first cylinder, hit enter. When
prompted for the last cylinder, type <c>+32M</c> to create a partition 32 Mbyte
in size:
</p>
<pre caption="Creating the boot partition">
Command (m for help): <i>n</i>
Command action
e extended
p primary partition (1-4)
<i>p</i>
Partition number (1-4): <i>1</i>
First cylinder (1-3876, default 1): <comment>(Hit Enter)</comment>
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-3876, default 3876): <i>+32M</i>
</pre>
<p>
Now, when you type <c>p</c>, you should see the following partition printout:
</p>
<pre caption="Created boot partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 1 14 105808+ 83 Linux
</pre>
<p>
We need to make this partition bootable. Type <c>a</c> to toggle the bootable
flag on a partition and select <c>1</c>. If you press <c>p</c> again, you will
notice that an <path>*</path> is placed in the "Boot" column.
</p>
</body>
</subsection>
<subsection>
<title>Creating the Swap Partition</title>
<body>
<p>
Let's now create the swap partition. To do this, type <c>n</c> to create a new
partition, then <c>p</c> to tell fdisk that you want a primary partition. Then
type <c>2</c> to create the second primary partition, <path>/dev/hda2</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
you've done this, type <c>t</c> to set the partition type, <c>2</c> to select
the partition you just created 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 this:
</p>
<pre caption="Partition listing after creating a swap partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 * 1 14 105808+ 83 Linux
/dev/hda2 15 81 506520 82 Linux swap
</pre>
</body>
</subsection>
<subsection>
<title>Creating the Root Partition</title>
<body>
<p>
Finally, let's create the root partition. To do this, type <c>n</c> to create a
new partition, then <c>p</c> to tell fdisk that you want a primary partition.
Then type <c>3</c> to create the third primary partition, <path>/dev/hda3</path>
in our case. When prompted for the first cylinder, hit enter. When prompted for
the last cylinder, hit enter to create a partition that takes up the rest of the
remaining space on your disk. After completing these steps, typing <c>p</c>
should display a partition table that looks similar to this:
</p>
<pre caption="Partition listing after creating the root partition">
Command (m for help): <i>p</i>
Disk /dev/hda: 30.0 GB, 30005821440 bytes
240 heads, 63 sectors/track, 3876 cylinders
Units = cylinders of 15120 * 512 = 7741440 bytes
Device Boot Start End Blocks Id System
/dev/hda1 * 1 14 105808+ 83 Linux
/dev/hda2 15 81 506520 82 Linux swap
/dev/hda3 82 3876 28690200 83 Linux
</pre>
</body>
</subsection>
<subsection>
<title>Saving the Partition Layout</title>
<body>
<p>
To save the partition layout and exit <c>fdisk</c>, type <c>w</c>.
</p>
<pre caption="Save and exit fdisk">
Command (m for help): <i>w</i>
</pre>
<p>
Now that your partitions are created, you can now continue with <uri
link="#filesystems">Creating Filesystems</uri>.
</p>
</body>
</subsection>
</section>
<section id="filesystems">
<title>Creating Filesystems</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Now that your partitions are created, it is time to place a filesystem on them.
If you don't care about what filesystem to choose and are happy with what we use
as default in this handbook, continue with <uri
link="#filesystems-apply">Applying a Filesystem to a Partition</uri>.
Otherwise read on to learn about the available filesystems...
</p>
</body>
</subsection>
<subsection>
<title>Filesystems?</title>
<body>
<p>
The Linux kernel supports various filesystems. We'll explain ext2, ext3,
ReiserFS, XFS and JFS as these are the most commonly used filesystems on Linux
systems.
</p>
<p>
<b>ext2</b> is the tried and true Linux filesystem but doesn't have metadata
journaling, which means that routine ext2 filesystem checks at startup time can
be quite time-consuming. There is now quite a selection of newer-generation
journaled filesystems that can be checked for consistency very quickly and are
thus generally preferred over their non-journaled counterparts. Journaled
filesystems prevent long delays when you boot your system and your filesystem
happens to be in an inconsistent state.
</p>
<p>
<b>ext3</b> is the journaled version of the ext2 filesystem, providing metadata
journaling for fast recovery in addition to other enhanced journaling modes like
full data and ordered data journaling. ext3 is a very good and reliable
filesystem. It has an additional hashed b-tree indexing option that enables
high performance in almost all situations. You can enable this indexing by
adding <c>-O dir_index</c> to the <c>mke2fs</c> command. In short, ext3 is an
excellent filesystem.
</p>
<p>
<b>ReiserFS</b> is a B*-tree based filesystem that has very good overall
performance and greatly outperforms both ext2 and ext3 when dealing with small
files (files less than 4k), often by a factor of 10x-15x. ReiserFS also scales
extremely well and has metadata journaling. As of kernel 2.4.18+, ReiserFS is
solid and usable as both general-purpose filesystem and for extreme cases such
as the creation of large filesystems, the use of many small files, very large
files and directories containing tens of thousands of files.
</p>
<p>
<b>XFS</b> is a filesystem with metadata journaling which comes with a robust
feature-set and is optimized for scalability. We only recommend using this
filesystem on Linux systems with high-end SCSI and/or fibre channel storage and
an uninterruptible power supply. Because XFS aggressively caches in-transit data
in RAM, improperly designed programs (those that don't take proper precautions
when writing files to disk and there are quite a few of them) can lose a good
deal of data if the system goes down unexpectedly.
</p>
<p>
<b>JFS</b> is IBM's high-performance journaling filesystem. It has recently
become production-ready and there hasn't been a sufficient track record to
comment positively nor negatively on its general stability at this point.
</p>
</body>
</subsection>
<subsection id="filesystems-apply">
<title>Applying a Filesystem to a Partition</title>
<body>
<p>
To create a filesystem on a partition or volume, there are tools available for
each possible filesystem:
</p>
<table>
<tr>
<th>Filesystem</th>
<th>Creation Command</th>
</tr>
<tr>
<ti>ext2</ti>
<ti><c>mke2fs</c></ti>
</tr>
<tr>
<ti>ext3</ti>
<ti><c>mke2fs -j</c></ti>
</tr>
<tr>
<ti>reiserfs</ti>
<ti><c>mkreiserfs</c></ti>
</tr>
<tr>
<ti>xfs</ti>
<ti><c>mkfs.xfs</c></ti>
</tr>
<tr>
<ti>jfs</ti>
<ti><c>mkfs.jfs</c></ti>
</tr>
</table>
<p>
For instance, to have the boot partition (<path>/dev/hda1</path> in our
example) in ext2 and the root partition (<path>/dev/hda3</path> in our example)
in ext3 (as in our example), you would use:
</p>
<pre caption="Applying a filesystem on a partition">
# <i>mke2fs /dev/hda1</i>
# <i>mke2fs -j /dev/hda3</i>
</pre>
<p>
Now create the filesystems on your newly created partitions (or logical
volumes).
</p>
</body>
</subsection>
<subsection>
<title>Activating the Swap Partition</title>
<body>
<p>
<c>mkswap</c> is the command that is used to initialize swap partitions:
</p>
<pre caption="Creating a Swap signature">
# <i>mkswap /dev/hda2</i>
</pre>
<p>
To activate the swap partition, use <c>swapon</c>:
</p>
<pre caption="Activating the swap partition">
# <i>swapon /dev/hda2</i>
</pre>
<p>
Create and activate the swap now.
</p>
</body>
</subsection>
</section>
<section>
<title>Mounting</title>
<body>
<p>
Now that your partitions are initialized and are housing a filesystem, it is
time to mount those partitions. Use the <c>mount</c> command. Don't forget to
create the necessary mount directories for every partition you created. As an
example we mount the root and boot partition:
</p>
<pre caption="Mounting partitions">
# <i>mount /dev/hda3 /mnt/gentoo</i>
# <i>mkdir /mnt/gentoo/boot</i>
# <i>mount /dev/hda1 /mnt/gentoo/boot</i>
</pre>
<note>
If you want your <path>/tmp</path> to reside on a separate partition, be sure to
change its permissions after mounting: <c>chmod 1777 /mnt/gentoo/tmp</c>. This
also holds for <path>/var/tmp</path>.
</note>
<p>
We will also have to mount the proc filesystem (a virtual interface with the
kernel) on <path>/proc</path>. But first we will need to place our files on the partitions.
</p>
<p>
Continue with <uri link="?part=1&chap=5">Installing the Gentoo
Installation Files</uri>.
</p>
</body>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-kernel.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-kernel.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-kernel.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-kernel.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-x86-kernel.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2006-01-06</date>
<section>
<title>Timezone</title>
<body>
<p>
You first need to select your timezone so that your system knows where it is
located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
it to <path>/etc/localtime</path>. Please avoid the
<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
</p>
<pre caption="Setting the timezone information">
# <i>ls /usr/share/zoneinfo</i>
<comment>(Suppose you want to use GMT)</comment>
# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
</pre>
</body>
</section>
<section>
<title>Installing the Sources</title>
<subsection>
<title>Choosing a Kernel</title>
<body>
<p>
The core around which all distributions are built is the Linux kernel. It is the
layer between the user programs and your system hardware. Gentoo provides its
users several possible kernel sources. A full listing with description is
available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
Guide</uri>.
</p>
<p>
For x86-based systems, our main supported kernel is named
<c>gentoo-sources</c>. This kernel is based on the official Linux sources, but
has security, stability, compatibility and bug fixes applied on top.
Alternatively, the plain and unpatched Linux sources are supplied through the
<c>vanilla-sources</c> package.
</p>
<p>
Both kernel sources are based on the official 2.6 kernel sources. If you
want to install a 2.4-based kernel, you will need to install Gentoo with a
working Internet connection as we do not supply these sources on our
Installation CD.
</p>
<p>
Choose your kernel source and install it using <c>emerge</c>. The
<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
install, but ensures proper creation of the <path>/usr/src/linux</path>
symlink.
</p>
<pre caption="Installing a kernel source">
# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
<path>linux</path> pointing to your kernel source. In this case, the installed
kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
# <i>ls -l /usr/src/linux</i>
lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.12-gentoo-r10
</pre>
<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is the best way to optimize your environment.
</p>
<p>
If you want to manually configure your kernel, continue now with <uri
link="#manual">Default: Manual Configuration</uri>. If you want to use
<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
genkernel</uri> instead.
</p>
</body>
</subsection>
</section>
<section id="manual">
<title>Default: Manual Configuration</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Manually configuring a kernel is often seen as the most difficult procedure a
Linux user ever has to perform. Nothing is less true -- after configuring a
couple of kernels you don't even remember that it was difficult ;)
</p>
<p>
However, one thing <e>is</e> true: you must know your system when you start
configuring a kernel manually. Most information can be gathered by emerging
pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
be able to use <c>lspci</c> within the chrooted environment. You may safely
ignore any <e>pcilib</e> warnings (like pcilib: cannot open
/sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
<c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
You can also run <c>lsmod</c> to see what kernel modules the Installation CD
uses (it might provide you with a nice hint on what to enable).
</p>
<p>
Now go to your kernel source directory and execute <c>make menuconfig</c>. This
will fire up an ncurses-based configuration menu.
</p>
<pre caption="Invoking menuconfig">
# <i>cd /usr/src/linux</i>
# <i>make menuconfig</i>
</pre>
<p>
You will be greeted with several configuration sections. We'll first list some
options you must activate (otherwise Gentoo will not function, or not function
properly without additional tweaks).
</p>
</body>
</subsection>
<subsection>
<title>Activating Required Options</title>
<body>
<p>
Make sure that every driver that is vital to the booting of your system (such as
SCSI controller, ...) is compiled <e>in</e> the kernel and not as a module,
otherwise your system will not be able to boot completely.
</p>
<p>
Now select the correct processor family:
</p>
<pre caption="General Support and processor family">
General setup --->
[*] Support for hot-pluggable devices
Processor type and features --->
Subarchitecture Type (PC-compatible) --->
<comment>(Change according to your system)</comment>
(<i>Athlon/Duron/K7</i>) Processor family
</pre>
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>/proc file system</c> and
<c>Virtual memory</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
<*> /proc file system support
<*> Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your system)</comment>
<*> Reiserfs support
<*> Ext3 journalling file system support
<*> JFS filesystem support
<*> Second extended fs support
<*> XFS filesystem support
</pre>
<p>
Do not forget to enable DMA for your drives:
</p>
<pre caption="Activating DMA">
Device Drivers --->
ATA/ATAPI/MFM/RLL support --->
[*] Generic PCI bus-master DMA support
[*] Use PCI DMA by default when available
</pre>
<p>
If you are using PPPoE to connect to the Internet or you are using a dial-up
modem, you will need the following options in the kernel:
</p>
<pre caption="Selecting PPPoE necessary drivers">
Device Drivers --->
Networking support --->
<*> PPP (point-to-point protocol) support
<*> PPP support for async serial ports
<*> PPP support for sync tty ports
</pre>
<p>
The two compression options won't harm but are not definitely needed, neither
does the <c>PPP over Ethernet</c> option, that might only be used by
<c>rp-pppoe</c> when configured to do kernel mode PPPoE.
</p>
<p>
If you require it, don't forget to include support in the kernel for your
ethernet card.
</p>
<p>
If you have an Intel CPU that supports HyperThreading (tm), or you have a
multi-CPU system, you should activate "Symmetric multi-processing support":
</p>
<pre caption="Activating SMP support">
Processor type and features --->
<*> Symmetric multi-processing support
</pre>
<p>
If you use USB Input Devices (like Keyboard or Mouse) don't forget to enable
those as well:
</p>
<pre caption="Activating USB Support for Input Devices">
Device Drivers --->
USB Support --->
<*> USB Human Interface Device (full HID) support
[*] HID input layer support
</pre>
<p>
If you are a laptop user and require PCMCIA support, remember to compile it
into the kernel. As well as the option below, be sure to enable support for
the PCMCIA card bridge present in your system (found in the same menu of the
configuration).
</p>
<pre caption="Activating PCMCIA support">
Bus options (PCI, PCMCIA, EISA, MCA, ISA) --->
PCCARD (PCMCIA/CardBus) support --->
<*> PCCard (PCMCIA/CardBus) support
<comment>(select 16 bit if you need support for older PCMCIA cards. Most people want this.)</comment>
<*> 16-bit PCMCIA support
[*] 32-bit CardBus support
<comment>(select the relevant bridges below)</comment>
--- PC-card bridges
<*> CardBus yenta-compatible bridge support (NEW)
<*> Cirrus PD6729 compatible bridge support (NEW)
<*> i82092 compatible bridge support (NEW)
<*> i82365 compatible bridge support (NEW)
<*> Databook TCIC host bridge support (NEW)
</pre>
</body>
</subsection>
<subsection id="compiling">
<title>Compiling and Installing</title>
<body>
<p>
Now that your kernel is configured, it is time to compile and install it. Exit
the configuration and start the compilation process:
</p>
<pre caption="Compiling the kernel">
# <i>make && make modules_install</i>
</pre>
<p>
When the kernel has finished compiling, copy the kernel image to
<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
choice and remember it as you will need it later on when you configure your
bootloader. Remember to replace <path><kernel-version></path> with the
name and version of your kernel.
</p>
<pre caption="Installing the kernel">
# <i>cp arch/i386/boot/bzImage /boot/<kernel-version></i>
</pre>
<p>
Now continue with <uri link="#kernel_modules">Configuring Kernel
Modules</uri>.
</p>
</body>
</subsection>
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
<body>
<p>
If you are reading this section, you have chosen to use our <c>genkernel</c>
script to configure your kernel for you.
</p>
<p>
Now that your kernel source tree is installed, it's now time to compile your
kernel by using our <c>genkernel</c> script to automatically build a kernel for
you. <c>genkernel</c> works by configuring a kernel nearly identically to the
way our Installation CD kernel is configured. This means that when you use
<c>genkernel</c> to build your kernel, your system will generally detect all
your hardware at boot-time, just like our Installation CD does. Because genkernel
doesn't require any manual kernel configuration, it is an ideal solution for
those users who may not be comfortable compiling their own kernels.
</p>
<p>
Now, let's see how to use genkernel. First, emerge the genkernel ebuild:
</p>
<pre caption="Emerging genkernel">
# <i>emerge genkernel</i>
</pre>
<p>
Now, compile your kernel sources by running <c>genkernel all</c>.
Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware, this compilation will take quite a while to finish!
</p>
<p>
Note that, if your boot partition doesn't use ext2 or ext3 as filesystem you
might need to manually configure your kernel using <c>genkernel --menuconfig
all</c> and add support for your filesystem <e>in</e> the kernel (i.e.
<e>not</e> as a module). Users of EVMS2 or LVM2 will probably want to add
<c>--evms2</c> or <c>--lvm2</c> as argument as well.
</p>
<pre caption="Running genkernel">
# <i>genkernel all</i>
</pre>
<p>
Once <c>genkernel</c> completes, a kernel, full set of modules and
<e>initial root disk</e> (initrd) will be created. We will use the kernel
and initrd when configuring a boot loader later in this document. Write
down the names of the kernel and initrd as you will need it when writing
the bootloader configuration file. The initrd will be started immediately after
booting to perform hardware autodetection (just like on the Installation CD)
before your "real" system starts up.
</p>
<pre caption="Checking the created kernel image name and initrd">
# <i>ls /boot/kernel* /boot/initramfs*</i>
</pre>
<p>
If you want your system to be more like the Installation CD you should
emerge <c>coldplug</c>. While the initrd autodetects hardware that is
needed to boot your system, <c>coldplug</c> autodetects everything
else.
</p>
<pre caption="Emerging and enabling coldplug">
# <i>emerge coldplug</i>
# <i>rc-update add coldplug boot</i>
</pre>
</body>
</section>
<section id="kernel_modules">
<title>Configuring Kernel Modules</title>
<subsection>
<title>Configuring the Modules</title>
<body>
<p>
You should list the modules you want automatically loaded in
<path>/etc/modules.autoload.d/kernel-2.6</path> (or <path>kernel-2.4</path>).
You can add extra options to the modules too if you want.
</p>
<p>
To view all available modules, run the following <c>find</c> command. Don't
forget to substitute "<kernel version>" with the version of the kernel you
just compiled:
</p>
<pre caption="Viewing all available modules">
# <i>find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko'</i>
</pre>
<p>
For instance, to automatically load the <c>3c59x.o</c> module, edit the
<path>kernel-2.6</path> (or <path>kernel-2.4</path>) file and enter the module
name in it.
</p>
<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
<comment>(Example for 2.6 kernels)</comment>
# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
</pre>
<pre caption="/etc/modules.autoload.d/kernel-2.6">
3c59x
</pre>
<p>
Now continue with <uri link="?part=1&chap=8">Configuring your System</uri>.
</p>
</body>
</subsection>
</section>
</sections>
1.1 xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-medium.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-medium.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/hb-install-x86-medium.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: hb-install-x86-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- 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/2006.0/hb-install-x86-medium.xml,v 1.1 2006/02/27 00:11:36 fox2mike Exp $ -->
<sections>
<version>5.5</version>
<date>2005-11-29</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr>
<th>CPU</th>
<ti>i486 or later</ti>
</tr>
<tr>
<th>Memory</th>
<ti>64 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- General description, propagated to other architectures as well -->
<!-- START -->
<section>
<title>The Gentoo Universal Installation CD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can successfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Universal Installation CD</title>
<body>
<p>
An Installation CD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Universal Installation CD contains everything you need to install
Gentoo. It provides stage3 files for common architectures, source code
for the extra applications you need to choose from and, of course, the
installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>
<p>
The use of the Package CD is covered later in this document.
</p>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CD</title>
<body>
<p>
You can download the Universal Installation CDs (and, if you want to, the
Packages CD as well) from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
the <path>releases/x86/2005.1-r1/installcd</path> directory;
the Package CDs are located in the <path>releases/x86/2005.1/packagecd</path>
directory.
</p>
<p>
i686, athlon-xp, pentium3 and pentium4 Package CDs are available via
<uri link="http://tracker.netdomination.org">BitTorrent</uri>.
</p>
<p>
Inside those directories you'll find ISO-files. Those are full CD images which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Universal Installation CD</title>
<body>
<impo>
Read this whole subsection before continuing, as you will probably not have the
opportunity to read it before doing things later.
</impo>
<p>
Once you have burned your installation CD, it is time to boot it.
Remove all CDs from your CD drives, reboot your system and enter the BIOS.
This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside
the BIOS, change the boot order so that the CD-ROM is tried before the hard
disk. This is often found under "CMOS Setup". If you don't do this, your system
will just reboot from the hard disk, ignoring the CD-ROM.
</p>
<p>
Now place the installation CD in the CD-ROM drive and reboot. You
should see a boot prompt. At this screen, you can hit Enter to begin the
boot process with the default boot options, or boot the Installation CD with
custom boot options by specifying a kernel followed by boot options and then
hitting Enter.
</p>
<p>
Specifying a kernel? Yes, we provide several kernels on our Installation CDs.
The default one is <c>gentoo</c>. Other kernels are for specific hardware needs
and the <c>-nofb</c> variants which disable framebuffer.
</p>
<p>
Below you'll find a short overview on the available kernels:
</p>
<table>
<tr>
<th>Kernel</th>
<th>Description</th>
</tr>
<tr>
<ti>gentoo</ti>
<ti>Default 2.6 kernel with support for multiple CPUs</ti>
</tr>
<tr>
<ti>gentoo-nofb</ti>
<ti>Same as <c>gentoo</c> but without framebuffer support</ti>
</tr>
<tr>
<ti>memtest86</ti>
<ti>Test your local RAM for errors</ti>
</tr>
</table>
<p>
You can also provide kernel options. They represent optional settings you can
(de)activate at will. The following list is the same as the one you receive
when you press F2 at the bootscreen.
</p>
<pre caption="Options available to pass to your kernel of choice">
- agpgart loads agpgart (use if you have graphic problems,lockups)
- acpi=on loads support for ACPI firmware
- ide=nodma force disabling of DMA for malfunctioning IDE devices
- doscsi scan for scsi devices (breaks some ethernet cards)
- dopcmcia starts pcmcia service for PCMCIA cdroms
- nofirewire disables firewire modules in initrd (for firewire cdroms,etc)
- nokeymap disables keymap selection for non-us keyboard layouts
- docache cache the entire runtime portion of cd in RAM, allows you
to umount /mnt/cdrom to mount another cdrom.
- nodetect causes hwsetup/kudzu and hotplug not to run
- nousb disables usb module load from initrd, disables hotplug
- nodhcp dhcp does not automatically start if nic detected
- nohotplug disables loading hotplug service
- noapic disable apic (try if having hardware problems nics,scsi,etc)
- noevms2 disable loading of EVMS2 modules
- nolvm2 disable loading of LVM2 modules
- hdx=stroke allows you to partition the whole harddrive even when your BIOS
can't handle large harddrives
- noload=module1[,module2[,...]]
disable loading of specific kernel modules
</pre>
<p>
Now boot your CD, select a kernel (if you are not happy with the default
<c>gentoo</c> kernel) and boot options. As an example, we show you how
to boot the <c>gentoo</c> kernel, with <c>dopcmcia</c> as kernel
parameters:
</p>
<pre caption="Booting an Installation CD">
boot: <i>gentoo dopcmcia</i>
</pre>
<p>
You will then be greeted with a boot screen and progress bar. If you are
installing Gentoo on a system with a non-US keyboard, make sure you
immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
selection is made in 10 seconds the default (US keyboard) will be accepted and
the boot process will continue. Once the boot process completes, you will be
automatically logged in to the "Live" Gentoo Linux as
"root", the super user. You should have a root ("#") prompt
on the current console and can also switch to other consoles by pressing Alt-F2,
Alt-F3 and Alt-F4. Get back to the one you started on by pressing Alt-F1.
</p>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases, it
may not auto-load the kernel modules you need. If the PCI auto-detection
missed some of your system's hardware, you will have to load the appropriate
kernel modules manually.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
<p>
If you need PCMCIA support, you should start the <c>pcmcia</c> init script:
</p>
<pre caption="Starting the PCMCIA init script">
# <i>/etc/init.d/pcmcia start</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate Safe Performance Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change
the root password.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
go to a new terminal and log in.
</p>
<p>
If you want to view the documentation on the CD you can immediately run
<c>links2</c> to read it:
</p>
<pre caption="Viewing the on-CD documentation">
# <i>links2 /mnt/cdrom/docs/html/index.html</i>
</pre>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using <c>links2</c>
as well, but only after having completed the <e>Configuring your Network</e>
chapter (otherwise you won't be able to go on the Internet to view the
document):
</p>
<pre caption="Viewing the Online Documentation">
# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-x86.xml</i>
</pre>
<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>
</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>
<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>
<p>
To fire up the SSH daemon, execute the following command:
</p>
<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>
<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
</p>
</body>
</subsection>
</section>
</sections>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2006-02-27 1:04 Shyam Mani
0 siblings, 0 replies; 25+ messages in thread
From: Shyam Mani @ 2006-02-27 1:04 UTC (permalink / raw
To: gentoo-doc-cvs
fox2mike 06/02/27 01:04:42
Modified: xml/htdocs/doc/en/handbook/2006.0 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-ppc64.xml
handbook-sparc.xml handbook-x86.xml
Log:
Fix links
Revision Changes Path
1.3 +18 -18 xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-alpha.xml 27 Feb 2006 00:37:17 -0000 1.2
+++ handbook-alpha.xml 27 Feb 2006 01:04:42 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml,v 1.2 2006/02/27 00:37:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-alpha.xml,v 1.3 2006/02/27 01:04:42 fox2mike Exp $ -->
<book link="handbook-alpha.xml">
<title>Gentoo Linux 2006.0 Alpha Handbook</title>
@@ -254,7 +254,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -263,7 +263,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -272,7 +272,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -282,7 +282,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -292,7 +292,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -309,7 +309,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -318,7 +318,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -329,7 +329,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -338,7 +338,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -348,7 +348,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -358,7 +358,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -372,7 +372,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -381,7 +381,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -390,7 +390,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -398,7 +398,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -406,7 +406,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -414,7 +414,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +18 -18 xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-amd64.xml 27 Feb 2006 00:37:17 -0000 1.2
+++ handbook-amd64.xml 27 Feb 2006 01:04:42 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml,v 1.2 2006/02/27 00:37:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-amd64.xml,v 1.3 2006/02/27 01:04:42 fox2mike Exp $ -->
<book link="handbook-amd64.xml">
<title>Gentoo Linux 2006.0 AMD64 Handbook</title>
@@ -253,7 +253,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -262,7 +262,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -281,7 +281,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -291,7 +291,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -308,7 +308,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -317,7 +317,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -328,7 +328,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -337,7 +337,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -347,7 +347,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -357,7 +357,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -371,7 +371,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -380,7 +380,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -389,7 +389,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -397,7 +397,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -405,7 +405,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -413,7 +413,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +18 -18 xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-hppa.xml 27 Feb 2006 00:37:17 -0000 1.2
+++ handbook-hppa.xml 27 Feb 2006 01:04:42 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml,v 1.2 2006/02/27 00:37:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-hppa.xml,v 1.3 2006/02/27 01:04:42 fox2mike Exp $ -->
<book link="handbook-hppa.xml">
<title>Gentoo Linux 2006.0 HPPA Handbook</title>
@@ -253,7 +253,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -262,7 +262,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -281,7 +281,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -291,7 +291,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -308,7 +308,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -317,7 +317,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -328,7 +328,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -337,7 +337,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -347,7 +347,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -357,7 +357,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -371,7 +371,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -380,7 +380,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -389,7 +389,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -397,7 +397,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -405,7 +405,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -413,7 +413,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +18 -18 xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-ppc.xml 27 Feb 2006 00:37:17 -0000 1.2
+++ handbook-ppc.xml 27 Feb 2006 01:04:42 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml,v 1.2 2006/02/27 00:37:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc.xml,v 1.3 2006/02/27 01:04:42 fox2mike Exp $ -->
<book link="handbook-ppc.xml">
<title>Gentoo Linux 2006.0 PPC Handbook</title>
@@ -260,7 +260,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -269,7 +269,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -278,7 +278,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -288,7 +288,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -298,7 +298,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -315,7 +315,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -324,7 +324,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -335,7 +335,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -344,7 +344,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -354,7 +354,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -364,7 +364,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -378,7 +378,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -387,7 +387,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -396,7 +396,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -404,7 +404,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -412,7 +412,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -420,7 +420,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +18 -18 xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-ppc64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-ppc64.xml 27 Feb 2006 00:37:17 -0000 1.2
+++ handbook-ppc64.xml 27 Feb 2006 01:04:42 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml,v 1.2 2006/02/27 00:37:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-ppc64.xml,v 1.3 2006/02/27 01:04:42 fox2mike Exp $ -->
<book link="handbook-ppc64.xml">
<title>Gentoo Linux 2006.0 PPC64 Handbook</title>
@@ -255,7 +255,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -264,7 +264,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -273,7 +273,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -283,7 +283,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -293,7 +293,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -310,7 +310,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -319,7 +319,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -330,7 +330,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -339,7 +339,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -349,7 +349,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -359,7 +359,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -373,7 +373,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -382,7 +382,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -391,7 +391,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -399,7 +399,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -407,7 +407,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -415,7 +415,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +18 -18 xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-sparc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-sparc.xml 27 Feb 2006 00:37:17 -0000 1.2
+++ handbook-sparc.xml 27 Feb 2006 01:04:42 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml,v 1.2 2006/02/27 00:37:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-sparc.xml,v 1.3 2006/02/27 01:04:42 fox2mike Exp $ -->
<book link="handbook-sparc.xml">
<title>Gentoo Linux 2006.0 SPARC Handbook</title>
@@ -253,7 +253,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -262,7 +262,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -281,7 +281,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -291,7 +291,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -308,7 +308,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -317,7 +317,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -328,7 +328,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -337,7 +337,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -347,7 +347,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -357,7 +357,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -371,7 +371,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -380,7 +380,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -389,7 +389,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -397,7 +397,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -405,7 +405,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -413,7 +413,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
1.3 +18 -18 xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-x86.xml 27 Feb 2006 00:37:17 -0000 1.2
+++ handbook-x86.xml 27 Feb 2006 01:04:42 -0000 1.3
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml,v 1.2 2006/02/27 00:37:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2006.0/handbook-x86.xml,v 1.3 2006/02/27 01:04:42 fox2mike Exp $ -->
<book link="handbook-x86.xml">
<title>Gentoo Linux 2006.0 x86 Handbook</title>
@@ -196,7 +196,7 @@
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
- <include href="../../hb-working-portage.xml"/>
+ <include href="../hb-working-portage.xml"/>
</chapter>
<chapter>
@@ -205,7 +205,7 @@
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
- <include href="../../hb-working-use.xml"/>
+ <include href="../hb-working-use.xml"/>
</chapter>
<chapter>
@@ -214,7 +214,7 @@
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
- <include href="../../hb-working-features.xml"/>
+ <include href="../hb-working-features.xml"/>
</chapter>
<chapter>
@@ -224,7 +224,7 @@
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
- <include href="../../hb-working-rcscripts.xml"/>
+ <include href="../hb-working-rcscripts.xml"/>
</chapter>
<chapter>
@@ -234,7 +234,7 @@
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
- <include href="../../hb-working-variables.xml"/>
+ <include href="../hb-working-variables.xml"/>
</chapter>
</part>
@@ -251,7 +251,7 @@
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
- <include href="../../hb-portage-files.xml"/>
+ <include href="../hb-portage-files.xml"/>
</chapter>
<chapter>
@@ -260,7 +260,7 @@
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
- <include href="../../hb-portage-configuration.xml"/>
+ <include href="../hb-portage-configuration.xml"/>
</chapter>
<chapter>
@@ -271,7 +271,7 @@
branches can be configured and how you can override this separation
individually.
</abstract>
- <include href="../../hb-portage-branches.xml"/>
+ <include href="../hb-portage-branches.xml"/>
</chapter>
<chapter>
@@ -280,7 +280,7 @@
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
- <include href="../../hb-portage-tools.xml"/>
+ <include href="../hb-portage-tools.xml"/>
</chapter>
<chapter>
@@ -290,7 +290,7 @@
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
- <include href="../../hb-portage-diverttree.xml"/>
+ <include href="../hb-portage-diverttree.xml"/>
</chapter>
<chapter>
@@ -300,7 +300,7 @@
installing software and how you can do this yourself using the ebuild
application.
</abstract>
- <include href="../../hb-portage-ebuild.xml"/>
+ <include href="../hb-portage-ebuild.xml"/>
</chapter>
</part>
@@ -314,7 +314,7 @@
A guide to quickly get your network interface up and running in most common
environments.
</abstract>
-<include href="../../hb-net-start.xml"/>
+<include href="../hb-net-start.xml"/>
</chapter>
<chapter>
@@ -323,7 +323,7 @@
Here we learn about how the configuration works - you need to know this
before we learn about modular networking.
</abstract>
-<include href="../../hb-net-advanced.xml"/>
+<include href="../hb-net-advanced.xml"/>
</chapter>
<chapter>
@@ -332,7 +332,7 @@
Gentoo provides you flexible networking - here you are told about choosing
different DHCP clients, setting up bonding, bridging, VLANs and more.
</abstract>
-<include href="../../hb-net-modules.xml"/>
+<include href="../hb-net-modules.xml"/>
</chapter>
<chapter>
@@ -340,7 +340,7 @@
<abstract>
Wireless isn't straight-forward. Hopefully we'll get you working!
</abstract>
-<include href="../../hb-net-wireless.xml"/>
+<include href="../hb-net-wireless.xml"/>
</chapter>
<chapter>
@@ -348,7 +348,7 @@
<abstract>
If you're feeling adventurous, you can add your own functions to networking.
</abstract>
-<include href="../../hb-net-functions.xml"/>
+<include href="../hb-net-functions.xml"/>
</chapter>
<chapter>
@@ -356,7 +356,7 @@
<abstract>
For laptop users or people who move their computer around different networks.
</abstract>
-<include href="../../hb-net-management.xml"/>
+<include href="../hb-net-management.xml"/>
</chapter>
</part>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2006-02-27 18:01 Shyam Mani
0 siblings, 0 replies; 25+ messages in thread
From: Shyam Mani @ 2006-02-27 18:01 UTC (permalink / raw
To: gentoo-doc-cvs
fox2mike 06/02/27 18:01:25
Removed: xml/htdocs/doc/en/handbook/draft/2006.0 handbook-alpha.xml
handbook-amd64.xml handbook-hppa.xml
handbook-ppc.xml handbook-ppc64.xml
handbook-sparc.xml handbook-x86.xml
hb-install-about.xml
hb-install-alpha-bootloader.xml
hb-install-alpha-disk.xml
hb-install-alpha-kernel.xml
hb-install-alpha-medium.xml
hb-install-amd64-bootloader.xml
hb-install-amd64-disk.xml
hb-install-amd64-kernel.xml
hb-install-amd64-medium.xml hb-install-config.xml
hb-install-finalise.xml hb-install-gli-dialog.xml
hb-install-gtkfe.xml hb-install-hppa-bootloader.xml
hb-install-hppa-disk.xml hb-install-hppa-kernel.xml
hb-install-hppa-medium.xml hb-install-network.xml
hb-install-next.xml hb-install-ppc-bootloader.xml
hb-install-ppc-disk.xml hb-install-ppc-kernel.xml
hb-install-ppc-medium.xml
hb-install-ppc64-bootloader.xml
hb-install-ppc64-disk.xml
hb-install-ppc64-kernel.xml
hb-install-ppc64-medium.xml
hb-install-sparc-bootloader.xml
hb-install-sparc-disk.xml
hb-install-sparc-kernel.xml
hb-install-sparc-medium.xml hb-install-stage.xml
hb-install-system.xml hb-install-tools.xml
hb-install-x86-medium.xml hb-installer-about.xml
index.xml
Log:
Removing 2006.0 networkless from draft.
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2006-08-02 22:09 Lukasz Damentko
0 siblings, 0 replies; 25+ messages in thread
From: Lukasz Damentko @ 2006-08-02 22:09 UTC (permalink / raw
To: gentoo-doc-cvs
rane 06/08/02 22:09:55
Modified: handbook-alpha.xml
Log:
bumping date and version
Revision Changes Path
1.124 xml/htdocs/doc/en/handbook/handbook-alpha.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.124&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.124&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml?r1=1.123&r2=1.124
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v
retrieving revision 1.123
retrieving revision 1.124
diff -u -r1.123 -r1.124
--- handbook-alpha.xml 2 Aug 2006 21:17:15 -0000 1.123
+++ handbook-alpha.xml 2 Aug 2006 22:09:55 -0000 1.124
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.123 2006/08/02 21:17:15 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.124 2006/08/02 22:09:55 rane Exp $ -->
<book link="/doc/en/handbook/handbook-alpha.xml">
<title>Gentoo Linux Alpha Handbook</title>
@@ -126,8 +126,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4.3</version>
-<date>2005-12-19</date>
+<version>4.4</version>
+<date>2006-08-01</date>
<part>
<title>Installing Gentoo</title>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2007-03-19 6:54 Josh Saddler
0 siblings, 0 replies; 25+ messages in thread
From: Josh Saddler @ 2007-03-19 6:54 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 07/03/19 06:54:47
Modified: handbook-alpha.xml
Log:
add alpha kernel key ids
Revision Changes Path
1.23 xml/htdocs/doc/en/handbook/draft/handbook-alpha.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/handbook-alpha.xml?rev=1.23&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/handbook-alpha.xml?rev=1.23&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/handbook-alpha.xml?r1=1.22&r2=1.23
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/handbook-alpha.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- handbook-alpha.xml 14 Mar 2007 06:37:25 -0000 1.22
+++ handbook-alpha.xml 19 Mar 2007 06:54:47 -0000 1.23
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/handbook-alpha.xml,v 1.22 2007/03/14 06:37:25 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/handbook-alpha.xml,v 1.23 2007/03/19 06:54:47 nightmorph Exp $ -->
<book link="/doc/en/handbook/handbook-alpha.xml">
<title>Gentoo Linux Alpha Handbook</title>
@@ -9,6 +9,8 @@
<values>
<key id="arch">Alpha</key>
<key id="/boot">/dev/sda1</key>
+ <key id="kernel-version">2.6.19-r5</key>
+ <key id="kernel-name">linux-2.6.19-gentoo-r5</key>
<key id="release-dir">releases/alpha/2007.0/</key>
<key id="stage3">stage3-alpha-2007.0.tar.bz2</key>
<key id="CFLAGS">-mieee -pipe -O2 -mcpu=ev6</key>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
* [gentoo-doc-cvs] cvs commit: handbook-alpha.xml
@ 2007-03-30 23:32 Josh Saddler
0 siblings, 0 replies; 25+ messages in thread
From: Josh Saddler @ 2007-03-30 23:32 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 07/03/30 23:32:27
Modified: handbook-alpha.xml
Log:
adding alpha keyvals
Revision Changes Path
1.4 xml/htdocs/doc/en/handbook/2007.0/handbook-alpha.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/2007.0/handbook-alpha.xml?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/2007.0/handbook-alpha.xml?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/2007.0/handbook-alpha.xml?r1=1.3&r2=1.4
Index: handbook-alpha.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2007.0/handbook-alpha.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-alpha.xml 28 Mar 2007 13:35:36 -0000 1.3
+++ handbook-alpha.xml 30 Mar 2007 23:32:26 -0000 1.4
@@ -1,11 +1,21 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2007.0/handbook-alpha.xml,v 1.3 2007/03/28 13:35:36 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2007.0/handbook-alpha.xml,v 1.4 2007/03/30 23:32:26 nightmorph Exp $ -->
<book link="/doc/en/handbook/2007.0/handbook-alpha.xml" disclaimer="draft">
<title>Gentoo Linux 2007.0 Alpha Handbook</title>
+<values>
+ <key id="arch">Alpha</key>
+ <key id="/boot">/dev/sda1</key>
+ <key id="kernel-version">2.6.19-r5</key>
+ <key id="kernel-name">kernel-2.6.19-gentoo-r5</key>
+ <key id="release-dir">releases/alpha/2007.0/</key>
+ <key id="stage3">stage3-alpha-2007.0.tar.bz2</key>
+ <key id="CFLAGS">-mieee -pipe -O2 -mcpu=ev6</key>
+</values>
+
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
@@ -121,7 +131,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>7.1</version>
+<version>8.0</version>
<date>2006-08-30</date>
<part>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 25+ messages in thread
end of thread, other threads:[~2007-03-30 23:33 UTC | newest]
Thread overview: 25+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2005-12-19 12:28 [gentoo-doc-cvs] cvs commit: handbook-alpha.xml Jan Kundrat
-- strict thread matches above, loose matches on Subject: below --
2007-03-30 23:32 Josh Saddler
2007-03-19 6:54 Josh Saddler
2006-08-02 22:09 Lukasz Damentko
2006-02-27 18:01 Shyam Mani
2006-02-27 1:04 Shyam Mani
2006-02-27 0:11 Shyam Mani
2006-02-22 5:32 Shyam Mani
2006-02-10 17:45 Shyam Mani
2006-02-05 9:51 Shyam Mani
2006-02-01 18:38 Shyam Mani
2005-12-19 12:36 Jan Kundrat
2005-11-11 17:27 swift
2005-10-13 15:08 Xavier Neys
2005-10-13 15:08 Xavier Neys
2005-10-09 23:28 Lukasz Damentko
2005-10-09 23:24 Lukasz Damentko
2005-08-08 14:00 swift
2005-08-08 13:27 swift
2005-08-08 13:24 swift
2005-08-08 13:16 swift
2005-07-28 14:33 Sven Vermeulen
2005-07-28 14:33 Sven Vermeulen
2005-07-28 14:33 Sven Vermeulen
2005-07-28 14:33 Sven Vermeulen
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox