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> -- [email protected] mailing list
