Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
View | Details | Raw Unified | Return to bug 334357
Collapse All | Expand All

(-)xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml (-161 / +3 lines)
Lines 12-19 Link Here
12
<date>2010-07-16</date>
12
<date>2010-07-16</date>
13
13
14
<section>
14
<section>
15
<title>Making your Choice</title>
16
<subsection>
17
<title>Introduction</title>
15
<title>Introduction</title>
18
<body>
16
<body>
19
17
Lines 27-34 program is called a <e>bootloader</e>. Link Here
27
</body>
25
</body>
28
<body test="contains('AMD64 x86', func:keyval('arch'))">
26
<body test="contains('AMD64 x86', func:keyval('arch'))">
29
<p>
27
<p>
30
For <keyval id="arch"/>, Gentoo Linux provides <uri
28
For <keyval id="arch"/>, Gentoo Linux provides <uri link="#grub">GRUB</uri>.
31
link="#grub">GRUB</uri> and <uri link="#lilo">LILO</uri>.
32
</p>
29
</p>
33
30
34
</body>
31
</body>
Lines 41-47 bootsplash image Gentoo provides). Link Here
41
</p>
38
</p>
42
39
43
</body>
40
</body>
44
</subsection>
45
<subsection>
41
<subsection>
46
<title>Optional: Framebuffer</title>
42
<title>Optional: Framebuffer</title>
47
<body>
43
<body>
Lines 109-123 Now, you should install the <uri link="# Link Here
109
</p>
105
</p>
110
106
111
<p test="not(func:keyval('arch')='IA64')">
107
<p test="not(func:keyval('arch')='IA64')">
112
Now continue by installing <uri link="#grub">GRUB</uri> <e>or</e> <uri
108
Now continue by installing <uri link="#grub">GRUB</uri>.
113
link="#lilo">LILO</uri>.
114
</p>
109
</p>
115
110
116
</body>
111
</body>
117
</subsection>
112
</subsection>
118
</section>
113
</section>
119
<section id="grub" test="contains('AMD64 x86',func:keyval('arch'))">
114
<section id="grub" test="contains('AMD64 x86',func:keyval('arch'))">
120
<title>Default: Using GRUB</title>
115
<title>Using GRUB</title>
121
<subsection>
116
<subsection>
122
<title>Understanding GRUB's terminology</title>
117
<title>Understanding GRUB's terminology</title>
123
<body>
118
<body>
Lines 432-590 Continue with <uri link="#reboot">Reboot Link Here
432
</body>
427
</body>
433
</subsection>
428
</subsection>
434
</section>
429
</section>
435
<section id="lilo" test="contains('AMD64 x86', func:keyval('arch'))">
436
<title>Alternative: Using LILO</title>
437
<subsection>
438
<title>Installing LILO</title>
439
<body>
440
441
<p>
442
LILO, the LInuxLOader, is the tried and true workhorse of Linux
443
bootloaders. However, it lacks some features that GRUB has (which is
444
also the reason why GRUB is currently gaining popularity). The reason
445
why LILO is still used is that, on some systems, GRUB doesn't work and
446
LILO does. Of course, it is also used because some people know LILO and
447
want to stick with it. Either way, Gentoo supports both, and apparently
448
you have chosen to use LILO.
449
</p>
450
451
<p>
452
Installing LILO is a breeze; just use <c>emerge</c>.
453
</p>
454
455
<pre caption="Installing LILO">
456
# <i>emerge lilo</i>
457
</pre>
458
459
</body>
460
</subsection>
461
<subsection>
462
<title>Configuring LILO</title>
463
<body>
464
465
<p>
466
To configure LILO, you must create <path>/etc/lilo.conf</path>. Fire up
467
your favorite editor (in this handbook we use <c>nano</c> for
468
consistency) and create the file.
469
</p>
470
471
<pre caption="Creating /etc/lilo.conf">
472
# <i>nano -w /etc/lilo.conf</i>
473
</pre>
474
475
<p>
476
Some sections ago we have asked you to remember the kernel-image name
477
you have created. In the next example <path>lilo.conf</path> we use the
478
example partitioning scheme. There are two separate parts:
479
</p>
480
481
<ul>
482
  <li>
483
    One for those who have not used <c>genkernel</c> to build their kernel
484
  </li>
485
  <li>
486
    One for those who have used <c>genkernel</c> to build their kernel
