From mboxrd@z Thu Jan 1 00:00:00 1970
Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org)
by nuthatch.gentoo.org with esmtp (Exim 4.62)
(envelope-from <gentoo-doc-cvs+bounces-2257-garchives=archives.gentoo.org@gentoo.org>)
id 1H1wUa-0004DI-BO
for garchives@archives.gentoo.org; Wed, 03 Jan 2007 03:08:41 +0000
Received: from robin.gentoo.org (localhost [127.0.0.1])
by robin.gentoo.org (8.13.8/8.13.8) with SMTP id l0338SWT004014;
Wed, 3 Jan 2007 03:08:28 GMT
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
by robin.gentoo.org (8.13.8/8.13.8) with ESMTP id l0338QgE006438
for <gentoo-doc-cvs@lists.gentoo.org>; Wed, 3 Jan 2007 03:08:26 GMT
Received: from lark (lark.gentoo.osuosl.org [140.211.166.177])
(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
(No client certificate requested)
by smtp.gentoo.org (Postfix) with SMTP id 212AA6484C
for <gentoo-doc-cvs@lists.gentoo.org>; Wed, 3 Jan 2007 03:08:26 +0000 (UTC)
Received: by lark (sSMTP sendmail emulation); Wed, 3 Jan 2007 03:08:25 +0000
From: "Josh Saddler" <nightmorph@lark.gentoo.org>
Date: Wed, 3 Jan 2007 03:08:25 +0000
To: gentoo-doc-cvs@lists.gentoo.org
Subject: [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
Message-Id: <20070103030826.212AA6484C@smtp.gentoo.org>
Precedence: bulk
List-Post: <mailto:gentoo-doc-cvs@lists.gentoo.org>
List-Help: <mailto:gentoo-doc-cvs+help@gentoo.org>
List-Unsubscribe: <mailto:gentoo-doc-cvs+unsubscribe@gentoo.org>
List-Subscribe: <mailto:gentoo-doc-cvs+subscribe@gentoo.org>
List-Id: Gentoo Linux mail <gentoo-doc-cvs.gentoo.org>
X-BeenThere: gentoo-doc-cvs@gentoo.org
Reply-to: docs-team@lists.gentoo.org
X-Archives-Salt: fd323fec-9641-4664-b523-a0361e6b6a0c
X-Archives-Hash: 1d2a51cbfee835933c0f9caa7371fb34
nightmorph 07/01/03 03:08:25
Modified: gentoo-freebsd.xml
Log:
updated the gentoo-freeBSD guide per flameeyes' request
Revision Changes Path
1.23 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.23&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.23&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.22&r2=1.23
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- gentoo-freebsd.xml 25 Nov 2006 04:04:43 -0000 1.22
+++ gentoo-freebsd.xml 3 Jan 2007 03:08:25 -0000 1.23
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.22 2006/11/25 04:04:43 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.23 2007/01/03 03:08:25 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -20,6 +20,12 @@
<author title="Author">
<mail link="chriswhite@gentoo.org">Chris White</mail>
</author>
+<author title="Contributor">
+ <mail link="flameeyes@gentoo.org">Diego Pettenò</mail>
+</author>
+<author title="Editor">
+ <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
+</author>
<abstract>
This document gives some general information on FreeBSD, as well as
@@ -31,8 +37,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.6</version>
-<date>2006-10-06</date>
+<version>2.7</version>
+<date>2007-01-02</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -47,12 +53,15 @@
link="http://www.386bsd.org/">386BSD</uri> stopped, two projects were born:
<uri link="http://www.netbsd.org/">NetBSD</uri>, commonly known to run on a
huge number of architectures, and FreeBSD which supports the x86, amd64, ia64,
-sparc64 and alpha platforms.FreeBSD is renowned for its stability, performance
+sparc64 and alpha platforms. FreeBSD is renowned for its stability, performance
and security, thus being used from small to huge companies all over the world.
-FreeBSD's current production release version is 6.1, which is also used as the
-foundation for the Gentoo/FreeBSD project. The previous 5.x branch is being
-continued by the FreeBSD project as a service release, but is no longer worked
-on by the Gentoo/FreeBSD developers.
+</p>
+
+<p>
+FreeBSD's current production release is version 6.1, although the release of 6.2
+is very near at the time of writing (Release Candidate 2 was released recently).
+Gentoo/FreeBSD development is ongoing on this latter version, while older
+versions are discontinued and no longer supported.
</p>
</body>
@@ -143,9 +152,9 @@
<note>
If you are intending to use FreeSBIE for installing Gentoo/FreeBSD, please make
-sure to use a version based on FreeBSD 6.0! Experimental versions can be downloaded
-from <uri link="http://torrent.freesbie.org/">FreeSBIE's Bittorrent tracker</uri> and
-version 20060118 has been tested to work for the purposes described in this document.
+sure to use a version based on FreeBSD 6.x, such as FreeSBIE 2.0 (or one of its
+release candidates). You can download it from <uri
+link="http://torrent.freesbie.org/">FreeSBIE's Bittorrent tracker</uri>.
</note>
<p>
@@ -256,6 +265,16 @@
</p>
<p>
+When choosing a different mountpoint than <path>/</path> for your partition,
+<c>sysinstall</c> will actually create a 'd' slice, which the bootloader won't
+boot from. To fix this, run the following:
+</p>
+
+<pre caption="Fixing the root partition letter">
+# <i>disklabel ad0s1 | sed 's/^ d:/ a:/g' | disklabel -w ad0s1</i>
+</pre>
+
+<p>
This will finalize the partitioning process, and format the drive in UFS for
FreeBSD to utilize. This will also mount the drive for you at the mount point
specified earlier (<path>/mnt/gentoo</path>). You can verify this worked by
@@ -265,7 +284,7 @@
<pre caption="Verifying the new disk layout was mounted with mount">
# <i>mount</i>
...
-/dev/ad0s1d on /mnt/gentoo (ufs, local)
+/dev/ad0s1a on /mnt/gentoo (ufs, local)
</pre>
<p>
@@ -289,33 +308,20 @@
<pre caption="Obtaining and unpacking a stage3 tarball">
# <i>cd /mnt/gentoo/</i>
<comment>(Any other Gentoo mirror which includes the experimental/ directory will also work.)</comment>
-# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/gentoo-freebsd-6.1-stage-20060802.tar.bz2</i>
-# <i>tar -jxvpf gentoo-freebsd-6.1-stage-20060802.tar.bz2</i>
+# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/stage3-x86-freebsd-6.2_rc2.tar.bz2</i>
+# <i>tar -jxvpf stage3-x86-freebsd-6.2_rc2.tar.bz2</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
-# <i>rm gentoo-freebsd-6.1-stage-20060802.tar.bz2</i>
-</pre>
-
-<p>
-Before chrooting into the newly-extracted stage, you first must obtain an
-up-to-date copy of the Gentoo/FreeBSD overlay. The easiest way to achieve this
-is to to get our latest snapshot which you then extract to
-<path>/mnt/gentoo/usr/local/portage</path>.
-</p>
-
-<pre caption="Getting the Gentoo/FreeBSD Portage overlay">
-# <i>cd /mnt/gentoo/usr/local/portage</i>
-# <i>wget http://gentoo.osuosl.org/experimental/snapshots/portage-alt-overlay-latest.tar.bz2</i>
-# <i>tar -xjf portage-alt-overlay-latest.tar.bz2</i>
-<comment>(You now can safely delete the snapshot with the following command.)</comment>
-# <i>rm portage-alt-overlay-latest.tar.bz2</i>
+# <i>rm stage3-x86-freebsd-6.2_rc2.tar.bz2</i>
</pre>
-<p>
-Alternatively, you can use Subversion to check out the current version of the
-overlay. To do this, please refer to the <uri
+<note>
+If you want you can use the transition overlay that contains semi-experimental
+ebuilds with patches not yet in the main Portage tree, but does allow a wider
+range of supported packages, please refer to the <uri
link="/proj/en/gentoo-alt/contribute/index.xml?part=1&chap=3">Gentoo/ALT
-overlay documentation</uri>.
-</p>
+overlay documentation</uri>. Please note that the overlay is not critical and
+you can easily install and use Gentoo/FreeBSD without it.
+</note>
<p>
In order for your install to work, you need to mount the <path>/dev</path>
@@ -351,25 +357,19 @@
</pre>
<pre caption="Setting up the profile and editing /etc/make.conf">
-# <i>ln -sf /usr/portage/profiles/default-bsd/fbsd/6.1/x86/ /etc/make.profile</i>
+# <i>ln -sf /usr/portage/profiles/default-bsd/fbsd/6.2/x86/ /etc/make.profile</i>
# <i>nano /etc/make.conf</i>
<comment>(Please make sure you add at least the following entries:)</comment>
-CHOST="i686-gentoo-freebsd6.1"
-ACCEPT_KEYWORDS="~x86-fbsd"
-FEATURES="-sandbox collision-protect"
-PORTDIR_OVERLAY="/usr/local/portage/portage-alt-overlay"
+CHOST="i486-gentoo-freebsd6.2"
+FEATURES="collision-protect"
</pre>
<note>
-Sandbox is disabled as it has not yet been ported to Gentoo/FreeBSD.
-</note>
-
-<note>
-You can have a very limited system by using ~x86-fbsd keyword alone; you might
-want to put ~x86 in your ACCEPT_KEYWORDS if you want access to more packages
-but you might find broken dependencies and non-working packages; please rather
-use package.keywords when testing packages and report working ones on <uri
-link="http://bugs.gentoo.org">Bugzilla</uri> for the product Gentoo/Alt.
+The <c>~x86-fbsd</c> keyword does not yet fully cover the same tree as
+<c>~x86</c>, but please <e>do not</e> put <c>~x86</c> in ACCEPT_KEYWORDS. Rather
+use <path>/etc/portage/package.keywords</path> to test packages, and report
+working packages on <uri
+link="http://bugs.gentoo.org/enter_bug.cgi?product=Gentoo%2FAlt">Bugzilla</uri>.
</note>
<p>
@@ -470,7 +470,42 @@
<p>
This will give us a complete kernel to work with. Now we'll need to setup the
bootloader for the kernel to boot. The next chapter will discuss two methods of
-setting up the bootloader: <c>grub</c> and <c>boot0</c>.
+setting up the bootloader: <c>boot0</c> and <c>grub</c>.
+</p>
+
+</body>
+</section>
+<section>
+<title>Setting up the bootloader (boot0)</title>
+<body>
+
+<impo>
+<c>boot0</c> is the FreeBSD bootloader. Previously, it was the only supported
+bootloader until <c>grub</c> was introduced into ports with UFS slice support.
+To install and configure <c>boot0</c>, run the following. Remember to replace
+<c>adXsY</c> with the actual number and slice of your disk.
+</impo>
+
+<pre caption="Installing and setting up boot0">
+# <i>emerge boot0</i>
+<comment>(Leave the chroot environment)</comment>
+# <i>exit</i>
+<comment>(Issued from outside the chroot)</comment>
+# <i>fdisk -B -b /mnt/gentoo/boot/boot0 /dev/adX</i>
+# <i>chroot /mnt/gentoo /bin/bash</i>
+# <i>disklabel -B adXsY</i>
+</pre>
+
+<p>
+If you need additional information on setting up <c>boot0</c>, please consult
+<uri
+link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/boot.html">chapter
+12</uri> of the FreeBSD handbook. Now it's time to do some basic system
+configuration and settings.
+</p>
+
+<p>
+The next section will look at using the alternative bootloader, <c>grub</c>.
</p>
</body>
@@ -533,40 +568,11 @@
grub> <i>boot</i>
</pre>
-<p>
-The next section will look at using the alternative bootloader, <c>boot0</c>.
-</p>
-
-</body>
-</section>
-<section>
-<title>Setting up the bootloader (boot0)</title>
-<body>
-
-<impo>
-<c>boot0</c> is the FreeBSD bootloader. Previously, it was the only supported
-bootloader until <c>grub</c> was introduced into ports with UFS slice support.
-To install and configure <c>boot0</c>, run the following. Remember to replace
-<c>adXsY</c> with the actual number and slice of your disk.
-</impo>
-
-<pre caption="Installing and setting up boot0">
-# <i>emerge boot0</i>
-<comment>(Leave the chroot environment)</comment>
-# <i>exit</i>
-<comment>(Issued from outside the chroot)</comment>
-# <i>fdisk -B -b /mnt/gentoo/boot/boot0 /dev/adX</i>
-# <i>chroot /mnt/gentoo /bin/bash</i>
-# <i>disklabel -B adXsY</i>
-</pre>
-
-<p>
-If you need additional information on setting up <c>boot0</c>, please consult
-<uri
-link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/boot.html">chapter
-12</uri> of the FreeBSD handbook. Now it's time to do some basic system
-configuration and settings.
-</p>
+<note>
+For more information on configuring grub, please refer to the <uri
+link="/doc/en/handbook/handbook-x86.xml?part=1&chap=10#doc_chap2">Gentoo
+Linux Handbook</uri>.
+</note>
</body>
</section>
@@ -619,8 +625,9 @@
<pre caption="Setting the domainname">
# <i>nano /etc/conf.d/domainname</i>
-<comment>(Set the DNSDOMAIN variable to your domain name)</comment>
-DNSDOMAIN="homenetwork"
+<comment>(Set the dns_domain variable to your domain name, and lo to your local
+network interface)</comment>
+dns_domain_lo="homenetwork"
</pre>
<p>
@@ -630,10 +637,17 @@
<pre caption="Setting the NIS domainname">
# <i>nano /etc/conf.d/domainname</i>
-<comment>(Set the NISDOMAIN variable to your NIS domain name)</comment>
-NISDOMAIN="my-nisdomain"
+<comment>(Set the nis_domain variable to your NIS domain name, and lo to your local network interface)</comment>
+nis_domain_lo="my-nisdomain"
</pre>
+<note>
+For more information on domainnames and networking, please refer to the <uri
+link="/doc/en/handbook/handbook-x86.xml?part=1&chap=8#doc_chap2">Gentoo
+Linux Handbook</uri>, and please read the documentation in
+<path>/etc/conf.d/net.example</path>.
+</note>
+
<p>
In case you need to use another keyboard layout for your language, you have to
set the correct value in <path>/etc/conf.d/syscons</path>. The following example
@@ -742,8 +756,8 @@
from you.
</li>
<li>
- Other areas where we need help include: system ebuilds, baselayout,
- creation of installation CDs, documentation, kernel hacking.
+ Other areas where we need help include: system ebuilds, creation of
+ installation CDs, documentation, kernel hacking.
</li>
</ul>
@@ -763,14 +777,8 @@
<li>
Some init scripts depend on the clock service which we don't provide right
now. You can just remove it from the dependencies of the script and report
- that on our <uri link="http://bugs.gentoo.org/">bugzilla</uri>. Please
- remember to use the "Gentoo BSD" product for your submission.
- </li>
- <li>glib and gnome in general need a lot of fixes to be backported.</li>
- <li>
- The init system currently provided by Gentoo/FreeBSD's baselayout package is
- not the same version used by Gentoo Linux and lacks some of its features. Work
- on making newer versions working is underway.
+ that on our <uri link="http://bugs.gentoo.org/">Bugzilla</uri>. Please
+ remember to use the "Gentoo/Alt" product for your submission.
</li>
</ul>
--
gentoo-doc-cvs@gentoo.org mailing list