PageRenderTime 925ms CodeModel.GetById 17ms RepoModel.GetById 0ms app.codeStats 0ms

/projects/netbeans-7.3/html.editor.lib/test/unit/data/testfiles/syntaxtree/big.html

https://gitlab.com/essere.lab.public/qualitas.class-corpus
HTML | 941 lines | 847 code | 94 blank | 0 comment | 0 complexity | 729fa299ec6ddef8d74f2ffff85f67c9 MD5 | raw file
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html lang="en">
  3. <head>
  4. <title>Gentoo Linux Documentation</title>
  5. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  6. <link title="new" rel="stylesheet" href="../../../css/main.css" type="text/css">
  7. <link REL="shortcut icon" HREF="../../../favicon.ico" TYPE="image/x-icon">
  8. <link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/www-gentoo-org.xml" title="Gentoo Website">
  9. <link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/forums-gentoo-org.xml" title="Gentoo Forums">
  10. <link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/bugs-gentoo-org.xml" title="Gentoo Bugzilla">
  11. <link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/archives-gentoo-org.xml" title="Gentoo List Archives">
  12. --
  13. </head>
  14. <body bgcolor="#ffffff">
  15. <h1>Gentoo Linux x86 Handbook</h1>
  16. <a href="mailto:swift@gentoo.org" class="altlink"><b>Sven Vermeulen</b></a>
  17. <i>Author</i><br>
  18. <a href="mailto:g2boojum@gentoo.org" class="altlink"><b>Grant Goodyear</b></a>
  19. <i>Author</i><br>
  20. <a href="mailto:uberlord@gentoo.org" class="altlink"><b>Roy Marples</b></a>
  21. <i>Author</i><br>
  22. <a href="mailto:drobbins.daniel@gmail.com" class="altlink"><b>Daniel Robbins</b></a>
  23. <i>Author</i><br>
  24. <a href="mailto:chouser@bluweb.com" class="altlink"><b>Chris Houser</b></a>
  25. <i>Author</i><br>
  26. <a href="mailto:jalexand@wlgore.com" class="altlink"><b>Jerry Alexandratos</b></a>
  27. <i>Author</i><br>
  28. <a href="mailto:seemant@gentoo.org" class="altlink"><b>Seemant Kulleen</b></a>
  29. <i>Gentoo x86 Developer</i><br>
  30. <a href="mailto:taviso@gentoo.org" class="altlink"><b>Tavis Ormandy</b></a>
  31. <i>Gentoo Alpha Developer</i><br>
  32. Jason Huebel
  33. <i>Gentoo AMD64 Developer</i><br>
  34. <a href="mailto:gmsoft@gentoo.org" class="altlink"><b>Guy Martin</b></a>
  35. <i>Gentoo HPPA developer</i><br>
  36. <a href="mailto:pvdabeel@gentoo.org" class="altlink"><b>Pieter Van den Abeele</b></a>
  37. <i>Gentoo PPC developer</i><br>
  38. <a href="mailto:jkallar@yahoo.com" class="altlink"><b>Joe Kallar</b></a>
  39. <i>Gentoo SPARC developer</i><br>
  40. <a href="mailto:john_davis@pauldavisautomation.com" class="altlink"><b>John P. Davis</b></a>
  41. <i>Editor</i><br>Pierre-Henri Jondot <i>Editor</i><br>
  42. <a href="mailto:stocke2@gmail.com" class="altlink"><b>Eric Stockbridge</b></a>
  43. <i>Editor</i><br>
  44. <a href="mailto:rajiv@gentoo.org" class="altlink"><b>Rajiv Manglani</b></a>
  45. <i>Editor</i><br>
  46. <a href="mailto:seo@gentoo.or.kr" class="altlink"><b>Jungmin Seo</b></a>
  47. <i>Editor</i><br>
  48. <a href="mailto:zhware@hotpop.com" class="altlink"><b>Stoyan Zhekov</b></a>
  49. <i>Editor</i><br>
  50. Jared Hudson
  51. <i>Editor</i><br>
  52. <a href="mailto:peitolm@gentoo.org" class="altlink"><b>Colin Morey</b></a>
  53. <i>Editor</i><br>
  54. Jorge Paulo
  55. <i>Editor</i><br>
  56. <a href="mailto:canderson@wayne.edu" class="altlink"><b>Carl Anderson</b></a>
  57. <i>Editor</i><br>
  58. <a href="mailto:avenj@tellink.net" class="altlink"><b>Jon Portnoy</b></a>
  59. <i>Editor</i><br>
  60. Zack Gilburd
  61. <i>Editor</i><br>
  62. <a href="mailto:jack@bonyari.com" class="altlink"><b>Jack Morgan</b></a>
  63. <i>Editor</i><br>
  64. <a href="mailto:benny@coolbee.net" class="altlink"><b>Benny Chuang</b></a>
  65. <i>Editor</i><br>
  66. <a href="mailto:erw1n@pmail.ntu.edu.sg" class="altlink"><b>Erwin</b></a>
  67. <i>Editor</i><br>
  68. <a href="mailto:kumba@gentoo.org" class="altlink"><b>Joshua Kinard</b></a>
  69. <i>Editor</i><br>
  70. <a href="mailto:dertobi123@gentoo.org" class="altlink"><b>Tobias Scherbaum</b></a>
  71. <i>Editor</i><br>
  72. <a href="mailto:neysx@gentoo.org" class="altlink"><b>Xavier Neys</b></a>
  73. <i>Editor</i><br>
  74. <a href="mailto:nightmorph@gentoo.org" class="altlink"><b>Joshua Saddler</b></a>
  75. <i>Editor</i><br>
  76. Gerald J. Normandin Jr.
  77. <i>Reviewer</i><br>
  78. <a href="mailto:dberkholz@gentoo.org" class="altlink"><b>Donnie Berkholz</b></a>
  79. <i>Reviewer</i><br>
  80. <a href="mailto:drake_stuff@yahoo.com" class="altlink"><b>Ken Nowack</b></a>
  81. <i>Reviewer</i><br>
  82. <a href="mailto:pylon@gentoo.org" class="altlink"><b>Lars Weiler</b></a>
  83. <i>Contributor</i><br><br><i>Updated November 27, 2007</i><p>Content:</p>
  84. <ul>
  85. <li>
  86. <b><a href="#book_part1">Installing Gentoo</a></b><br>
  87. In this part you learn how to install Gentoo on your system.
  88. <ol>
  89. <li>
  90. <b><a href="#book_part1_chap1">About the Gentoo Linux Installation</a></b><br>
  91. This chapter introduces you to the installation approach documented in this
  92. handbook.
  93. </li>
  94. <li>
  95. <b><a href="#book_part1_chap2">Choosing the Right Installation Medium</a></b><br>
  96. You can install Gentoo in many ways. This chapter explains how to install
  97. Gentoo using the minimal Installation CD although installation through the
  98. Installer LiveCD is possible as well.
  99. </li>
  100. <li>
  101. <b><a href="#book_part1_chap3">Configuring your Network</a></b><br>
  102. To be able to download the latest source code, you will need to setup
  103. networking.
  104. </li>
  105. <li>
  106. <b><a href="#book_part1_chap4">Preparing the Disks</a></b><br>
  107. To be able to install Gentoo, you must create the necessary partitions.
  108. This chapter describes how to partition a disk for future usage.
  109. </li>
  110. <li>
  111. <b><a href="#book_part1_chap5">Installing the Gentoo Installation Files</a></b><br>
  112. Gentoo installs work through a stage3 archive. In this chapter we
  113. describe how you extract the stage3 archive and configure Portage.
  114. </li>
  115. <li>
  116. <b><a href="#book_part1_chap6">Installing the Gentoo Base System</a></b><br>
  117. After installing and configuring a stage3, the eventual result is that you
  118. have a Gentoo base system at your disposal. This chapter describes how
  119. to progress to that state.
  120. </li>
  121. <li>
  122. <b><a href="#book_part1_chap7">Configuring the Kernel</a></b><br>
  123. The Linux kernel is the core of every distribution. This chapter
  124. explains how to configure your kernel.
  125. </li>
  126. <li>
  127. <b><a href="#book_part1_chap8">Configuring your System</a></b><br>
  128. You need to edit some important configuration files. In this chapter
  129. you receive an overview of these files and an explanation on how to
  130. proceed.
  131. </li>
  132. <li>
  133. <b><a href="#book_part1_chap9">Installing Necessary System Tools</a></b><br>
  134. In this chapter we help you choose and install some important tools.
  135. </li>
  136. <li>
  137. <b><a href="#book_part1_chap10">Configuring the Bootloader</a></b><br>
  138. Several bootloaders exist for the x86 architecture. Each one of them has its
  139. own way of configuration. We step you through the process of configuring a
  140. bootloader to your needs.
  141. </li>
  142. <li>
  143. <b><a href="#book_part1_chap11">Finalizing your Gentoo Installation</a></b><br>
  144. You're almost done. We'll just create one (or more) users for your
  145. system.
  146. </li>
  147. <li>
  148. <b><a href="#book_part1_chap12">Where to go from here?</a></b><br>
  149. Now you have your Gentoo system, but what's next?
  150. </li>
  151. </ol>
  152. </li>
  153. <li>
  154. <b><a href="#book_part2">Working with Gentoo</a></b><br>
  155. Learn how to work with Gentoo: installing software, altering variables, changing
  156. Portage behaviour etc.
  157. <ol>
  158. <li>
  159. <b><a href="#book_part2_chap1">A Portage Introduction</a></b><br>
  160. This chapter explains the "simple" steps a user definitely needs to know to
  161. maintain the software on his system.
  162. </li>
  163. <li>
  164. <b><a href="#book_part2_chap2">USE flags</a></b><br>
  165. USE flags are a very important aspect of Gentoo. In this chapter, you learn to
  166. work with USE flags and understand how USE flags interact with your system.
  167. </li>
  168. <li>
  169. <b><a href="#book_part2_chap2">USE flags</a></b><br>
  170. USE flags are a very important aspect of Gentoo. In this chapter, you learn to
  171. work with USE flags and understand how USE flags interact with your system.
  172. </li>
  173. <li>
  174. <b><a href="#book_part2_chap2">USE flags</a></b><br>
  175. USE flags are a very important aspect of Gentoo. In this chapter, you learn to
  176. work with USE flags and understand how USE flags interact with your system.
  177. </li>
  178. <li>
  179. </li>
  180. <li>
  181. <b><a href="#book_part2_chap3">Portage Features</a></b><br>
  182. Discover the features Portage has, such as support for distributed compiling,
  183. ccache and more.
  184. </li>
  185. <li>
  186. <b><a href="#book_part2_chap3">Portage Features</a></b><br>
  187. Discover the features Portage has, such as support for distributed compiling,
  188. ccache and more.
  189. </li>
  190. <li>
  191. <b><a href="#book_part2_chap4">Initscripts</a></b><br>
  192. Gentoo uses a special initscript format which, amongst other features, allows
  193. dependency-driven decisions and virtual initscripts. This chapter explains all
  194. these aspects and explains how to deal with these scripts.
  195. </li>
  196. <li>
  197. <b><a href="#book_part2_chap5">Environment Variables</a></b><br>
  198. With Gentoo you can easily manage the environment variables for your system.
  199. This chapter explains how you do that, and also describes frequently used
  200. variables.
  201. </li>
  202. </ol>
  203. </li>
  204. <li>
  205. <b><a href="#book_part3">Working with Portage</a></b><br>
  206. "Working with Portage" provides an in-depth coverage of Portage, Gentoo's
  207. Software Management Tool.
  208. <ol>
  209. <li>
  210. <b><a href="#book_part3_chap1">Files and Directories</a></b><br>
  211. Once you want to know Portage in-depth you need to know where it stores its
  212. files and data.
  213. </li>
  214. <li>
  215. <b><a href="#book_part3_chap2">Configuring through Variables</a></b><br>
  216. Portage is completely configurable through various variables you can set in the
  217. configuration file or as environment variable.
  218. </li>
  219. <li>
  220. <b><a href="#book_part3_chap3">Mixing Software Branches</a></b><br>
  221. Gentoo provides software separated in several branches, depending on stability
  222. and architectural support. "Mixing Software Branches" inform you how these
  223. branches can be configured and how you can override this separation
  224. individually.
  225. </li>
  226. <li>
  227. <b><a href="#book_part3_chap4">Additional Portage Tools</a></b><br>
  228. Portage comes with a few extra tools that might make your Gentoo experience even
  229. better. Read on to discover how to use dispatch-conf and other tools.
  230. </li>
  231. <li>
  232. <b><a href="#book_part3_chap5">Diverting from the Official Tree</a></b><br>
  233. "Diverting from the Official Tree" gives you some tips and tricks on how to use
  234. your own Portage tree, how to synchronise only the categories you want, inject
  235. packages and more.
  236. </li>
  237. </ol>
  238. </li>
  239. <li>
  240. <b><a href="#book_part4">Gentoo Network Configuration</a></b><br>A comprehensive guide to Networking in Gentoo.<ol>
  241. <li>
  242. <b><a href="#book_part4_chap1">Getting Started</a></b><br>
  243. A guide to quickly get your network interface up and running in most common
  244. environments.
  245. </li>
  246. <li>
  247. <b><a href="#book_part4_chap2">Advanced Configuration</a></b><br>
  248. Here we learn about how the configuration works - you need to know this
  249. before we learn about modular networking.
  250. </li>
  251. <li>
  252. <b><a href="#book_part4_chap3">Modular Networking</a></b><br>
  253. Gentoo provides you flexible networking - here you are told about choosing
  254. different DHCP clients, setting up bonding, bridging, VLANs and more.
  255. </li>
  256. <li>
  257. <b>
  258. <a href="#book_part4_chap4">Wireless Networking</a></b><br>
  259. Wireless isn't straightforward. Hopefully we'll get you working!
  260. </li>
  261. <li>
  262. <b><a href="#book_part4_chap5">Adding Functionality</a></b><br>
  263. If you're feeling adventurous, you can add your own functions to networking.
  264. </li>
  265. <li>
  266. <b><a href="#book_part4_chap6">Network Management</a></b><br>
  267. For laptop users or people who move their computer around different networks.
  268. </li>
  269. </ol>
  270. </li>
  271. </ul>
  272. <a name="book_part1"></a><h2>A. Installing Gentoo</h2>
  273. <a name="book_part1_chap1"></a><h3>1. About the Gentoo Linux Installation</h3>
  274. <a name="book_id6780645_chap1"></a><a name="book_part1_chap1__chap1"></a><p class="chaphead"><span class="chapnum">1.a. </span>Introduction</p>
  275. <a name="book_id6780645_chap1_sect1"></a><a name="book_part1_chap1__chap1_sect1"></a><p class="secthead">Welcome!</p>
  276. <p>
  277. First of all, <span class="emphasis">welcome</span> to Gentoo. You are about to enter the world
  278. of choices and performance. Gentoo is all about choices. When
  279. installing Gentoo, this is made clear to you several times -- you can
  280. choose how much you want to compile yourself, how to install Gentoo,
  281. what system logger you want, etc.
  282. </p>
  283. <p>
  284. First of all, <span class="emphasis">welcome</span> to Gentoo. You are about to enter the world
  285. of choices and performance. Gentoo is all about choices. When
  286. installing Gentoo, this is made clear to you several times -- you can
  287. choose how much you want to compile yourself, how to install Gentoo,
  288. what system logger you want, etc.
  289. <a>
  290. hallo!
  291. this is big <span style="color:red">FILE!!!</span>
  292. this is no so BIG <span style="color:green">
  293. FF!
  294. </span>
  295. </a>
  296. </p>
  297. <a name="book_part1"></a><h2>A. Installing Gentoo</h2>
  298. <a name="book_part1"></a><h2>A. Installing Gentoo</h2>
  299. <a name="book_part1_chap1"></a><h3>1. About the Gentoo Linux Installation</h3>
  300. <a name="book_id6780645_chap1"></a><a name="book_part1_chap1__chap1"></a><p class="chaphead"><span class="chapnum">1.a. </span>Introduction</p>
  301. <a name="book_id6780645_chap1_sect1"></a><a name="book_part1_chap1__chap1_sect1"></a><p class="secthead">Welcome!</p>
  302. <p>
  303. Gentoo is a fast, modern metadistribution with a clean and flexible
  304. design. Gentoo is built around free software and doesn't hide from its
  305. users what is beneath the hood. Portage, the package maintenance system
  306. which Gentoo uses, is written in Python, meaning you can easily view and
  307. modify the source code. Gentoo's packaging system uses source code
  308. (although support for precompiled packages is included too) and
  309. configuring Gentoo happens through regular textfiles. In other words,
  310. openness everywhere.
  311. </p>
  312. <p>
  313. Gentoo is a fast, modern metadistribution with a clean and flexible
  314. design. Gentoo is built around free software and doesn't hide from its
  315. users what is beneath the hood. Portage, the package maintenance system
  316. which Gentoo uses, is written in Python, meaning you can easily view and
  317. modify the source code. Gentoo's packaging system uses source code
  318. (although support for precompiled packages is included too) and
  319. configuring Gentoo happens through regular textfiles. In other words,
  320. openness everywhere.
  321. </p>
  322. <p>
  323. When you are given a certain choice, we try our best to explain what the pros
  324. and cons are. We will continue then with a default
  325. choice, identified by "Default: " in the title. The other
  326. possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
  327. this is OK.....
  328. possibilities are marked by "Alternative: ". Do
  329. <span class="emphasis" style="color:green">
  330. not
  331. </span>
  332. it works well
  333. think that the default is what we recommend. It is however what we
  334. believe most users will use.
  335. </p>
  336. <p>
  337. When you are given a certain choice, we try our best to explain what the pros
  338. and cons are. We will continue then with a default
  339. choice, identified by "Default: " in the title. The other
  340. possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
  341. this is OK.....
  342. it works well
  343. think that the default is what we recommend. It is however what we
  344. believe most users will use.
  345. </p>
  346. <p>
  347. When you are given a certain choice, we try our best to explain what the pros
  348. and cons are. We will continue then with a default
  349. choice, identified by "Default: " in the title. The other
  350. possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
  351. this is OK.....
  352. it works well
  353. think that the default is what we recommend. It is however what we
  354. believe most users will use.
  355. </p>
  356. <p>
  357. When you are given a certain choice, we try our best to explain what the pros
  358. and cons are. We will continue then with a default
  359. choice, identified by "Default: " in the title. The other
  360. possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
  361. this is OK.....
  362. it works well
  363. think that the default is what we recommend. It is however what we
  364. believe most users will use.
  365. </p>
  366. <p>
  367. It is very important that you understand that <span class="emphasis">choices</span> are what
  368. makes Gentoo run. We try not to force you onto anything you don't like.
  369. If you feel like we do, please <a href="http://bugs.gentoo.org">bugreport</a> it.
  370. </p>
  371. <a name="book_id6780645_chap1_sect2"></a><a name="book_part1_chap1__chap1_sect2"></a><p class="secthead">How is the Installation Structured?</p>
  372. <p>
  373. The Gentoo Installation can be seen as a 10-step procedure,
  374. corresponding to chapters 2 - 11. Every step results in
  375. a certain state:
  376. </p>
  377. <ul>
  378. <li>
  379. After step 1, you are in a working environment ready to install Gentoo
  380. </li>
  381. <li>
  382. After step 2, your internet connection is ready to install Gentoo
  383. </li>
  384. <li>
  385. After step 3, your hard disks are initialized to house your Gentoo
  386. installation
  387. </li>
  388. <li>
  389. After step 4, your installation environment is prepared and you are
  390. ready to chroot into the new environment
  391. </li>
  392. <li>
  393. After step 5, core packages, which are the same on all Gentoo
  394. installations, are installed
  395. </li>
  396. <li>
  397. After step 6, you have compiled your Linux kernel
  398. </li>
  399. <li>
  400. After step 7, you have written most of your Gentoo system
  401. configuration files
  402. </li>
  403. <li>
  404. After step 8, necessary system tools (which you can choose from a nice
  405. list) are installed
  406. </li>
  407. <li>
  408. After step 9, your choice of bootloader has been installed and
  409. configured and you are logged in into your new Gentoo installation
  410. </li>
  411. <li>
  412. After step 10, your Gentoo Linux environment is ready to be explored
  413. </li>
  414. </ul>
  415. <p>
  416. When you are given a certain choice, we try our best to explain what the pros
  417. and cons are. We will continue then with a default
  418. choice, identified by "Default: " in the title. The other
  419. possibilities are marked by "Alternative: ". Do <span class="emphasis">not</span>
  420. think that the default is what we recommend. It is however what we
  421. believe most users will use.
  422. </p>
  423. <p>
  424. Sometimes you can pursue an optional step. Such steps are marked as
  425. "Optional: " and are therefore not needed to install Gentoo.
  426. However, some optional steps are dependant on a previous decision you
  427. made. We will inform you when this happens, both when you make the
  428. decision, and right before the optional step is described.
  429. </p>
  430. <a name="book_id6780645_chap1_sect3"></a><a name="book_part1_chap1__chap1_sect3"></a><p class="secthead">What are my Options?</p>
  431. <p></p>
  432. <p>
  433. Also note that, if you plan on using GRP (the Gentoo Reference Platform, a
  434. collection of prebuilt packages meant for immediate use after a Gentoo
  435. 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>.
  436. </p>
  437. <p>
  438. For help on the other installation approaches, please read our <a href="/doc/en/altinstall.xml?style=printable">Alternative Installation Guide</a>. We also
  439. provide a <a href="/doc/en/gentoo-x86-tipsntricks.xml?style=printable">Gentoo Installation
  440. Tips &amp; Tricks</a> document that might be useful to read as well. If you
  441. feel that the current installation instructions are too elaborate, feel free
  442. to use our Quick Installation Guide available from our <a href="/doc/en/index.xml?style=printable">Documentation Resources</a> if your architecture
  443. has such a document available.
  444. </p>
  445. <p>
  446. You also have several possibilities: you can compile your entire system from
  447. scratch or use a prebuilt environment to have your Gentoo environment up and
  448. running in no time. And of course you have intermediate solutions in which you
  449. don't compile everything but start from a semi-ready system.
  450. </p>
  451. <a name="book_id6780645_chap1_sect4"></a><a name="book_part1_chap1__chap1_sect4"></a><p class="secthead">Troubles?</p>
  452. <p>
  453. If you find a problem in the installation (or in the installation
  454. documentation), please visit our <a href="http://bugs.gentoo.org">bugtracking
  455. system</a> and check if the bug is known. If not, please create a bugreport
  456. for it so we can take care of it. Do not be afraid of the developers who are
  457. assigned to (your) bugs -- they generally don't eat people.
  458. </p>
  459. <p>
  460. Note though that, although the document you are now reading is
  461. architecture-specific, it will contain references to other architectures as
  462. well. This is due to the fact that large parts of the Gentoo Handbook use source
  463. code that is common for all architectures (to avoid duplication of efforts and
  464. starvation of development resources). We will try to keep this to a minimum
  465. to avoid confusion.
  466. </p>
  467. <p>
  468. If you are uncertain if the problem is a user-problem (some error you
  469. made despite having read the documentation carefully) or a
  470. software-problem (some error we made despite having tested the
  471. installation/documentation carefully) you are free to join #gentoo on
  472. irc.freenode.net. Of course, you are welcome otherwise too :)
  473. </p>
  474. <p>
  475. 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
  476. <a href="http://forums.gentoo.org">forums</a>. If you can't find the answer
  477. there ask on #gentoo, our IRC-channel on irc.freenode.net. Yes, several of
  478. us are freaks who sit on IRC :-)
  479. </p>
  480. <a name="book_part1_chap2"></a><h3>2. Choosing the Right Installation Medium</h3>
  481. <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>
  482. <a name="book_id6780643_chap1_sect1"></a><a name="book_part1_chap2__chap1_sect1"></a><p class="secthead">Introduction</p>
  483. <p>
  484. Before we start, we first list what hardware requirements you need to
  485. successfully install Gentoo on your box.
  486. </p>
  487. <a name="book_id6780643_chap1_sect2"></a><a name="book_part1_chap2__chap1_sect2"></a><p class="secthead">Hardware Requirements</p>
  488. <table class="ntable">
  489. <tr>
  490. <td class="tableinfo"></td>
  491. <td class="infohead"><b>Minimal CD</b></td>
  492. <td class="infohead"><b>LiveCD</b></td>
  493. </tr>
  494. <tr>
  495. <td class="infohead"><b>CPU</b></td>
  496. <td class="tableinfo">i486 or later</td>
  497. <td class="tableinfo">
  498. <b>i686</b> or later</td>
  499. </tr>
  500. <tr>
  501. <td class="infohead"><b>Memory</b></td>
  502. <td class="tableinfo">64 MB</td>
  503. <td class="tableinfo">256 MB</td>
  504. </tr>
  505. <tr>
  506. <td class="infohead"><b>Diskspace</b></td>
  507. <td class="tableinfo" colspan="2">1.5 GB (excluding swap space)</td>
  508. </tr>
  509. <tr>
  510. <td class="infohead"><b>Swap space</b></td>
  511. <td class="tableinfo" colspan="2">At least 256 MB</td>
  512. </tr>
  513. </table>
  514. <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>
  515. <a name="book_id6780643_chap2_sect1"></a><a name="book_part1_chap2__chap2_sect1"></a><p class="secthead">Introduction</p>
  516. <p>
  517. The <span class="emphasis">Gentoo Installation CDs</span> are bootable CDs which contain a
  518. self-sustained Gentoo environment. They allow you to boot Linux from the CD.
  519. During the boot process your hardware is detected and the appropriate drivers
  520. are loaded. They are maintained by Gentoo developers.
  521. </p>
  522. <p>
  523. All Installation CDs allow you to boot, set up networking, initialize your
  524. partitions and start installing Gentoo from the Internet. We currently provide
  525. two Installation CDs which are equally suitable to install Gentoo from, as long
  526. as you're planning on performing an Internet-based installation using the
  527. latest version of the available packages.
  528. </p>
  529. <table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#ffffbb"><p class="note"><b>Important: </b>
  530. If you wish to install Gentoo without a working Internet connection, or would
  531. like to use one of the provided installers, please use the installation
  532. instructions described in the <a href="2007.0/?style=printable">Gentoo 2007.0
  533. Handbooks</a>.
  534. </p></td></tr></table>
  535. <p>
  536. The Installation CDs that we currently provide are:
  537. </p>
  538. <ul>
  539. <li>
  540. The Gentoo <span class="emphasis">Minimal</span> Installation CD, a small, no-nonsense, bootable
  541. CD which sole purpose is to boot the system, prepare the networking and
  542. continue with the Gentoo installation.
  543. </li>
  544. <li>
  545. The Gentoo <span class="emphasis">Installer LiveCD</span> contains everything you need to install
  546. Gentoo. It provides a graphical environment, a graphical as well as console
  547. based installer which automatically carries out the installation for you,
  548. and of course, the installation instructions for your architecture.
  549. </li>
  550. </ul>
  551. <p>
  552. To help you decide which Installation CD you need, we have written down the
  553. major advantages and disadvantages of each Installation CD.
  554. </p>
  555. <a name="book_id6780643_chap2_sect2"></a><a name="book_part1_chap2__chap2_sect2"></a><p class="secthead">Gentoo Minimal Installation CD</p>
  556. <p>
  557. The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
  558. takes up only 57 MB of diskspace. You can use this
  559. Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
  560. connection.
  561. </p>
  562. <p>
  563. The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
  564. takes up only 57 MB of diskspace. You can use this
  565. Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
  566. connection.
  567. </p>
  568. <p>
  569. The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
  570. takes up only 57 MB of diskspace. You can use this
  571. Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
  572. connection.
  573. </p>
  574. <p>
  575. The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
  576. takes up only 57 MB of diskspace. You can use this
  577. Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
  578. connection.
  579. </p>
  580. <table class="ntable">
  581. <tr>
  582. <td class="infohead"><b>Minimal Installation CD</b></td>
  583. <td class="infohead"><b>Pros and Cons</b></td>
  584. </tr>
  585. <tr>
  586. <td class="infohead"><b>+</b></td>
  587. <td class="tableinfo">Smallest download</td>
  588. </tr>
  589. <tr>
  590. <td class="infohead"><b>-</b></td>
  591. <td class="tableinfo">
  592. Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and
  593. is therefore not suitable for networkless installation
  594. </td>
  595. </tr>
  596. </table>
  597. <a name="book_id6780643_chap2_sect3"></a><a name="book_part1_chap2__chap2_sect3"></a><p class="secthead">Gentoo Installer LiveCD</p>
  598. <p>
  599. The Installer LiveCD is called <span class="code" dir="ltr">livecd-i686-installer-2007.0.iso</span> and takes up
  600. 697 MB. You can use this Installation CD to install
  601. Gentoo, and you can even use it to install Gentoo without a working internet
  602. connection, just in case you want to bring Gentoo to another PC than the one
  603. you are currently installing Gentoo on.
  604. </p>
  605. <table class="ntable">
  606. <tr>
  607. <td class="infohead"><b>Installer LiveCD</b></td>
  608. <td class="infohead"><b>Pros and Cons</b></td>
  609. </tr>
  610. <tr>
  611. <td class="infohead"><b>+</b></td>
  612. <td class="tableinfo">
  613. Contains everything you need. You can even install without a network
  614. connection.
  615. </td>
  616. </tr>
  617. <tr>
  618. <td class="infohead"><b>-</b></td>
  619. <td class="tableinfo">Huge download</td>
  620. </tr>
  621. </table>
  622. <a name="book_id6780643_chap2_sect4"></a><a name="book_part1_chap2__chap2_sect4"></a><p class="secthead">The Stage3 Tarball</p>
  623. <p>
  624. The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
  625. takes up only 57 MB of diskspace. You can use this
  626. Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
  627. connection.
  628. </p>
  629. <p>
  630. The Minimal Installation CD is called <span class="code" dir="ltr">install-x86-minimal-2007.0-r1.iso</span> and
  631. takes up only 57 MB of diskspace. You can use this
  632. Installation CD to install Gentoo, but <span class="emphasis">only</span> with a working Internet
  633. connection.
  634. </p>
  635. <p>
  636. </p>
  637. <p>
  638. A stage3 tarball is an archive containing a minimal Gentoo environment,
  639. suitable to continue the Gentoo installation using the instructions in this
  640. manual. Previously, the Gentoo Handbook described the installation using one of
  641. three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
  642. official installation method uses the stage3 tarball. If you are interested in
  643. performing a Gentoo installation using a stage1 or stage2 tarball, please read
  644. the Gentoo FAQ on <a href="/doc/en/faq.xml?style=printable#stage12">How do I Install Gentoo
  645. Using a Stage1 or Stage2 Tarball?</a>
  646. </p>
  647. <p>
  648. 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
  649. on the LiveCD.
  650. </p>
  651. <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>
  652. <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>
  653. <p>
  654. You have chosen to use a Gentoo Installation CD. We'll first start by
  655. downloading and burning the chosen Installation CD. We previously discussed
  656. the several available Installation CDs, but where can you find them?
  657. </p>
  658. <p>
  659. 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
  660. the <span class="path" dir="ltr">releases/x86/2007.0/installcd/</span> directory.
  661. </p>
  662. <p>
  663. Inside that directory you'll find ISO-files. Those are full CD images which you
  664. can write on a CD-R.
  665. </p>
  666. <p>
  667. In case you wonder if your downloaded file is corrupted or not, you can check
  668. its MD5 checksum and compare it with the MD5 checksum we provide (such as
  669. <span class="path" dir="ltr">install-x86-minimal-2007.0-r1.iso.DIGESTS</span>). You can check the MD5
  670. 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.
  671. </p>
  672. <p>
  673. Another way to check the validity of the downloaded file is to use GnuPG to
  674. verify the cryptographic signature that we provide (the file ending with
  675. <span class="path" dir="ltr">.asc</span>). Download the signature file and obtain the public key:
  676. </p>
  677. <a name="doc_chap_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
  678. <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 1: Obtaining the public key</p></td></tr>
  679. <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
  680. $ <span class="code-input">gpg --keyserver subkeys.pgp.net --recv-keys 17072058</span>
  681. </pre></td></tr>
  682. </table>
  683. <p>
  684. Now verify the signature:
  685. </p>
  686. <a name="doc_chap_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
  687. <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 2: Verify the cryptographic signature</p></td></tr>
  688. <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
  689. $ <span class="code-input">gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</span>
  690. </pre></td></tr>
  691. </table>
  692. <p>
  693. To burn the downloaded ISO(s), you have to select raw-burning. How you
  694. do this is highly program-dependent. We will discuss <span class="code" dir="ltr">cdrecord</span> and
  695. <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>.
  696. </p>
  697. <ul>
  698. <li>
  699. With cdrecord, you simply type <span class="code" dir="ltr">cdrecord dev=/dev/hdc &lt;downloaded iso
  700. file&gt;</span> (replace <span class="path" dir="ltr">/dev/hdc</span> with your CD-RW drive's
  701. device path).
  702. </li>
  703. <li>
  704. With K3B, select <span class="code" dir="ltr">Tools</span> &gt; <span class="code" dir="ltr">Burn CD Image</span>. Then you can locate
  705. your ISO file within the 'Image to Burn' area. Finally click <span class="code" dir="ltr">Start</span>.
  706. </li>
  707. </ul>
  708. <a name="book_id6780643_chap3_sect2"></a><a name="book_part1_chap2__chap3_sect2"></a><p class="secthead">Booting the Installation CD</p>
  709. <p>
  710. Once you have burnt your installation CD, it is time to boot it.
  711. Remove all CDs from your CD drives, reboot your system and enter the BIOS.
  712. This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside
  713. the BIOS, change the boot order so that the CD-ROM is tried before the hard
  714. disk. This is often found under "CMOS Setup". If you don't do this, your system
  715. will just reboot from the hard disk, ignoring the CD-ROM.
  716. </p>
  717. <p>
  718. Now place the installation CD in the CD-ROM drive and reboot. You should see a
  719. boot prompt. At this screen, you can hit Enter to begin the boot process with
  720. the default boot options, or boot the Installation CD with custom boot options
  721. by specifying a kernel followed by boot options and then hitting Enter.
  722. </p>
  723. <p>
  724. Specifying a kernel? Yes, we provide several kernels on our Installation CDs.
  725. The default one is <span class="code" dir="ltr">gentoo</span>. Other kernels are for specific hardware needs
  726. and the <span class="code" dir="ltr">-nofb</span> variants which disable framebuffer.
  727. </p>
  728. <p>
  729. Below you'll find a short overview on the available kernels:
  730. </p>
  731. <table class="ntable">
  732. <tr>
  733. <td class="infohead"><b>Kernel</b></td>
  734. <td class="infohead"><b>Description</b></td>
  735. </tr>
  736. <tr>
  737. <td class="tableinfo">gentoo</td>
  738. <td class="tableinfo">Default 2.6 kernel with support for multiple CPUs</td>
  739. </tr>
  740. <tr>
  741. <td class="tableinfo">gentoo-nofb</td>
  742. <td class="tableinfo">Same as <span class="code" dir="ltr">gentoo</span> but without framebuffer support</td>
  743. </tr>
  744. <tr>
  745. <td class="tableinfo">memtest86</td>
  746. <td class="tableinfo">Test your local RAM for errors</td>
  747. </tr>
  748. </table>
  749. <p>
  750. You can also provide kernel options. They represent optional settings you can
  751. (de)activate at will. The following list is the same as the one you receive
  752. when you press F2 at the bootscreen.
  753. </p>
  754. <a name="doc_chap_pre3"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
  755. <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 3: Options available to pass to your kernel of choice</p></td></tr>
  756. <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
  757. - agpgart loads agpgart (use if you have graphic problems,lockups)
  758. - acpi=on loads support for ACPI firmware
  759. - ide=nodma force disabling of DMA for malfunctioning IDE devices
  760. - doscsi scan for scsi devices (breaks some ethernet cards)
  761. - dopcmcia starts pcmcia service for PCMCIA cdroms
  762. - nofirewire disables firewire modules in initrd (for firewire cdroms,etc)
  763. - nokeymap disables keymap selection for non-us keyboard layouts
  764. - docache cache the entire runtime portion of cd in RAM, allows you
  765. to umount /mnt/cdrom to mount another cdrom.
  766. - nodetect causes hwsetup/kudzu and hotplug not to run
  767. - nousb disables usb module load from initrd, disables hotplug
  768. - nodhcp dhcp does not automatically start if nic detected
  769. - nohotplug disables loading hotplug service
  770. - noapic disable apic (try if having hardware problems nics,scsi,etc)
  771. - noevms disable loading of EVMS2 modules
  772. - nolvm2 disable loading of LVM2 modules
  773. - hdx=stroke allows you to partition the whole harddrive even when your BIOS
  774. can't handle large harddrives
  775. - noload=module1,[module2,[...]]
  776. disable loading of specific kernel modules
  777. </pre></td></tr>
  778. </table>
  779. <p>
  780. Now boot your CD, select a kernel (if you are not happy with the default
  781. <span class="code" dir="ltr">gentoo</span> kernel) and boot options. As an example, we show you how
  782. to boot the <span class="code" dir="ltr">gentoo</span> kernel, with <span class="code" dir="ltr">dopcmcia</span> as kernel
  783. parameters:
  784. </p>
  785. <a name="doc_chap_pre4"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
  786. <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 4: Booting an Installation CD</p></td></tr>
  787. <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
  788. boot: <span class="code-input">gentoo dopcmcia</span>
  789. </pre></td></tr>
  790. </table>
  791. <p>
  792. You will then be greeted with a boot screen and progress bar. If you are
  793. installing Gentoo on a system with a non-US keyboard, make sure you immediately
  794. press Alt-F1 to switch to verbose mode and follow the prompt. If no selection
  795. is made in 10 seconds the default (US keyboard) will be accepted and the boot
  796. process will continue. Once the boot process completes, you will be
  797. automatically logged in to the "Live" Gentoo Linux as "root", the super user.
  798. You should have a root ("#") prompt on the current console and can also switch
  799. to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one
  800. you started on by pressing Alt-F1.
  801. </p>
  802. <p>
  803. Now continue with <a href="#hardware">Extra Hardware Configuration</a>.
  804. </p>
  805. <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>
  806. <p>
  807. When the Installation CD boots, it tries to detect all your hardware devices
  808. and loads the appropriate kernel modules to support your hardware. In the vast
  809. majority of cases, it does a very good job. However, in some cases it may not
  810. auto-load the kernel modules you need. If the PCI auto-detection missed some of
  811. your system's hardware, you will have to load the appropriate kernel modules
  812. manually.
  813. </p>
  814. <p>
  815. In the next example we try to load the <span class="code" dir="ltr">8139too</span> module (support for
  816. certain kinds of network interfaces):
  817. </p>
  818. <a name="doc_chap_pre5"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
  819. <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 5: Loading kernel modules</p></td></tr>
  820. <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
  821. # <span class="code-input">modprobe 8139too</span>
  822. </pre></td></tr>
  823. </table>
  824. <a name="book_id6780643_chap3_sect4"></a><a name="book_part1_chap2__chap3_sect4"></a><p class="secthead">Optional: Tweaking Hard Disk Performance</p>
  825. <p>
  826. If you are an advanced user, you might want to tweak the IDE hard disk
  827. performance using <span class="code" dir="ltr">hdparm</span>. With the <span class="code" dir="ltr">-tT</span> options you can
  828. test the performance of your disk (execute it several times to get a
  829. more precise impression):
  830. </p>
  831. <a name="doc_chap_pre6"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
  832. <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 6: Testing disk performance</p></td></tr>
  833. <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
  834. # <span class="code-input">hdparm -tT /dev/hda</span>
  835. </pre></td></tr>
  836. </table>
  837. <p>
  838. To tweak, you can use any of the following examples (or experiment
  839. yourself) which use <span class="path" dir="ltr">/dev/hda</span> as disk (substitute with your
  840. disk):
  841. </p>
  842. <a name="doc_chap_pre7"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
  843. <tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 7: Tweaking hard disk performance</p></td></tr>
  844. <tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
  845. <span class="code-comment">(Activate DMA:)</span>
  846. # <span class="code-input">hdparm -d 1 /dev/hda</span>
  847. <span class="code-comment">(Activate Safe Performa