/[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.1 Revision 1.2
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.1 2005/08/31 14:19:33 neysx Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.2 2005/09/09 11:09:07 fox2mike 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.0</version> 31<version>1.1</version>
32<date>2005-08-31</date> 32<date>2005-09-09</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
216<p> 216<p>
217Now, you have to obtain a copy of the main Gentoo Portage tree, which depending 217Now, you have to obtain a copy of the main Gentoo Portage tree, which depending
218on your connection might take quite a while. 218on your connection might take quite a while.
219</p> 219</p>
220 220
221<pre caption="Obtaining the portage tree"> 221<pre caption="Obtaining the portage tree">
222# <i>emerge --sync</i> 222# <i>emerge --sync</i>
223</pre> 223</pre>
224 224
225<p> 225<p>
226After you have synchronised your Portage tree, you only have to take a few last 226After you have synchronised your Portage tree, you only have to take a few last
227steps before your Gentoo/FreeBSD system is ready to use. 227steps before your Gentoo/FreeBSD system is ready to use.
228</p> 228</p>
229 229
230<pre caption="Final configuration"> 230<pre caption="Final configuration">
231<comment>(Prevent crt1.o from getting removed by emerging gcc.)</comment> 231<comment>(Prevent crt1.o from getting removed by emerging gcc)</comment>
232# <i>chflags schg /usr/lib/crt1.o</i> 232# <i>chflags schg /usr/lib/crt1.o</i>
233<comment>(Emerge binary packages for binutils and patch provided by the stage3 tarball.)</comment> 233<comment>(Emerge binary packages for binutils and patch provided by the stage3 tarball)</comment>
234# <i>emerge -K binutils patch</i> 234# <i>emerge -K binutils patch</i>
235<comment>(Select the correct gcc.)</comment> 235<comment>(Select the correct gcc)</comment>
236# <i>gcc-config 1</i> 236# <i>gcc-config 1</i>
237<comment>(Re-emerging python, portage and py-freebsd.)</comment> 237<comment>(Re-emerging python, portage and py-freebsd)</comment>
238# <i>emerge python portage py-freebsd</i> 238# <i>emerge --nodeps python portage py-freebsd</i>
239</pre> 239</pre>
240 240
241<p> 241<p>
242Congratulations, by the time you have reached this step you should have a 242Congratulations, 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 243running Gentoo/FreeBSD system! If you want, you can now rebuild the system's
244core packages. 244core packages.
245</p> 245</p>
246 246
247<pre caption="Rebuilding the FreeBSD core packages"> 247<pre caption="Rebuilding the FreeBSD core packages">
248# <i>emerge -e system</i> 248# <i>emerge -e system</i>
249</pre> 249</pre>
250 250
251<impo> 251<impo>
252Please make absolutely sure you add your new Gentoo/FreeBSD installation to the 252Please make absolutely sure you add your new Gentoo/FreeBSD installation to the
253configuration of the bootloader, otherwise you won't be able to boot your newly 253configuration of your bootloader, otherwise you won't be able to boot your newly
254installed system! If you have no bootloader installed, you should run <c>emerge 254installed system! If you don't have another bootloader installed, you should use
255boot0</c>. 255<c>boot0</c>, as it is currently the only one supported by FreeBSD.
256</impo> 256</impo>
257
258<pre caption="Installing and setting up boot0">
259# <i>emerge boot0</i>
260<comment>(Leave the chroot environment)</comment>
261# <i>exit</i>
262<comment>(Issued from outside the chroot)</comment>
263# <i>fdisk -b -B /mnt/gfbsd/boot/boot0 /dev/adX</i>
264# <i>chroot /mnt/gfbsd /bin/bash</i>
265# <i>disklabel -B adXsY</i>
266</pre>
267
268<p>
269If you need additonal information on setting up <c>boot0</c>, please consult
270<uri link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/boot.html">
271chapter 12</uri> of the FreeBSD handbook.
272</p>
273
274<p>
275When you did <c>emerge system</c>, the sources for the FreeBSD kernel got
276installed to <path>/usr/src/sys</path>. Configuring and compiling a custom
277kernel is really different from compiling Linux, so if you are not familiar with
278the process we encourage you to have a look at <uri
279link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html">
280chapter 8</uri> of the FreeBSD handbook.
281</p>
282
283<p>
284Please note that currently only the "Traditional" way of building the kernel is
285supported on Gentoo/FreeBSD! Also note that <c>make install</c> will probably
286ask you for a <path>/boot/device.hints</path> file. A default version can be
287found in the <path>conf</path> subdirectory of the <c>GENERIC</c> configuration
288and is called <path>GENERIC.hints</path>
289</p>
257 290
258</body> 291</body>
259</section> 292</section>
260</chapter> 293</chapter>
261 294
262<chapter> 295<chapter>
263<title>Developing for Gentoo/FreeBSD</title> 296<title>Developing for Gentoo/FreeBSD</title>
264<section> 297<section>
265<title>How to help </title> 298<title>How to help </title>
266<body> 299<body>
267 300
268<p> 301<p>
269There are many things you could help with, depending on your skill level and 302There are many things you could help with, depending on your skill level and
270spare time: 303spare time:
271</p> 304</p>

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

  ViewVC Help
Powered by ViewVC 1.1.20