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