/[gentoo]/xml/htdocs/doc/en/draft/bootstrapping-guide.xml
Gentoo

Contents of /xml/htdocs/doc/en/draft/bootstrapping-guide.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1 - (hide annotations) (download) (as text)
Sat Nov 26 16:23:25 2005 UTC (8 years, 10 months ago) by swift
Branch: MAIN
File MIME type: application/xml
Adding framework for bootstrapping guide

1 swift 1.1 <?xml version='1.0' encoding="UTF-8"?>
2    
3     <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/ldapdns-guide.xml,v 1.3 2005/09/29 15:11:35 neysx Exp $ -->
4    
5     <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
6    
7     <guide link="/doc/en/draft/bootstrapping-guide.xml">
8     <title>Gentoo Bootstrapping Guide</title>
9    
10     <author title="Author">
11     <mail link="swift@gentoo.org">Sven Vermeulen</mail>
12     </author>
13    
14     <abstract>
15     Bootstrapping means to build a toolchain so that it is ready to build the rest
16     of your system. Gentoo is a perfect operating system to perform such
17     installation while retaining support from the software management system,
18     Portage.
19     </abstract>
20    
21     <!-- The content of this document is licensed under the CC-BY-SA license -->
22     <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
23     <license/>
24    
25     <version>0.1</version>
26     <date>2005-07-25</date>
27    
28     <chapter>
29     <title>What is Bootstrapping?</title>
30     <section>
31     <title>Definition</title>
32     <body>
33    
34     <warn>
35     Not only is this guide still in its early stage, it is also built on theoretical
36     information found on the Internet and not from experience. It should be taken
37     with a big grain of salt until the steps in it are verified and accepted by more
38     experienced people.
39     </warn>
40    
41     <p>
42     If we were to believe the stories, <e>bootstrapping</e> - the term - originates
43     from a German legend about Baron M√ľnchhausen who was able to save himself from
44     drowning in a swamp by pulling himself up by his hairs.
45     </p>
46    
47     <p>
48     In computer theory, bootstrapping has several meanings. All of them boil down to
49     building more complex systems from simple ones. This document will discuss
50     bootstrapping a toolchain: building a full cross-compilation environment able to
51     build software for the target system.
52     </p>
53    
54     </body>
55     </section>
56     <section>
57     <title>Toolchain Bootstrapping</title>
58     <body>
59    
60     <p>
61     The process of bootstrapping a toolchain is two-fold.
62     </p>
63    
64     <p>
65     At first, you use an existing toolchain to create a cross-compilation
66     environment, a toolchain capable of running on one system but building software
67     for a different one. The second step is to use the cross-compilation toolchain
68     to rebuild itself so that it builds code native to the system it is booted on.
69     </p>
70    
71     <p>
72     There are three important terms we use in this definition:
73     </p>
74    
75     <ul>
76     <li>the <e>host</e> system is the system on which the programs are ran, </li>
77     <li>
78     the <e>build</e> system is the system on which a particular package is being
79     built, and
80     </li>
81     <li>
82     the <e>target</e> system is the system for which the software generates
83     output (like the compiler)
84     </li>
85     </ul>
86    
87     <p>
88     After the toolchain is bootstrapped, the third stage is to build the rest of the
89     system using the native toolchain.
90     </p>
91    
92     </body>
93     </section>
94     </chapter>
95    
96     <chapter>
97     <title>Installing Gentoo on an Unsupported Platform</title>
98     <section>
99     <title>Creating the Cross-Compilation Environment</title>
100     <body>
101    
102     </body>
103     </section>
104     <section>
105     <title>Filling the Environment</title>
106     <body>
107    
108     </body>
109     </section>
110     <section>
111     <title>Bootstrapping the Toolchain</title>
112     <body>
113    
114     </body>
115     </section>
116     <section>
117     <title>Building the Core System Packages</title>
118     <body>
119    
120     </body>
121     </section>
122     <section>
123     <title>Porting Portage</title>
124     <body>
125    
126     </body>
127     </section>
128     <section>
129     <title>Creating a Stage1 Tarball</title>
130     <body>
131    
132     </body>
133     </section>
134     <section>
135     <title>Creating a Bootable Environment</title>
136     <body>
137    
138     </body>
139     </section>
140     <section>
141     <title>Finishing Off</title>
142     <body>
143    
144     </body>
145     </section>
146     </chapter>
147    
148     <chapter>
149     <title>Bootstrapping the System</title>
150     <section>
151     <title>Installing Gentoo</title>
152     <body>
153    
154     </body>
155     </section>
156     <section>
157     <title>Using the Bootstrap Script</title>
158     <body>
159    
160     </body>
161     </section>
162     <section>
163     <title>Building the Core System</title>
164     <body>
165    
166     </body>
167     </section>
168     <section>
169     <title>Finishing the Installation</title>
170     <body>
171    
172     </body>
173     </section>
174     </chapter>
175    
176     <chapter>
177     <title>Frequently Asked Questions</title>
178     <section>
179     <title>
180     Should I bootstrap when I want my entire system to use changed CFLAGS,
181     CXXFLAGS, USE settings and profile changes?
182     </title>
183     <body>
184    
185     </body>
186     </section>
187     <section>
188     <title>
189     Should I bootstrap when I want my entire system to use changed CHOST settings?
190     </title>
191     <body>
192    
193     </body>
194     </section>
195     </chapter>
196    
197     </guide>

  ViewVC Help
Powered by ViewVC 1.1.20