/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.35 Revision 1.36
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v 1.35 2013/12/17 11:55:40 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v 1.36 2013/12/17 11:58:38 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>19</version> 11<version>20</version>
12<date>2013-12-17</date> 12<date>2013-12-17</date>
13 13
14<section> 14<section>
15<title>Making your Choice</title> 15<title>Making your Choice</title>
16<subsection> 16<subsection>
26 26
27</body> 27</body>
28<body test="contains('AMD64 x86', func:keyval('arch'))"> 28<body test="contains('AMD64 x86', func:keyval('arch'))">
29<p> 29<p>
30For <keyval id="arch"/>, Gentoo Linux provides <uri 30For <keyval id="arch"/>, Gentoo Linux provides <uri
31link="#grub">GRUB</uri>, <uri link="#grub2">GRUB2</uri> and 31link="#grub2">GRUB2</uri>, <uri link="#lilo">LILO</uri> and
32<uri link="#lilo">LILO</uri>. 32<uri link="#grub">GRUB Legacy</uri>.
33</p> 33</p>
34
35<note>
36GRUB2 might not be stabilized at the moment of reading this. However,
37stabilization is due very soon so we temporarily document both GRUB and GRUB2
38and will remove the GRUB instructions after stabilization of GRUB2.
39</note>
40 34
41</body> 35</body>
42<body> 36<body>
43<p> 37<p>
44But before we install the bootloader, we inform you how to configure 38But before we install the bootloader, we inform you how to configure
129<subsection> 123<subsection>
130<title>Installing GRUB2</title> 124<title>Installing GRUB2</title>
131<body> 125<body>
132 126
133<p> 127<p>
134GRUB2 is provided through the <c>sys-boot/grub</c> package. To deploy GRUB2, use 128GRUB2 is provided through the <c>sys-boot/grub</c> package.
135the <e>SLOT</e> notation to tell Portage to install GRUB2. SLOTs are a feature
136of Gentoo Linux where multiple versions of the same package can be deployed
137simultaneously on a system. In our case, this means that GRUB Legacy and GRUB2
138can be installed on a system (software-wise) at the same time.
139</p> 129</p>
140
141<note>
142GRUB2 might still be marked as ~<keyval id="arch" />. If that is the case, you
143can either wait and use <uri link="#grub">GRUB Legacy</uri> or unmask the
144package. This is explained in <uri
145link="handbook-amd64.xml?part=3&amp;chap=3#doc_chap2">Mixing Stable with
146Testing</uri>. Once GRUB2 is stabilized, the SLOT operator also is no longer
147mandatory.
148</note>
149 130
150<pre caption="Installing GRUB2"> 131<pre caption="Installing GRUB2">
151# <i>emerge sys-boot/grub:2</i> 132# <i>emerge sys-boot/grub</i>
152</pre> 133</pre>
153 134
154<p> 135<p>
155The GRUB2 software is now installed on the system, but not activated yet. 136The GRUB2 software is now installed on the system, but not activated yet.
156</p> 137</p>
363GRUB has been reworked and a new release dubbed GRUB2 is made available. The new 344GRUB has been reworked and a new release dubbed GRUB2 is made available. The new
364GRUB2 codebase is quite different from the current GRUB, which is why this GRUB 345GRUB2 codebase is quite different from the current GRUB, which is why this GRUB
365version is now dubbed as "GRUB Legacy". 346version is now dubbed as "GRUB Legacy".
366</p> 347</p>
367 348
368<p>
369We recommend to start with GRUB2 as soon as it is available. The migration of
370GRUB to GRUB2 is <uri link="https://wiki.gentoo.org/wiki/GRUB2_Migration">documented
371online</uri>. The instructions in this section relate to "GRUB Legacy" and will
372disappear from the book soon after the stabilization of <uri
373link="#grub2">GRUB2</uri>.
374</p>
375
376</body> 349</body>
377</subsection> 350</subsection>
378<subsection> 351<subsection>
379<title>Understanding GRUB's terminology</title> 352<title>Understanding GRUB's terminology</title>
380<body> 353<body>
415<subsection> 388<subsection>
416<title>Installing GRUB</title> 389<title>Installing GRUB</title>
417<body> 390<body>
418 391
419<p> 392<p>
420To install GRUB, let's first emerge it: 393To install GRUB Legacy, let's first emerge it:
421</p> 394</p>
422 395
423<impo test="func:keyval('arch')='AMD64'"> 396<impo test="func:keyval('arch')='AMD64'">
424If you are using a non-multilib <uri 397If you are using a non-multilib <uri
425link="?part=1&amp;chap=6#doc_chap2">profile</uri> and still intend to use the 398link="?part=1&amp;chap=6#doc_chap2">profile</uri> and still intend to use the

Legend:
Removed from v.1.35  
changed lines
  Added in v.1.36

  ViewVC Help
Powered by ViewVC 1.1.20