| 1 | <?xml version="1.0" encoding="UTF-8"?> |
1 | <?xml version="1.0" encoding="UTF-8"?> |
| 2 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
2 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.38 2011/10/30 11:56:08 swift Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.41 2012/08/01 22:08:58 nightmorph Exp $ --> |
| 4 | |
4 | |
| 5 | <guide disclaimer="obsolete"> |
5 | <guide disclaimer="obsolete"> |
| 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"> |
| 18 | <mail link="ka0ttic@gentoo.org">Aaron Walker</mail> |
18 | <mail link="ka0ttic@gentoo.org">Aaron Walker</mail> |
| … | |
… | |
| 31 | </author> |
31 | </author> |
| 32 | <author title="Editor"> |
32 | <author title="Editor"> |
| 33 | <mail link="klondike" /> |
33 | <mail link="klondike" /> |
| 34 | </author> |
34 | </author> |
| 35 | |
35 | |
| 36 | <abstract> |
36 | <abstract> |
| 37 | This document gives some general information on FreeBSD, as well as |
37 | This document gives some general information on FreeBSD, as well as |
| 38 | installation instructions for Gentoo/FreeBSD. It also includes some reference |
38 | installation instructions for Gentoo/FreeBSD. It also includes some reference |
| 39 | for people interested in helping out with development. |
39 | for people interested in helping out with development. |
| 40 | </abstract> |
40 | </abstract> |
| 41 | |
41 | |
| 42 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
42 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 43 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
43 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 44 | <license/> |
44 | <license/> |
| 45 | |
45 | |
| 46 | <version>7</version> |
46 | <version>9</version> |
| 47 | <date>2011-10-30</date> |
47 | <date>2012-08-01</date> |
| 48 | |
48 | |
| 49 | <chapter> |
49 | <chapter> |
| 50 | <title>Introduction to FreeBSD</title> |
50 | <title>Introduction to FreeBSD</title> |
| 51 | <section> |
51 | <section> |
| 52 | <title>What is FreeBSD?</title> |
52 | <title>What is FreeBSD?</title> |
| 53 | <body> |
53 | <body> |
|
|
54 | |
|
|
55 | <impo> |
|
|
56 | Be sure to read the Gentoo/FreeBSD <uri |
|
|
57 | link="http://wiki.gentoo.org/wiki/Gentoo_FreeBSD">wiki page</uri> for up-to-date |
|
|
58 | installation instructions. |
|
|
59 | </impo> |
| 54 | |
60 | |
| 55 | <p> |
61 | <p> |
| 56 | <uri link="http://www.freebsd.org/">FreeBSD</uri> is a free (<uri |
62 | <uri link="http://www.freebsd.org/">FreeBSD</uri> is a free (<uri |
| 57 | link="http://www.freebsd.org/copyright/freebsd-license.html">license</uri>) |
63 | link="http://www.freebsd.org/copyright/freebsd-license.html">license</uri>) |
| 58 | Unix-like operating system. Back in 1993 when development of <uri |
64 | Unix-like operating system. Back in 1993 when development of <uri |
| 59 | link="http://www.386bsd.org/">386BSD</uri> stopped, two projects were born: |
65 | link="http://www.386bsd.org/">386BSD</uri> stopped, two projects were born: |
| 60 | <uri link="http://www.netbsd.org/">NetBSD</uri>, commonly known to run on a |
66 | <uri link="http://www.netbsd.org/">NetBSD</uri>, commonly known to run on a |
| 61 | huge number of architectures, and FreeBSD which supports the x86, amd64, ia64, |
67 | huge number of architectures, and FreeBSD which supports the x86, amd64, ia64, |
| 62 | sparc64 and alpha platforms. FreeBSD is renowned for its stability, performance |
68 | sparc64 and alpha platforms. FreeBSD is renowned for its stability, performance |
| 63 | and security, thus being used from small to huge companies all over the world. |
69 | and security, thus being used from small to huge companies all over the world. |
| 64 | </p> |
70 | </p> |
| 65 | |
71 | |
| 66 | <p> |
72 | <p> |
| 67 | FreeBSD's current production release is version 7.1. Gentoo/FreeBSD is based on |
73 | FreeBSD's current production release is version 7.1. Gentoo/FreeBSD is based on |
| 68 | version 6.2 and older versions of Gentoo/FreeBSD are discontinued and no |
74 | version 6.2 and older versions of Gentoo/FreeBSD are discontinued and no |
| … | |
… | |
| 323 | <p> |
329 | <p> |
| 324 | In order for your install to work, you need to mount the <path>/dev</path> |
330 | In order for your install to work, you need to mount the <path>/dev</path> |
| 325 | filesystem from the currently running system into the Gentoo/FreeBSD mount |
331 | filesystem from the currently running system into the Gentoo/FreeBSD mount |
| 326 | point before proceeding with the chroot. |
332 | point before proceeding with the chroot. |
| 327 | </p> |
333 | </p> |
| 328 | |
334 | |
| 329 | <pre caption="Mounting the /dev filesystem and chrooting"> |
335 | <pre caption="Mounting the /dev filesystem and chrooting"> |
| 330 | # <i>mount -t devfs none /mnt/dev/</i> |
336 | # <i>mount -t devfs none /mnt/dev/</i> |
| 331 | # <i>cp /etc/resolv.conf /mnt/etc/</i> |
337 | # <i>cp /etc/resolv.conf /mnt/etc/</i> |
| 332 | # <i>chroot /mnt/ /bin/bash</i> |
338 | # <i>chroot /mnt/ /bin/bash</i> |
| 333 | # <i>env-update && source /etc/profile</i> |
339 | # <i>env-update && source /etc/profile</i> |
| 334 | </pre> |
340 | </pre> |
| 335 | |
341 | |
| 336 | <p> |
342 | <p> |
| 337 | After you obtain the Gentoo/FreeBSD overlay, it's time to link |
343 | After you obtain the Gentoo/FreeBSD overlay, it's time to link |
| 338 | <path>/etc/make.profile</path> to the correct profile and get your |
344 | <path>/etc/portage/make.profile</path> to the correct profile and get your |
| 339 | <path>/etc/make.conf</path> ready for Gentoo/FreeBSD. |
345 | <path>/etc/portage/make.conf</path> ready for Gentoo/FreeBSD. |
| 340 | </p> |
346 | </p> |
| 341 | |
347 | |
| 342 | <p> |
348 | <p> |
| 343 | Now, you have to obtain a copy of the main Gentoo Portage tree, which depending |
349 | Now, you have to obtain a copy of the main Gentoo Portage tree, which depending |
| 344 | on your connection might take quite a while. |
350 | on your connection might take quite a while. |
| 345 | </p> |
351 | </p> |
| 346 | |
352 | |
| 347 | <pre caption="Obtaining the Portage tree"> |
353 | <pre caption="Obtaining the Portage tree"> |
| 348 | # <i>emerge --sync</i> |
354 | # <i>emerge --sync</i> |
| 349 | <comment>(It's also possible to retrieve the Portage tree in another way:)</comment> |
355 | <comment>(It's also possible to retrieve the Portage tree in another way:)</comment> |
| 350 | # <i>cd /</i> |
356 | # <i>cd /</i> |
| 351 | # <i>wget http://distfiles.gentoo.org/snapshots/portage-latest.tar.bz2</i> |
357 | # <i>wget http://distfiles.gentoo.org/snapshots/portage-latest.tar.bz2</i> |
| 352 | # <i>tar -xjf portage-latest.tar.bz2 -C /usr/</i> |
358 | # <i>tar -xjf portage-latest.tar.bz2 -C /usr/</i> |
| 353 | # <i>emerge --metadata</i> |
359 | # <i>emerge --metadata</i> |
| 354 | </pre> |
360 | </pre> |
| 355 | |
361 | |
| 356 | <pre caption="Setting up the profile and editing /etc/make.conf"> |
362 | <pre caption="Setting up the profile and editing /etc/portage/make.conf"> |
| 357 | # <i>ln -sf /usr/portage/profiles/default-bsd/fbsd/6.2/x86/ /etc/make.profile</i> |
363 | # <i>ln -sf /usr/portage/profiles/default-bsd/fbsd/6.2/x86/ /etc/portage/make.profile</i> |
| 358 | # <i>nano /etc/make.conf</i> |
364 | # <i>nano /etc/portage/make.conf</i> |
| 359 | <comment>(Please make sure you add at least the following entries:)</comment> |
365 | <comment>(Please make sure you add at least the following entries:)</comment> |
| 360 | CHOST="i686-gentoo-freebsd6.2" |
366 | CHOST="i686-gentoo-freebsd6.2" |
| 361 | FEATURES="collision-protect" |
367 | FEATURES="collision-protect" |
| 362 | </pre> |
368 | </pre> |
| 363 | |
369 | |
| 364 | <note> |
370 | <note> |
| 365 | The <c>~x86-fbsd</c> keyword does not yet fully cover the same tree as |
371 | The <c>~x86-fbsd</c> keyword does not yet fully cover the same tree as |
| 366 | <c>~x86</c>, but please <e>do not</e> put <c>~x86</c> in ACCEPT_KEYWORDS. Rather |
372 | <c>~x86</c>, but please <e>do not</e> put <c>~x86</c> in ACCEPT_KEYWORDS. Rather |
| 367 | use <path>/etc/portage/package.accept_keywords</path> to test packages, and |
373 | use <path>/etc/portage/package.accept_keywords</path> to test packages, and |
| 368 | report working packages on <uri |
374 | report working packages on <uri |
| 369 | link="http://bugs.gentoo.org/enter_bug.cgi?product=Gentoo%2FAlt">Bugzilla</uri>. |
375 | link="http://bugs.gentoo.org/enter_bug.cgi?product=Gentoo%2FAlt">Bugzilla</uri>. |
| 370 | </note> |
376 | </note> |
| 371 | |
377 | |
| 372 | <p> |
378 | <p> |
| 373 | If you want, you can now rebuild the system's core packages. |
379 | If you want, you can now rebuild the system's core packages. |