/[gentoo]/xml/htdocs/doc/en/gentoo-freebsd.xml
Gentoo

Diff of /xml/htdocs/doc/en/gentoo-freebsd.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.2 Revision 1.3
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.2 2005/09/09 11:09:07 fox2mike Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.3 2005/09/10 21:09:01 rane Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link="/doc/en/gentoo-freebsd.xml"> 5<guide link="/doc/en/gentoo-freebsd.xml">
6<title>A short guide to Gentoo/FreeBSD</title> 6<title>A short guide to Gentoo/FreeBSD</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="ignacio.arquelatour@gmail.com">Ignacio Arque-Latour</mail> 9 <mail link="ignacio.arquelatour@gmail.com">Ignacio Arque-Latour</mail>
10</author> 10</author>
11<author title="Author"> 11<author title="Author">
12 <mail link="citizen428@gentoo.org">Michael Kohl</mail> 12 <mail link="citizen428@gentoo.org">Michael Kohl</mail>
13</author> 13</author>
14<author title="Author"> 14<author title="Author">
15 Otavio R. Piske 15 Otavio R. Piske
16</author> 16</author>
17<author title="Author"> 17<author title="Author">
18 <mail link="ka0ttic@gentoo.org">Aaron Walker</mail> 18 <mail link="ka0ttic@gentoo.org">Aaron Walker</mail>
19</author> 19</author>
20 20
21<abstract> 21<abstract>
22This document gives some general information on FreeBSD, as well as 22This document gives some general information on FreeBSD, as well as
23installation instructions for Gentoo/FreeBSD. It also includes some reference 23installation instructions for Gentoo/FreeBSD. It also includes some reference
24for people interested in helping out with development. 24for people interested in helping out with development.
25</abstract> 25</abstract>
26 26
27<!-- The content of this document is licensed under the CC-BY-SA license --> 27<!-- The content of this document is licensed under the CC-BY-SA license -->
28<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 28<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
29<license/> 29<license/>
30 30
31<version>1.1</version> 31<version>1.2</version>
32<date>2005-09-09</date> 32<date>2005-09-10</date>
33 33
34<chapter> 34<chapter>
35<title>Introduction to FreeBSD</title> 35<title>Introduction to FreeBSD</title>
36<section> 36<section>
37<title>What is FreeBSD?</title> 37<title>What is FreeBSD?</title>
38<body> 38<body>
39 39
40<p> 40<p>
41<uri link="http://www.freebsd.org/">FreeBSD</uri> is a free (<uri 41<uri link="http://www.freebsd.org/">FreeBSD</uri> is a free (<uri
42link="http://www.freebsd.org/copyright/freebsd-license.html">license</uri>) 42link="http://www.freebsd.org/copyright/freebsd-license.html">license</uri>)
43Unix-like operating system. Back in 1993 when development of <uri 43Unix-like operating system. Back in 1993 when development of <uri
44link="http://www.386bsd.org/">386BSD</uri> stopped, two projects were born: 44link="http://www.386bsd.org/">386BSD</uri> stopped, two projects were born:
45<uri link="http://www.netbsd.org/">NetBSD</uri>, commonly known to run on a 45<uri link="http://www.netbsd.org/">NetBSD</uri>, commonly known to run on a
46huge number of architetures, and FreeBSD which focuses mainly on the x86 46huge number of architetures, and FreeBSD which focuses mainly on the x86
47platform. FreeBSD is renowned for its stability, performance and security, thus 47platform. FreeBSD is renowned for its stability, performance and security, thus
159</pre> 159</pre>
160 160
161<p> 161<p>
162Now that you have mounted the target partition, it is time to fetch and unpack 162Now that you have mounted the target partition, it is time to fetch and unpack
163a stage3 tarball. 163a stage3 tarball.
164</p> 164</p>
165 165
166<pre caption="Obtaining and unpacking a stage3 tarball"> 166<pre caption="Obtaining and unpacking a stage3 tarball">
167<comment>(Any other Gentoo mirror which includes the experimental/ directory will also work.)</comment> 167<comment>(Any other Gentoo mirror which includes the experimental/ directory will also work.)</comment>
168# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stage3-x86-fbsd-20050811.tar.bz2</i> 168# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stage3-x86-fbsd-20050811.tar.bz2</i>
169# <i>cp stage3-x86-fbsd-20050811.tar.bz2 /mnt/gfbsd/</i> 169# <i>cp stage3-x86-fbsd-20050811.tar.bz2 /mnt/gfbsd/</i>
170# <i>cd /mnt/gfbsd/</i> 170# <i>cd /mnt/gfbsd/</i>
171# <i>tar -jxvpf stage3-x86-fbsd-20050811.tar.bz2</i> 171# <i>tar -jxvpf stage3-x86-fbsd-20050811.tar.bz2</i>
172<comment>(You can delete the tarball with the following command if you want to.)</comment> 172<comment>(You can delete the tarball with the following command if you want to.)</comment>
173# <i>rm stage3-x86-fbsd-20050811.tar.bz2</i> 173# <i>rm stage3-x86-fbsd-20050811.tar.bz2</i>
174<comment>(Create a home directory for root.)</comment>
175# <i>mkdir /mnt/gfbsd/root</i>
176</pre>
177
178<p>
179Before chrooting into the newly-extracted stage, you first must obtain a copy of
180the Gentoo/FreeBSD overlay. If you are not a Gentoo developer, you can get it
181from the mirror provided by <mail link="carpaski@gentoo.org">Nick Jones</mail>.
182Theoretically, you could put this overlay in any directory you like, but from
183now on we will just assume that you have downloaded it to
184<path>/usr/local/portage/gentoo-freebsd</path>.
185</p>
186
187<pre caption="Getting the Gentoo/FreeBSD portage overlay">
188# <i>cvs -d:pserver:anonymous@zarquon.twobit.net:/var/cvsroot -q -z9 co -R gentoo-projects/bsd/fbsd/</i>
174</pre> 189</pre>
175 190
176<p> 191<p>
177In order for your install to work, you need to mount the <path>/dev</path> 192In order for your install to work, you need to mount the <path>/dev</path>
178filesystem from the currently running system into the Gentoo/FreeBSD mount 193filesystem from the currently running system into the Gentoo/FreeBSD mount
179point before proceeding with the chroot. 194point before proceeding with the chroot.
180</p> 195</p>
181 196
182<pre caption="Mounting the /dev filesystem and chrooting"> 197<pre caption="Mounting the /dev filesystem and chrooting">
183# <i>mount -t devfs none /mnt/gfbsd/dev/</i> 198# <i>mount -t devfs none /mnt/gfbsd/dev/</i>
184# <i>chroot /mnt/gfbsd/ /bin/bash</i> 199# <i>chroot /mnt/gfbsd/ /bin/bash</i>
185</pre>
186
187<p>
188Once inside the chroot you have to obtain a copy of the Gentoo/FreeBSD overlay.
189If you are not a Gentoo developer, you can get it from the mirror provided by
190<mail link="carpaski@gentoo.org">Nick Jones</mail>. Theoretically, you could
191put this overlay in any directory you like, but from now on we will just assume
192that you have downloaded it to <path>/usr/local/portage/gentoo-freebsd</path>.
193</p>
194
195<pre caption="Getting the Gentoo/FreeBSD portage overlay">
196# <i>cvs -d:pserver:anonymous@zarquon.twobit.net:/var/cvsroot -q -z9 co -R gentoo-projects/bsd/fbsd/</i>
197</pre> 200</pre>
198 201
199<p> 202<p>
200After you got hold of the Gentoo/FreeBSD overlay, it's time to link 203After you got hold of the Gentoo/FreeBSD overlay, it's time to link
201<path>/etc/make.profile</path> to the correct profile and add get your 204<path>/etc/make.profile</path> to the correct profile and add get your
202<path>/etc/make.conf</path> ready for Gentoo/FreeBSD. 205<path>/etc/make.conf</path> ready for Gentoo/FreeBSD.
203</p> 206</p>
204 207
205<pre caption="Setting up the profile and editing /etc/make.conf"> 208<pre caption="Setting up the profile and editing /etc/make.conf">
206# <i>ln -sf /usr/local/portage/gentoo-freebsd/profiles/default-bsd/fbsd/5.4/x86/ /etc/make.profile</i> 209# <i>ln -sf /usr/local/portage/gentoo-freebsd/profiles/default-bsd/fbsd/5.4/x86/ /etc/make.profile</i>
207<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment> 210<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment>
208# <i>ee /etc/make.conf</i> 211# <i>ee /etc/make.conf</i>
209<comment>(Please make sure you add at least the following entries:)</comment> 212<comment>(Please make sure you add at least the following entries:)</comment>
210CHOST="i686-gentoo-freebsd5.4" 213CHOST="i686-gentoo-freebsd5.4"
211ACCEPT_KEYWORDS="~x86-fbsd ~x86" 214ACCEPT_KEYWORDS="~x86-fbsd ~x86"
216<p> 219<p>
217Now, you have to obtain a copy of the main Gentoo Portage tree, which depending 220Now, you have to obtain a copy of the main Gentoo Portage tree, which depending
218on your connection might take quite a while. 221on your connection might take quite a while.
219</p> 222</p>
220 223
221<pre caption="Obtaining the portage tree"> 224<pre caption="Obtaining the portage tree">
222# <i>emerge --sync</i> 225# <i>emerge --sync</i>
223</pre> 226</pre>
224 227
225<p> 228<p>
226After you have synchronised your Portage tree, you only have to take a few last 229After you have synchronised your Portage tree, you only have to take a few last
227steps before your Gentoo/FreeBSD system is ready to use. 230steps before your Gentoo/FreeBSD system is ready to use.
228</p> 231</p>
229 232
230<pre caption="Final configuration"> 233<pre caption="Final configuration">
231<comment>(Prevent crt1.o from getting removed by emerging gcc)</comment> 234<comment>(Prevent crt1.o from getting removed by emerging gcc.)</comment>
232# <i>chflags schg /usr/lib/crt1.o</i> 235# <i>chflags schg /usr/lib/crt1.o</i>
233<comment>(Emerge binary packages for binutils and patch provided by the stage3 tarball)</comment> 236<comment>(Update the binutils installed by the stage3 tarball.)</comment>
234# <i>emerge -K binutils patch</i> 237# <i>emerge -u binutils</i>
235<comment>(Select the correct gcc)</comment> 238<comment>(Select the correct gcc.)</comment>
236# <i>gcc-config 1</i> 239# <i>gcc-config 1</i>
240# <i>source /etc/profile</i>
241<comment>(Start the following script to fix a current bug in the stage3.)</comment>
242# <i>/usr/local/portage/gentoo-freebsd/scripts/domove.sh</i>
237<comment>(Re-emerging python, portage and py-freebsd)</comment> 243<comment>(Re-emerge python, portage and py-freebsd.)</comment>
238# <i>emerge --nodeps python portage py-freebsd</i> 244# <i>emerge --nodeps python portage py-freebsd</i>
239</pre> 245</pre>
246
247<note>
248After gcc-config you will notice a message about GCC-SPECS which you can safely
249ignore.
250</note>
240 251
241<p> 252<p>
242Congratulations, by the time you have reached this step you should have a 253Congratulations, by the time you have reached this step you should have a
243running Gentoo/FreeBSD system! If you want, you can now rebuild the system's 254running Gentoo/FreeBSD system! If you want, you can now rebuild the system's
244core packages. 255core packages.
245</p> 256</p>
246 257
247<pre caption="Rebuilding the FreeBSD core packages"> 258<pre caption="Rebuilding the FreeBSD core packages">
248# <i>emerge -e system</i> 259# <i>emerge -e system</i>
249</pre> 260</pre>
250 261
251<impo> 262<impo>
252Please make absolutely sure you add your new Gentoo/FreeBSD installation to the 263Please make absolutely sure you add your new Gentoo/FreeBSD installation to the
253configuration of your bootloader, otherwise you won't be able to boot your newly 264configuration of your bootloader, otherwise you won't be able to boot your newly
254installed system! If you don't have another bootloader installed, you should use 265installed system! If you don't have another bootloader installed, you should use

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.3

  ViewVC Help
Powered by ViewVC 1.1.20