/[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 - (show annotations) (download) (as text)
Sat Nov 26 16:23:25 2005 UTC (8 years, 4 months ago) by swift
Branch: MAIN
File MIME type: application/xml
Adding framework for bootstrapping guide

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