[gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml

[Josh Saddler]

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@g.o">Chris White</mail>
 </author>
+<author title="Contributor">
+  <mail link="flameeyes@g.o">Diego Pettenò</mail>
+</author>
+<author title="Editor">
+  <mail link="nightmorph@g.o">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&amp;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&gt; <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&amp;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&amp;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@g.o mailing list