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