swift 05/11/26 16:23:25 Added: xml/htdocs/doc/en/draft bootstrapping-guide.xml Log: Adding framework for bootstrapping guide
Revision Changes Path 1.1 xml/htdocs/doc/en/draft/bootstrapping-guide.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/bootstrapping-guide.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/draft/bootstrapping-guide.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo Index: bootstrapping-guide.xml =================================================================== <?xml version='1.0' encoding="UTF-8"?> <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/bootstrapping-guide.xml,v 1.1 2005/11/26 16:23:25 swift Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/draft/bootstrapping-guide.xml"> <title>Gentoo Bootstrapping Guide</title> <author title="Author"> <mail link="[EMAIL PROTECTED]">Sven Vermeulen</mail> </author> <abstract> Bootstrapping means to build a toolchain so that it is ready to build the rest of your system. Gentoo is a perfect operating system to perform such installation while retaining support from the software management system, 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>0.1</version> <date>2005-07-25</date> <chapter> <title>What is Bootstrapping?</title> <section> <title>Definition</title> <body> <warn> Not only is this guide still in its early stage, it is also built on theoretical information found on the Internet and not from experience. It should be taken with a big grain of salt until the steps in it are verified and accepted by more experienced people. </warn> <p> If we were to believe the stories, <e>bootstrapping</e> - the term - originates from a German legend about Baron Münchhausen who was able to save himself from drowning in a swamp by pulling himself up by his hairs. </p> <p> In computer theory, bootstrapping has several meanings. All of them boil down to building more complex systems from simple ones. This document will discuss bootstrapping a toolchain: building a full cross-compilation environment able to build software for the target system. </p> </body> </section> <section> <title>Toolchain Bootstrapping</title> <body> <p> The process of bootstrapping a toolchain is two-fold. </p> <p> At first, you use an existing toolchain to create a cross-compilation environment, a toolchain capable of running on one system but building software for a different one. The second step is to use the cross-compilation toolchain to rebuild itself so that it builds code native to the system it is booted on. </p> <p> There are three important terms we use in this definition: </p> <ul> <li>the <e>host</e> system is the system on which the programs are ran, </li> <li> the <e>build</e> system is the system on which a particular package is being built, and </li> <li> the <e>target</e> system is the system for which the software generates output (like the compiler) </li> </ul> <p> After the toolchain is bootstrapped, the third stage is to build the rest of the system using the native toolchain. </p> </body> </section> </chapter> <chapter> <title>Installing Gentoo on an Unsupported Platform</title> <section> <title>Creating the Cross-Compilation Environment</title> <body> </body> </section> <section> <title>Filling the Environment</title> <body> </body> </section> <section> <title>Bootstrapping the Toolchain</title> <body> </body> </section> <section> <title>Building the Core System Packages</title> <body> </body> </section> <section> <title>Porting Portage</title> <body> </body> </section> <section> <title>Creating a Stage1 Tarball</title> <body> </body> </section> <section> <title>Creating a Bootable Environment</title> <body> </body> </section> <section> <title>Finishing Off</title> <body> </body> </section> </chapter> <chapter> <title>Bootstrapping the System</title> <section> <title>Installing Gentoo</title> <body> </body> </section> <section> <title>Using the Bootstrap Script</title> <body> </body> </section> <section> <title>Building the Core System</title> <body> </body> </section> <section> <title>Finishing the Installation</title> <body> </body> </section> </chapter> <chapter> <title>Frequently Asked Questions</title> <section> <title> Should I bootstrap when I want my entire system to use changed CFLAGS, CXXFLAGS, USE settings and profile changes? </title> <body> </body> </section> <section> <title> Should I bootstrap when I want my entire system to use changed CHOST settings? </title> <body> </body> </section> </chapter> </guide> -- [email protected] mailing list
