* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-10-06 21:48 Josh Saddler
0 siblings, 0 replies; 30+ messages in thread
From: Josh Saddler @ 2006-10-06 21:48 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/10/06 21:48:26
Modified: gentoo-freebsd.xml
Log:
updated gentoo-freebsd guide for bug 149766
Revision Changes Path
1.21 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.21&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.21&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.20&r2=1.21
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- gentoo-freebsd.xml 26 May 2006 19:29:27 -0000 1.20
+++ gentoo-freebsd.xml 6 Oct 2006 21:48:25 -0000 1.21
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.20 2006/05/26 19:29:27 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.21 2006/10/06 21:48:25 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -17,6 +17,9 @@
<author title="Author">
<mail link="ka0ttic@gentoo.org">Aaron Walker</mail>
</author>
+<author title="Author">
+ <mail link="chriswhite@gentoo.org">Chris White</mail>
+</author>
<abstract>
This document gives some general information on FreeBSD, as well as
@@ -28,8 +31,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.5</version>
-<date>2006-05-26</date>
+<version>2.6</version>
+<date>2006-10-06</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -125,7 +128,7 @@
<chapter>
<title>Installing Gentoo/FreeBSD</title>
<section>
-<title>Installation instructions</title>
+<title>Booting the CD</title>
<body>
<p>
@@ -133,8 +136,8 @@
Gentoo/FreeBSD. Unfortunately, we currently lack our own installation media, so
you have to choose between two alternative installation methods. The first
would be to use an existing FreeBSD installation to partition your hard drive
-and use it as a base for installing Gentoo/FreeBSD. Alternatively, you can also
-use the excellent <uri link="http://www.freesbie.org/">FreeSBIE LiveCD</uri> as
+and use it as a base for installing Gentoo/FreeBSD. This guide will describe how
+to use the <uri link="http://www.freesbie.org/">FreeSBIE LiveCD</uri> as
an installation medium for Gentoo/FreeBSD.
</p>
@@ -145,66 +148,151 @@
version 20060118 has been tested to work for the purposes described in this document.
</note>
+<p>
+First, boot the CD in order to begin the installation process. You'll be
+presented with a login screen. The username is <c>freesbie</c>, and there is
+no password. Next, run <c>sudo su</c> to become root, and optionally setup a
+password. If you want to pass time during the installation process, you can run
+<c>startx</c> to enter into an Xfce environment, suitable for web browsing,
+AIM, and other things. Unlike Linux, FreeBSD bases the name of your interface
+on the driver for the interface. For example, the Intel EtherExpress driver
+(fxp) appears as fxp0 (driver fxp, first network card). To see what your
+interface is, use <c>ifconfig</c>:
+</p>
+
+<pre caption="Finding out the network interface name using ifconfig">
+# <i>ifconfig</i>
+fxp0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 1500
+ options=8<VLAN_MTU>
+ inet6 fe80::2d0::b7ff:febc:4fe3%fxp0 prefixlen 64 scopeid 0x1
+ inet 192.168.0.106 netmask 0xffffff00 broadcast 192.168.0.255
+ ether 00:d0:b7:bc:4f:e3
+ media: Ethernet autoselect (100baseTX <full-duplex>)
+ status: active
+lo0: flags=8007<LOOPBACK,MULTICAST> mtu 16384
+</pre>
+
+<p>
+If the original DHCP request during the CD bootup failed, you can use the
+<c>dhclient</c> command to obtain an IP:
+</p>
+
+<pre caption="Obtaining a DHCP address using dhclient">
+# <i>dhclient fxp0</i>
+DHCPDISCOVER on fxp0 to 255.255.255.255 port 67 interval 9
+DHCPOFFER from 192.168.0.1
+DHCPREQUEST on fxp0 to 255.255.255.255 port 67
+DHCPACK from 192.168.0.1
+bound to 192.168.0.106 -- renewal in 302400 seconds
+</pre>
+
<note>
-We use <c>ee</c> as a default editor in this guide but you can choose
-<c>vim</c>, <c>nano</c> or any other editor you like to configure your system.
+The output presented here will differ based on your network.
</note>
<p>
-Before you can begin with the installation, you have to setup a hard disk for
-use with Gentoo/FreeBSD. This can either be done via <c>sysinstall</c>
-(available from a current FreeBSD installation as well as from within FreeSBIE)
-or by manually using the commands <c>fdisk</c>, <c>disklabel</c> and <c>newfs</c>.
-If you have never set up a FreeBSD system before, <c>sysinstall</c> may be the
-better option for you. In that case make sure that you don't use the sysinstall
-launched by FreeBSD's or FreeSBIE's installers, but use the following command instead:
+Next, create the chroot for your installation:
</p>
-<pre caption="Partitioning with sysinstall">
-# <i>sysinstall diskPartitionEditor diskPartitionWrite diskLabelEditor diskLabelCommit</i>
+<pre caption="Making the chroot directory">
+# <i>mkdir /mnt/gentoo</i>
</pre>
+<note>
+There is a bug in the <uri
+link="http://dev.gentoo.org/~flameeyes/minimal-freesbie-drizzt.iso.bz2">
+minimal Freesbie CD</uri> that prevents the creation of the
+<path>/mnt/gentoo</path> mount point. To avoid this, use <path>/mnt</path>
+instead of <path>/mnt/gentoo</path> in the following sections.
+</note>
+
+</body>
+</section>
+<section>
+<title>Partitioning the Drive</title>
+<body>
+
<p>
-If you face difficulties
-while partitioning or formatting your hard disks, have a look at the great
-<uri link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
-Handbook</uri> or hop onto <c>#gentoo-bsd</c> on the Freenode IRC server.
+Now that we have a mount point, it's time to partition the drive. This is done
+with the <c>sysinstall</c> command:
</p>
+<pre caption="Running the sysinstall command to fdisk the drive">
+# <i>sysinstall diskPartitionEditor diskPartitionWrite</i>
+</pre>
+
<p>
-Once you're done setting up your disks, you have to create a mount point for
-your Gentoo/FreeBSD installation and mount all the necessary partitions.
+We recommend that you use the default layout. Press enter at the dialog, then
+press <b>a</b> followed by <b>q</b> to accept the default layout. The next
+screen will present you with the option of a bootloader. For this option,
+choose "None" as we'll be installing the bootloader later on. Next comes the
+actual partition sizing and mount points.
</p>
-<pre caption="Creating a mount point and mounting partitions">
-# <i>mkdir /mnt/gentoo</i>
-<comment>(Replace X with the correct numbers for your hard disk.)</comment>
-# <i>mount /dev/adXsXa /mnt/gentoo</i>
+<p>
+This next step also uses <c>sysinstall</c>, but with different arguments:
+</p>
+
+<pre caption="Running sysinstall to setup partition sizing and mount points">
+# <i>sysinstall diskLabelEditor diskLabelCommit</i>
</pre>
<p>
-If you're using the FreeSBIE LiveCD and you already had an UFS partition on
-your hard disk, it has already been mounted read-only to <path>/mnt/ufs.1</path>.
-If you want to use that location for your installation, you'll have to remount it
-in read-write mode:
+Here, we'll refrain from using the automatic layout, and create one giant root
+partition, followed by a swap partition. Hit <b>c</b> to create a new
+partition. A dialog prompts you to enter a size. Go ahead and do so, using
+MB/GB for setting different sizes, or C for cylinders. For root, choose FS as
+the partition type, and set the mount point as <path>/mnt/gentoo</path>. <e>If
+you do not adjust the mount point, it will overwrite the FreeSBIE
+environment!</e>. As <path>/boot</path> is not a separate partition, you'll
+need to disable soft-updates, or your system will not boot! To do so, use the
+arrow keys to navigate to your newly created partition, then hit the <b>s</b>
+key, until "Newfs" contains no <b>+S</b>. Now navigate the arrow keys until
+the "Disk" line is highlighted, and hit <b>c</b> again to create a swap
+partition. Generally, we recommend a swap space that is twice the size of your
+RAM. Choose SWAP as the partition type, and don't worry about soft-updates, as
+it does not apply to swap. Now we're finished, so hit <b>q</b> to finish the
+process.
+</p>
+
+<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
+running <c>mount</c>:
</p>
-<pre caption="Remounting a partition in read-write mode">
-# <i>mount -u -o rw /mnt/ufs.1</i>
+<pre caption="Verifying the new disk layout was mounted with mount">
+# <i>mount</i>
+...
+/dev/ad0s1d on /mnt/gentoo (ufs, local)
</pre>
<p>
-Now that you have mounted the target partition, it is time to fetch and unpack
-a stage3 tarball.
+Now that you have mounted the target partition, it is time to start on the Gentoo
+setup.
+</p>
+
+</body>
+</section>
+<section>
+<title>Gentoo Setup</title>
+<body>
+
+<p>
+First, we need to download a stage3 tarball and unpack it into the chroot.
+Point your browser to
+<uri>http://gentoo.osuosl.org/experimental/x86/freebsd/stages/</uri>, grab the
+latest snapshot, and unpack it into the mountpoint:
</p>
<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-20060509.tar.bz2</i>
-# <i>tar -jxvpf gentoo-freebsd-6.1-stage-20060509.tar.bz2</i>
+# <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>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
-# <i>rm gentoo-freebsd-6.1-stage-20060509.tar.bz2</i>
+# <i>rm gentoo-freebsd-6.1-stage-20060802.tar.bz2</i>
</pre>
<p>
@@ -223,10 +311,9 @@
</pre>
<p>
-Alternatively, you can also use Subversion to check out the current version of
-the overlay. If you are interested in this possibility, please refer to the
-<uri
-link="/proj/en/gentoo-alt/contribute/index.xml?part=1&chap=3">Gentoo/ALT
+Alternatively, you can use Subversion to check out the current version of the
+overlay. To do this, please refer to the <uri
+link="/proj/en/gentoo-alt/contribute/index.xml?part=1&chap=3">Gentoo/ALT
overlay documentation</uri>.
</p>
@@ -240,7 +327,7 @@
# <i>mount -t devfs none /mnt/gentoo/dev/</i>
# <i>cp /etc/resolv.conf /mnt/gentoo/etc</i>
# <i>chroot /mnt/gentoo/ /bin/bash</i>
-# <i>source /etc/profile</i>
+# <i>env-update && source /etc/profile</i>
</pre>
<p>
@@ -265,8 +352,7 @@
<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>
-<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment>
-# <i>ee /etc/make.conf</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"
@@ -275,6 +361,10 @@
</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
@@ -283,15 +373,6 @@
</note>
<p>
-In order to boot correctly, you will need to create the <path>/proc</path>
-directory.
-</p>
-
-<pre caption="Creating the /proc directory">
-# <i>mkdir /proc</i>
-</pre>
-
-<p>
If you want, you can now rebuild the system's core packages.
</p>
@@ -299,8 +380,17 @@
# <i>emerge -e system</i>
</pre>
+</body>
+</section>
+</chapter>
+<chapter>
+<title>Setting up for Booting</title>
+<section>
+<title>Kernel Installation</title>
+<body>
+
<p>
-When you did <c>emerge -e system</c>, the sources for the FreeBSD kernel got
+If you ran <c>emerge -e system</c>, the sources for the FreeBSD kernel were
installed to <path>/usr/src/sys</path>. If you skipped this step, you can get
them in the following way:
</p>
@@ -310,28 +400,187 @@
</pre>
<p>
-Configuring and compiling a custom kernel is really different from compiling
+Configuring and compiling a custom kernel is quite different from compiling
Linux, so if you are not familiar with the process we encourage you to have a
look at <uri
link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html">
-chapter 8</uri> of the FreeBSD handbook.
+chapter 8</uri> of the FreeBSD handbook. For now, you can do an installation of
+the GENERIC kernel, which works on most systems. To begin, enter the source
+directory for the kernel:
</p>
-<p>
+<impo>
Please note that currently only the "Traditional" way of building the kernel is
-supported on Gentoo/FreeBSD! Also note that <c>make install</c> will probably
-ask you for a <path>/boot/device.hints</path> file. A default version can be
-found in the <path>conf</path> subdirectory of the <c>GENERIC</c> configuration
-and is called <path>GENERIC.hints</path>.
+supported on Gentoo/FreeBSD!
+</impo>
+
+<pre caption="Entering the kernel source directory">
+# <i>cd /usr/src/sys/</i>
+</pre>
+
+<p>
+Looking over the layout, you'll see various architectures and subdirectories
+for various parts of the kernel. To begin the installation, we head into the
+<path>i386/conf/</path> directory:
+</p>
+
+<pre caption="The kernel configuration directory">
+# <i>cd i386/conf/</i>
+# <i>ls</i>
+.cvsignore GENERIC Makefile PAE
+DEFAULTS GENERIC.hints NOTES SMP
+</pre>
+
+<p>
+The main files to note are <path>GENERIC</path> and <path>GENERIC.hints</path>.
+As it will be needed by the installation of the kernel, go ahead and copy
+<path>GENERIC.hints</path> file to <path>/boot/device.hints</path>:
+</p>
+
+<pre caption="Copying over the GENERIC.hints file">
+# <i>cp GENERIC.hints /boot/device.hints</i>
+</pre>
+
+<p>
+This file is used by the kernel drivers for basic configuration information
+such as IRQ settings. Now it's time to configure the kernel. FreeBSD uses the
+<c>config</c> command to do this. <c>config</c> uses the given file (in this
+instance GENERIC) to copy over the required build files to a
+<path>compile</path> directory in the parent directory. <path>GENERIC</path> is
+similiar to the <path>.config</path> file for the Linux kernel. Run
+<c>config</c> to produce the build directory:
+</p>
+
+<pre caption="Configuring the kernel build">
+# <i>config GENERIC</i>
+Kernel build directory is ../compile/GENERIC
+Don't forget to ''make cleandepend; make depend''
+</pre>
+
+<p>
+<c>config</c> has created a GENERIC build directory for us in the parent
+directory. <c>cd</c> into it, then run the following to do a complete build:
</p>
+<pre caption="Building and installing the kernel">
+# <i>cd ../compile/GENERIC</i>
+# <i>make cleandepend && make depend && make && make install</i>
+</pre>
+
<p>
-Now is the time to do some basic system configuration and settings. First, we
-are going to setup the filesystem mounting points in <path>/etc/fstab</path>.
+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>.
+</p>
+
+</body>
+</section>
+<section>
+<title>Setting up the bootloader (grub)</title>
+<body>
+
+<p>
+As of grub 0.97-r1, UFS slices are readable to <c>grub</c>. This lets us use
+<c>grub</c> as a bootloader, the prefered method for those coming from a Linux
+background. To begin, emerge <c>grub</c> and setup the label as bootable.
+Remember to replace <c>adXsY</c> with the actual number and slice of your disk.
+</p>
+
+<pre caption="Emerge grub">
+# <i>emerge grub</i>
+# <i>disklabel -B adXsY</i>
+</pre>
+
+<p>
+Now run <c>grub</c> to bring up the command prompt, and set up the partition as
+shown:
+</p>
+
+<pre caption="Setting up grub">
+<comment>(This is done to prevent disk error 29)</comment>
+# <i>sysctl kern.geom.debugflags=16</i>
+# <i>grub</i>
+<comment>(Example using ad0s1d)</comment>
+grub> <i>root (hd0,0,d)</i>
+ Filesystem type is ufs2, partition type 0xa5
+
+grub> <i>setup (hd0)</i>
+ Checking if "/boot/grub/stage1" exists... yes
+ Checking if "/boot/grub/stage2" exists... yes
+ Checking if "/boot/grub/ufs2_stage1_5" exists... yes
+ Running "embed /boot/grub/ufs2_stage1_5 (hd0)"... 14 sectors are embedded.
+succeeded
+ Running "install /boot/grub/stage1 (hd0) (hd0)1+14 p (hd0,0,d)/boot/grub/stage
+2 /boot/grub/menu.lst"... succeeded
+Done.
+
+grub> quit
+</pre>
+
+<p>
+When you first boot, you may not receive a grub menu. If so, run this at the
+prompt:
+</p>
+
+<pre caption="Booting the kernel with no menu">
+grub> <i>find /boot/grub/stage1</i>
+<comment>(The output here is what you'll use in the next command)</comment>
+ (hd0,0,d)
+
+grub> <i>kernel (hd0,0,d)/boot/loader</i>
+ [FreeBSD-a.out, loadaddr=0x200000, text=0x1000, data=0x3a000, bss=0x0, entry=0x200000]
+
+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>
+
+</body>
+</section>
+<section>
+<title>System configuration</title>
+<body>
+
+<p>
+First, we are going to setup the filesystem mounting points in
+<path>/etc/fstab</path>.
</p>
<pre caption="Editing the filesystem in /etc/fstab">
-# <i>ee /etc/fstab</i>
+# <i>nano /etc/fstab</i>
<comment>(This is an example, replace X and Y with the correct numbers for your hard disk.)</comment>
#Device Mountpoint Fstype Options Dump Pass
/dev/adXsYb none swap sw 0 0
@@ -343,22 +592,14 @@
<p>
Now would also be a good time to set up your network connection before the final
-reboot.
-</p>
-
-<p>
-You can find all the information necessary to configure your network in the
-<uri link="/doc/en/handbook/handbook-x86.xml?part=4&chap=1">Gentoo
-Handbook</uri>.
-</p>
-
-<p>
-To have your network interface activated at boot time, you have to add it to
-the default runlevel.
+reboot. You can find all the information necessary to configure your network in
+the <uri link="/doc/en/handbook/handbook-x86.xml?part=4&chap=1">Gentoo
+Handbook</uri>. To have your network interface activated at boot time, you have
+to add it to the default runlevel:
</p>
<pre caption="Adding your network adapter to the default runlevel">
-# <i>rc-update add net.rl0 default</i>
+# <i>rc-update add net.fxp0 default</i>
</pre>
<p>
@@ -366,7 +607,7 @@
</p>
<pre caption="Setting up the machine's hostname">
-# <i>ee /etc/conf.d/hostname</i>
+# <i>nano /etc/conf.d/hostname</i>
<comment>(Set the HOSTNAME variable to your hostname)</comment>
HOSTNAME="tux"
</pre>
@@ -377,7 +618,7 @@
</p>
<pre caption="Setting the domainname">
-# <i>ee /etc/conf.d/domainname</i>
+# <i>nano /etc/conf.d/domainname</i>
<comment>(Set the DNSDOMAIN variable to your domain name)</comment>
DNSDOMAIN="homenetwork"
</pre>
@@ -388,7 +629,7 @@
</p>
<pre caption="Setting the NIS domainname">
-# <i>ee /etc/conf.d/domainname</i>
+# <i>nano /etc/conf.d/domainname</i>
<comment>(Set the NISDOMAIN variable to your NIS domain name)</comment>
NISDOMAIN="my-nisdomain"
</pre>
@@ -401,37 +642,11 @@
</p>
<pre caption="Changing your keyboard layout (Optional)">
-# <i>ee /etc/conf.d/syscons</i>
+# <i>nano /etc/conf.d/syscons</i>
KEYMAP="spanish.iso.acc"
<comment>(Possible layouts can be found in /usr/share/syscons/keymaps).</comment>
</pre>
-<impo>
-Please make absolutely sure you add your new Gentoo/FreeBSD installation to the
-configuration of your bootloader, otherwise you won't be able to boot your newly
-installed system! If you don't have another bootloader installed, you should use
-<c>boot0</c>, as it is currently the only one supported by FreeBSD. In this case
-please don't forget to use your other operating systems to <c>boot0</c>'s
-configuration.
-</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.
-</p>
-
<p>
Now would be a good time to set a password for the <c>root</c> user and to add
another user account for your day-to-day work.
@@ -439,8 +654,43 @@
<pre caption="Changing the root password and adding a new user">
# <i>passwd</i>
-<comment>(If you need help in adding a user please consult the FreeBSD handbook).</comment>
# <i>adduser</i>
+Username: <i>fred</i>
+Full Name: <i>Fred Smith</i>
+<comment>(Accepting the default here, just hit Enter.)</comment>
+Uid (Leave empty for default):
+<comment>(OK to accept the default here as well; hit Enter.)</comment>
+Login group [fred]:
+<comment>(Enter your groups here, space separated. They must exist.)</comment>
+Login group is fred. Invite fred into other groups? []: wheel portage
+<comment>(OK to accept the default here, hit Enter)</comment>
+Login class [default]:
+<comment>(Somewhat of a personal preference. Make sure the shell exists in /etc/shells)</comment>
+Shell (sh bash tcsh csh esh ksh zsh sash nologin) [sh] <i>bash</i>
+<comment>(OK to accept the default here, hit Enter for all these)</comment>
+User password-based authentication [yes]
+Use an empty password (yes/no) [no]:
+Use a random password? (yes/no) [no]:
+Enter password: <i>password goes here</i>
+Enter password again: <i>retype it</i>
+<comment>(OK to accept the default here, hit Enter)</comment>
+Lock out the account after creation? [no]:
+Username : fred
+Password : *****
+Full Name : Fred Smith
+<comment>(This will vary)</comment>
+Uid : 1002
+Class :
+Groups : fred wheel portage
+Home : /home/fred
+Shell : /bin/bash
+Locked : no
+<comment>(Confirm the information is correct)</comment>
+OK? (yes/no): <i>yes</i>
+adduser: INFO: Sucessfully added (fred) to the user database
+Add another user? (yes/no): <i>no</i>
+Goodbye!
+#
</pre>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2008-06-02 18:58 Camille Huot
0 siblings, 0 replies; 30+ messages in thread
From: Camille Huot @ 2008-06-02 18:58 UTC (permalink / raw
To: gentoo-doc-cvs
cam 08/06/02 18:58:52
Modified: gentoo-freebsd.xml
Log:
#224613 Update stage3 file name + add a note about umounting before disklabel
Revision Changes Path
1.31 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.31&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.31&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.30&r2=1.31
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- gentoo-freebsd.xml 20 May 2008 18:38:54 -0000 1.30
+++ gentoo-freebsd.xml 2 Jun 2008 18:58:52 -0000 1.31
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.30 2008/05/20 18:38:54 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.31 2008/06/02 18:58:52 cam Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -40,8 +40,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.11</version>
-<date>2007-05-17</date>
+<version>2.12</version>
+<date>2008-06-02</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -256,6 +256,11 @@
boot from. To fix this, run the following:
</p>
+<note>
+Please, make sure ad0s1 is unmounted before running the following command,
+otherwise it will not work.
+</note>
+
<pre caption="Fixing the root partition letter">
# <i>disklabel ad0s1 | sed 's/^ d:/ a:/' | disklabel -R ad0s1 /dev/stdin</i>
</pre>
@@ -294,10 +299,10 @@
<pre caption="Obtaining and unpacking a stage3 tarball">
# <i>cd /mnt/</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/stage3-x86-freebsd-6.2.tar.bz2</i>
-# <i>tar -jxvpf stage3-x86-freebsd-6.2.tar.bz2</i>
+# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/stage3-x86-freebsd-6.2-r1.tar.bz2</i>
+# <i>tar -jxvpf stage3-x86-freebsd-6.2-r1.tar.bz2</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
-# <i>rm stage3-x86-freebsd-6.2.tar.bz2</i>
+# <i>rm stage3-x86-freebsd-6.2-r1.tar.bz2</i>
</pre>
<note>
--
gentoo-doc-cvs@lists.gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2008-05-20 18:38 Sven Vermeulen
0 siblings, 0 replies; 30+ messages in thread
From: Sven Vermeulen @ 2008-05-20 18:38 UTC (permalink / raw
To: gentoo-doc-cvs
swift 08/05/20 18:38:54
Modified: gentoo-freebsd.xml
Log:
Coding style
Revision Changes Path
1.30 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.30&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.30&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.29&r2=1.30
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- gentoo-freebsd.xml 17 May 2007 15:50:28 -0000 1.29
+++ gentoo-freebsd.xml 20 May 2008 18:38:54 -0000 1.30
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.29 2007/05/17 15:50:28 cam Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.30 2008/05/20 18:38:54 swift Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -274,8 +274,8 @@
</pre>
<p>
-Now that you have mounted the target partition, it is time to start on the Gentoo
-setup.
+Now that you have mounted the target partition, it is time to start on the
+Gentoo setup.
</p>
</body>
--
gentoo-doc-cvs@lists.gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2007-05-11 0:11 Camille Huot
0 siblings, 0 replies; 30+ messages in thread
From: Camille Huot @ 2007-05-11 0:11 UTC (permalink / raw
To: gentoo-doc-cvs
cam 07/05/11 00:11:39
Modified: gentoo-freebsd.xml
Log:
Bumping for previous fix.
Revision Changes Path
1.28 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.28&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.28&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.27&r2=1.28
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- gentoo-freebsd.xml 10 May 2007 23:59:40 -0000 1.27
+++ gentoo-freebsd.xml 11 May 2007 00:11:39 -0000 1.28
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.27 2007/05/10 23:59:40 cam Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.28 2007/05/11 00:11:39 cam Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -40,8 +40,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.9</version>
-<date>2007-05-10</date>
+<version>2.10</version>
+<date>2007-05-11</date>
<chapter>
<title>Introduction to FreeBSD</title>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2007-05-10 23:59 Camille Huot
0 siblings, 0 replies; 30+ messages in thread
From: Camille Huot @ 2007-05-10 23:59 UTC (permalink / raw
To: gentoo-doc-cvs
cam 07/05/10 23:59:40
Modified: gentoo-freebsd.xml
Log:
Fixed notice about 6.2 release
Revision Changes Path
1.27 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.27&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.27&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.26&r2=1.27
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- gentoo-freebsd.xml 10 May 2007 22:00:51 -0000 1.26
+++ gentoo-freebsd.xml 10 May 2007 23:59:40 -0000 1.27
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.26 2007/05/10 22:00:51 cam Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.27 2007/05/10 23:59:40 cam Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -61,10 +61,9 @@
</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.
+FreeBSD's current production release is version 6.2. Gentoo/FreeBSD is based on
+this version and older versions of Gentoo/FreeBSD are discontinued and no
+longer supported.
</p>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2007-05-10 22:00 Camille Huot
0 siblings, 0 replies; 30+ messages in thread
From: Camille Huot @ 2007-05-10 22:00 UTC (permalink / raw
To: gentoo-doc-cvs
cam 07/05/10 22:00:51
Modified: gentoo-freebsd.xml
Log:
- Replaced /mnt/gentoo by /mnt thanks to Freesbie
- Fixed the disklabel command that didn't work
- Set the time to avoid error messages in the kernel version
- How to use a non-'a' slice to boot
- Added a warning to not use symlink with Grub
Revision Changes Path
1.26 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.26&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.26&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.25&r2=1.26
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- gentoo-freebsd.xml 8 Apr 2007 21:55:42 -0000 1.25
+++ gentoo-freebsd.xml 10 May 2007 22:00:51 -0000 1.26
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.25 2007/04/08 21:55:42 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.26 2007/05/10 22:00:51 cam Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -26,6 +26,9 @@
<author title="Editor">
<mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
</author>
+<author title="Editor">
+ <mail link="cam@gentoo.org">Camille Huot</mail>
+</author>
<abstract>
This document gives some general information on FreeBSD, as well as
@@ -37,8 +40,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.8</version>
-<date>2007-04-08</date>
+<version>2.9</version>
+<date>2007-05-10</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -199,22 +202,6 @@
The output presented here will differ based on your network.
</note>
-<p>
-Next, create the chroot for your installation:
-</p>
-
-<pre caption="Making the chroot directory">
-# <i>mkdir /mnt/gentoo</i>
-</pre>
-
-<note>
-There is a bug in the <uri
-link="http://dev.gentoo.org/~flameeyes/minimal-freesbie-drizzt.iso.bz2">
-minimal Freesbie CD</uri> that prevents the creation of the
-<path>/mnt/gentoo</path> mount point. To avoid this, use <path>/mnt</path>
-instead of <path>/mnt/gentoo</path> in the following sections.
-</note>
-
</body>
</section>
<section>
@@ -251,7 +238,7 @@
partition, followed by a swap partition. Hit <b>c</b> to create a new
partition. A dialog prompts you to enter a size. Go ahead and do so, using
MB/GB for setting different sizes, or C for cylinders. For root, choose FS as
-the partition type, and set the mount point as <path>/mnt/gentoo</path>. <e>If
+the partition type, and set the mount point as <path>/mnt/</path>. <e>If
you do not adjust the mount point, it will overwrite the FreeSBIE
environment!</e> As <path>/boot</path> is not a separate partition, you'll
need to disable soft-updates, or your system will not boot! To do so, use the
@@ -271,20 +258,21 @@
</p>
<pre caption="Fixing the root partition letter">
-# <i>disklabel ad0s1 | sed 's/^ d:/ a:/g' | disklabel -w ad0s1</i>
+# <i>disklabel ad0s1 | sed 's/^ d:/ a:/' > label</i>
+# <i>disklabel -R ad0s1 label</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
+specified earlier (<path>/mnt/</path>). You can verify this worked by
running <c>mount</c>:
</p>
<pre caption="Verifying the new disk layout was mounted with mount">
# <i>mount</i>
...
-/dev/ad0s1a on /mnt/gentoo (ufs, local)
+/dev/ad0s1a on /mnt (ufs, local)
</pre>
<p>
@@ -306,7 +294,7 @@
</p>
<pre caption="Obtaining and unpacking a stage3 tarball">
-# <i>cd /mnt/gentoo/</i>
+# <i>cd /mnt/</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/stage3-x86-freebsd-6.2.tar.bz2</i>
# <i>tar -jxvpf stage3-x86-freebsd-6.2.tar.bz2</i>
@@ -330,9 +318,9 @@
</p>
<pre caption="Mounting the /dev filesystem and chrooting">
-# <i>mount -t devfs none /mnt/gentoo/dev/</i>
-# <i>cp /etc/resolv.conf /mnt/gentoo/etc</i>
-# <i>chroot /mnt/gentoo/ /bin/bash</i>
+# <i>mount -t devfs none /mnt/dev/</i>
+# <i>cp /etc/resolv.conf /mnt/etc/</i>
+# <i>chroot /mnt/ /bin/bash</i>
# <i>env-update && source /etc/profile</i>
</pre>
@@ -386,6 +374,51 @@
<chapter>
<title>Setting up for Booting</title>
<section>
+<title>Set your time zone</title>
+<body>
+
+<p>
+First make sure your date and time is set correctly using <c>date
+yyyymmddHHMM</c>. Use UTC time.
+</p>
+
+<pre caption="Set the date and UTC time">
+<comment>(Check the clock)</comment>
+# <i>date</i>
+Mon Mar 6 00:14:13 UTC 2006
+
+<comment>(Set the current date and time if required)</comment>
+# <i>date 200603060016</i> <comment>(Format is yyyymmddHHMM)</comment>
+Mon Mar 6 00:16:00 UTC 2006
+</pre>
+
+<p>
+Next, set your time zone information by using the correct listing in
+<path>/usr/share/zoneinfo</path>.
+</p>
+
+<pre caption="Setting your timezone">
+# <i>ls /usr/share/zoneinfo</i>
+<comment>(Using Brussels as an example)</comment>
+# <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i>
+
+# <i>date</i>
+Wed Mar 8 00:46:05 CET 2006
+</pre>
+
+<p>
+Edit <path>/etc/conf.d/clock</path> to define the time zone you used
+previously.
+</p>
+
+<pre caption="Edit /etc/conf.d/clock">
+# <i>nano -w /etc/conf.d/clock</i>
+TIMEZONE="Europe/Brussels"
+</pre>
+
+</body>
+</section>
+<section>
<title>Kernel Installation</title>
<body>
@@ -491,8 +524,8 @@
<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>fdisk -B -b /mnt/boot/boot0 /dev/adX</i>
+# <i>chroot /mnt/ /bin/bash</i>
# <i>disklabel -B adXsY</i>
</pre>
@@ -553,6 +586,16 @@
</pre>
<p>
+To make the loader find the kernel on a specific slice (the default is 'a'),
+add a <c>vfs.root.mountfrom</c> line to the <path>/boot/loader.conf</path>
+file:
+</p>
+
+<pre caption="Tell the loader where to look for the kernel">
+# <i>echo 'vfs.root.mountfrom="ufs:ad0s1d"' >> /boot/loader.conf</i>
+</pre>
+
+<p>
When you first boot, you may not receive a grub menu. If so, run this at the
prompt:
</p>
@@ -574,6 +617,12 @@
Linux Handbook</uri>.
</note>
+<warn>
+Grub doesn't follow UFS symlinks so be sure to delete the
+<path>/boot/grub/menu.lst</path> symlink and to use <path>menu.lst</path> to
+setup Grub (<path>grub.conf</path> isn't used).
+</warn>
+
</body>
</section>
<section>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2007-04-08 21:55 Josh Saddler
0 siblings, 0 replies; 30+ messages in thread
From: Josh Saddler @ 2007-04-08 21:55 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 07/04/08 21:55:42
Modified: gentoo-freebsd.xml
Log:
updated freebsd guide to use available non-rc stages, thanks to rbu for reporting
Revision Changes Path
1.25 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.25&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.25&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.24&r2=1.25
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- gentoo-freebsd.xml 4 Apr 2007 14:22:45 -0000 1.24
+++ gentoo-freebsd.xml 8 Apr 2007 21:55:42 -0000 1.25
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.24 2007/04/04 14:22:45 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.25 2007/04/08 21:55:42 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -37,8 +37,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.7</version>
-<date>2007-01-02</date>
+<version>2.8</version>
+<date>2007-04-08</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -308,10 +308,10 @@
<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/stage3-x86-freebsd-6.2_rc2.tar.bz2</i>
-# <i>tar -jxvpf stage3-x86-freebsd-6.2_rc2.tar.bz2</i>
+# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/stage3-x86-freebsd-6.2.tar.bz2</i>
+# <i>tar -jxvpf stage3-x86-freebsd-6.2.tar.bz2</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
-# <i>rm stage3-x86-freebsd-6.2_rc2.tar.bz2</i>
+# <i>rm stage3-x86-freebsd-6.2.tar.bz2</i>
</pre>
<note>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2007-04-04 14:22 Josh Saddler
0 siblings, 0 replies; 30+ messages in thread
From: Josh Saddler @ 2007-04-04 14:22 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 07/04/04 14:22:46
Modified: gentoo-freebsd.xml
Log:
better english, no content change, bug 173315
Revision Changes Path
1.24 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.24&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.24&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.23&r2=1.24
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- gentoo-freebsd.xml 3 Jan 2007 03:08:25 -0000 1.23
+++ gentoo-freebsd.xml 4 Apr 2007 14:22:45 -0000 1.24
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.23 2007/01/03 03:08:25 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.24 2007/04/04 14:22:45 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -337,8 +337,8 @@
</pre>
<p>
-After you got hold of the Gentoo/FreeBSD overlay, it's time to link
-<path>/etc/make.profile</path> to the correct profile and add get your
+After you obtain the Gentoo/FreeBSD overlay, it's time to link
+<path>/etc/make.profile</path> to the correct profile and get your
<path>/etc/make.conf</path> ready for Gentoo/FreeBSD.
</p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2007-01-03 3:08 Josh Saddler
0 siblings, 0 replies; 30+ messages in thread
From: Josh Saddler @ 2007-01-03 3:08 UTC (permalink / raw
To: gentoo-doc-cvs
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 13138 bytes --]
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
^ permalink raw reply [flat|nested] 30+ messages in thread* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-11-25 4:04 Josh Saddler
0 siblings, 0 replies; 30+ messages in thread
From: Josh Saddler @ 2006-11-25 4:04 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/11/25 04:04:43
Modified: gentoo-freebsd.xml
Log:
typo fix, **no content change**
Revision Changes Path
1.22 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.22&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.22&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml?r1=1.21&r2=1.22
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- gentoo-freebsd.xml 6 Oct 2006 21:48:25 -0000 1.21
+++ gentoo-freebsd.xml 25 Nov 2006 04:04:43 -0000 1.22
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.21 2006/10/06 21:48:25 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.22 2006/11/25 04:04:43 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -244,7 +244,7 @@
MB/GB for setting different sizes, or C for cylinders. For root, choose FS as
the partition type, and set the mount point as <path>/mnt/gentoo</path>. <e>If
you do not adjust the mount point, it will overwrite the FreeSBIE
-environment!</e>. As <path>/boot</path> is not a separate partition, you'll
+environment!</e> As <path>/boot</path> is not a separate partition, you'll
need to disable soft-updates, or your system will not boot! To do so, use the
arrow keys to navigate to your newly created partition, then hit the <b>s</b>
key, until "Newfs" contains no <b>+S</b>. Now navigate the arrow keys until
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-05-26 19:29 Josh Saddler
0 siblings, 0 replies; 30+ messages in thread
From: Josh Saddler @ 2006-05-26 19:29 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/05/26 19:29:27
Modified: gentoo-freebsd.xml
Log:
Minor grammar/spelling fixes for this update; no content change
Revision Changes Path
1.20 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.20&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.20&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.19&r2=1.20&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- gentoo-freebsd.xml 26 May 2006 19:21:37 -0000 1.19
+++ gentoo-freebsd.xml 26 May 2006 19:29:27 -0000 1.20
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.19 2006/05/26 19:21:37 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.20 2006/05/26 19:29:27 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -59,10 +59,11 @@
<body>
<p>
-<uri link="/proj/en/gentoo-alt/bsd/fbsd/">Gentoo/FreeBSD</uri> is a subproject of the
-<uri link="/proj/en/gentoo-alt/">Gentoo/Alt project</uri>, with the goal of providing
-a fully-capable FreeBSD operating system featuring the design sensibilities known from
-Gentoo Linux, like the init system and the portage package management system.
+<uri link="/proj/en/gentoo-alt/bsd/fbsd/">Gentoo/FreeBSD</uri> is a subproject
+of the <uri link="/proj/en/gentoo-alt/">Gentoo/Alt project</uri>, with the
+goal of providing a fully-capable FreeBSD operating system featuring design
+sensibilities taken from Gentoo Linux, such as the init system and the Portage
+package management system.
</p>
</body>
@@ -294,7 +295,7 @@
If you want, you can now rebuild the system's core packages.
</p>
-<pre caption="Rebuilding the FreeBSD core packages (Optional)">
+<pre caption="Rebuilding the FreeBSD core packages (optional)">
# <i>emerge -e system</i>
</pre>
@@ -304,7 +305,7 @@
them in the following way:
</p>
-<pre caption="Geting the FreeBSD kernel sources">
+<pre caption="Getting the FreeBSD kernel sources">
# <i>emerge freebsd-sources</i>
</pre>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-05-26 19:21 Josh Saddler
0 siblings, 0 replies; 30+ messages in thread
From: Josh Saddler @ 2006-05-26 19:21 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/05/26 19:21:37
Modified: gentoo-freebsd.xml
Log:
Updated freebsd profile & stage instructions for bug 134444. thanks to flameeyes for reporting
Revision Changes Path
1.19 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.19&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.19&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.18&r2=1.19&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- gentoo-freebsd.xml 3 May 2006 01:03:42 -0000 1.18
+++ gentoo-freebsd.xml 26 May 2006 19:21:37 -0000 1.19
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.18 2006/05/03 01:03:42 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.19 2006/05/26 19:21:37 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.4</version>
-<date>2006-05-03</date>
+<version>2.5</version>
+<date>2006-05-26</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -43,13 +43,13 @@
Unix-like operating system. Back in 1993 when development of <uri
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
-and security, thus being used from small to huge companies all over the world.
-FreeBSD's current production release version is 6.0, 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 more worked on by
-the Gentoo/FreeBSD developers.
+huge number of architectures, and FreeBSD which supports the x86, amd64, ia64,
+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>
</body>
@@ -200,10 +200,10 @@
<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.0-stage-20060221.tar.bz2</i>
-# <i>tar -jxvpf gentoo-freebsd-6.0-stage-20060221</i>
+# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/gentoo-freebsd-6.1-stage-20060509.tar.bz2</i>
+# <i>tar -jxvpf gentoo-freebsd-6.1-stage-20060509.tar.bz2</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
-# <i>rm gentoo-freebsd-6.0-stage-20060221</i>
+# <i>rm gentoo-freebsd-6.1-stage-20060509.tar.bz2</i>
</pre>
<p>
@@ -263,11 +263,11 @@
</pre>
<pre caption="Setting up the profile and editing /etc/make.conf">
-# <i>ln -sf /usr/local/portage/portage-alt-overlay/profiles/default-bsd/fbsd/6.0/x86/ /etc/make.profile</i>
+# <i>ln -sf /usr/portage/profiles/default-bsd/fbsd/6.1/x86/ /etc/make.profile</i>
<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment>
# <i>ee /etc/make.conf</i>
<comment>(Please make sure you add at least the following entries:)</comment>
-CHOST="i686-gentoo-freebsd6.0"
+CHOST="i686-gentoo-freebsd6.1"
ACCEPT_KEYWORDS="~x86-fbsd"
FEATURES="-sandbox collision-protect"
PORTDIR_OVERLAY="/usr/local/portage/portage-alt-overlay"
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-05-03 1:03 Lukasz Damentko
0 siblings, 0 replies; 30+ messages in thread
From: Lukasz Damentko @ 2006-05-03 1:03 UTC (permalink / raw
To: gentoo-doc-cvs
rane 06/05/03 01:03:42
Modified: gentoo-freebsd.xml
Log:
fixed a typo, no other content change
Revision Changes Path
1.18 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.18&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.18&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.17&r2=1.18&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- gentoo-freebsd.xml 3 May 2006 01:01:04 -0000 1.17
+++ gentoo-freebsd.xml 3 May 2006 01:03:42 -0000 1.18
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.17 2006/05/03 01:01:04 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.18 2006/05/03 01:03:42 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -361,7 +361,7 @@
</pre>
<p>
-Your system's hostname can be changed in <path>/etc/conf.dhostname</path>.
+Your system's hostname can be changed in <path>/etc/conf.d/hostname</path>.
</p>
<pre caption="Setting up the machine's hostname">
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-05-03 1:01 Lukasz Damentko
0 siblings, 0 replies; 30+ messages in thread
From: Lukasz Damentko @ 2006-05-03 1:01 UTC (permalink / raw
To: gentoo-doc-cvs
rane 06/05/03 01:01:04
Modified: gentoo-freebsd.xml
Log:
updates from #132071
Revision Changes Path
1.17 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.17&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.17&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.16&r2=1.17&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- gentoo-freebsd.xml 30 Mar 2006 08:41:57 -0000 1.16
+++ gentoo-freebsd.xml 3 May 2006 01:01:04 -0000 1.17
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.16 2006/03/30 08:41:57 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.17 2006/05/03 01:01:04 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.3</version>
-<date>2006-03-24</date>
+<version>2.4</version>
+<date>2006-05-03</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -43,7 +43,7 @@
Unix-like operating system. Back in 1993 when development of <uri
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 architetures, and FreeBSD which supports the x86, amd64, ia64,
+huge number of architectures, and FreeBSD which supports the x86, amd64, ia64,
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.0, which is also used as the
@@ -144,6 +144,11 @@
version 20060118 has been tested to work for the purposes described in this document.
</note>
+<note>
+We use <c>ee</c> as a default editor in this guide but you can choose
+<c>vim</c>, <c>nano</c> or any other editor you like to configure your system.
+</note>
+
<p>
Before you can begin with the installation, you have to setup a hard disk for
use with Gentoo/FreeBSD. This can either be done via <c>sysinstall</c>
@@ -187,7 +192,6 @@
# <i>mount -u -o rw /mnt/ufs.1</i>
</pre>
-
<p>
Now that you have mounted the target partition, it is time to fetch and unpack
a stage3 tarball.
@@ -244,20 +248,37 @@
<path>/etc/make.conf</path> ready for Gentoo/FreeBSD.
</p>
+<p>
+Now, you have to obtain a copy of the main Gentoo Portage tree, which depending
+on your connection might take quite a while.
+</p>
+
+<pre caption="Obtaining the Portage tree">
+# <i>emerge --sync</i>
+<comment>(It's also possible to retrieve the Portage tree in another way:)</comment>
+# <i>cd /</i>
+# <i>wget http://gentoo.osuosl.org/snapshots/portage-latest.tar.bz2</i>
+# <i>tar -xjf portage-latest.tar.bz2 -C /usr/</i>
+# <i>emerge --metadata</i>
+</pre>
+
<pre caption="Setting up the profile and editing /etc/make.conf">
# <i>ln -sf /usr/local/portage/portage-alt-overlay/profiles/default-bsd/fbsd/6.0/x86/ /etc/make.profile</i>
<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment>
# <i>ee /etc/make.conf</i>
<comment>(Please make sure you add at least the following entries:)</comment>
CHOST="i686-gentoo-freebsd6.0"
-ACCEPT_KEYWORDS="~x86-fbsd ~x86"
+ACCEPT_KEYWORDS="~x86-fbsd"
FEATURES="-sandbox collision-protect"
PORTDIR_OVERLAY="/usr/local/portage/portage-alt-overlay"
</pre>
<note>
-If you're installing using an old 5.4 stage, please replace "5.4" by "6.0" when symlinking the profile and
-setting the CHOST variable.
+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.
</note>
<p>
@@ -270,20 +291,6 @@
</pre>
<p>
-Now, you have to obtain a copy of the main Gentoo Portage tree, which depending
-on your connection might take quite a while.
-</p>
-
-<pre caption="Obtaining the Portage tree">
-# <i>emerge --sync</i>
-<comment>(It's also possible to retrieve the Portage tree in another way:)</comment>
-# <i>cd /</i>
-# <i>wget http://gentoo.osuosl.org/snapshots/portage-latest.tar.bz2</i>
-# <i>tar -xjf portage-latest.tar.bz2 -C /usr/</i>
-# <i>emerge --metadata</i>
-</pre>
-
-<p>
If you want, you can now rebuild the system's core packages.
</p>
@@ -317,13 +324,6 @@
and is called <path>GENERIC.hints</path>.
</p>
-<note>
-When building a kernel, you should use the command "make WERROR=NO_WERROR"
-because the Gentoo/FreeBSD developers have not yet been able to patch out all
-occurrences of -Werror and the currently used GCC doesn't accept FreeBSD's
-extensions to the printf() function.
-</note>
-
<p>
Now is the time to do some basic system configuration and settings. First, we
are going to setup the filesystem mounting points in <path>/etc/fstab</path>.
@@ -345,15 +345,15 @@
reboot.
</p>
-<pre caption="Setting up your network">
-# <i>ee /etc/conf.d/net</i>
-<comment>(This is just an example which you have to adjust for your network.)</comment>
-ifconfig_rl0=("192.168.0.10 netmask 255.255.255.0 broadcast 192.168.0.255")
-routes_rl0=("-net 0.0.0.0 -host 192.168.0.1")
-</pre>
+<p>
+You can find all the information necessary to configure your network in the
+<uri link="/doc/en/handbook/handbook-x86.xml?part=4&chap=1">Gentoo
+Handbook</uri>.
+</p>
<p>
-To have your network interface activated at boot time, you have to add it to the default runlevel.
+To have your network interface activated at boot time, you have to add it to
+the default runlevel.
</p>
<pre caption="Adding your network adapter to the default runlevel">
@@ -361,11 +361,35 @@
</pre>
<p>
-Your system's hostname can be changed in <path>/etc/hostname</path>.
+Your system's hostname can be changed in <path>/etc/conf.dhostname</path>.
</p>
<pre caption="Setting up the machine's hostname">
-# <i>echo "YOUR_HOSTNAME_HERE" > /etc/hostname</i>
+# <i>ee /etc/conf.d/hostname</i>
+<comment>(Set the HOSTNAME variable to your hostname)</comment>
+HOSTNAME="tux"
+</pre>
+
+<p>
+You should also configure your domain name, which is done in the
+<path>/etc/conf.d/domainname</path> file:
+</p>
+
+<pre caption="Setting the domainname">
+# <i>ee /etc/conf.d/domainname</i>
+<comment>(Set the DNSDOMAIN variable to your domain name)</comment>
+DNSDOMAIN="homenetwork"
+</pre>
+
+<p>
+If you have a NIS domain, you need to define it in the
+<path>/etc/conf.d/domainname</path> file:
+</p>
+
+<pre caption="Setting the NIS domainname">
+# <i>ee /etc/conf.d/domainname</i>
+<comment>(Set the NISDOMAIN variable to your NIS domain name)</comment>
+NISDOMAIN="my-nisdomain"
</pre>
<p>
@@ -401,7 +425,7 @@
</pre>
<p>
-If you need additonal information on setting up <c>boot0</c>, please consult
+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.
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-03-30 8:41 Xavier Neys
0 siblings, 0 replies; 30+ messages in thread
From: Xavier Neys @ 2006-03-30 8:41 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 06/03/30 08:41:58
Modified: gentoo-freebsd.xml
Log:
Commit fixes mentioned on #127477, this time saving the file before committing
Revision Changes Path
1.16 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.16&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.16&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.15&r2=1.16&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- gentoo-freebsd.xml 28 Mar 2006 10:30:14 -0000 1.15
+++ gentoo-freebsd.xml 30 Mar 2006 08:41:57 -0000 1.16
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.15 2006/03/28 10:30:14 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.16 2006/03/30 08:41:57 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,7 +28,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.2</version>
+<version>2.3</version>
<date>2006-03-24</date>
<chapter>
@@ -59,8 +59,8 @@
<body>
<p>
-<uri link="proj/en/gentoo-alt/bsd/fbsd/">Gentoo/FreeBSD</uri> is a subproject of the
-<uri link="proj/en/gentoo-alt/">Gentoo/Alt project</uri>, with the goal of providing
+<uri link="/proj/en/gentoo-alt/bsd/fbsd/">Gentoo/FreeBSD</uri> is a subproject of the
+<uri link="/proj/en/gentoo-alt/">Gentoo/Alt project</uri>, with the goal of providing
a fully-capable FreeBSD operating system featuring the design sensibilities known from
Gentoo Linux, like the init system and the portage package management system.
</p>
@@ -184,7 +184,7 @@
</p>
<pre caption="Remounting a partition in read-write mode">
-# <i>ount -u -o rw /mnt/ufs.1</i>
+# <i>mount -u -o rw /mnt/ufs.1</i>
</pre>
@@ -320,8 +320,8 @@
<note>
When building a kernel, you should use the command "make WERROR=NO_WERROR"
because the Gentoo/FreeBSD developers have not yet been able to patch out all
-occurences of -Werror and the currently used GCC doesn't accept FreeBSD's
-extensions to the printf() funktion.
+occurrences of -Werror and the currently used GCC doesn't accept FreeBSD's
+extensions to the printf() function.
</note>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-03-28 10:30 Xavier Neys
0 siblings, 0 replies; 30+ messages in thread
From: Xavier Neys @ 2006-03-28 10:30 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 06/03/28 10:30:14
Modified: gentoo-freebsd.xml
Log:
Update from #127477
Revision Changes Path
1.15 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.15&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.15&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.14&r2=1.15&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- gentoo-freebsd.xml 2 Mar 2006 13:32:47 -0000 1.14
+++ gentoo-freebsd.xml 28 Mar 2006 10:30:14 -0000 1.15
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.14 2006/03/02 13:32:47 yoswink Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.15 2006/03/28 10:30:14 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.1</version>
-<date>2006-03-02</date>
+<version>2.2</version>
+<date>2006-03-24</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -43,11 +43,13 @@
Unix-like operating system. Back in 1993 when development of <uri
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 architetures, and FreeBSD which focuses mainly on the x86
-platform. 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 5.4, which is also used as the foundation for the
-Gentoo/FreeBSD project.
+huge number of architetures, and FreeBSD which supports the x86, amd64, ia64,
+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.0, 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 more worked on by
+the Gentoo/FreeBSD developers.
</p>
</body>
@@ -57,10 +59,10 @@
<body>
<p>
-Gentoo/FreeBSD is an effort to provide a fully-capable FreeBSD operating system
-with Gentoo's design sensibilities. The long-term goal of the Gentoo/BSD project
-is to allow users to choose any combination of *BSD or Linux kernels, *BSD or
-GNU libc, and *BSD or GNU userland tools.
+<uri link="proj/en/gentoo-alt/bsd/fbsd/">Gentoo/FreeBSD</uri> is a subproject of the
+<uri link="proj/en/gentoo-alt/">Gentoo/Alt project</uri>, with the goal of providing
+a fully-capable FreeBSD operating system featuring the design sensibilities known from
+Gentoo Linux, like the init system and the portage package management system.
</p>
</body>
@@ -135,13 +137,29 @@
an installation medium for Gentoo/FreeBSD.
</p>
+<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.
+</note>
+
<p>
Before you can begin with the installation, you have to setup a hard disk for
use with Gentoo/FreeBSD. This can either be done via <c>sysinstall</c>
(available from a current FreeBSD installation as well as from within FreeSBIE)
-or by manually using the commands <c>fdisk</c>, <c>disklabel</c> and
-<c>newfs</c>. If you have never set up a FreeBSD system before,
-<c>sysinstall</c> may be the better option for you. If you face difficulties
+or by manually using the commands <c>fdisk</c>, <c>disklabel</c> and <c>newfs</c>.
+If you have never set up a FreeBSD system before, <c>sysinstall</c> may be the
+better option for you. In that case make sure that you don't use the sysinstall
+launched by FreeBSD's or FreeSBIE's installers, but use the following command instead:
+</p>
+
+<pre caption="Partitioning with sysinstall">
+# <i>sysinstall diskPartitionEditor diskPartitionWrite diskLabelEditor diskLabelCommit</i>
+</pre>
+
+<p>
+If you face difficulties
while partitioning or formatting your hard disks, have a look at the great
<uri link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
Handbook</uri> or hop onto <c>#gentoo-bsd</c> on the Freenode IRC server.
@@ -159,6 +177,18 @@
</pre>
<p>
+If you're using the FreeSBIE LiveCD and you already had an UFS partition on
+your hard disk, it has already been mounted read-only to <path>/mnt/ufs.1</path>.
+If you want to use that location for your installation, you'll have to remount it
+in read-write mode:
+</p>
+
+<pre caption="Remounting a partition in read-write mode">
+# <i>ount -u -o rw /mnt/ufs.1</i>
+</pre>
+
+
+<p>
Now that you have mounted the target partition, it is time to fetch and unpack
a stage3 tarball.
</p>
@@ -166,10 +196,10 @@
<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/stage3-x86-fbsd-20051020.tar.bz2</i>
-# <i>tar -jxvpf stage3-x86-fbsd-20051020.tar.bz2</i>
+# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/gentoo-freebsd-6.0-stage-20060221.tar.bz2</i>
+# <i>tar -jxvpf gentoo-freebsd-6.0-stage-20060221</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
-# <i>rm stage3-x86-fbsd-20051020.tar.bz2</i>
+# <i>rm gentoo-freebsd-6.0-stage-20060221</i>
</pre>
<p>
@@ -215,16 +245,21 @@
</p>
<pre caption="Setting up the profile and editing /etc/make.conf">
-# <i>ln -sf /usr/local/portage/portage-alt-overlay/profiles/default-bsd/fbsd/5.4/x86/ /etc/make.profile</i>
+# <i>ln -sf /usr/local/portage/portage-alt-overlay/profiles/default-bsd/fbsd/6.0/x86/ /etc/make.profile</i>
<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment>
# <i>ee /etc/make.conf</i>
<comment>(Please make sure you add at least the following entries:)</comment>
-CHOST="i686-gentoo-freebsd5.4"
+CHOST="i686-gentoo-freebsd6.0"
ACCEPT_KEYWORDS="~x86-fbsd ~x86"
FEATURES="-sandbox collision-protect"
PORTDIR_OVERLAY="/usr/local/portage/portage-alt-overlay"
</pre>
+<note>
+If you're installing using an old 5.4 stage, please replace "5.4" by "6.0" when symlinking the profile and
+setting the CHOST variable.
+</note>
+
<p>
In order to boot correctly, you will need to create the <path>/proc</path>
directory.
@@ -279,9 +314,16 @@
supported on Gentoo/FreeBSD! Also note that <c>make install</c> will probably
ask you for a <path>/boot/device.hints</path> file. A default version can be
found in the <path>conf</path> subdirectory of the <c>GENERIC</c> configuration
-and is called <path>GENERIC.hints</path>
+and is called <path>GENERIC.hints</path>.
</p>
+<note>
+When building a kernel, you should use the command "make WERROR=NO_WERROR"
+because the Gentoo/FreeBSD developers have not yet been able to patch out all
+occurences of -Werror and the currently used GCC doesn't accept FreeBSD's
+extensions to the printf() funktion.
+</note>
+
<p>
Now is the time to do some basic system configuration and settings. First, we
are going to setup the filesystem mounting points in <path>/etc/fstab</path>.
@@ -353,7 +395,7 @@
<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>fdisk -B -b /mnt/gentoo/boot/boot0 /dev/adX</i>
# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>disklabel -B adXsY</i>
</pre>
@@ -403,10 +445,6 @@
<ul>
<li>
- We need GCC and binutils hackers who are able to port FreeBSD's patches to
- the original versions of these tools provided by our main Portage tree.
- </li>
- <li>
Working on current ebuilds: this means working closely with ebuild
maintainers in order to create patches or modify ebuilds in a way that can
be accepted into the main tree.
@@ -436,63 +474,7 @@
</body>
</section>
-<section>
-<title>Building the system and dealing with issues</title>
-<body>
-
-<p>
-Although Linux and FreeBSD both are Unix-like operating systems, there are some
-important differences you have to know about if you want to contribute to our
-development effort:
-</p>
-<ul>
- <li>
- FreeBSD doesn't use the GNU autotools (autoconf, automake, autoheader).
- Instead, it uses its own implementation of <c>make</c>, putting
- configuration options in external files and some .mk files that are
- included with each Makefile. Although a lot of work has been put into
- those .mk files, it is not hard to find some installations failing due to
- a missing <c>${INSTALL} -d</c> somewhere. The easy way to deal with
- this kind of problem is to read the Makefile to find the accompanying .mk
- file, then open that file and try to figure out which part failed (this is
- not really hard once you figure out where in the installation process it
- stopped).
- </li>
- <li>
- Besides, due to the fact that FreeBSD is a complete operating system, you
- won't find things like a FreeBSD kernel tarball for download on a web site.
- The system is meant to be concise, thus whenever you start making an ebuild
- for something that uses system sources, you are very likely to run into
- problems when it tries to access non-existent files or directories. This
- generally occurs when a Makefile points to <path>${.CURDIR}/../sys</path>,
- or when a Makefile has a source dependency on another system package. There
- is no default rule on dealing with such issues, but generally one of the
- following procedures helps:
- <ul>
- <li>
- If the ebuild is trying to access kernel sources, patch it to point to
- <path>/usr/src/sys</path>
- </li>
- <li>
- If it's trying to access some other source that is provided by the
- system, it's easier to add it to <c>$SRC_URI</c> and unpack it to
- <c>$WORKDIR</c>
- </li>
- </ul>
- </li>
- <li>
- In order to maintain a concise buildsystem, we have several tarballs which
- are grouped by their functionality. This means that system libraries can be
- found in the freebsd-lib tarball, which contains the sources you would
- usually find in /usr/src/lib. On the other hand, freebsd-usrsbin contains
- <path>/usr/sbin/*</path> tools and consists of sources from
- <path>/usr/src/usr.sbin</path>.
- </li>
-</ul>
-
-</body>
-</section>
<section>
<title>Known issues</title>
<body>
@@ -510,6 +492,11 @@
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.
+ </li>
</ul>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-03-02 13:32 Jose Luis Rivero
0 siblings, 0 replies; 30+ messages in thread
From: Jose Luis Rivero @ 2006-03-02 13:32 UTC (permalink / raw
To: gentoo-doc-cvs
yoswink 06/03/02 13:32:48
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
Updated broken Gentoo/freebsd overlay link. Thanks to Flameeyes for the new link.
Revision Changes Path
1.14 +7 -6 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.14&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.14&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.13&r2=1.14&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- gentoo-freebsd.xml 10 Jan 2006 21:15:20 -0000 1.13
+++ gentoo-freebsd.xml 2 Mar 2006 13:32:47 -0000 1.14
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.13 2006/01/10 21:15:20 vanquirius Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.14 2006/03/02 13:32:47 yoswink Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.0</version>
-<date>2006-01-10</date>
+<version>2.1</version>
+<date>2006-03-02</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -189,9 +189,10 @@
<p>
Alternatively, you can also use Subversion to check out the current version of
-the overlay. If you are interested in this possibility, please refer to the
-<uri link="/proj/en/gentoo-alt/overlay.xml">Gentoo/ALT overlay
-documentation</uri>.
+the overlay. If you are interested in this possibility, please refer to the
+<uri
+link="/proj/en/gentoo-alt/contribute/index.xml?part=1&chap=3">Gentoo/ALT
+overlay documentation</uri>.
</p>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2006-01-10 21:15 Marcelo Goes
0 siblings, 0 replies; 30+ messages in thread
From: Marcelo Goes @ 2006-01-10 21:15 UTC (permalink / raw
To: gentoo-doc-cvs
vanquirius 06/01/10 21:15:20
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
Add network adapter to runlevel. Fixes bug 118573. Thanks to Michael Kohl <citizen428 at gentoo dot org>.
Revision Changes Path
1.13 +12 -4 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.13&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.13&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.12&r2=1.13&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- gentoo-freebsd.xml 20 Dec 2005 19:12:53 -0000 1.12
+++ gentoo-freebsd.xml 10 Jan 2006 21:15:20 -0000 1.13
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.12 2005/12/20 19:12:53 cam Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.13 2006/01/10 21:15:20 vanquirius Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.9</version>
-<date>2005-12-06</date>
+<version>2.0</version>
+<date>2006-01-10</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -310,7 +310,15 @@
</pre>
<p>
-To change your hostname you have to edit <path>/etc/hostname</path>.
+To have your network interface activated at boot time, you have to add it to the default runlevel.
+</p>
+
+<pre caption="Adding your network adapter to the default runlevel">
+# <i>rc-update add net.rl0 default</i>
+</pre>
+
+<p>
+Your system's hostname can be changed in <path>/etc/hostname</path>.
</p>
<pre caption="Setting up the machine's hostname">
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-12-20 19:12 Camille Huot
0 siblings, 0 replies; 30+ messages in thread
From: Camille Huot @ 2005-12-20 19:12 UTC (permalink / raw
To: gentoo-doc-cvs
cam 05/12/20 19:12:53
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
Only XML style fixes. No content changed.
Revision Changes Path
1.12 +32 -27 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.12&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.12&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.11&r2=1.12&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- gentoo-freebsd.xml 6 Dec 2005 12:32:46 -0000 1.11
+++ gentoo-freebsd.xml 20 Dec 2005 19:12:53 -0000 1.12
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.11 2005/12/06 12:32:46 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.12 2005/12/20 19:12:53 cam Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -173,9 +173,10 @@
</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>
+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">
@@ -224,7 +225,8 @@
</pre>
<p>
-In order to boot correctly, you will need to create the <path>/proc</path> directory.
+In order to boot correctly, you will need to create the <path>/proc</path>
+directory.
</p>
<pre caption="Creating the /proc directory">
@@ -254,8 +256,8 @@
</pre>
<p>
-When you did <c>emerge -e system</c>, the sources for the FreeBSD kernel got
-installed to <path>/usr/src/sys</path>. If you skipped this step, you can get
+When you did <c>emerge -e system</c>, the sources for the FreeBSD kernel got
+installed to <path>/usr/src/sys</path>. If you skipped this step, you can get
them in the following way:
</p>
@@ -264,14 +266,15 @@
</pre>
<p>
-Configuring and compiling a custom kernel is really different from compiling Linux,
-so if you are not familiar with the process we encourage you to have a look at
-<uri link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html">
+Configuring and compiling a custom kernel is really different from compiling
+Linux, so if you are not familiar with the process we encourage you to have a
+look at <uri
+link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html">
chapter 8</uri> of the FreeBSD handbook.
</p>
<p>
-Please note that currently only the "Traditional" way of building the kernel is
+Please note that currently only the "Traditional" way of building the kernel is
supported on Gentoo/FreeBSD! Also note that <c>make install</c> will probably
ask you for a <path>/boot/device.hints</path> file. A default version can be
found in the <path>conf</path> subdirectory of the <c>GENERIC</c> configuration
@@ -279,8 +282,8 @@
</p>
<p>
-Now is the time to do some basic system configuration and settings. First, we are
-going to setup the filesystem mounting points in <path>/etc/fstab</path>
+Now is the time to do some basic system configuration and settings. First, we
+are going to setup the filesystem mounting points in <path>/etc/fstab</path>.
</p>
<pre caption="Editing the filesystem in /etc/fstab">
@@ -315,9 +318,10 @@
</pre>
<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 uses the Spanish
-layout, so you'll have to adjust it to your need if you want to use another one.
+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
+uses the Spanish layout, so you'll have to adjust it to your need if you want to
+use another one.
</p>
<pre caption="Changing your keyboard layout (Optional)">
@@ -329,9 +333,9 @@
<impo>
Please make absolutely sure you add your new Gentoo/FreeBSD installation to the
configuration of your bootloader, otherwise you won't be able to boot your newly
-installed system! If you don't have another bootloader installed, you should use
+installed system! If you don't have another bootloader installed, you should use
<c>boot0</c>, as it is currently the only one supported by FreeBSD. In this case
-please don't forget to use your other operating systems to <c>boot0</c>'s
+please don't forget to use your other operating systems to <c>boot0</c>'s
configuration.
</impo>
@@ -346,13 +350,14 @@
</pre>
<p>
-If you need additonal 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.
+If you need additonal 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.
</p>
<p>
-Now would be a good time to set a password for the <c>root</c> user and to add
+Now would be a good time to set a password for the <c>root</c> user and to add
another user account for your day-to-day work.
</p>
@@ -363,8 +368,8 @@
</pre>
<p>
-Congratulations, you have just finished your Gentoo/FreeBSD installation which you
-can start exploring after the final reboot. Have fun!
+Congratulations, you have just finished your Gentoo/FreeBSD installation which
+you can start exploring after the final reboot. Have fun!
</p>
<pre caption="Rebooting the system">
@@ -393,9 +398,9 @@
the original versions of these tools provided by our main Portage tree.
</li>
<li>
- Working on current ebuilds: this means working closely with ebuild maintainers
- in order to create patches or modify ebuilds in a way that can be accepted
- into the main tree.
+ Working on current ebuilds: this means working closely with ebuild
+ maintainers in order to create patches or modify ebuilds in a way that can
+ be accepted into the main tree.
</li>
<li>
Security: if you are into security, we need you! Although security
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-12-06 12:32 Jan Kundrat
0 siblings, 0 replies; 30+ messages in thread
From: Jan Kundrat @ 2005-12-06 12:32 UTC (permalink / raw
To: gentoo-doc-cvs
jkt 05/12/06 12:32:46
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
#114574, another update from citizen428
Revision Changes Path
1.11 +107 -20 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.11&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.11&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.10&r2=1.11&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- gentoo-freebsd.xml 21 Oct 2005 10:45:18 -0000 1.10
+++ gentoo-freebsd.xml 6 Dec 2005 12:32:46 -0000 1.11
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.10 2005/10/21 10:45:18 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.11 2005/12/06 12:32:46 jkt Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.8</version>
-<date>2005-10-21</date>
+<version>1.9</version>
+<date>2005-12-06</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -175,13 +175,15 @@
<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 than extract to <path>/mnt/gentoo/usr/local/portage</path>
+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>
</pre>
<p>
@@ -222,6 +224,14 @@
</pre>
<p>
+In order to boot correctly, you will need to create the <path>/proc</path> directory.
+</p>
+
+<pre caption="Creating the /proc directory">
+# <i>mkdir /proc</i>
+</pre>
+
+<p>
Now, you have to obtain a copy of the main Gentoo Portage tree, which depending
on your connection might take quite a while.
</p>
@@ -236,20 +246,93 @@
</pre>
<p>
-Congratulations, by the time you have reached this step you should have a
-running Gentoo/FreeBSD system! If you want, you can now rebuild the system's
-core packages.
+If you want, you can now rebuild the system's core packages.
</p>
-<pre caption="Rebuilding the FreeBSD core packages">
+<pre caption="Rebuilding the FreeBSD core packages (Optional)">
# <i>emerge -e system</i>
</pre>
+<p>
+When you did <c>emerge -e system</c>, the sources for the FreeBSD kernel got
+installed to <path>/usr/src/sys</path>. If you skipped this step, you can get
+them in the following way:
+</p>
+
+<pre caption="Geting the FreeBSD kernel sources">
+# <i>emerge freebsd-sources</i>
+</pre>
+
+<p>
+Configuring and compiling a custom kernel is really different from compiling Linux,
+so if you are not familiar with the process we encourage you to have a look at
+<uri link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html">
+chapter 8</uri> of the FreeBSD handbook.
+</p>
+
+<p>
+Please note that currently only the "Traditional" way of building the kernel is
+supported on Gentoo/FreeBSD! Also note that <c>make install</c> will probably
+ask you for a <path>/boot/device.hints</path> file. A default version can be
+found in the <path>conf</path> subdirectory of the <c>GENERIC</c> configuration
+and is called <path>GENERIC.hints</path>
+</p>
+
+<p>
+Now is the time to do some basic system configuration and settings. First, we are
+going to setup the filesystem mounting points in <path>/etc/fstab</path>
+</p>
+
+<pre caption="Editing the filesystem in /etc/fstab">
+# <i>ee /etc/fstab</i>
+<comment>(This is an example, replace X and Y with the correct numbers for your hard disk.)</comment>
+#Device Mountpoint Fstype Options Dump Pass
+/dev/adXsYb none swap sw 0 0
+/dev/adXsYa / ufs rw 1 1
+/dev/adXsYe /usr/home ufs rw 2 2
+/dev/adXsYd /tmp ufs rw 2 2
+/dev/acdX /cdrom cd9660 ro,noauto 0 0
+</pre>
+
+<p>
+Now would also be a good time to set up your network connection before the final
+reboot.
+</p>
+
+<pre caption="Setting up your network">
+# <i>ee /etc/conf.d/net</i>
+<comment>(This is just an example which you have to adjust for your network.)</comment>
+ifconfig_rl0=("192.168.0.10 netmask 255.255.255.0 broadcast 192.168.0.255")
+routes_rl0=("-net 0.0.0.0 -host 192.168.0.1")
+</pre>
+
+<p>
+To change your hostname you have to edit <path>/etc/hostname</path>.
+</p>
+
+<pre caption="Setting up the machine's hostname">
+# <i>echo "YOUR_HOSTNAME_HERE" > /etc/hostname</i>
+</pre>
+
+<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 uses the Spanish
+layout, so you'll have to adjust it to your need if you want to use another one.
+</p>
+
+<pre caption="Changing your keyboard layout (Optional)">
+# <i>ee /etc/conf.d/syscons</i>
+KEYMAP="spanish.iso.acc"
+<comment>(Possible layouts can be found in /usr/share/syscons/keymaps).</comment>
+</pre>
+
<impo>
Please make absolutely sure you add your new Gentoo/FreeBSD installation to the
configuration of your bootloader, otherwise you won't be able to boot your newly
installed system! If you don't have another bootloader installed, you should use
-<c>boot0</c>, as it is currently the only one supported by FreeBSD.
+<c>boot0</c>, as it is currently the only one supported by FreeBSD. In this case
+please don't forget to use your other operating systems to <c>boot0</c>'s
+configuration.
</impo>
<pre caption="Installing and setting up boot0">
@@ -269,22 +352,26 @@
</p>
<p>
-When you did <c>emerge system</c>, the sources for the FreeBSD kernel got
-installed to <path>/usr/src/sys</path>. Configuring and compiling a custom
-kernel is really different from compiling Linux, so if you are not familiar with
-the process we encourage you to have a look at <uri
-link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html">
-chapter 8</uri> of the FreeBSD handbook.
+Now would be a good time to set a password for the <c>root</c> user and to add
+another user account for your day-to-day work.
</p>
+<pre caption="Changing the root password and adding a new user">
+# <i>passwd</i>
+<comment>(If you need help in adding a user please consult the FreeBSD handbook).</comment>
+# <i>adduser</i>
+</pre>
+
<p>
-Please note that currently only the "Traditional" way of building the kernel is
-supported on Gentoo/FreeBSD! Also note that <c>make install</c> will probably
-ask you for a <path>/boot/device.hints</path> file. A default version can be
-found in the <path>conf</path> subdirectory of the <c>GENERIC</c> configuration
-and is called <path>GENERIC.hints</path>
+Congratulations, you have just finished your Gentoo/FreeBSD installation which you
+can start exploring after the final reboot. Have fun!
</p>
+<pre caption="Rebooting the system">
+# <i>exit</i>
+# <i>reboot</i>
+</pre>
+
</body>
</section>
</chapter>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-10-21 10:45 Xavier Neys
0 siblings, 0 replies; 30+ messages in thread
From: Xavier Neys @ 2005-10-21 10:45 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 05/10/21 10:45:18
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
#110011 Update dates
Revision Changes Path
1.10 +6 -6 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.10&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.10&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.9&r2=1.10&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- gentoo-freebsd.xml 16 Oct 2005 15:31:50 -0000 1.9
+++ gentoo-freebsd.xml 21 Oct 2005 10:45:18 -0000 1.10
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.9 2005/10/16 15:31:50 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.10 2005/10/21 10:45:18 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.7</version>
-<date>2005-10-16</date>
+<version>1.8</version>
+<date>2005-10-21</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -166,10 +166,10 @@
<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/stage3-x86-fbsd-20051013.tar.bz2</i>
-# <i>tar -jxvpf stage3-x86-fbsd-20051013.tar.bz2</i>
+# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/stage3-x86-fbsd-20051020.tar.bz2</i>
+# <i>tar -jxvpf stage3-x86-fbsd-20051020.tar.bz2</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
-# <i>rm stage3-x86-fbsd-20051013.tar.bz2</i>
+# <i>rm stage3-x86-fbsd-20051020.tar.bz2</i>
</pre>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-10-16 15:31 Xavier Neys
0 siblings, 0 replies; 30+ messages in thread
From: Xavier Neys @ 2005-10-16 15:31 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 05/10/16 15:31:50
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
Update from #109478
Revision Changes Path
1.9 +6 -9 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.9&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.9&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.8&r2=1.9&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- gentoo-freebsd.xml 11 Oct 2005 14:03:40 -0000 1.8
+++ gentoo-freebsd.xml 16 Oct 2005 15:31:50 -0000 1.9
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.8 2005/10/11 14:03:40 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.9 2005/10/16 15:31:50 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.6</version>
-<date>2005-10-10</date>
+<version>1.7</version>
+<date>2005-10-16</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -166,12 +166,10 @@
<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/stage3-x86-fbsd-20051005.tar.bz2</i>
-# <i>tar -jxvpf stage3-x86-fbsd-20051005.tar.bz2</i>
-<comment>(A wrong make.conf was packaged with the current stage3 tarball. We'll now remove it.)</comment>
-# <i>rm -f /mnt/gentoo/etc/make.conf</i>
+# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/stage3-x86-fbsd-20051013.tar.bz2</i>
+# <i>tar -jxvpf stage3-x86-fbsd-20051013.tar.bz2</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
-# <i>rm stage3-x86-fbsd-20051005.tar.bz2</i>
+# <i>rm stage3-x86-fbsd-20051013.tar.bz2</i>
</pre>
<p>
@@ -181,7 +179,6 @@
</p>
<pre caption="Getting the Gentoo/FreeBSD Portage overlay">
-# <i>mkdir /mnt/gentoo/usr/local/portage</i>
# <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>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-10-11 14:03 Lukasz Damentko
0 siblings, 0 replies; 30+ messages in thread
From: Lukasz Damentko @ 2005-10-11 14:03 UTC (permalink / raw
To: gentoo-doc-cvs
rane 05/10/11 14:03:40
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
update from #108859
Revision Changes Path
1.8 +28 -22 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.8&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.8&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.7&r2=1.8&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- gentoo-freebsd.xml 6 Oct 2005 15:58:16 -0000 1.7
+++ gentoo-freebsd.xml 11 Oct 2005 14:03:40 -0000 1.8
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.7 2005/10/06 15:58:16 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.8 2005/10/11 14:03:40 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -12,7 +12,7 @@
<mail link="citizen428@gentoo.org">Michael Kohl</mail>
</author>
<author title="Author">
- Otavio R. Piske
+ <mail link="angusyoung@gentoo.org">Otavio R. Piske</mail>
</author>
<author title="Author">
<mail link="ka0ttic@gentoo.org">Aaron Walker</mail>
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.5</version>
-<date>2005-10-06</date>
+<version>1.6</version>
+<date>2005-10-10</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -153,9 +153,9 @@
</p>
<pre caption="Creating a mount point and mounting partitions">
-# <i>mkdir /mnt/gfbsd</i>
+# <i>mkdir /mnt/gentoo</i>
<comment>(Replace X with the correct numbers for your hard disk.)</comment>
-# <i>mount /dev/adXsXa /mnt/gfbsd</i>
+# <i>mount /dev/adXsXa /mnt/gentoo</i>
</pre>
<p>
@@ -164,33 +164,33 @@
</p>
<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/stage3-x86-fbsd-20051005.tar.bz2</i>
-# <i>cp stage3-x86-fbsd-20051005.tar.bz2 /mnt/gfbsd/</i>
-# <i>cd /mnt/gfbsd/</i>
+# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/stage3-x86-fbsd-20051005.tar.bz2</i>
# <i>tar -jxvpf stage3-x86-fbsd-20051005.tar.bz2</i>
+<comment>(A wrong make.conf was packaged with the current stage3 tarball. We'll now remove it.)</comment>
+# <i>rm -f /mnt/gentoo/etc/make.conf</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
# <i>rm stage3-x86-fbsd-20051005.tar.bz2</i>
-<comment>(Create a home directory for root.)</comment>
-# <i>mkdir /mnt/gfbsd/root</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 than extract to <path>/usr/local/portage</path>.
+snapshot which you than extract to <path>/mnt/gentoo/usr/local/portage</path>
</p>
-<pre caption="Getting the Gentoo/FreeBSD portage overlay">
-# <i>cd /usr/local/portage</i>
+<pre caption="Getting the Gentoo/FreeBSD Portage overlay">
+# <i>mkdir /mnt/gentoo/usr/local/portage</i>
+# <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>
</pre>
<p>
-Alternatively, you can also use Subversion to check out the current version of the overlay.
-If you are interested in this possibility, please refer to the <uri
-link="http://www.gentoo.org/proj/en/gentoo-alt/overlay.xml">Gentoo/ALT overlay
+Alternatively, you can also use Subversion to check out the current version of
+the overlay. If you are interested in this possibility, please refer to the
+<uri link="/proj/en/gentoo-alt/overlay.xml">Gentoo/ALT overlay
documentation</uri>.
</p>
@@ -201,8 +201,9 @@
</p>
<pre caption="Mounting the /dev filesystem and chrooting">
-# <i>mount -t devfs none /mnt/gfbsd/dev/</i>
-# <i>chroot /mnt/gfbsd/ /bin/bash</i>
+# <i>mount -t devfs none /mnt/gentoo/dev/</i>
+# <i>cp /etc/resolv.conf /mnt/gentoo/etc</i>
+# <i>chroot /mnt/gentoo/ /bin/bash</i>
# <i>source /etc/profile</i>
</pre>
@@ -228,8 +229,13 @@
on your connection might take quite a while.
</p>
-<pre caption="Obtaining the portage tree">
+<pre caption="Obtaining the Portage tree">
# <i>emerge --sync</i>
+<comment>(It's also possible to retrieve the Portage tree in another way:)</comment>
+# <i>cd /</i>
+# <i>wget http://gentoo.osuosl.org/snapshots/portage-latest.tar.bz2</i>
+# <i>tar -xjf portage-latest.tar.bz2 -C /usr/</i>
+# <i>emerge --metadata</i>
</pre>
<p>
@@ -254,8 +260,8 @@
<comment>(Leave the chroot environment)</comment>
# <i>exit</i>
<comment>(Issued from outside the chroot)</comment>
-# <i>fdisk -b -B /mnt/gfbsd/boot/boot0 /dev/adX</i>
-# <i>chroot /mnt/gfbsd /bin/bash</i>
+# <i>fdisk -b -B /mnt/gentoo/boot/boot0 /dev/adX</i>
+# <i>chroot /mnt/gentoo /bin/bash</i>
# <i>disklabel -B adXsY</i>
</pre>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-10-06 15:58 Jan Kundrat
0 siblings, 0 replies; 30+ messages in thread
From: Jan Kundrat @ 2005-10-06 15:58 UTC (permalink / raw
To: gentoo-doc-cvs
jkt 05/10/06 15:58:16
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
#108285, "Update to gentoo-freebsd.xml" by citizen428
Revision Changes Path
1.7 +23 -46 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.7&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.7&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.6&r2=1.7&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- gentoo-freebsd.xml 21 Sep 2005 19:16:21 -0000 1.6
+++ gentoo-freebsd.xml 6 Oct 2005 15:58:16 -0000 1.7
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.6 2005/09/21 19:16:21 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.7 2005/10/06 15:58:16 jkt Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.4</version>
-<date>2005-09-21</date>
+<version>1.5</version>
+<date>2005-10-06</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -165,30 +165,36 @@
<pre caption="Obtaining and unpacking a stage3 tarball">
<comment>(Any other Gentoo mirror which includes the experimental/ directory will also work.)</comment>
-# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stage3-x86-fbsd-20050811.tar.bz2</i>
-# <i>cp stage3-x86-fbsd-20050811.tar.bz2 /mnt/gfbsd/</i>
+# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stage3-x86-fbsd-20051005.tar.bz2</i>
+# <i>cp stage3-x86-fbsd-20051005.tar.bz2 /mnt/gfbsd/</i>
# <i>cd /mnt/gfbsd/</i>
-# <i>tar -jxvpf stage3-x86-fbsd-20050811.tar.bz2</i>
+# <i>tar -jxvpf stage3-x86-fbsd-20051005.tar.bz2</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
-# <i>rm stage3-x86-fbsd-20050811.tar.bz2</i>
+# <i>rm stage3-x86-fbsd-20051005.tar.bz2</i>
<comment>(Create a home directory for root.)</comment>
# <i>mkdir /mnt/gfbsd/root</i>
</pre>
<p>
-Before chrooting into the newly-extracted stage, you first must obtain a copy of
-the Gentoo/FreeBSD overlay. If you are not a Gentoo developer, you can get it
-from the mirror provided by <mail link="carpaski@gentoo.org">Nick Jones</mail>.
-Theoretically, you could put this overlay in any directory you like, but from
-now on we will just assume that you have downloaded it to
-<path>/usr/local/portage/gentoo-freebsd</path>.
+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 than extract to <path>/usr/local/portage</path>.
</p>
<pre caption="Getting the Gentoo/FreeBSD portage overlay">
-# <i>cvs -d:pserver:anonymous@zarquon.twobit.net:/var/cvsroot -q -z9 co -R gentoo-projects/bsd/fbsd/</i>
+# <i>cd /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>
</pre>
<p>
+Alternatively, you can also use Subversion to check out the current version of the overlay.
+If you are interested in this possibility, please refer to the <uri
+link="http://www.gentoo.org/proj/en/gentoo-alt/overlay.xml">Gentoo/ALT overlay
+documentation</uri>.
+</p>
+
+<p>
In order for your install to work, you need to mount the <path>/dev</path>
filesystem from the currently running system into the Gentoo/FreeBSD mount
point before proceeding with the chroot.
@@ -197,6 +203,7 @@
<pre caption="Mounting the /dev filesystem and chrooting">
# <i>mount -t devfs none /mnt/gfbsd/dev/</i>
# <i>chroot /mnt/gfbsd/ /bin/bash</i>
+# <i>source /etc/profile</i>
</pre>
<p>
@@ -206,14 +213,14 @@
</p>
<pre caption="Setting up the profile and editing /etc/make.conf">
-# <i>ln -sf /usr/local/portage/gentoo-freebsd/profiles/default-bsd/fbsd/5.4/x86/ /etc/make.profile</i>
+# <i>ln -sf /usr/local/portage/portage-alt-overlay/profiles/default-bsd/fbsd/5.4/x86/ /etc/make.profile</i>
<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment>
# <i>ee /etc/make.conf</i>
<comment>(Please make sure you add at least the following entries:)</comment>
CHOST="i686-gentoo-freebsd5.4"
ACCEPT_KEYWORDS="~x86-fbsd ~x86"
FEATURES="-sandbox collision-protect"
-PORTDIR_OVERLAY="/usr/local/portage/gentoo-freebsd"
+PORTDIR_OVERLAY="/usr/local/portage/portage-alt-overlay"
</pre>
<p>
@@ -226,30 +233,6 @@
</pre>
<p>
-After you have synchronised your Portage tree, you only have to take a few last
-steps before your Gentoo/FreeBSD system is ready to use.
-</p>
-
-<pre caption="Final configuration">
-<comment>(Prevent crt1.o from getting removed by emerging gcc.)</comment>
-# <i>chflags schg /usr/lib/crt1.o</i>
-<comment>(Update the binutils installed by the stage3 tarball.)</comment>
-# <i>emerge -u binutils</i>
-<comment>(Select the correct gcc.)</comment>
-# <i>gcc-config 1</i>
-# <i>source /etc/profile</i>
-<comment>(Start the following script to fix a current bug in the stage3.)</comment>
-# <i>/usr/local/portage/gentoo-freebsd/scripts/domove.sh</i>
-<comment>(Re-emerge python, portage and py-freebsd.)</comment>
-# <i>emerge --nodeps python portage py-freebsd</i>
-</pre>
-
-<note>
-After gcc-config you will notice a message about GCC-SPECS which you can safely
-ignore.
-</note>
-
-<p>
Congratulations, by the time you have reached this step you should have a
running Gentoo/FreeBSD system! If you want, you can now rebuild the system's
core packages.
@@ -422,12 +405,6 @@
that on our <uri link="http://bugs.gentoo.org/">bugzilla</uri>. Please
remember to use the "Gentoo BSD" product for your submission.
</li>
- <li>
- Some ebuilds have hardcoded -ldl flags to link against libdl to get
- <c>dlopen()</c>. This needs to be fixed (for further information, please
- consult our <uri link="/proj/en/gentoo-alt/bsd/maintnotes.xml#doc_chap3">
- our Gentoo/*BSD Technotes Guide</uri>.
- </li>
<li>glib and gnome in general need a lot of fixes to be backported.</li>
</ul>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-09-21 19:16 Jan Kundrat
0 siblings, 0 replies; 30+ messages in thread
From: Jan Kundrat @ 2005-09-21 19:16 UTC (permalink / raw
To: gentoo-doc-cvs
jkt 05/09/21 19:16:21
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
21:09 <@jkt|> Flameeyes: btw, would you get angry if I change your mailing list stuff to link to lists.xml?
21:10 <@Flameeyes> jkt|, no problem, just don't remove the reference to #gentoo-bsd as there is where we discuss most of the things :P
Revision Changes Path
1.6 +4 -6 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.6&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.6&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.5&r2=1.6&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- gentoo-freebsd.xml 21 Sep 2005 19:04:05 -0000 1.5
+++ gentoo-freebsd.xml 21 Sep 2005 19:16:21 -0000 1.6
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.5 2005/09/21 19:04:05 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.6 2005/09/21 19:16:21 jkt Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,7 +28,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.3</version>
+<version>1.4</version>
<date>2005-09-21</date>
<chapter>
@@ -444,10 +444,8 @@
A list of Gentoo/FreeBSD developers can be found at the <uri
link="/proj/en/gentoo-alt/bsd/fbsd/">project page</uri>. Other ways to contact
Gentoo/FreeBSD developers include our IRC Channel <c>#gentoo-bsd</c> on
-Freenode, as well as the mailing list <mail>gentoo-bsd@gentoo.org</mail>. To
-subscribe just send an empty email to
-<mail>gentoo-bsd-subscribe@gentoo.org</mail> and follow the instructions
-included in the reply.
+Freenode, as well as the <uri link="/main/en/lists.xml">gentoo-bsd mailing
+list</uri>.
</p>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-09-21 19:04 Jan Kundrat
0 siblings, 0 replies; 30+ messages in thread
From: Jan Kundrat @ 2005-09-21 19:04 UTC (permalink / raw
To: gentoo-doc-cvs
jkt 05/09/21 19:04:05
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
#106816, update from citizen428
Revision Changes Path
1.5 +9 -11 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- gentoo-freebsd.xml 11 Sep 2005 16:27:55 -0000 1.4
+++ gentoo-freebsd.xml 21 Sep 2005 19:04:05 -0000 1.5
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.4 2005/09/11 16:27:55 cam Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.5 2005/09/21 19:04:05 jkt Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.2</version>
-<date>2005-09-10</date>
+<version>1.3</version>
+<date>2005-09-21</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -320,8 +320,9 @@
the original versions of these tools provided by our main Portage tree.
</li>
<li>
- Working with userland ebuilds: this means working closely with other
- developers in order to have our changes/patches accepted into the main tree.
+ Working on current ebuilds: this means working closely with ebuild maintainers
+ in order to create patches or modify ebuilds in a way that can be accepted
+ into the main tree.
</li>
<li>
Security: if you are into security, we need you! Although security
@@ -423,12 +424,9 @@
</li>
<li>
Some ebuilds have hardcoded -ldl flags to link against libdl to get
- <c>dlopen()</c>. This needs to be fixed.
- </li>
- <li>
- xorg-x11 6.8.99.14 and .15 won't build. Until this has been fixed, you can
- revert to xorg-x11-6.8.99.13. An ebuild can be obtained via <uri
- link="http://viewcvs.gentoo.org">ViewCVS</uri>.
+ <c>dlopen()</c>. This needs to be fixed (for further information, please
+ consult our <uri link="/proj/en/gentoo-alt/bsd/maintnotes.xml#doc_chap3">
+ our Gentoo/*BSD Technotes Guide</uri>.
</li>
<li>glib and gnome in general need a lot of fixes to be backported.</li>
</ul>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-09-11 16:27 Camille Huot
0 siblings, 0 replies; 30+ messages in thread
From: Camille Huot @ 2005-09-11 16:27 UTC (permalink / raw
To: gentoo-doc-cvs
cam 05/09/11 16:27:55
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
Fixed minor typos, no content changes.
Revision Changes Path
1.4 +26 -26 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- gentoo-freebsd.xml 10 Sep 2005 21:09:01 -0000 1.3
+++ gentoo-freebsd.xml 11 Sep 2005 16:27:55 -0000 1.4
@@ -1,5 +1,5 @@
-<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.3 2005/09/10 21:09:01 rane Exp $ -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.4 2005/09/11 16:27:55 cam Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -57,10 +57,10 @@
<body>
<p>
-Gentoo/FreeBSD is an effort effort to provide a fully-capable FreeBSD operating
-system with Gentoo's design sensibilities. The long-term goal of the Gentoo/BSD
-project is to allow users to choose any combination of *BSD or Linux kernels,
-*BSD or GNU libc, and *BSD or GNU userland tools.
+Gentoo/FreeBSD is an effort to provide a fully-capable FreeBSD operating system
+with Gentoo's design sensibilities. The long-term goal of the Gentoo/BSD project
+is to allow users to choose any combination of *BSD or Linux kernels, *BSD or
+GNU libc, and *BSD or GNU userland tools.
</p>
</body>
@@ -81,7 +81,7 @@
Contrary to Linux, which actually only refers to the kernel, FreeBSD is a
complete operating system, consisting of a C library, userland tools and
much more. This development approach makes the overall system very
- consistent
+ consistent.
</li>
<li>
Contrary to the Linux kernel, FreeBSD development is not led by one person,
@@ -99,19 +99,19 @@
<ul>
<li>
- To get run-time dynamic linking fuctions like <c>dlopen()</c>, programs do
+ To get run-time dynamic linking functions like <c>dlopen()</c>, programs do
not need to be linked against libdl like on GNU/Linux. Instead they are
- linked against libc
+ linked against libc.
</li>
<li>
FreeBSD doesn't have an official tool for kernel compilation, thus you'll
- have to resolve feature dependecies on your own
+ have to resolve feature dependencies on your own.
</li>
<li>
FreeBSD uses UFS/UFS-2 as its filesystems and has no official support for
e.g. ReiserFS or XFS. However, there are projects for adding read-only
- support for these filesystems. However, accessing ext2/ext3 partitions is
- already possible, but you cannot install your system on them.
+ support for these filesystems. Accessing ext2/ext3 partitions is already
+ possible, but you cannot install your system on them.
</li>
</ul>
@@ -210,8 +210,8 @@
<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment>
# <i>ee /etc/make.conf</i>
<comment>(Please make sure you add at least the following entries:)</comment>
-CHOST="i686-gentoo-freebsd5.4"
-ACCEPT_KEYWORDS="~x86-fbsd ~x86"
+CHOST="i686-gentoo-freebsd5.4"
+ACCEPT_KEYWORDS="~x86-fbsd ~x86"
FEATURES="-sandbox collision-protect"
PORTDIR_OVERLAY="/usr/local/portage/gentoo-freebsd"
</pre>
@@ -306,7 +306,7 @@
<chapter>
<title>Developing for Gentoo/FreeBSD</title>
<section>
-<title>How to help </title>
+<title>How to help</title>
<body>
<p>
@@ -317,28 +317,28 @@
<ul>
<li>
We need GCC and binutils hackers who are able to port FreeBSD's patches to
- the original versions of these tools provided by our main Portage tree
+ the original versions of these tools provided by our main Portage tree.
</li>
<li>
Working with userland ebuilds: this means working closely with other
- developers in order to have our changes/patches accepted into the main tree
+ developers in order to have our changes/patches accepted into the main tree.
</li>
<li>
Security: if you are into security, we need you! Although security
advisories from the FreeBSD project are tracked and fixed, we can always
- use help in this area
+ use help in this area.
</li>
<li>
Contacts: we need people who can get in touch with FreeBSD developers to
maintain contacts between us and the original project to exchange patches
and discuss various problems and their solutions. Note that this should
- never involve any kind of spamming of mailing lists or IRC channels
+ never involve any kind of spamming of mailing lists or IRC channels.
</li>
<li>
Testing: the more people are actively using Gentoo/FreeBSD, the more bugs
will be discovered, which helps us improving the quality of the port. If
you are good at describing bugs or problems, we definitely want to hear
- from you
+ from you.
</li>
<li>
Other areas where we need help include: system ebuilds, baselayout,
@@ -364,12 +364,12 @@
Instead, it uses its own implementation of <c>make</c>, putting
configuration options in external files and some .mk files that are
included with each Makefile. Although a lot of work has been put into
- those .mk files, it is not hard to find some installations failling due to
+ those .mk files, it is not hard to find some installations failing due to
a missing <c>${INSTALL} -d</c> somewhere. The easy way to deal with
this kind of problem is to read the Makefile to find the accompanying .mk
file, then open that file and try to figure out which part failed (this is
not really hard once you figure out where in the installation process it
- stopped)
+ stopped).
</li>
<li>
Besides, due to the fact that FreeBSD is a complete operating system, you
@@ -419,16 +419,16 @@
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
+ remember to use the "Gentoo BSD" product for your submission.
</li>
<li>
Some ebuilds have hardcoded -ldl flags to link against libdl to get
- <c>dlopen()</c>. This needs to be fixed
+ <c>dlopen()</c>. This needs to be fixed.
</li>
<li>
xorg-x11 6.8.99.14 and .15 won't build. Until this has been fixed, you can
revert to xorg-x11-6.8.99.13. An ebuild can be obtained via <uri
- link="http://viewcvs.gentoo.org">ViewCVS</uri>
+ link="http://viewcvs.gentoo.org">ViewCVS</uri>.
</li>
<li>glib and gnome in general need a lot of fixes to be backported.</li>
</ul>
@@ -443,7 +443,7 @@
<body>
<p>
-At list of Gentoo/FreeBSD developers can be found at the <uri
+A list of Gentoo/FreeBSD developers can be found at the <uri
link="/proj/en/gentoo-alt/bsd/fbsd/">project page</uri>. Other ways to contact
Gentoo/FreeBSD developers include our IRC Channel <c>#gentoo-bsd</c> on
Freenode, as well as the mailing list <mail>gentoo-bsd@gentoo.org</mail>. To
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-09-10 21:09 Lukasz Damentko
0 siblings, 0 replies; 30+ messages in thread
From: Lukasz Damentko @ 2005-09-10 21:09 UTC (permalink / raw
To: gentoo-doc-cvs
rane 05/09/10 21:09:01
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
update by citizen428 from #105533
Revision Changes Path
1.3 +31 -20 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- gentoo-freebsd.xml 9 Sep 2005 11:09:07 -0000 1.2
+++ gentoo-freebsd.xml 10 Sep 2005 21:09:01 -0000 1.3
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.2 2005/09/09 11:09:07 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.3 2005/09/10 21:09:01 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.1</version>
-<date>2005-09-09</date>
+<version>1.2</version>
+<date>2005-09-10</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -171,6 +171,21 @@
# <i>tar -jxvpf stage3-x86-fbsd-20050811.tar.bz2</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
# <i>rm stage3-x86-fbsd-20050811.tar.bz2</i>
+<comment>(Create a home directory for root.)</comment>
+# <i>mkdir /mnt/gfbsd/root</i>
+</pre>
+
+<p>
+Before chrooting into the newly-extracted stage, you first must obtain a copy of
+the Gentoo/FreeBSD overlay. If you are not a Gentoo developer, you can get it
+from the mirror provided by <mail link="carpaski@gentoo.org">Nick Jones</mail>.
+Theoretically, you could put this overlay in any directory you like, but from
+now on we will just assume that you have downloaded it to
+<path>/usr/local/portage/gentoo-freebsd</path>.
+</p>
+
+<pre caption="Getting the Gentoo/FreeBSD portage overlay">
+# <i>cvs -d:pserver:anonymous@zarquon.twobit.net:/var/cvsroot -q -z9 co -R gentoo-projects/bsd/fbsd/</i>
</pre>
<p>
@@ -185,18 +200,6 @@
</pre>
<p>
-Once inside the chroot you have to obtain a copy of the Gentoo/FreeBSD overlay.
-If you are not a Gentoo developer, you can get it from the mirror provided by
-<mail link="carpaski@gentoo.org">Nick Jones</mail>. Theoretically, you could
-put this overlay in any directory you like, but from now on we will just assume
-that you have downloaded it to <path>/usr/local/portage/gentoo-freebsd</path>.
-</p>
-
-<pre caption="Getting the Gentoo/FreeBSD portage overlay">
-# <i>cvs -d:pserver:anonymous@zarquon.twobit.net:/var/cvsroot -q -z9 co -R gentoo-projects/bsd/fbsd/</i>
-</pre>
-
-<p>
After you got hold of the Gentoo/FreeBSD overlay, it's time to link
<path>/etc/make.profile</path> to the correct profile and add get your
<path>/etc/make.conf</path> ready for Gentoo/FreeBSD.
@@ -228,16 +231,24 @@
</p>
<pre caption="Final configuration">
-<comment>(Prevent crt1.o from getting removed by emerging gcc)</comment>
+<comment>(Prevent crt1.o from getting removed by emerging gcc.)</comment>
# <i>chflags schg /usr/lib/crt1.o</i>
-<comment>(Emerge binary packages for binutils and patch provided by the stage3 tarball)</comment>
-# <i>emerge -K binutils patch</i>
-<comment>(Select the correct gcc)</comment>
+<comment>(Update the binutils installed by the stage3 tarball.)</comment>
+# <i>emerge -u binutils</i>
+<comment>(Select the correct gcc.)</comment>
# <i>gcc-config 1</i>
-<comment>(Re-emerging python, portage and py-freebsd)</comment>
+# <i>source /etc/profile</i>
+<comment>(Start the following script to fix a current bug in the stage3.)</comment>
+# <i>/usr/local/portage/gentoo-freebsd/scripts/domove.sh</i>
+<comment>(Re-emerge python, portage and py-freebsd.)</comment>
# <i>emerge --nodeps python portage py-freebsd</i>
</pre>
+<note>
+After gcc-config you will notice a message about GCC-SPECS which you can safely
+ignore.
+</note>
+
<p>
Congratulations, by the time you have reached this step you should have a
running Gentoo/FreeBSD system! If you want, you can now rebuild the system's
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-09-09 11:09 Shyam Mani
0 siblings, 0 replies; 30+ messages in thread
From: Shyam Mani @ 2005-09-09 11:09 UTC (permalink / raw
To: gentoo-doc-cvs
fox2mike 05/09/09 11:09:07
Modified: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
#104812 - Updates to the Gentoo/FBSD guide, thanks to citizen428.
Revision Changes Path
1.2 +44 -11 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- gentoo-freebsd.xml 31 Aug 2005 14:19:33 -0000 1.1
+++ gentoo-freebsd.xml 9 Sep 2005 11:09:07 -0000 1.2
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.1 2005/08/31 14:19:33 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.2 2005/09/09 11:09:07 fox2mike Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.0</version>
-<date>2005-08-31</date>
+<version>1.1</version>
+<date>2005-09-09</date>
<chapter>
<title>Introduction to FreeBSD</title>
@@ -228,14 +228,14 @@
</p>
<pre caption="Final configuration">
-<comment>(Prevent crt1.o from getting removed by emerging gcc.)</comment>
+<comment>(Prevent crt1.o from getting removed by emerging gcc)</comment>
# <i>chflags schg /usr/lib/crt1.o</i>
-<comment>(Emerge binary packages for binutils and patch provided by the stage3 tarball.)</comment>
+<comment>(Emerge binary packages for binutils and patch provided by the stage3 tarball)</comment>
# <i>emerge -K binutils patch</i>
-<comment>(Select the correct gcc.)</comment>
+<comment>(Select the correct gcc)</comment>
# <i>gcc-config 1</i>
-<comment>(Re-emerging python, portage and py-freebsd.)</comment>
-# <i>emerge python portage py-freebsd</i>
+<comment>(Re-emerging python, portage and py-freebsd)</comment>
+# <i>emerge --nodeps python portage py-freebsd</i>
</pre>
<p>
@@ -250,11 +250,44 @@
<impo>
Please make absolutely sure you add your new Gentoo/FreeBSD installation to the
-configuration of the bootloader, otherwise you won't be able to boot your newly
-installed system! If you have no bootloader installed, you should run <c>emerge
-boot0</c>.
+configuration of your bootloader, otherwise you won't be able to boot your newly
+installed system! If you don't have another bootloader installed, you should use
+<c>boot0</c>, as it is currently the only one supported by FreeBSD.
</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/gfbsd/boot/boot0 /dev/adX</i>
+# <i>chroot /mnt/gfbsd /bin/bash</i>
+# <i>disklabel -B adXsY</i>
+</pre>
+
+<p>
+If you need additonal 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.
+</p>
+
+<p>
+When you did <c>emerge system</c>, the sources for the FreeBSD kernel got
+installed to <path>/usr/src/sys</path>. Configuring and compiling a custom
+kernel is really different from compiling Linux, so if you are not familiar with
+the process we encourage you to have a look at <uri
+link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html">
+chapter 8</uri> of the FreeBSD handbook.
+</p>
+
+<p>
+Please note that currently only the "Traditional" way of building the kernel is
+supported on Gentoo/FreeBSD! Also note that <c>make install</c> will probably
+ask you for a <path>/boot/device.hints</path> file. A default version can be
+found in the <path>conf</path> subdirectory of the <c>GENERIC</c> configuration
+and is called <path>GENERIC.hints</path>
+</p>
+
</body>
</section>
</chapter>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
@ 2005-08-31 14:19 Xavier Neys
0 siblings, 0 replies; 30+ messages in thread
From: Xavier Neys @ 2005-08-31 14:19 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 05/08/31 14:19:33
Added: xml/htdocs/doc/en gentoo-freebsd.xml
Log:
New doc from the G/FreeBSD team
Revision Changes Path
1.1 xml/htdocs/doc/en/gentoo-freebsd.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: gentoo-freebsd.xml
===================================================================
<?xml version='1.0' encoding="UTF-8"?>
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.1 2005/08/31 14:19:33 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-freebsd.xml">
<title>A short guide to Gentoo/FreeBSD</title>
<author title="Author">
<mail link="ignacio.arquelatour@gmail.com">Ignacio Arque-Latour</mail>
</author>
<author title="Author">
<mail link="citizen428@gentoo.org">Michael Kohl</mail>
</author>
<author title="Author">
Otavio R. Piske
</author>
<author title="Author">
<mail link="ka0ttic@gentoo.org">Aaron Walker</mail>
</author>
<abstract>
This document gives some general information on FreeBSD, as well as
installation instructions for Gentoo/FreeBSD. It also includes some reference
for people interested in helping out with development.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>1.0</version>
<date>2005-08-31</date>
<chapter>
<title>Introduction to FreeBSD</title>
<section>
<title>What is FreeBSD?</title>
<body>
<p>
<uri link="http://www.freebsd.org/">FreeBSD</uri> is a free (<uri
link="http://www.freebsd.org/copyright/freebsd-license.html">license</uri>)
Unix-like operating system. Back in 1993 when development of <uri
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 architetures, and FreeBSD which focuses mainly on the x86
platform. 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 5.4, which is also used as the foundation for the
Gentoo/FreeBSD project.
</p>
</body>
</section>
<section>
<title>What is Gentoo/FreeBSD?</title>
<body>
<p>
Gentoo/FreeBSD is an effort effort to provide a fully-capable FreeBSD operating
system with Gentoo's design sensibilities. The long-term goal of the Gentoo/BSD
project is to allow users to choose any combination of *BSD or Linux kernels,
*BSD or GNU libc, and *BSD or GNU userland tools.
</p>
</body>
</section>
<section>
<title>FreeBSD and Linux</title>
<body>
<p>
Users migrating from Linux to FreeBSD commonly consider the two operating
systems "almost the same". In fact, FreeBSD really shares a lot of similarities
with Linux distributions in general. Nevertheless, it has some key differences
that are worth noting:
</p>
<ul>
<li>
Contrary to Linux, which actually only refers to the kernel, FreeBSD is a
complete operating system, consisting of a C library, userland tools and
much more. This development approach makes the overall system very
consistent
</li>
<li>
Contrary to the Linux kernel, FreeBSD development is not led by one person,
but instead managed by a small group of people called the <uri
link="http://www.freebsd.org/doc/en_US.ISO8859-1/articles/contributors/staff-core.html">Core
Team</uri>.
</li>
</ul>
<p>
Besides, FreeBSD also has some technical differences which set it apart
from Linux. Some of them are very important to know, even if you don't plan on
joining the Gentoo/FreeBSD development effort:
</p>
<ul>
<li>
To get run-time dynamic linking fuctions like <c>dlopen()</c>, programs do
not need to be linked against libdl like on GNU/Linux. Instead they are
linked against libc
</li>
<li>
FreeBSD doesn't have an official tool for kernel compilation, thus you'll
have to resolve feature dependecies on your own
</li>
<li>
FreeBSD uses UFS/UFS-2 as its filesystems and has no official support for
e.g. ReiserFS or XFS. However, there are projects for adding read-only
support for these filesystems. However, accessing ext2/ext3 partitions is
already possible, but you cannot install your system on them.
</li>
</ul>
</body>
</section>
</chapter>
<chapter>
<title>Installing Gentoo/FreeBSD</title>
<section>
<title>Installation instructions</title>
<body>
<p>
After this short introduction, it's about time to finally install
Gentoo/FreeBSD. Unfortunately, we currently lack our own installation media, so
you have to choose between two alternative installation methods. The first
would be to use an existing FreeBSD installation to partition your hard drive
and use it as a base for installing Gentoo/FreeBSD. Alternatively, you can also
use the excellent <uri link="http://www.freesbie.org/">FreeSBIE LiveCD</uri> as
an installation medium for Gentoo/FreeBSD.
</p>
<p>
Before you can begin with the installation, you have to setup a hard disk for
use with Gentoo/FreeBSD. This can either be done via <c>sysinstall</c>
(available from a current FreeBSD installation as well as from within FreeSBIE)
or by manually using the commands <c>fdisk</c>, <c>disklabel</c> and
<c>newfs</c>. If you have never set up a FreeBSD system before,
<c>sysinstall</c> may be the better option for you. If you face difficulties
while partitioning or formatting your hard disks, have a look at the great
<uri link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
Handbook</uri> or hop onto <c>#gentoo-bsd</c> on the Freenode IRC server.
</p>
<p>
Once you're done setting up your disks, you have to create a mount point for
your Gentoo/FreeBSD installation and mount all the necessary partitions.
</p>
<pre caption="Creating a mount point and mounting partitions">
# <i>mkdir /mnt/gfbsd</i>
<comment>(Replace X with the correct numbers for your hard disk.)</comment>
# <i>mount /dev/adXsXa /mnt/gfbsd</i>
</pre>
<p>
Now that you have mounted the target partition, it is time to fetch and unpack
a stage3 tarball.
</p>
<pre caption="Obtaining and unpacking a stage3 tarball">
<comment>(Any other Gentoo mirror which includes the experimental/ directory will also work.)</comment>
# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stage3-x86-fbsd-20050811.tar.bz2</i>
# <i>cp stage3-x86-fbsd-20050811.tar.bz2 /mnt/gfbsd/</i>
# <i>cd /mnt/gfbsd/</i>
# <i>tar -jxvpf stage3-x86-fbsd-20050811.tar.bz2</i>
<comment>(You can delete the tarball with the following command if you want to.)</comment>
# <i>rm stage3-x86-fbsd-20050811.tar.bz2</i>
</pre>
<p>
In order for your install to work, you need to mount the <path>/dev</path>
filesystem from the currently running system into the Gentoo/FreeBSD mount
point before proceeding with the chroot.
</p>
<pre caption="Mounting the /dev filesystem and chrooting">
# <i>mount -t devfs none /mnt/gfbsd/dev/</i>
# <i>chroot /mnt/gfbsd/ /bin/bash</i>
</pre>
<p>
Once inside the chroot you have to obtain a copy of the Gentoo/FreeBSD overlay.
If you are not a Gentoo developer, you can get it from the mirror provided by
<mail link="carpaski@gentoo.org">Nick Jones</mail>. Theoretically, you could
put this overlay in any directory you like, but from now on we will just assume
that you have downloaded it to <path>/usr/local/portage/gentoo-freebsd</path>.
</p>
<pre caption="Getting the Gentoo/FreeBSD portage overlay">
# <i>cvs -d:pserver:anonymous@zarquon.twobit.net:/var/cvsroot -q -z9 co -R gentoo-projects/bsd/fbsd/</i>
</pre>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 30+ messages in thread
end of thread, other threads:[~2008-06-02 18:58 UTC | newest]
Thread overview: 30+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-10-06 21:48 [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml Josh Saddler
-- strict thread matches above, loose matches on Subject: below --
2008-06-02 18:58 Camille Huot
2008-05-20 18:38 Sven Vermeulen
2007-05-11 0:11 Camille Huot
2007-05-10 23:59 Camille Huot
2007-05-10 22:00 Camille Huot
2007-04-08 21:55 Josh Saddler
2007-04-04 14:22 Josh Saddler
2007-01-03 3:08 Josh Saddler
2006-11-25 4:04 Josh Saddler
2006-05-26 19:29 Josh Saddler
2006-05-26 19:21 Josh Saddler
2006-05-03 1:03 Lukasz Damentko
2006-05-03 1:01 Lukasz Damentko
2006-03-30 8:41 Xavier Neys
2006-03-28 10:30 Xavier Neys
2006-03-02 13:32 Jose Luis Rivero
2006-01-10 21:15 Marcelo Goes
2005-12-20 19:12 Camille Huot
2005-12-06 12:32 Jan Kundrat
2005-10-21 10:45 Xavier Neys
2005-10-16 15:31 Xavier Neys
2005-10-11 14:03 Lukasz Damentko
2005-10-06 15:58 Jan Kundrat
2005-09-21 19:16 Jan Kundrat
2005-09-21 19:04 Jan Kundrat
2005-09-11 16:27 Camille Huot
2005-09-10 21:09 Lukasz Damentko
2005-09-09 11:09 Shyam Mani
2005-08-31 14:19 Xavier Neys
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox