| … | |
… | |
| 2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
| 3 | |
3 | |
| 4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 5 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
5 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 6 | |
6 | |
| 7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.89 2007/03/12 08:12:38 nightmorph Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.90 2007/05/07 18:11:40 nightmorph Exp $ --> |
| 8 | |
8 | |
| 9 | <sections> |
9 | <sections> |
| 10 | |
10 | |
| 11 | <abstract> |
11 | <abstract> |
| 12 | You need to edit some important configuration files. In this chapter |
12 | You need to edit some important configuration files. In this chapter |
| 13 | you receive an overview of these files and an explanation on how to |
13 | you receive an overview of these files and an explanation on how to |
| 14 | proceed. |
14 | proceed. |
| 15 | </abstract> |
15 | </abstract> |
| 16 | |
16 | |
| 17 | <version>7.7</version> |
17 | <version>8.0</version> |
| 18 | <date>2007-03-11</date> |
18 | <date>2007-05-07</date> |
| 19 | |
19 | |
| 20 | <section> |
20 | <section> |
| 21 | <title>Filesystem Information</title> |
21 | <title>Filesystem Information</title> |
| 22 | <subsection> |
22 | <subsection> |
| 23 | <title>What is fstab?</title> |
23 | <title>What is fstab?</title> |
| … | |
… | |
| 73 | </li> |
73 | </li> |
| 74 | </ul> |
74 | </ul> |
| 75 | |
75 | |
| 76 | <impo> |
76 | <impo> |
| 77 | The default <path>/etc/fstab</path> file provided by Gentoo <e>is not a valid |
77 | The default <path>/etc/fstab</path> file provided by Gentoo <e>is not a valid |
| 78 | fstab file</e>, You <b>have to create</b> your own <path>/etc/fstab</path>. |
78 | fstab file</e>. You <b>have to create</b> your own <path>/etc/fstab</path>. |
| 79 | </impo> |
79 | </impo> |
| 80 | |
80 | |
| 81 | <pre caption="Opening /etc/fstab"> |
81 | <pre caption="Opening /etc/fstab"> |
| 82 | # <i>nano -w /etc/fstab</i> |
82 | # <i>nano -w /etc/fstab</i> |
| 83 | </pre> |
83 | </pre> |
| … | |
… | |
| 137 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='AMD64' or func:keyval('arch')='x86'"> |
137 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='AMD64' or func:keyval('arch')='x86'"> |
| 138 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
138 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
| 139 | /dev/hda2 none swap sw 0 0 |
139 | /dev/hda2 none swap sw 0 0 |
| 140 | /dev/hda3 / ext3 noatime 0 1 |
140 | /dev/hda3 / ext3 noatime 0 1 |
| 141 | |
141 | |
| 142 | proc /proc proc defaults 0 0 |
142 | proc /proc proc nodev,nosuid,noexec 0 0 |
| 143 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
143 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 144 | |
144 | |
| 145 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
145 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 146 | </pre> |
146 | </pre> |
| 147 | |
147 | |
| 148 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='HPPA'"> |
148 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='HPPA'"> |
| 149 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
149 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
| 150 | /dev/sda3 none swap sw 0 0 |
150 | /dev/sda3 none swap sw 0 0 |
| 151 | /dev/sda4 / ext3 noatime 0 1 |
151 | /dev/sda4 / ext3 noatime 0 1 |
| 152 | |
152 | |
| 153 | proc /proc proc defaults 0 0 |
153 | proc /proc proc nodev,nosuid,noexec 0 0 |
| 154 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
154 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 155 | |
155 | |
| 156 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
156 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 157 | </pre> |
157 | </pre> |
| 158 | |
158 | |
| 159 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='Alpha' or func:keyval('arch')='MIPS'"> |
159 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='Alpha' or func:keyval('arch')='MIPS'"> |
| 160 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
160 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
| 161 | /dev/sda2 none swap sw 0 0 |
161 | /dev/sda2 none swap sw 0 0 |
| 162 | /dev/sda3 / ext3 noatime 0 1 |
162 | /dev/sda3 / ext3 noatime 0 1 |
| 163 | |
163 | |
| 164 | proc /proc proc defaults 0 0 |
164 | proc /proc proc nodev,nosuid,noexec 0 0 |
| 165 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
165 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 166 | |
166 | |
| 167 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
167 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 168 | </pre> |
168 | </pre> |
| 169 | |
169 | |
| … | |
… | |
| 173 | /dev/sda4 /usr ext3 noatime 0 2 |
173 | /dev/sda4 /usr ext3 noatime 0 2 |
| 174 | /dev/sda5 /var ext3 noatime 0 2 |
174 | /dev/sda5 /var ext3 noatime 0 2 |
| 175 | /dev/sda6 /home ext3 noatime 0 2 |
175 | /dev/sda6 /home ext3 noatime 0 2 |
| 176 | |
176 | |
| 177 | openprom /proc/openprom openpromfs defaults 0 0 |
177 | openprom /proc/openprom openpromfs defaults 0 0 |
| 178 | proc /proc proc defaults 0 0 |
178 | proc /proc proc nodev,nosuid,noexec 0 0 |
| 179 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
179 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 180 | |
180 | |
| 181 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
181 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 182 | </pre> |
182 | </pre> |
| 183 | |
183 | |
| … | |
… | |
| 188 | |
188 | |
| 189 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC'"> |
189 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC'"> |
| 190 | /dev/hda4 / ext3 noatime 0 1 |
190 | /dev/hda4 / ext3 noatime 0 1 |
| 191 | /dev/hda3 none swap sw 0 0 |
191 | /dev/hda3 none swap sw 0 0 |
| 192 | |
192 | |
| 193 | proc /proc proc defaults 0 0 |
193 | proc /proc proc nodev,nosuid,noexec 0 0 |
| 194 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
194 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 195 | |
195 | |
| 196 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
196 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 197 | </pre> |
197 | </pre> |
| 198 | |
198 | |
| 199 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC64'"> |
199 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC64'"> |
| 200 | /dev/sda4 / ext3 noatime 0 1 |
200 | /dev/sda4 / ext3 noatime 0 1 |
| 201 | /dev/sda3 none swap sw 0 0 |
201 | /dev/sda3 none swap sw 0 0 |
| 202 | |
202 | |
| 203 | proc /proc proc defaults 0 0 |
203 | proc /proc proc nodev,nosuid,noexec 0 0 |
| 204 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
204 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 205 | |
205 | |
| 206 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
206 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 207 | </pre> |
207 | </pre> |
| 208 | |
208 | |
| … | |
… | |
| 345 | to set both <c>config_eth0</c> and <c>routes_eth0</c>: |
345 | to set both <c>config_eth0</c> and <c>routes_eth0</c>: |
| 346 | </p> |
346 | </p> |
| 347 | |
347 | |
| 348 | <pre caption="Manually setting IP information for eth0"> |
348 | <pre caption="Manually setting IP information for eth0"> |
| 349 | config_eth0=( "192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" ) |
349 | config_eth0=( "192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" ) |
| 350 | routes_eth0=( "default gw 192.168.0.1" ) |
350 | routes_eth0=( "default via 192.168.0.1" ) |
| 351 | </pre> |
351 | </pre> |
| 352 | |
352 | |
| 353 | <p> |
353 | <p> |
| 354 | To use DHCP and add specific DHCP options, define <c>config_eth0</c> and |
354 | To use DHCP and add specific DHCP options, define <c>config_eth0</c> and |
| 355 | <c>dhcp_eth0</c>: |
355 | <c>dhcp_eth0</c>: |
| … | |
… | |
| 380 | <title>Automatically Start Networking at Boot</title> |
380 | <title>Automatically Start Networking at Boot</title> |
| 381 | <body> |
381 | <body> |
| 382 | |
382 | |
| 383 | <p> |
383 | <p> |
| 384 | To have your network interfaces activated at boot, you need to add them to the |
384 | To have your network interfaces activated at boot, you need to add them to the |
| 385 | default runlevel. If you have PCMCIA interfaces you should skip this action as |
385 | default runlevel. |
| 386 | the PCMCIA interfaces are started by the PCMCIA init script. |
|
|
| 387 | </p> |
386 | </p> |
| 388 | |
387 | |
| 389 | <pre caption="Adding net.eth0 to the default runlevel"> |
388 | <pre caption="Adding net.eth0 to the default runlevel"> |
| 390 | # <i>rc-update add net.eth0 default</i> |
389 | # <i>rc-update add net.eth0 default</i> |
| 391 | </pre> |
390 | </pre> |
| … | |
… | |
| 445 | <subsection test="func:keyval('arch')='AMD64' or func:keyval('arch')='x86' or substring(func:keyval('arch'),1,3)='PPC'"> |
444 | <subsection test="func:keyval('arch')='AMD64' or func:keyval('arch')='x86' or substring(func:keyval('arch'),1,3)='PPC'"> |
| 446 | <title>Optional: Get PCMCIA Working</title> |
445 | <title>Optional: Get PCMCIA Working</title> |
| 447 | <body> |
446 | <body> |
| 448 | |
447 | |
| 449 | <p> |
448 | <p> |
| 450 | PCMCIA-users should first install the <c>pcmcia-cs</c> package. This also |
449 | PCMCIA users should first install the <c>pcmciautils</c> package. |
| 451 | includes users who will be working with a 2.6 kernel (even though they won't be |
|
|
| 452 | using the PCMCIA drivers from this package). The <c>USE="-X"</c> is necessary |
|
|
| 453 | to avoid installing xorg-x11 at this moment: |
|
|
| 454 | </p> |
450 | </p> |
| 455 | |
451 | |
| 456 | <pre caption="Installing pcmcia-cs"> |
452 | <pre caption="Installing pcmciautils"> |
| 457 | # <i>USE="-X" emerge pcmcia-cs</i> |
453 | # <i>emerge pcmciautils</i> |
| 458 | </pre> |
|
|
| 459 | |
|
|
| 460 | <p> |
|
|
| 461 | When <c>pcmcia-cs</c> is installed, add <c>pcmcia</c> to the <e>default</e> |
|
|
| 462 | runlevel: |
|
|
| 463 | </p> |
|
|
| 464 | |
|
|
| 465 | <pre caption="Adding pcmcia to the default runlevel"> |
|
|
| 466 | # <i>rc-update add pcmcia default</i> |
|
|
| 467 | </pre> |
454 | </pre> |
| 468 | |
455 | |
| 469 | </body> |
456 | </body> |
| 470 | </subsection> |
457 | </subsection> |
| 471 | </section> |
458 | </section> |
| … | |
… | |
| 529 | |
516 | |
| 530 | <p> |
517 | <p> |
| 531 | Take special care with the <c>KEYMAP</c> variable. If you select the wrong |
518 | Take special care with the <c>KEYMAP</c> variable. If you select the wrong |
| 532 | <c>KEYMAP</c>, you will get weird results when typing on your keyboard. |
519 | <c>KEYMAP</c>, you will get weird results when typing on your keyboard. |
| 533 | </p> |
520 | </p> |
| 534 | |
|
|
| 535 | <note test="func:keyval('arch')='SPARC'"> |
|
|
| 536 | Users of USB-based SPARC systems and SPARC clones might need to select an i386 |
|
|
| 537 | keymap (such as "us") instead of "sunkeymap". |
|
|
| 538 | </note> |
|
|
| 539 | |
521 | |
| 540 | <note test="substring(func:keyval('arch'),1,3)='PPC'"> |
522 | <note test="substring(func:keyval('arch'),1,3)='PPC'"> |
| 541 | PPC uses x86 keymaps on most systems. Users who want to be able to use ADB |
523 | PPC uses x86 keymaps on most systems. Users who want to be able to use ADB |
| 542 | keymaps on boot have to enable ADB keycode sendings in their kernel and have to |
524 | keymaps on boot have to enable ADB keycode sendings in their kernel and have to |
| 543 | set a mac/ppc keymap in <path>/etc/conf.d/keymaps</path>. |
525 | set a mac/ppc keymap in <path>/etc/conf.d/keymaps</path>. |