| … | |
… | |
| 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.90 2007/05/07 18:11:40 nightmorph Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.115 2012/04/29 16:52:20 swift 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>8.0</version> |
17 | <version>21</version> |
| 18 | <date>2007-05-07</date> |
18 | <date>2012-04-29</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> |
| … | |
… | |
| 89 | Let us take a look at how we write down the options for the <path>/boot</path> |
89 | Let us take a look at how we write down the options for the <path>/boot</path> |
| 90 | partition. This is just an example, if you didn't or couldn't create a |
90 | partition. This is just an example, if you didn't or couldn't create a |
| 91 | <path>/boot</path>, don't copy it. |
91 | <path>/boot</path>, don't copy it. |
| 92 | </p> |
92 | </p> |
| 93 | |
93 | |
| 94 | <p test="contains(func:keyval('/boot'), '/dev/hd')"> |
|
|
| 95 | In our default <keyval id="arch"/> partitioning example, <path>/boot</path> is |
|
|
| 96 | usually the <path><keyval id="/boot"/></path> partition (or |
|
|
| 97 | <path>/dev/sda*</path> if you use SCSI or SATA drives), with <c>ext2</c> as |
|
|
| 98 | filesystem. It needs to be checked during boot, so we would write down: |
|
|
| 99 | </p> |
94 | <p> |
| 100 | |
|
|
| 101 | <p test="contains(func:keyval('/boot'), '/dev/sd')"> |
|
|
| 102 | In our default <keyval id="arch"/> partitioning example, <path>/boot</path> is |
95 | In our default <keyval id="arch"/> partitioning example, <path>/boot</path> is |
| 103 | usually the <path><keyval id="/boot"/></path> partition, with <c>ext2</c> as |
96 | usually the <path><keyval id="/boot"/></path> partition, with <c>ext2</c> as |
| 104 | filesystem. It needs to be checked during boot, so we would write down: |
97 | filesystem. It needs to be checked during boot, so we would write down: |
| 105 | </p> |
98 | </p> |
| 106 | |
99 | |
| … | |
… | |
| 116 | </p> |
109 | </p> |
| 117 | |
110 | |
| 118 | </body> |
111 | </body> |
| 119 | <body> |
112 | <body> |
| 120 | |
113 | |
| 121 | <p test="not(func:keyval('arch')='SPARC')"> |
114 | <p> |
| 122 | Add the rules that match your partitioning scheme and append rules for |
115 | Add the rules that match your partitioning scheme and append rules for |
| 123 | <path>/proc</path>, <c>tmpfs</c>, for your CD-ROM drive(s), and of course, if |
|
|
| 124 | you have other partitions or drives, for those too. |
|
|
| 125 | </p> |
|
|
| 126 | |
|
|
| 127 | <p test="func:keyval('arch')='SPARC'"> |
|
|
| 128 | Add the rules that match your partitioning schema and append rules for |
|
|
| 129 | <path>/proc/openprom</path>, <path>/proc</path>, <c>tmpfs</c> , for your CD-ROM |
|
|
| 130 | drive(s), and of course, if you have other partitions or drives, for those too. |
116 | your CD-ROM drive(s), and of course, if you have other partitions or drives, |
|
|
117 | for those too. |
| 131 | </p> |
118 | </p> |
| 132 | |
119 | |
| 133 | <p> |
120 | <p> |
| 134 | Now use the <e>example</e> below to create your <path>/etc/fstab</path>: |
121 | Now use the <e>example</e> below to create your <path>/etc/fstab</path>: |
| 135 | </p> |
122 | </p> |
| 136 | |
|
|
| 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 |
|
|
| 139 | /dev/hda2 none swap sw 0 0 |
|
|
| 140 | /dev/hda3 / ext3 noatime 0 1 |
|
|
| 141 | |
|
|
| 142 | proc /proc proc nodev,nosuid,noexec 0 0 |
|
|
| 143 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
|
|
| 144 | |
|
|
| 145 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
|
|
| 146 | </pre> |
|
|
| 147 | |
123 | |
| 148 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='HPPA'"> |
124 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='HPPA'"> |
| 149 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
125 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
| 150 | /dev/sda3 none swap sw 0 0 |
126 | /dev/sda3 none swap sw 0 0 |
| 151 | /dev/sda4 / ext3 noatime 0 1 |
127 | /dev/sda4 / ext3 noatime 0 1 |
| 152 | |
128 | |
| 153 | proc /proc proc nodev,nosuid,noexec 0 0 |
|
|
| 154 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
|
|
| 155 | |
|
|
| 156 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
129 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 157 | </pre> |
130 | </pre> |
| 158 | |
131 | |
| 159 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='Alpha' or func:keyval('arch')='MIPS'"> |
132 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='Alpha' or func:keyval('arch')='MIPS' or func:keyval('arch')='x86' or func:keyval('arch')='AMD64'"> |
| 160 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
133 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
| 161 | /dev/sda2 none swap sw 0 0 |
134 | /dev/sda2 none swap sw 0 0 |
| 162 | /dev/sda3 / ext3 noatime 0 1 |
135 | /dev/sda3 / ext3 noatime 0 1 |
| 163 | |
|
|
| 164 | proc /proc proc nodev,nosuid,noexec 0 0 |
|
|
| 165 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
|
|
| 166 | |
136 | |
| 167 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
137 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 168 | </pre> |
138 | </pre> |
| 169 | |
139 | |
| 170 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='SPARC'"> |
140 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='SPARC'"> |
| … | |
… | |
| 172 | /dev/sda2 none swap sw 0 0 |
142 | /dev/sda2 none swap sw 0 0 |
| 173 | /dev/sda4 /usr ext3 noatime 0 2 |
143 | /dev/sda4 /usr ext3 noatime 0 2 |
| 174 | /dev/sda5 /var ext3 noatime 0 2 |
144 | /dev/sda5 /var ext3 noatime 0 2 |
| 175 | /dev/sda6 /home ext3 noatime 0 2 |
145 | /dev/sda6 /home ext3 noatime 0 2 |
| 176 | |
146 | |
|
|
147 | <comment># You must add the rules for openprom</comment> |
| 177 | openprom /proc/openprom openpromfs defaults 0 0 |
148 | openprom /proc/openprom openpromfs defaults 0 0 |
| 178 | proc /proc proc nodev,nosuid,noexec 0 0 |
|
|
| 179 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
|
|
| 180 | |
149 | |
| 181 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
150 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 182 | </pre> |
151 | </pre> |
| 183 | |
152 | |
| 184 | <note test="func:keyval('arch')='PPC'"> |
|
|
| 185 | There are important variations between PPC machine types. Please make sure you |
|
|
| 186 | adapt the following example to your system. |
|
|
| 187 | </note> |
|
|
| 188 | |
|
|
| 189 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC'"> |
153 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC' or |
| 190 | /dev/hda4 / ext3 noatime 0 1 |
154 | func:keyval('arch')='PPC64'"> |
| 191 | /dev/hda3 none swap sw 0 0 |
|
|
| 192 | |
|
|
| 193 | proc /proc proc nodev,nosuid,noexec 0 0 |
|
|
| 194 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
|
|
| 195 | |
|
|
| 196 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
|
|
| 197 | </pre> |
|
|
| 198 | |
|
|
| 199 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC64'"> |
|
|
| 200 | /dev/sda4 / ext3 noatime 0 1 |
155 | /dev/sda4 / ext3 noatime 0 1 |
| 201 | /dev/sda3 none swap sw 0 0 |
156 | /dev/sda3 none swap sw 0 0 |
| 202 | |
|
|
| 203 | proc /proc proc nodev,nosuid,noexec 0 0 |
|
|
| 204 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
|
|
| 205 | |
157 | |
| 206 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
158 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
| 207 | </pre> |
159 | </pre> |
| 208 | |
160 | |
| 209 | <p> |
161 | <p> |
| … | |
… | |
| 240 | </p> |
192 | </p> |
| 241 | |
193 | |
| 242 | <pre caption="Setting the host name"> |
194 | <pre caption="Setting the host name"> |
| 243 | # <i>nano -w /etc/conf.d/hostname</i> |
195 | # <i>nano -w /etc/conf.d/hostname</i> |
| 244 | |
196 | |
| 245 | <comment>(Set the HOSTNAME variable to your host name)</comment> |
197 | <comment>(Set the hostname variable to your host name)</comment> |
| 246 | HOSTNAME="<i>tux</i>" |
198 | hostname="<i>tux</i>" |
| 247 | </pre> |
199 | </pre> |
| 248 | |
200 | |
| 249 | <p> |
201 | <p> |
| 250 | Second, <e>if</e> you need a domainname, set it in <path>/etc/conf.d/net</path>. |
202 | Second, <e>if</e> you need a domainname, set it in <path>/etc/conf.d/net</path>. |
| 251 | You only need a domain if your ISP or network administrator says so, or if you |
203 | You only need a domain if your ISP or network administrator says so, or if you |
| … | |
… | |
| 278 | nis_domain_lo="<i>my-nisdomain</i>" |
230 | nis_domain_lo="<i>my-nisdomain</i>" |
| 279 | </pre> |
231 | </pre> |
| 280 | |
232 | |
| 281 | <note> |
233 | <note> |
| 282 | For more information on configuring DNS and NIS, please read the examples |
234 | For more information on configuring DNS and NIS, please read the examples |
| 283 | provided in <path>/etc/conf.d/net.example</path>. Also, you may want to emerge |
235 | provided in <path>/usr/share/doc/openrc-*/net.example.bz2</path> which |
| 284 | <c>resolvconf-gentoo</c> to help manage your DNS/NIS setup. |
236 | can be read using <c>bzless</c>. Also, you may want to emerge <c>openresolv</c> |
|
|
237 | to help manage your DNS/NIS setup. |
| 285 | </note> |
238 | </note> |
| 286 | |
239 | |
| 287 | </body> |
240 | </body> |
| 288 | </subsection> |
241 | </subsection> |
| 289 | <subsection> |
242 | <subsection> |
| … | |
… | |
| 306 | <p> |
259 | <p> |
| 307 | All networking information is gathered in <path>/etc/conf.d/net</path>. It uses |
260 | All networking information is gathered in <path>/etc/conf.d/net</path>. It uses |
| 308 | a straightforward yet not intuitive syntax if you don't know how to set up |
261 | a straightforward yet not intuitive syntax if you don't know how to set up |
| 309 | networking manually. But don't fear, we'll explain everything. A fully |
262 | networking manually. But don't fear, we'll explain everything. A fully |
| 310 | commented example that covers many different configurations is available in |
263 | commented example that covers many different configurations is available in |
| 311 | <path>/etc/conf.d/net.example</path>. |
264 | <path>/usr/share/doc/openrc-*/net.example.bz2</path>. |
| 312 | </p> |
265 | </p> |
| 313 | |
266 | |
| 314 | <p> |
267 | <p> |
| 315 | DHCP is used by default. For DHCP to work, you will need to install a DHCP |
268 | DHCP is used by default. For DHCP to work, you will need to install a DHCP |
| 316 | client. This is described later in <uri |
269 | client. This is described later in <uri |
| … | |
… | |
| 334 | </p> |
287 | </p> |
| 335 | |
288 | |
| 336 | <pre caption="Default /etc/conf.d/net"> |
289 | <pre caption="Default /etc/conf.d/net"> |
| 337 | # This blank configuration will automatically use DHCP for any net.* |
290 | # This blank configuration will automatically use DHCP for any net.* |
| 338 | # scripts in /etc/init.d. To create a more complete configuration, |
291 | # scripts in /etc/init.d. To create a more complete configuration, |
| 339 | # please review /etc/conf.d/net.example and save your configuration |
292 | # please review /usr/share/doc/openrc-*/net.example.bz2 and save |
| 340 | # in /etc/conf.d/net (this file :]!). |
293 | # your configuration in /etc/conf.d/net (this file :]!). |
| 341 | </pre> |
294 | </pre> |
| 342 | |
295 | |
| 343 | <p> |
296 | <p> |
| 344 | To enter your own IP address, netmask and gateway, you need |
297 | To enter your own IP address, netmask and gateway, you need |
| 345 | to set both <c>config_eth0</c> and <c>routes_eth0</c>: |
298 | to set both <c>config_eth0</c> and <c>routes_eth0</c>: |
| 346 | </p> |
299 | </p> |
| 347 | |
300 | |
| 348 | <pre caption="Manually setting IP information for eth0"> |
301 | <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" ) |
302 | config_eth0="192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" |
| 350 | routes_eth0=( "default via 192.168.0.1" ) |
303 | routes_eth0="default via 192.168.0.1" |
| 351 | </pre> |
304 | </pre> |
| 352 | |
305 | |
| 353 | <p> |
306 | <p> |
| 354 | To use DHCP and add specific DHCP options, define <c>config_eth0</c> and |
307 | To use DHCP, define <c>config_eth0</c>: |
| 355 | <c>dhcp_eth0</c>: |
|
|
| 356 | </p> |
308 | </p> |
| 357 | |
309 | |
| 358 | <pre caption="Automatically obtaining an IP address for eth0"> |
310 | <pre caption="Automatically obtaining an IP address for eth0"> |
| 359 | config_eth0=( "dhcp" ) |
311 | config_eth0="dhcp" |
| 360 | dhcp_eth0="nodns nontp nonis" |
|
|
| 361 | </pre> |
312 | </pre> |
| 362 | |
313 | |
| 363 | <p> |
314 | <p> |
| 364 | Please read <path>/etc/conf.d/net.example</path> for a list of all available |
315 | Please read <path>/usr/share/doc/openrc-*/net.example.bz2</path> for a |
| 365 | options. |
316 | list of all available options. Be sure to also read your DHCP client manpage if |
|
|
317 | you need to set specific DHCP options. |
| 366 | </p> |
318 | </p> |
| 367 | |
319 | |
| 368 | <p> |
320 | <p> |
| 369 | If you have several network interfaces repeat the above steps for |
321 | If you have several network interfaces repeat the above steps for |
| 370 | <c>config_eth1</c>, <c>config_eth2</c>, etc. |
322 | <c>config_eth1</c>, <c>config_eth2</c>, etc. |
| … | |
… | |
| 384 | To have your network interfaces activated at boot, you need to add them to the |
336 | To have your network interfaces activated at boot, you need to add them to the |
| 385 | default runlevel. |
337 | default runlevel. |
| 386 | </p> |
338 | </p> |
| 387 | |
339 | |
| 388 | <pre caption="Adding net.eth0 to the default runlevel"> |
340 | <pre caption="Adding net.eth0 to the default runlevel"> |
|
|
341 | # <i>cd /etc/init.d</i> |
|
|
342 | # <i>ln -s net.lo net.eth0</i> |
| 389 | # <i>rc-update add net.eth0 default</i> |
343 | # <i>rc-update add net.eth0 default</i> |
| 390 | </pre> |
344 | </pre> |
| 391 | |
345 | |
| 392 | <p> |
346 | <p> |
| 393 | If you have several network interfaces, you need to create the appropriate |
347 | If you have several network interfaces, you need to create the appropriate |
| 394 | <path>net.eth1</path>, <path>net.eth2</path> etc. initscripts for those. You can |
348 | <path>net.eth1</path>, <path>net.eth2</path> etc. just like you did with |
| 395 | use <c>ln</c> to do this: |
349 | <path>net.eth0</path>. |
| 396 | </p> |
|
|
| 397 | |
|
|
| 398 | <pre caption="Creating extra initscripts"> |
|
|
| 399 | # <i>cd /etc/init.d</i> |
|
|
| 400 | # <i>ln -s net.lo net.eth1</i> |
|
|
| 401 | # <i>rc-update add net.eth1 default</i> |
|
|
| 402 | </pre> |
350 | </p> |
| 403 | |
351 | |
| 404 | </body> |
352 | </body> |
| 405 | </subsection> |
353 | </subsection> |
| 406 | <subsection> |
354 | <subsection> |
| 407 | <title>Writing Down Network Information</title> |
355 | <title>Writing Down Network Information</title> |
| … | |
… | |
| 469 | |
417 | |
| 470 | <pre caption="Setting the root password"> |
418 | <pre caption="Setting the root password"> |
| 471 | # <i>passwd</i> |
419 | # <i>passwd</i> |
| 472 | </pre> |
420 | </pre> |
| 473 | |
421 | |
| 474 | <p> |
|
|
| 475 | If you want root to be able to log on through the serial console, add |
|
|
| 476 | <c>tts/0</c> to <path>/etc/securetty</path>: |
|
|
| 477 | </p> |
|
|
| 478 | |
|
|
| 479 | <pre caption="Adding tts/0 to /etc/securetty"> |
|
|
| 480 | # <i>echo "tts/0" >> /etc/securetty</i> |
|
|
| 481 | </pre> |
|
|
| 482 | |
|
|
| 483 | </body> |
422 | </body> |
| 484 | </subsection> |
423 | </subsection> |
| 485 | <subsection> |
424 | <subsection> |
| 486 | <title>System Information</title> |
425 | <title>System Information</title> |
| 487 | <body> |
426 | <body> |
| 488 | |
427 | |
| 489 | <p> |
428 | <p> |
| 490 | Gentoo uses <path>/etc/rc.conf</path> for general, system-wide configuration. |
429 | Gentoo uses <path>/etc/rc.conf</path> to configure the services, startup, |
| 491 | Open up <path>/etc/rc.conf</path> and enjoy all the comments in that file :) |
430 | and shutdown of your system. Open up <path>/etc/rc.conf</path> and enjoy all |
|
|
431 | the comments in the file. |
| 492 | </p> |
432 | </p> |
| 493 | |
433 | |
| 494 | <pre caption="Opening /etc/rc.conf"> |
434 | <pre caption="Configuring services"> |
| 495 | # <i>nano -w /etc/rc.conf</i> |
435 | # <i>nano -w /etc/rc.conf</i> |
| 496 | </pre> |
436 | </pre> |
| 497 | |
437 | |
| 498 | <p> |
438 | <p> |
| 499 | When you're finished configuring <path>/etc/rc.conf</path>, save and exit. |
439 | When you're finished configuring these two files, save them and exit. |
| 500 | </p> |
|
|
| 501 | |
|
|
| 502 | <p> |
|
|
| 503 | As you can see, this file is well commented to help you set up the necessary |
|
|
| 504 | configuration variables. You can configure your system to use unicode and |
|
|
| 505 | define your default editor and your display manager (like gdm or kdm). |
|
|
| 506 | </p> |
440 | </p> |
| 507 | |
441 | |
| 508 | <p> |
442 | <p> |
| 509 | Gentoo uses <path>/etc/conf.d/keymaps</path> to handle keyboard configuration. |
443 | Gentoo uses <path>/etc/conf.d/keymaps</path> to handle keyboard configuration. |
| 510 | Edit it to configure your keyboard. |
444 | Edit it to configure your keyboard. |
| … | |
… | |
| 513 | <pre caption="Opening /etc/conf.d/keymaps"> |
447 | <pre caption="Opening /etc/conf.d/keymaps"> |
| 514 | # <i>nano -w /etc/conf.d/keymaps</i> |
448 | # <i>nano -w /etc/conf.d/keymaps</i> |
| 515 | </pre> |
449 | </pre> |
| 516 | |
450 | |
| 517 | <p> |
451 | <p> |
| 518 | Take special care with the <c>KEYMAP</c> variable. If you select the wrong |
452 | Take special care with the <c>keymap</c> variable. If you select the wrong |
| 519 | <c>KEYMAP</c>, you will get weird results when typing on your keyboard. |
453 | <c>keymap</c>, you will get weird results when typing on your keyboard. |
| 520 | </p> |
454 | </p> |
| 521 | |
455 | |
| 522 | <note test="substring(func:keyval('arch'),1,3)='PPC'"> |
456 | <note test="substring(func:keyval('arch'),1,3)='PPC'"> |
| 523 | PPC uses x86 keymaps on most systems. Users who want to be able to use ADB |
457 | PPC uses x86 keymaps on most systems. |
| 524 | keymaps on boot have to enable ADB keycode sendings in their kernel and have to |
|
|
| 525 | set a mac/ppc keymap in <path>/etc/conf.d/keymaps</path>. |
|
|
| 526 | </note> |
458 | </note> |
| 527 | |
459 | |
| 528 | <p> |
460 | <p> |
| 529 | When you're finished configuring <path>/etc/conf.d/keymaps</path>, save and |
461 | When you're finished configuring <path>/etc/conf.d/keymaps</path>, save and |
| 530 | exit. |
462 | exit. |
| 531 | </p> |
463 | </p> |
| 532 | |
464 | |
| 533 | <p> |
465 | <p> |
| 534 | Gentoo uses <path>/etc/conf.d/clock</path> to set clock options. Edit it |
466 | Gentoo uses <path>/etc/conf.d/hwclock</path> to set clock options. Edit it |
| 535 | according to your needs. |
467 | according to your needs. |
| 536 | </p> |
468 | </p> |
| 537 | |
469 | |
| 538 | <pre caption="Opening /etc/conf.d/clock"> |
470 | <pre caption="Opening /etc/conf.d/hwclock"> |
| 539 | # <i>nano -w /etc/conf.d/clock</i> |
471 | # <i>nano -w /etc/conf.d/hwclock</i> |
| 540 | </pre> |
472 | </pre> |
| 541 | |
473 | |
| 542 | <p> |
474 | <p> |
| 543 | If your hardware clock is not using UTC, you need to add <c>CLOCK="local"</c> |
475 | If your hardware clock is not using UTC, you need to add <c>clock="local"</c> |
| 544 | to the file. Otherwise you will notice some clock skew. |
476 | to the file. Otherwise you will notice some clock skew. |
| 545 | </p> |
477 | </p> |
| 546 | |
478 | |
| 547 | <p> |
479 | <p> |
| 548 | When you're finished configuring <path>/etc/conf.d/clock</path>, save and |
480 | When you're finished configuring <path>/etc/conf.d/hwclock</path>, save and |
| 549 | exit. |
481 | exit. |
|
|
482 | </p> |
|
|
483 | |
|
|
484 | <p> |
|
|
485 | You should define the timezone that you previously copied to |
|
|
486 | <path>/etc/localtime</path> in the <path>/etc/timezone</path> file so that |
|
|
487 | further upgrades of the <c>sys-libs/timezone-data</c> package can update |
|
|
488 | <path>/etc/localtime</path> automatically. For instance, if you used the |
|
|
489 | Europe/Brussels timezone, you would write <c>Europe/Brussels</c> in the |
|
|
490 | <path>/etc/timezone</path> file. |
|
|
491 | </p> |
|
|
492 | |
|
|
493 | </body> |
|
|
494 | </subsection> |
|
|
495 | |
|
|
496 | <subsection> |
|
|
497 | <title>Configure locales</title> |
|
|
498 | <body> |
|
|
499 | |
|
|
500 | <p> |
|
|
501 | You will probably only use one or maybe two locales on your system. You have to |
|
|
502 | specify locales you will need in <path>/etc/locale.gen</path>. |
|
|
503 | </p> |
|
|
504 | |
|
|
505 | <pre caption="Opening /etc/locale.gen"> |
|
|
506 | # <i>nano -w /etc/locale.gen</i> |
|
|
507 | </pre> |
|
|
508 | |
|
|
509 | <p> |
|
|
510 | The following locales are an example to get both English (United States) and |
|
|
511 | German (Germany) with the accompanying character formats (like UTF-8). |
|
|
512 | </p> |
|
|
513 | |
|
|
514 | <pre caption="Specify your locales"> |
|
|
515 | en_US ISO-8859-1 |
|
|
516 | en_US.UTF-8 UTF-8 |
|
|
517 | de_DE ISO-8859-1 |
|
|
518 | de_DE@euro ISO-8859-15 |
|
|
519 | </pre> |
|
|
520 | |
|
|
521 | <note> |
|
|
522 | You can select your desired locales in the list given by running <c>locale -a</c>. |
|
|
523 | </note> |
|
|
524 | |
|
|
525 | <warn> |
|
|
526 | We strongly suggest that you should use at least one UTF-8 locale because some |
|
|
527 | applications may require it. |
|
|
528 | </warn> |
|
|
529 | |
|
|
530 | <p> |
|
|
531 | The next step is to run <c>locale-gen</c>. It will generates all the locales you |
|
|
532 | have specified in the <path>/etc/locale.gen</path> file. |
|
|
533 | </p> |
|
|
534 | |
|
|
535 | <pre caption="Running locale-gen"> |
|
|
536 | # <i>locale-gen</i> |
|
|
537 | </pre> |
|
|
538 | |
|
|
539 | <p> |
|
|
540 | Once done, you now have the possibility to set the system-wide locale settings |
|
|
541 | in the <path>/etc/env.d/02locale</path> file: |
|
|
542 | </p> |
|
|
543 | |
|
|
544 | <pre caption="Setting the default system locale in /etc/env.d/02locale"> |
|
|
545 | LANG="de_DE.UTF-8" |
|
|
546 | LC_COLLATE="C" |
|
|
547 | </pre> |
|
|
548 | |
|
|
549 | <p> |
|
|
550 | And reload your environment: |
|
|
551 | </p> |
|
|
552 | |
|
|
553 | <pre caption="Reload shell environment"> |
|
|
554 | # env-update && source /etc/profile |
|
|
555 | </pre> |
|
|
556 | |
|
|
557 | <p> |
|
|
558 | We made a full <uri link="../guide-localization.xml#doc_chap3">Localization |
|
|
559 | Guide</uri> to help you through this process. You can also read our detailed |
|
|
560 | <uri link="../utf-8.xml#doc_chap2">UTF-8 Guide</uri> for very specific |
|
|
561 | informations to enable UTF-8 on your system. |
| 550 | </p> |
562 | </p> |
| 551 | |
563 | |
| 552 | <p test="not(func:keyval('arch')='PPC64')"> |
564 | <p test="not(func:keyval('arch')='PPC64')"> |
| 553 | Please continue with <uri link="?part=1&chap=9">Installing Necessary System |
565 | Please continue with <uri link="?part=1&chap=9">Installing Necessary System |
| 554 | Tools</uri>. |
566 | Tools</uri>. |