/projects/netbeans-7.3/html.editor.lib/test/unit/data/testfiles/syntaxtree/big.html
HTML | 941 lines | 847 code | 94 blank | 0 comment | 0 complexity | 729fa299ec6ddef8d74f2ffff85f67c9 MD5 | raw file
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
- <html lang="en">
- <head>
- <title>Gentoo Linux Documentation</title>
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
- <link title="new" rel="stylesheet" href="../../../css/main.css" type="text/css">
- <link REL="shortcut icon" HREF="../../../favicon.ico" TYPE="image/x-icon">
- <link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/www-gentoo-org.xml" title="Gentoo Website">
- <link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/forums-gentoo-org.xml" title="Gentoo Forums">
- <link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/bugs-gentoo-org.xml" title="Gentoo Bugzilla">
- <link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/archives-gentoo-org.xml" title="Gentoo List Archives">
- --
- </head>
- <body bgcolor="#ffffff">
- <h1>Gentoo Linux x86 Handbook</h1>
- <a href="mailto:swift@gentoo.org" class="altlink"><b>Sven Vermeulen</b></a>
- <i>Author</i><br>
- <a href="mailto:g2boojum@gentoo.org" class="altlink"><b>Grant Goodyear</b></a>
- <i>Author</i><br>
- <a href="mailto:uberlord@gentoo.org" class="altlink"><b>Roy Marples</b></a>
- <i>Author</i><br>
- <a href="mailto:drobbins.daniel@gmail.com" class="altlink"><b>Daniel Robbins</b></a>
- <i>Author</i><br>
- <a href="mailto:chouser@bluweb.com" class="altlink"><b>Chris Houser</b></a>
- <i>Author</i><br>
- <a href="mailto:jalexand@wlgore.com" class="altlink"><b>Jerry Alexandratos</b></a>
- <i>Author</i><br>
- <a href="mailto:seemant@gentoo.org" class="altlink"><b>Seemant Kulleen</b></a>
- <i>Gentoo x86 Developer</i><br>
- <a href="mailto:taviso@gentoo.org" class="altlink"><b>Tavis Ormandy</b></a>
- <i>Gentoo Alpha Developer</i><br>
- Jason Huebel
- <i>Gentoo AMD64 Developer</i><br>
- <a href="mailto:gmsoft@gentoo.org" class="altlink"><b>Guy Martin</b></a>
- <i>Gentoo HPPA developer</i><br>
- <a href="mailto:pvdabeel@gentoo.org" class="altlink"><b>Pieter Van den Abeele</b></a>
- <i>Gentoo PPC developer</i><br>
- <a href="mailto:jkallar@yahoo.com" class="altlink"><b>Joe Kallar</b></a>
- <i>Gentoo SPARC developer</i><br>
- <a href="mailto:john_davis@pauldavisautomation.com" class="altlink"><b>John P. Davis</b></a>
- <i>Editor</i><br>Pierre-Henri Jondot <i>Editor</i><br>
- <a href="mailto:stocke2@gmail.com" class="altlink"><b>Eric Stockbridge</b></a>
- <i>Editor</i><br>
- <a href="mailto:rajiv@gentoo.org" class="altlink"><b>Rajiv Manglani</b></a>
- <i>Editor</i><br>
- <a href="mailto:seo@gentoo.or.kr" class="altlink"><b>Jungmin Seo</b></a>
- <i>Editor</i><br>
- <a href="mailto:zhware@hotpop.com" class="altlink"><b>Stoyan Zhekov</b></a>
- <i>Editor</i><br>
- Jared Hudson
- <i>Editor</i><br>
- <a href="mailto:peitolm@gentoo.org" class="altlink"><b>Colin Morey</b></a>
- <i>Editor</i><br>
- Jorge Paulo
- <i>Editor</i><br>
- <a href="mailto:canderson@wayne.edu" class="altlink"><b>Carl Anderson</b></a>
- <i>Editor</i><br>
- <a href="mailto:avenj@tellink.net" class="altlink"><b>Jon Portnoy</b></a>
- <i>Editor</i><br>
- Zack Gilburd
- <i>Editor</i><br>
- <a href="mailto:jack@bonyari.com" class="altlink"><b>Jack Morgan</b></a>
- <i>Editor</i><br>
- <a href="mailto:benny@coolbee.net" class="altlink"><b>Benny Chuang</b></a>
- <i>Editor</i><br>
- <a href="mailto:erw1n@pmail.ntu.edu.sg" class="altlink"><b>Erwin</b></a>
- <i>Editor</i><br>
- <a href="mailto:kumba@gentoo.org" class="altlink"><b>Joshua Kinard</b></a>
- <i>Editor</i><br>
- <a href="mailto:dertobi123@gentoo.org" class="altlink"><b>Tobias Scherbaum</b></a>
- <i>Editor</i><br>
- <a href="mailto:neysx@gentoo.org" class="altlink"><b>Xavier Neys</b></a>
- <i>Editor</i><br>
- <a href="mailto:nightmorph@gentoo.org" class="altlink"><b>Joshua Saddler</b></a>
- <i>Editor</i><br>
- Gerald J. Normandin Jr.
- <i>Reviewer</i><br>
- <a href="mailto:dberkholz@gentoo.org" class="altlink"><b>Donnie Berkholz</b></a>
- <i>Reviewer</i><br>
- <a href="mailto:drake_stuff@yahoo.com" class="altlink"><b>Ken Nowack</b></a>
- <i>Reviewer</i><br>
- <a href="mailto:pylon@gentoo.org" class="altlink"><b>Lars Weiler</b></a>
- <i>Contributor</i><br><br><i>Updated November 27, 2007</i><p>Content:</p>
- <ul>
- <li>
- <b><a href="#book_part1">Installing Gentoo</a></b><br>
- In this part you learn how to install Gentoo on your system.
- <ol>
- <li>
- <b><a href="#book_part1_chap1">About the Gentoo Linux Installation</a></b><br>
- This chapter introduces you to the installation approach documented in this
- handbook.
- </li>
- <li>
- <b><a href="#book_part1_chap2">Choosing the Right Installation Medium</a></b><br>
- You can install Gentoo in many ways. This chapter explains how to install
- Gentoo using the minimal Installation CD although installation through the
- Installer LiveCD is possible as well.
- </li>
- <li>
- <b><a href="#book_part1_chap3">Configuring your Network</a></b><br>
- To be able to download the latest source code, you will need to setup
- networking.
- </li>
- <li>
- <b><a href="#book_part1_chap4">Preparing the Disks</a></b><br>
- To be able to install Gentoo, you must create the necessary partitions.
- This chapter describes how to partition a disk for future usage.
- </li>
- <li>
- <b><a href="#book_part1_chap5">Installing the Gentoo Installation Files</a></b><br>
- Gentoo installs work through a stage3 archive. In this chapter we
- describe how you extract the stage3 archive and configure Portage.
- </li>
- <li>
- <b><a href="#book_part1_chap6">Installing the Gentoo Base System</a></b><br>
- After installing and configuring a stage3, the eventual result is that you
- have a Gentoo base system at your disposal. This chapter describes how
- to progress to that state.
- </li>
- <li>
- <b><a href="#book_part1_chap7">Configuring the Kernel</a></b><br>
- The Linux kernel is the core of every distribution. This chapter
- explains how to configure your kernel.
- </li>
- <li>
- <b><a href="#book_part1_chap8">Configuring your System</a></b><br>
- You need to edit some important configuration files. In this chapter
- you receive an overview of these files and an explanation on how to
- proceed.
- </li>
- <li>
- <b><a href="#book_part1_chap9">Installing Necessary System Tools</a></b><br>
- In this chapter we help you choose and install some important tools.
- </li>
- <li>
- <b><a href="#book_part1_chap10">Configuring the Bootloader</a></b><br>
- Several bootloaders exist for the x86 architecture. Each one of them has its
- own way of configuration. We step you through the process of configuring a
- bootloader to your needs.
- </li>
- <li>
- <b><a href="#book_part1_chap11">Finalizing your Gentoo Installation</a></b><br>
- You're almost done. We'll just create one (or more) users for your
- system.
- </li>
- <li>
- <b><a href="#book_part1_chap12">Where to go from here?</a></b><br>
- Now you have your Gentoo system, but what's next?
- </li>
- </ol>
- </li>
- <li>
- <b><a href="#book_part2">Working with Gentoo</a></b><br>
- Learn how to work with Gentoo: installing software, altering variables, changing
- Portage behaviour etc.
- <ol>
- <li>
- <b><a href="#book_part2_chap1">A Portage Introduction</a></b><br>
- This chapter explains the "simple" steps a user definitely needs to know to
- maintain the software on his system.
- </li>
- <li>
- <b><a href="#book_part2_chap2">USE flags</a></b><br>
- USE flags are a very important aspect of Gentoo. In this chapter, you learn to
- work with USE flags and understand how USE flags interact with your system.
- </li>
- <li>
- <b><a href="#book_part2_chap2">USE flags</a></b><br>
- USE flags are a very important aspect of Gentoo. In this chapter, you learn to
- work with USE flags and understand how USE flags interact with your system.
- </li>
- <li>
- <b><a href="#book_part2_chap2">USE flags</a></b><br>
- USE flags are a very important aspect of Gentoo. In this chapter, you learn to
- work with USE flags and understand how USE flags interact with your system.
- </li>
- <li>
- </li>
- <li>
- <b><a href="#book_part2_chap3">Portage Features</a></b><br>
- Discover the features Portage has, such as support for distributed compiling,
- ccache and more.
- </li>
- <li>
- <b><a href="#book_part2_chap3">Portage Features</a></b><br>
- Discover the features Portage has, such as support for distributed compiling,
- ccache and more.
- </li>
- <li>
- <b><a href="#book_part2_chap4">Initscripts</a></b><br>
- Gentoo uses a special initscript format which, amongst other features, allows
- dependency-driven decisions and virtual initscripts. This chapter explains all
- these aspects and explains how to deal with these scripts.
- </li>
- <li>
- <b><a href="#book_part2_chap5">Environment Variables</a></b><br>
- With Gentoo you can easily manage the environment variables for your system.
- This chapter explains how you do that, and also describes frequently used
- variables.
- </li>
- </ol>
- </li>
- <li>
- <b><a href="#book_part3">Working with Portage</a></b><br>
- "Working with Portage" provides an in-depth coverage of Portage, Gentoo's
- Software Management Tool.
- <ol>
- <li>
- <b><a href="#book_part3_chap1">Files and Directories</a></b><br>
- Once you want to know Portage in-depth you need to know where it stores its
- files and data.
- </li>
- <li>
- <b><a href="#book_part3_chap2">Configuring through Variables</a></b><br>
- Portage is completely configurable through various variables you can set in the
- configuration file or as environment variable.
- </li>
- <li>
- <b><a href="#book_part3_chap3">Mixing Software Branches</a></b><br>
- Gentoo provides software separated in several branches, depending on stability
- and architectural support. "Mixing Software Branches" inform you how these
- branches can be configured and how you can override this separation
- individually.
- </li>
- <li>
- <b><a href="#book_part3_chap4">Additional Portage Tools</a></b><br>
- Portage comes with a few extra tools that might make your Gentoo experience even
- better. Read on to discover how to use dispatch-conf and other tools.
- </li>
- <li>
- <b><a href="#book_part3_chap5">Diverting from the Official Tree</a></b><br>
- "Diverting from the Official Tree" gives you some tips and tricks on how to use
- your own Portage tree, how to synchronise only the categories you want, inject
- packages and more.
- </li>
- </ol>
- </li>
- <li>
- <b><a href="#book_part4">Gentoo Network Configuration</a></b><br>A comprehensive guide to Networking in Gentoo.<ol>
- <li>
- <b><a href="#book_part4_chap1">Getting Started</a></b><br>
- A guide to quickly get your network interface up and running in most common
- environments.
- </li>
- <li>
- <b><a href="#book_part4_chap2">Advanced Configuration</a></b><br>
- Here we learn about how the configuration works - you need to know this
- before we learn about modular networking.
- </li>
- <li>
- <b><a href="#book_part4_chap3">Modular Networking</a></b><br>
- Gentoo provides you flexible networking - here you are told about choosing
- different DHCP clients, setting up bonding, bridging, VLANs and more.
- </li>
- <li>
- <b>
- <a href="#book_part4_chap4">Wireless Networking</a></b><br>
- Wireless isn't straightforward. Hopefully we'll get you working!
- </li>
- <li>
- <b><a href="#book_part4_chap5">Adding Functionality</a></b><br>
- If you're feeling adventurous, you can add your own functions to networking.
- </li>
- <li>
- <b><a href="#book_part4_chap6">Network Management</a></b><br>
- For laptop users or people who move their computer around different networks.
- </li>
- </ol>
- </li>
- </ul>
- <a name="book_part1"></a><h2>A. Installing Gentoo</h2>
- <a name="book_part1_chap1"></a><h3>1. About the Gentoo Linux Installation</h3>
- <a name="book_id6780645_chap1"></a><a name="book_part1_chap1__chap1"></a><p class="chaphead"><span class="chapnum">1.a. </span>Introduction</p>
- <a name="book_id6780645_chap1_sect1"></a><a name="book_part1_chap1__chap1_sect1"></a><p class="secthead">Welcome!</p>
- <p>
- First of all, <span class="emphasis">welcome</span> to Gentoo. You are about to enter the world
- of choices and performance. Gentoo is all about choices. When
- installing Gentoo, this is made clear to you several times -- you can
- choose how much you want to compile yourself, how to install Gentoo,
- what system logger you want, etc.
- </p>
- <p>
- First of all, <span class="emphasis">welcome</span> to Gentoo. You are about to enter the world
- of choices and performance. Gentoo is all about choices. When
- installing Gentoo, this is made clear to you several times -- you can
- choose how much you want to compile yourself, how to install Gentoo,
- what system logger you want, etc.
- <a>
- hallo!
- this is big <span style="color:red">FILE!!!</span>
- this is no so BIG <span style="color:green">
- FF!
- </span>
- </a>
- </p>
- <a name="book_part1"></a><h2>A. Installing Gentoo</h2>
- <a name="book_part1"></a><h2>A. Installing Gentoo</h2>
- <a name="book_part1_chap1"></a><h3>1. About the Gentoo Linux Installation</h3>
- <a name="book_id6780645_chap1"></a><a name="book_part1_chap1__chap1"></a><p class="chaphead"><span class="chapnum">1.a. </span>Introduction</p>
- <a name="book_id6780645_chap1_sect1"></a><a name="book_part1_chap1__chap1_sect1"></a><p class="secthead">Welcome!</p>
- <p>
- Gentoo is a fast, modern metadistribution with a clean and flexible
- design. Gentoo is built around free software and doesn't hide from its
- users what is beneath the hood. Portage, the package maintenance system
- which Gentoo uses, is written in Python, meaning you can easily view and
- modify the source code. Gentoo's packaging system uses source code
- (although support for precompiled packages is included too) and
- configuring Gentoo happens through regular textfiles. In other words,
- openness everywhere.
- </p>
- <p>
- Gentoo is a fast, modern metadistribution with a clean and flexible
- design. Gentoo is built around free software and doesn't hide from its
- users what is beneath the hood. Portage, the package maintenance system
- which Gentoo uses, is written in Python, meaning you can easily view and
- modify the source code. Gentoo's packaging system uses source code
- (although support for precompiled packages is included too) and
- configuring Gentoo happens through regular textfiles. In other words,
- openness everywhere.
- </p>
- <p>
- When you are given a certain choice, we try our best to explain what the pros
- and cons are. We will continue then with a default
- choice, identified by "Default: " in the title. The other
- possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
- this is OK.....
- possibilities are marked by "Alternative: ". Do
- <span class="emphasis" style="color:green">
- not
- </span>
- it works well
- think that the default is what we recommend. It is however what we
- believe most users will use.
- </p>
- <p>
- When you are given a certain choice, we try our best to explain what the pros
- and cons are. We will continue then with a default
- choice, identified by "Default: " in the title. The other
- possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
- this is OK.....
- it works well
- think that the default is what we recommend. It is however what we
- believe most users will use.
- </p>
- <p>
- When you are given a certain choice, we try our best to explain what the pros
- and cons are. We will continue then with a default
- choice, identified by "Default: " in the title. The other
- possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
- this is OK.....
- it works well
- think that the default is what we recommend. It is however what we
- believe most users will use.
- </p>
- <p>
- When you are given a certain choice, we try our best to explain what the pros
- and cons are. We will continue then with a default
- choice, identified by "Default: " in the title. The other
- possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
- this is OK.....
- it works well
- think that the default is what we recommend. It is however what we
- believe most users will use.
- </p>
- <p>
- It is very important that you understand that <span class="emphasis">choices</span> are what
- makes Gentoo run. We try not to force you onto anything you don't like.
- If you feel like we do, please <a href="http://bugs.gentoo.org">bugreport</a> it.
- </p>
- <a name="book_id6780645_chap1_sect2"></a><a name="book_part1_chap1__chap1_sect2"></a><p class="secthead">How is the Installation Structured?</p>
- <p>
- The Gentoo Installation can be seen as a 10-step procedure,
- corresponding to chapters 2 - 11. Every step results in
- a certain state:
- </p>
- <ul>
- <li>
- After step 1, you are in a working environment ready to install Gentoo
- </li>
- <li>
- After step 2, your internet connection is ready to install Gentoo
- </li>
- <li>
- After step 3, your hard disks are initialized to house your Gentoo
- installation
- </li>
- <li>
- After step 4, your installation environment is prepared and you are
- ready to chroot into the new environment
- </li>
- <li>
- After step 5, core packages, which are the same on all Gentoo
- installations, are installed
- </li>
- <li>
- After step 6, you have compiled your Linux kernel
- </li>
- <li>
- After step 7, you have written most of your Gentoo system
- configuration files
- </li>
- <li>
- After step 8, necessary system tools (which you can choose from a nice
- list) are installed
- </li>
- <li>
- After step 9, your choice of bootloader has been installed and
- configured and you are logged in into your new Gentoo installation
- </li>
- <li>
- After step 10, your Gentoo Linux environment is ready to be explored
- </li>
- </ul>
- <p>
- When you are given a certain choice, we try our best to explain what the pros
- and cons are. We will continue then with a default
- choice, identified by "Default: " in the title. The other
- possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
- think that the default is what we recommend. It is however what we
- believe most users will use.
- </p>
- <p>
- Sometimes you can pursue an optional step. Such steps are marked as
- "Optional: " and are therefore not needed to install Gentoo.
- However, some optional steps are dependant on a previous decision you
- made. We will inform you when this happens, both when you make the
- decision, and right before the optional step is described.
- </p>
- <a name="book_id6780645_chap1_sect3"></a><a name="book_part1_chap1__chap1_sect3"></a><p class="secthead">What are my Options?</p>
- <p></p>
- <p>
- Also note that, if you plan on using GRP (the Gentoo Reference Platform, a
- collection of prebuilt packages meant for immediate use after a Gentoo
- installation), you <span class="emphasis">must</span> follow the instructions in the <a href="/doc/en/handbook/2007.0/?style=printable">Gentoo 2007.0 Handbooks</a>.
- </p>
- <p>
- For help on the other installation approaches, please read our <a href="/doc/en/altinstall.xml?style=printable">Alternative Installation Guide</a>. We also
- provide a <a href="/doc/en/gentoo-x86-tipsntricks.xml?style=printable">Gentoo Installation
- Tips & Tricks</a> document that might be useful to read as well. If you
- feel that the current installation instructions are too elaborate, feel free
- to use our Quick Installation Guide available from our <a href="/doc/en/index.xml?style=printable">Documentation Resources</a> if your architecture
- has such a document available.
- </p>
- <p>
- You also have several possibilities: you can compile your entire system from
- scratch or use a prebuilt environment to have your Gentoo environment up and
- running in no time. And of course you have intermediate solutions in which you
- don't compile everything but start from a semi-ready system.
- </p>
- <a name="book_id6780645_chap1_sect4"></a><a name="book_part1_chap1__chap1_sect4"></a><p class="secthead">Troubles?</p>
- <p>
- If you find a problem in the installation (or in the installation
- documentation), please visit our <a href="http://bugs.gentoo.org">bugtracking
- system</a> and check if the bug is known. If not, please create a bugreport
- for it so we can take care of it. Do not be afraid of the developers who are
- assigned to (your) bugs -- they generally don't eat people.
- </p>
- <p>
- Note though that, although the document you are now reading is
- architecture-specific, it will contain references to other architectures as
- well. This is due to the fact that large parts of the Gentoo Handbook use source
- code that is common for all architectures (to avoid duplication of efforts and
- starvation of development resources). We will try to keep this to a minimum
- to avoid confusion.
- </p>
- <p>
- If you are uncertain if the problem is a user-problem (some error you
- made despite having read the documentation carefully) or a
- software-problem (some error we made despite having tested the
- installation/documentation carefully) you are free to join #gentoo on
- irc.freenode.net. Of course, you are welcome otherwise too :)
- </p>
- <p>
- If you have a question regarding Gentoo, check out our <a href="/doc/en/faq.xml?style=printable">Frequently Asked Questions</a>, available from the <a href="/doc/en/?style=printable">Gentoo Documentation</a>. You can also view the <a href="http://forums.gentoo.org/viewforum.php?f=40">FAQs</a> on our
- <a href="http://forums.gentoo.org">forums</a>. If you can't find the answer
- there ask on #gentoo, our IRC-channel on irc.freenode.net. Yes, several of
- us are freaks who sit on IRC :-)
- </p>
- <a name="book_part1_chap2"></a><h3>2. Choosing the Right Installation Medium</h3>
- <a name="book_id6780643_chap1"></a><a name="book_part1_chap2__chap1"></a><p class="chaphead"><span class="chapnum">2.a. </span>Hardware Requirements</p>
- <a name="book_id6780643_chap1_sect1"></a><a name="book_part1_chap2__chap1_sect1"></a><p class="secthead">Introduction</p>
- <p>
- Before we start, we first list what hardware requirements you need to
- successfully install Gentoo on your box.
- </p>
- <a name="book_id6780643_chap1_sect2"></a><a name="book_part1_chap2__chap1_sect2"></a><p class="secthead">Hardware Requirements</p>
- <table class="ntable">
- <tr>
- <td class="tableinfo"></td>
- <td class="infohead"><b>Minimal CD</b></td>
- <td class="infohead"><b>LiveCD</b></td>
- </tr>
- <tr>
- <td class="infohead"><b>CPU</b></td>
- <td class="tableinfo">i486 or later</td>
- <td class="tableinfo">
- <b>i686</b> or later</td>
- </tr>
- <tr>
- <td class="infohead"><b>Memory</b></td>
- <td class="tableinfo">64 MB</td>
- <td class="tableinfo">256 MB</td>
- </tr>
- <tr>
- <td class="infohead"><b>Diskspace</b></td>
- <td class="tableinfo" colspan="2">1.5 GB (excluding swap space)</td>
- </tr>
- <tr>
- <td class="infohead"><b>Swap space</b></td>
- <td class="tableinfo" colspan="2">At least 256 MB</td>
- </tr>
- </table>
- <a name="book_id6780643_chap2"></a><a name="book_part1_chap2__chap2"></a><p class="chaphead"><span class="chapnum">2.b. </span>The Gentoo Installation CDs</p>
- <a name="book_id6780643_chap2_sect1"></a><a name="book_part1_chap2__chap2_sect1"></a><p class="secthead">Introduction</p>
- <p>
- The <span class="emphasis">Gentoo Installation CDs</span> are bootable CDs which contain a
- self-sustained Gentoo environment. They allow you to boot Linux from the CD.
- During the boot process your hardware is detected and the appropriate drivers
- are loaded. They are maintained by Gentoo developers.
- </p>
- <p>
- All Installation CDs allow you to boot, set up networking, initialize your
- partitions and start installing Gentoo from the Internet. We currently provide
- two Installation CDs which are equally suitable to install Gentoo from, as long
- as you're planning on performing an Internet-based installation using the
- latest version of the available packages.
- </p>
- <table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#ffffbb"><p class="note"><b>Important: </b>
- If you wish to install Gentoo without a working Internet connection, or would
- like to use one of the provided installers, please use the installation
- instructions described in the <a href="2007.0/?style=printable">Gentoo 2007.0
- Handbooks</a>.
- </p></td></tr></table>
- <p>
- The Installation CDs that we currently provide are:
- </p>
- <ul>
- <li>
- The Gentoo <span class="emphasis">Minimal</span> Installation CD, a small, no-nonsense, bootable
- CD which sole purpose is to boot the system, prepare the networking and
- continue with the Gentoo installation.
- </li>
- <li>
- The Gentoo <span class="emphasis">Installer LiveCD</span> contains everything you need to install
- Gentoo. It provides a graphical environment, a graphical as well as console
- based installer which automatically carries out the installation for you,
- and of course, the installation instructions for your architecture.
- </li>
- </ul>
- <p>
- To help you decide which Installation CD you need, we have written down the
- major advantages and disadvantages of each Installation CD.
- </p>
- <a name="book_id6780643_chap2_sect2"></a><a name="book_part1_chap2__chap2_sect2"></a><p class="secthead">Gentoo Minimal Installation CD</p>
- <p>
- The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
- takes up only 57 MB of diskspace. You can use this
- Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
- connection.
- </p>
- <p>
- The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
- takes up only 57 MB of diskspace. You can use this
- Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
- connection.
- </p>
- <p>
- The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
- takes up only 57 MB of diskspace. You can use this
- Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
- connection.
- </p>
- <p>
- The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
- takes up only 57 MB of diskspace. You can use this
- Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
- connection.
- </p>
- <table class="ntable">
- <tr>
- <td class="infohead"><b>Minimal Installation CD</b></td>
- <td class="infohead"><b>Pros and Cons</b></td>
- </tr>
- <tr>
- <td class="infohead"><b>+</b></td>
- <td class="tableinfo">Smallest download</td>
- </tr>
- <tr>
- <td class="infohead"><b>-</b></td>
- <td class="tableinfo">
- Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and
- is therefore not suitable for networkless installation
- </td>
- </tr>
- </table>
- <a name="book_id6780643_chap2_sect3"></a><a name="book_part1_chap2__chap2_sect3"></a><p class="secthead">Gentoo Installer LiveCD</p>
- <p>
- The Installer LiveCD is called <span class="code" dir="ltr">livecd-i686-installer-2007.0.iso</span> and takes up
- 697 MB. You can use this Installation CD to install
- Gentoo, and you can even use it to install Gentoo without a working internet
- connection, just in case you want to bring Gentoo to another PC than the one
- you are currently installing Gentoo on.
- </p>
- <table class="ntable">
- <tr>
- <td class="infohead"><b>Installer LiveCD</b></td>
- <td class="infohead"><b>Pros and Cons</b></td>
- </tr>
- <tr>
- <td class="infohead"><b>+</b></td>
- <td class="tableinfo">
- Contains everything you need. You can even install without a network
- connection.
- </td>
- </tr>
- <tr>
- <td class="infohead"><b>-</b></td>
- <td class="tableinfo">Huge download</td>
- </tr>
- </table>
- <a name="book_id6780643_chap2_sect4"></a><a name="book_part1_chap2__chap2_sect4"></a><p class="secthead">The Stage3 Tarball</p>
- <p>
- The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
- takes up only 57 MB of diskspace. You can use this
- Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
- connection.
- </p>
- <p>
- The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
- takes up only 57 MB of diskspace. You can use this
- Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
- connection.
- </p>
- <p>
- </p>
- <p>
- A stage3 tarball is an archive containing a minimal Gentoo environment,
- suitable to continue the Gentoo installation using the instructions in this
- manual. Previously, the Gentoo Handbook described the installation using one of
- three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
- official installation method uses the stage3 tarball. If you are interested in
- performing a Gentoo installation using a stage1 or stage2 tarball, please read
- the Gentoo FAQ on <a href="/doc/en/faq.xml?style=printable#stage12">How do I Install Gentoo
- Using a Stage1 or Stage2 Tarball?</a>
- </p>
- <p>
- Stage3 tarballs can be downloaded from <span class="path" dir="ltr">releases/x86/2007.0/stages/</span> on any of the <a href="/main/en/mirrors.xml?style=printable">Official Gentoo Mirrors</a> and are not provided
- on the LiveCD.
- </p>
- <a name="book_id6780643_chap3"></a><a name="book_part1_chap2__chap3"></a><p class="chaphead"><span class="chapnum">2.c. </span>Download, Burn and Boot a Gentoo Installation CD</p>
- <a name="book_id6780643_chap3_sect1"></a><a name="book_part1_chap2__chap3_sect1"></a><p class="secthead">Downloading and Burning the Installation CDs</p>
- <p>
- You have chosen to use a Gentoo Installation CD. We'll first start by
- downloading and burning the chosen Installation CD. We previously discussed
- the several available Installation CDs, but where can you find them?
- </p>
- <p>
- You can download any of the Installation CDs from one of our <a href="/main/en/mirrors.xml?style=printable">mirrors</a>. The Installation CDs are located in
- the <span class="path" dir="ltr">releases/x86/2007.0/installcd/</span> directory.
- </p>
- <p>
- Inside that directory you'll find ISO-files. Those are full CD images which you
- can write on a CD-R.
- </p>
- <p>
- In case you wonder if your downloaded file is corrupted or not, you can check
- its MD5 checksum and compare it with the MD5 checksum we provide (such as
- <span class="path" dir="ltr">install-x86-minimal-2007.0-r1.iso.DIGESTS</span>). You can check the MD5
- checksum with the <span class="code" dir="ltr">md5sum</span> tool under Linux/Unix or <a href="http://www.etree.org/md5com.html">md5sum</a> for Windows.
- </p>
- <p>
- Another way to check the validity of the downloaded file is to use GnuPG to
- verify the cryptographic signature that we provide (the file ending with
- <span class="path" dir="ltr">.asc</span>). Download the signature file and obtain the public key:
- </p>
- <a name="doc_chap_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
- <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 1: Obtaining the public key</p></td></tr>
- <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
- $ <span class="code-input">gpg --keyserver subkeys.pgp.net --recv-keys 17072058</span>
- </pre></td></tr>
- </table>
- <p>
- Now verify the signature:
- </p>
- <a name="doc_chap_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
- <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 2: Verify the cryptographic signature</p></td></tr>
- <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
- $ <span class="code-input">gpg --verify <signature file> <downloaded iso></span>
- </pre></td></tr>
- </table>
- <p>
- To burn the downloaded ISO(s), you have to select raw-burning. How you
- do this is highly program-dependent. We will discuss <span class="code" dir="ltr">cdrecord</span> and
- <span class="code" dir="ltr">K3B</span> here; more information can be found in our <a href="/doc/en/faq.xml?style=printable#isoburning">Gentoo FAQ</a>.
- </p>
- <ul>
- <li>
- With cdrecord, you simply type <span class="code" dir="ltr">cdrecord dev=/dev/hdc <downloaded iso
- file></span> (replace <span class="path" dir="ltr">/dev/hdc</span> with your CD-RW drive's
- device path).
- </li>
- <li>
- With K3B, select <span class="code" dir="ltr">Tools</span> > <span class="code" dir="ltr">Burn CD Image</span>. Then you can locate
- your ISO file within the 'Image to Burn' area. Finally click <span class="code" dir="ltr">Start</span>.
- </li>
- </ul>
- <a name="book_id6780643_chap3_sect2"></a><a name="book_part1_chap2__chap3_sect2"></a><p class="secthead">Booting the Installation CD</p>
- <p>
- Once you have burnt your installation CD, it is time to boot it.
- Remove all CDs from your CD drives, reboot your system and enter the BIOS.
- This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside
- the BIOS, change the boot order so that the CD-ROM is tried before the hard
- disk. This is often found under "CMOS Setup". If you don't do this, your system
- will just reboot from the hard disk, ignoring the CD-ROM.
- </p>
- <p>
- Now place the installation CD in the CD-ROM drive and reboot. You should see a
- boot prompt. At this screen, you can hit Enter to begin the boot process with
- the default boot options, or boot the Installation CD with custom boot options
- by specifying a kernel followed by boot options and then hitting Enter.
- </p>
- <p>
- Specifying a kernel? Yes, we provide several kernels on our Installation CDs.
- The default one is <span class="code" dir="ltr">gentoo</span>. Other kernels are for specific hardware needs
- and the <span class="code" dir="ltr">-nofb</span> variants which disable framebuffer.
- </p>
- <p>
- Below you'll find a short overview on the available kernels:
- </p>
- <table class="ntable">
- <tr>
- <td class="infohead"><b>Kernel</b></td>
- <td class="infohead"><b>Description</b></td>
- </tr>
- <tr>
- <td class="tableinfo">gentoo</td>
- <td class="tableinfo">Default 2.6 kernel with support for multiple CPUs</td>
- </tr>
- <tr>
- <td class="tableinfo">gentoo-nofb</td>
- <td class="tableinfo">Same as <span class="code" dir="ltr">gentoo</span> but without framebuffer support</td>
- </tr>
- <tr>
- <td class="tableinfo">memtest86</td>
- <td class="tableinfo">Test your local RAM for errors</td>
- </tr>
- </table>
- <p>
- You can also provide kernel options. They represent optional settings you can
- (de)activate at will. The following list is the same as the one you receive
- when you press F2 at the bootscreen.
- </p>
- <a name="doc_chap_pre3"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
- <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 3: Options available to pass to your kernel of choice</p></td></tr>
- <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
- - agpgart loads agpgart (use if you have graphic problems,lockups)
- - acpi=on loads support for ACPI firmware
- - ide=nodma force disabling of DMA for malfunctioning IDE devices
- - doscsi scan for scsi devices (breaks some ethernet cards)
- - dopcmcia starts pcmcia service for PCMCIA cdroms
- - nofirewire disables firewire modules in initrd (for firewire cdroms,etc)
- - nokeymap disables keymap selection for non-us keyboard layouts
- - docache cache the entire runtime portion of cd in RAM, allows you
- to umount /mnt/cdrom to mount another cdrom.
- - nodetect causes hwsetup/kudzu and hotplug not to run
- - nousb disables usb module load from initrd, disables hotplug
- - nodhcp dhcp does not automatically start if nic detected
- - nohotplug disables loading hotplug service
- - noapic disable apic (try if having hardware problems nics,scsi,etc)
- - noevms disable loading of EVMS2 modules
- - nolvm2 disable loading of LVM2 modules
- - hdx=stroke allows you to partition the whole harddrive even when your BIOS
- can't handle large harddrives
- - noload=module1,[module2,[...]]
- disable loading of specific kernel modules
- </pre></td></tr>
- </table>
- <p>
- Now boot your CD, select a kernel (if you are not happy with the default
- <span class="code" dir="ltr">gentoo</span> kernel) and boot options. As an example, we show you how
- to boot the <span class="code" dir="ltr">gentoo</span> kernel, with <span class="code" dir="ltr">dopcmcia</span> as kernel
- parameters:
- </p>
- <a name="doc_chap_pre4"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
- <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 4: Booting an Installation CD</p></td></tr>
- <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
- boot: <span class="code-input">gentoo dopcmcia</span>
- </pre></td></tr>
- </table>
- <p>
- You will then be greeted with a boot screen and progress bar. If you are
- installing Gentoo on a system with a non-US keyboard, make sure you immediately
- press Alt-F1 to switch to verbose mode and follow the prompt. If no selection
- is made in 10 seconds the default (US keyboard) will be accepted and the boot
- process will continue. Once the boot process completes, you will be
- automatically logged in to the "Live" Gentoo Linux as "root", the super user.
- You should have a root ("#") prompt on the current console and can also switch
- to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one
- you started on by pressing Alt-F1.
- </p>
- <p>
- Now continue with <a href="#hardware">Extra Hardware Configuration</a>.
- </p>
- <a name="book_id6780643_chap3_sect3"></a><a name="book_part1_chap2__chap3_sect3"></a><a name="hardware"></a><p class="secthead">Extra Hardware Configuration</p>
- <p>
- When the Installation CD boots, it tries to detect all your hardware devices
- and loads the appropriate kernel modules to support your hardware. In the vast
- majority of cases, it does a very good job. However, in some cases it may not
- auto-load the kernel modules you need. If the PCI auto-detection missed some of
- your system's hardware, you will have to load the appropriate kernel modules
- manually.
- </p>
- <p>
- In the next example we try to load the <span class="code" dir="ltr">8139too</span> module (support for
- certain kinds of network interfaces):
- </p>
- <a name="doc_chap_pre5"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
- <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 5: Loading kernel modules</p></td></tr>
- <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
- # <span class="code-input">modprobe 8139too</span>
- </pre></td></tr>
- </table>
- <a name="book_id6780643_chap3_sect4"></a><a name="book_part1_chap2__chap3_sect4"></a><p class="secthead">Optional: Tweaking Hard Disk Performance</p>
- <p>
- If you are an advanced user, you might want to tweak the IDE hard disk
- performance using <span class="code" dir="ltr">hdparm</span>. With the <span class="code" dir="ltr">-tT</span> options you can
- test the performance of your disk (execute it several times to get a
- more precise impression):
- </p>
- <a name="doc_chap_pre6"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
- <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 6: Testing disk performance</p></td></tr>
- <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
- # <span class="code-input">hdparm -tT /dev/hda</span>
- </pre></td></tr>
- </table>
- <p>
- To tweak, you can use any of the following examples (or experiment
- yourself) which use <span class="path" dir="ltr">/dev/hda</span> as disk (substitute with your
- disk):
- </p>
- <a name="doc_chap_pre7"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
- <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 7: Tweaking hard disk performance</p></td></tr>
- <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
- <span class="code-comment">(Activate DMA:)</span>
- # <span class="code-input">hdparm -d 1 /dev/hda</span>
- <span class="code-comment">(Activate Safe Performa