| 1 | <?xml version="1.0" encoding="UTF-8"?> |
1 | <?xml version="1.0" encoding="UTF-8"?> |
| 2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.28 2007/05/11 00:11:39 cam Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.29 2007/05/17 15:50:28 cam Exp $ --> |
| 3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 4 | |
4 | |
| 5 | <guide link="/doc/en/gentoo-freebsd.xml"> |
5 | <guide link="/doc/en/gentoo-freebsd.xml"> |
| 6 | <title>A short guide to Gentoo/FreeBSD</title> |
6 | <title>A short guide to Gentoo/FreeBSD</title> |
| 7 | |
7 | |
| 8 | <author title="Author"> |
8 | <author title="Author"> |
| 9 | <mail link="ignacio.arquelatour@gmail.com">Ignacio Arque-Latour</mail> |
9 | <mail link="ignacio.arquelatour@gmail.com">Ignacio Arque-Latour</mail> |
| 10 | </author> |
10 | </author> |
| 11 | <author title="Author"> |
11 | <author title="Author"> |
| 12 | <mail link="citizen428@gentoo.org">Michael Kohl</mail> |
12 | <mail link="citizen428@gentoo.org">Michael Kohl</mail> |
| 13 | </author> |
13 | </author> |
| 14 | <author title="Author"> |
14 | <author title="Author"> |
| 15 | <mail link="angusyoung@gentoo.org">Otavio R. Piske</mail> |
15 | <mail link="angusyoung@gentoo.org">Otavio R. Piske</mail> |
| 16 | </author> |
16 | </author> |
| 17 | <author title="Author"> |
17 | <author title="Author"> |
| … | |
… | |
| 28 | </author> |
28 | </author> |
| 29 | <author title="Editor"> |
29 | <author title="Editor"> |
| 30 | <mail link="cam@gentoo.org">Camille Huot</mail> |
30 | <mail link="cam@gentoo.org">Camille Huot</mail> |
| 31 | </author> |
31 | </author> |
| 32 | |
32 | |
| 33 | <abstract> |
33 | <abstract> |
| 34 | This document gives some general information on FreeBSD, as well as |
34 | This document gives some general information on FreeBSD, as well as |
| 35 | installation instructions for Gentoo/FreeBSD. It also includes some reference |
35 | installation instructions for Gentoo/FreeBSD. It also includes some reference |
| 36 | for people interested in helping out with development. |
36 | for people interested in helping out with development. |
| 37 | </abstract> |
37 | </abstract> |
| 38 | |
38 | |
| 39 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
39 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 40 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
40 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 41 | <license/> |
41 | <license/> |
| 42 | |
42 | |
| 43 | <version>2.10</version> |
43 | <version>2.11</version> |
| 44 | <date>2007-05-11</date> |
44 | <date>2007-05-17</date> |
| 45 | |
45 | |
| 46 | <chapter> |
46 | <chapter> |
| 47 | <title>Introduction to FreeBSD</title> |
47 | <title>Introduction to FreeBSD</title> |
| 48 | <section> |
48 | <section> |
| 49 | <title>What is FreeBSD?</title> |
49 | <title>What is FreeBSD?</title> |
| 50 | <body> |
50 | <body> |
| 51 | |
51 | |
| 52 | <p> |
52 | <p> |
| 53 | <uri link="http://www.freebsd.org/">FreeBSD</uri> is a free (<uri |
53 | <uri link="http://www.freebsd.org/">FreeBSD</uri> is a free (<uri |
| 54 | link="http://www.freebsd.org/copyright/freebsd-license.html">license</uri>) |
54 | link="http://www.freebsd.org/copyright/freebsd-license.html">license</uri>) |
| 55 | Unix-like operating system. Back in 1993 when development of <uri |
55 | Unix-like operating system. Back in 1993 when development of <uri |
| 56 | link="http://www.386bsd.org/">386BSD</uri> stopped, two projects were born: |
56 | link="http://www.386bsd.org/">386BSD</uri> stopped, two projects were born: |
| 57 | <uri link="http://www.netbsd.org/">NetBSD</uri>, commonly known to run on a |
57 | <uri link="http://www.netbsd.org/">NetBSD</uri>, commonly known to run on a |
| 58 | huge number of architectures, and FreeBSD which supports the x86, amd64, ia64, |
58 | huge number of architectures, and FreeBSD which supports the x86, amd64, ia64, |
| 59 | sparc64 and alpha platforms. FreeBSD is renowned for its stability, performance |
59 | sparc64 and alpha platforms. FreeBSD is renowned for its stability, performance |
| … | |
… | |
| 245 | key, until "Newfs" contains no <b>+S</b>. Now navigate the arrow keys until |
245 | key, until "Newfs" contains no <b>+S</b>. Now navigate the arrow keys until |
| 246 | the "Disk" line is highlighted, and hit <b>c</b> again to create a swap |
246 | the "Disk" line is highlighted, and hit <b>c</b> again to create a swap |
| 247 | partition. Generally, we recommend a swap space that is twice the size of your |
247 | partition. Generally, we recommend a swap space that is twice the size of your |
| 248 | RAM. Choose SWAP as the partition type, and don't worry about soft-updates, as |
248 | RAM. Choose SWAP as the partition type, and don't worry about soft-updates, as |
| 249 | it does not apply to swap. Now we're finished, so hit <b>q</b> to finish the |
249 | it does not apply to swap. Now we're finished, so hit <b>q</b> to finish the |
| 250 | process. |
250 | process. |
| 251 | </p> |
251 | </p> |
| 252 | |
252 | |
| 253 | <p> |
253 | <p> |
| 254 | When choosing a different mountpoint than <path>/</path> for your partition, |
254 | When choosing a different mountpoint than <path>/</path> for your partition, |
| 255 | <c>sysinstall</c> will actually create a 'd' slice, which the bootloader won't |
255 | <c>sysinstall</c> will actually create a 'd' slice, which the bootloader won't |
| 256 | boot from. To fix this, run the following: |
256 | boot from. To fix this, run the following: |
| 257 | </p> |
257 | </p> |
| 258 | |
258 | |
| 259 | <pre caption="Fixing the root partition letter"> |
259 | <pre caption="Fixing the root partition letter"> |
| 260 | # <i>disklabel ad0s1 | sed 's/^ d:/ a:/' > label</i> |
260 | # <i>disklabel ad0s1 | sed 's/^ d:/ a:/' | disklabel -R ad0s1 /dev/stdin</i> |
| 261 | # <i>disklabel -R ad0s1 label</i> |
|
|
| 262 | </pre> |
261 | </pre> |
| 263 | |
262 | |
| 264 | <p> |
263 | <p> |
| 265 | This will finalize the partitioning process, and format the drive in UFS for |
264 | This will finalize the partitioning process, and format the drive in UFS for |
| 266 | FreeBSD to utilize. This will also mount the drive for you at the mount point |
265 | FreeBSD to utilize. This will also mount the drive for you at the mount point |
| 267 | specified earlier (<path>/mnt/</path>). You can verify this worked by |
266 | specified earlier (<path>/mnt/</path>). You can verify this worked by |
| 268 | running <c>mount</c>: |
267 | running <c>mount</c>: |
| 269 | </p> |
268 | </p> |
| 270 | |
269 | |
| 271 | <pre caption="Verifying the new disk layout was mounted with mount"> |
270 | <pre caption="Verifying the new disk layout was mounted with mount"> |
| 272 | # <i>mount</i> |
271 | # <i>mount</i> |
| 273 | ... |
272 | ... |
| 274 | /dev/ad0s1a on /mnt (ufs, local) |
273 | /dev/ad0s1a on /mnt (ufs, local) |
| 275 | </pre> |
274 | </pre> |
| 276 | |
275 | |
| … | |
… | |
| 335 | </p> |
334 | </p> |
| 336 | |
335 | |
| 337 | <pre caption="Obtaining the Portage tree"> |
336 | <pre caption="Obtaining the Portage tree"> |
| 338 | # <i>emerge --sync</i> |
337 | # <i>emerge --sync</i> |
| 339 | <comment>(It's also possible to retrieve the Portage tree in another way:)</comment> |
338 | <comment>(It's also possible to retrieve the Portage tree in another way:)</comment> |
| 340 | # <i>cd /</i> |
339 | # <i>cd /</i> |
| 341 | # <i>wget http://gentoo.osuosl.org/snapshots/portage-latest.tar.bz2</i> |
340 | # <i>wget http://gentoo.osuosl.org/snapshots/portage-latest.tar.bz2</i> |
| 342 | # <i>tar -xjf portage-latest.tar.bz2 -C /usr/</i> |
341 | # <i>tar -xjf portage-latest.tar.bz2 -C /usr/</i> |
| 343 | # <i>emerge --metadata</i> |
342 | # <i>emerge --metadata</i> |
| 344 | </pre> |
343 | </pre> |
| 345 | |
344 | |
| 346 | <pre caption="Setting up the profile and editing /etc/make.conf"> |
345 | <pre caption="Setting up the profile and editing /etc/make.conf"> |
| 347 | # <i>ln -sf /usr/portage/profiles/default-bsd/fbsd/6.2/x86/ /etc/make.profile</i> |
346 | # <i>ln -sf /usr/portage/profiles/default-bsd/fbsd/6.2/x86/ /etc/make.profile</i> |
| 348 | # <i>nano /etc/make.conf</i> |
347 | # <i>nano /etc/make.conf</i> |
| 349 | <comment>(Please make sure you add at least the following entries:)</comment> |
348 | <comment>(Please make sure you add at least the following entries:)</comment> |
| 350 | CHOST="i486-gentoo-freebsd6.2" |
349 | CHOST="i686-gentoo-freebsd6.2" |
| 351 | FEATURES="collision-protect" |
350 | FEATURES="collision-protect" |
| 352 | </pre> |
351 | </pre> |
| 353 | |
352 | |
| 354 | <note> |
353 | <note> |
| 355 | The <c>~x86-fbsd</c> keyword does not yet fully cover the same tree as |
354 | The <c>~x86-fbsd</c> keyword does not yet fully cover the same tree as |
| 356 | <c>~x86</c>, but please <e>do not</e> put <c>~x86</c> in ACCEPT_KEYWORDS. Rather |
355 | <c>~x86</c>, but please <e>do not</e> put <c>~x86</c> in ACCEPT_KEYWORDS. Rather |
| 357 | use <path>/etc/portage/package.keywords</path> to test packages, and report |
356 | use <path>/etc/portage/package.keywords</path> to test packages, and report |
| 358 | working packages on <uri |
357 | working packages on <uri |
| 359 | link="http://bugs.gentoo.org/enter_bug.cgi?product=Gentoo%2FAlt">Bugzilla</uri>. |
358 | link="http://bugs.gentoo.org/enter_bug.cgi?product=Gentoo%2FAlt">Bugzilla</uri>. |
| 360 | </note> |
359 | </note> |
| 361 | |
360 | |
| 362 | <p> |
361 | <p> |
| 363 | If you want, you can now rebuild the system's core packages. |
362 | If you want, you can now rebuild the system's core packages. |
| 364 | </p> |
363 | </p> |
| 365 | |
364 | |