487
  </li>
488
</ul>
489
490
<p>
491
Make sure you use <e>your</e> kernel image filename and, if appropriate,
492
<e>your</e> initrd image filename.
493
</p>
494
495
<note>
496
If your root filesystem is JFS, you <e>must</e> add a <c>append="ro"</c>
497
line after each boot item since JFS needs to replay its log before it allows
498
read-write mounting.
499
</note>
500
501
<pre caption="Example /etc/lilo.conf">
502
boot=/dev/sda             <comment># Install LILO in the MBR</comment>
503
prompt                    <comment># Give the user the chance to select another section</comment>
504
timeout=50                <comment># Wait 5 (five) seconds before booting the default section</comment>
505
default=gentoo            <comment># When the timeout has passed, boot the "gentoo" section</comment>
506
507
<comment># For non-genkernel users</comment>
508
image=/boot/<keyval id="kernel-name"/>
509
  label=gentoo            <comment># Name we give to this section</comment>
510
  read-only               <comment># Start with a read-only root. Do not alter!</comment>
511
  root=/dev/sda3          <comment># Location of the root filesystem</comment>
512
513
image=/boot/<keyval id="kernel-name"/>
514
  label=gentoo.rescue     <comment># Name we give to this section</comment>
515
  read-only               <comment># Start with a read-only root. Do not alter!</comment>
516
  root=/dev/sda3          <comment># Location of the root filesystem</comment>
517
  append="init=/bin/bb"   <comment># Launch the Gentoo static rescue shell</comment>
518
519
<comment># For genkernel users</comment>
520
image=/boot/<keyval id="genkernel-name"/>
521
  label=gentoo
522
  read-only
523
  root=/dev/ram0
524
  append="init=/linuxrc ramdisk=8192 real_root=/dev/sda3"
525
  initrd=/boot/<keyval id="genkernel-initrd"/>
526
527
<comment># The next two lines are only if you dualboot with a Windows system.</comment>
528
<comment># In this case, Windows is hosted on /dev/sda6.</comment>
529
other=/dev/sda6
530
  label=windows
531
</pre>
532
533
<note>
534
If you use a different partitioning scheme and/or kernel image, adjust
535
accordingly.
536
</note>
537
538
<p>
539
If you need to pass any additional options to the kernel, add an
540
<c>append</c> statement to the section. As an example, we add the
541
<c>video</c> statement to enable framebuffer:
542
</p>
543
544
<pre caption="Using append to add kernel options">
545
image=/boot/<keyval id="kernel-name"/>
546
  label=gentoo
547
  read-only
548
  root=/dev/sda3
549
  <i>append="video=uvesafb:mtrr,ywrap,1024x768-32@85"</i>
550
</pre>
551
552
<p>
553
If you're using a 2.6.7 or higher kernel and you jumpered your harddrive
554
because the BIOS can't handle large harddrives you'll need to append
555
<c>sda=stroke</c>. Replace sda with the device that requires this option.
556
</p>
557
558
<p>
559
<c>genkernel</c> users should know that their kernels use the same boot options
560
as is used for the Installation CD. For instance, if you have SCSI devices, you
561
should add <c>doscsi</c> as kernel option.
562
</p>
563
564
<p>
565
Now save the file and exit. To finish up, you have to run <c>/sbin/lilo</c> so
566
LILO can apply the <path>/etc/lilo.conf</path> to your system (i.e. install
567
itself on the disk). Keep in mind that you'll also have to run
568
<c>/sbin/lilo</c> every time you install a new kernel or make any changes to
569
the menu.
570
</p>
571
572
<pre caption="Finishing the LILO installation">
573
# <i>/sbin/lilo</i>
574
</pre>
575
576
<p>
577
If you have more questions regarding LILO, please consult its <uri
578
link="http://en.wikipedia.org/wiki/LILO_(boot_loader)">wikipedia page</uri>.
579
</p>
580
581
<p>
582
You can now continue with <uri link="#reboot">Rebooting the System</uri>.
583
</p>
584
585
</body>
586
</subsection>
587
</section>
588
<section id="elilo" test="func:keyval('arch')='IA64'">
430
<section id="elilo" test="func:keyval('arch')='IA64'">
589
<title>Default: Installing elilo</title>
431
<title>Default: Installing elilo</title>
590
<body>
432
<body>

Return to bug 334357