/[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.6 Revision 1.7
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.6 2005/09/21 19:16:21 jkt Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.7 2005/10/06 15:58:16 jkt 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
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.4</version> 31<version>1.5</version>
32<date>2005-09-21</date> 32<date>2005-10-06</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>
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-20051005.tar.bz2</i>
169# <i>cp stage3-x86-fbsd-20050811.tar.bz2 /mnt/gfbsd/</i> 169# <i>cp stage3-x86-fbsd-20051005.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-20051005.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-20051005.tar.bz2</i>
174<comment>(Create a home directory for root.)</comment> 174<comment>(Create a home directory for root.)</comment>
175# <i>mkdir /mnt/gfbsd/root</i> 175# <i>mkdir /mnt/gfbsd/root</i>
176</pre> 176</pre>
177 177
178<p> 178<p>
179Before chrooting into the newly-extracted stage, you first must obtain a copy of 179Before chrooting into the newly-extracted stage, you first must obtain an up-to-date
180the Gentoo/FreeBSD overlay. If you are not a Gentoo developer, you can get it 180copy of the Gentoo/FreeBSD overlay. The easiest way to achieve this is to to get our latest
181from the mirror provided by <mail link="carpaski@gentoo.org">Nick Jones</mail>. 181snapshot which you than extract to <path>/usr/local/portage</path>.
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> 182</p>
186 183
187<pre caption="Getting the Gentoo/FreeBSD portage overlay"> 184<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> 185# <i>cd /usr/local/portage</i>
186# <i>wget http://gentoo.osuosl.org/experimental/snapshots/portage-alt-overlay-latest.tar.bz2</i>
187# <i>tar -xjf portage-alt-overlay-latest.tar.bz2</i>
188</pre>
189
190<p>
191Alternatively, you can also use Subversion to check out the current version of the overlay.
192If you are interested in this possibility, please refer to the <uri
193link="http://www.gentoo.org/proj/en/gentoo-alt/overlay.xml">Gentoo/ALT overlay
194documentation</uri>.
189</pre> 195</p>
190 196
191<p> 197<p>
192In order for your install to work, you need to mount the <path>/dev</path> 198In order for your install to work, you need to mount the <path>/dev</path>
193filesystem from the currently running system into the Gentoo/FreeBSD mount 199filesystem from the currently running system into the Gentoo/FreeBSD mount
194point before proceeding with the chroot. 200point before proceeding with the chroot.
195</p> 201</p>
196 202
197<pre caption="Mounting the /dev filesystem and chrooting"> 203<pre caption="Mounting the /dev filesystem and chrooting">
198# <i>mount -t devfs none /mnt/gfbsd/dev/</i> 204# <i>mount -t devfs none /mnt/gfbsd/dev/</i>
199# <i>chroot /mnt/gfbsd/ /bin/bash</i> 205# <i>chroot /mnt/gfbsd/ /bin/bash</i>
206# <i>source /etc/profile</i>
200</pre> 207</pre>
201 208
202<p> 209<p>
203After you got hold of the Gentoo/FreeBSD overlay, it's time to link 210After you got hold of the Gentoo/FreeBSD overlay, it's time to link
204<path>/etc/make.profile</path> to the correct profile and add get your 211<path>/etc/make.profile</path> to the correct profile and add get your
205<path>/etc/make.conf</path> ready for Gentoo/FreeBSD. 212<path>/etc/make.conf</path> ready for Gentoo/FreeBSD.
206</p> 213</p>
207 214
208<pre caption="Setting up the profile and editing /etc/make.conf"> 215<pre caption="Setting up the profile and editing /etc/make.conf">
209# <i>ln -sf /usr/local/portage/gentoo-freebsd/profiles/default-bsd/fbsd/5.4/x86/ /etc/make.profile</i> 216# <i>ln -sf /usr/local/portage/portage-alt-overlay/profiles/default-bsd/fbsd/5.4/x86/ /etc/make.profile</i>
210<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment> 217<comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment>
211# <i>ee /etc/make.conf</i> 218# <i>ee /etc/make.conf</i>
212<comment>(Please make sure you add at least the following entries:)</comment> 219<comment>(Please make sure you add at least the following entries:)</comment>
213CHOST="i686-gentoo-freebsd5.4" 220CHOST="i686-gentoo-freebsd5.4"
214ACCEPT_KEYWORDS="~x86-fbsd ~x86" 221ACCEPT_KEYWORDS="~x86-fbsd ~x86"
215FEATURES="-sandbox collision-protect" 222FEATURES="-sandbox collision-protect"
216PORTDIR_OVERLAY="/usr/local/portage/gentoo-freebsd" 223PORTDIR_OVERLAY="/usr/local/portage/portage-alt-overlay"
217</pre> 224</pre>
218 225
219<p> 226<p>
220Now, you have to obtain a copy of the main Gentoo Portage tree, which depending 227Now, you have to obtain a copy of the main Gentoo Portage tree, which depending
221on your connection might take quite a while. 228on your connection might take quite a while.
222</p> 229</p>
223 230
224<pre caption="Obtaining the portage tree"> 231<pre caption="Obtaining the portage tree">
225# <i>emerge --sync</i> 232# <i>emerge --sync</i>
226</pre> 233</pre>
227
228<p>
229After you have synchronised your Portage tree, you only have to take a few last
230steps before your Gentoo/FreeBSD system is ready to use.
231</p>
232
233<pre caption="Final configuration">
234<comment>(Prevent crt1.o from getting removed by emerging gcc.)</comment>
235# <i>chflags schg /usr/lib/crt1.o</i>
236<comment>(Update the binutils installed by the stage3 tarball.)</comment>
237# <i>emerge -u binutils</i>
238<comment>(Select the correct gcc.)</comment>
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>
243<comment>(Re-emerge python, portage and py-freebsd.)</comment>
244# <i>emerge --nodeps python portage py-freebsd</i>
245</pre>
246
247<note>
248After gcc-config you will notice a message about GCC-SPECS which you can safely
249ignore.
250</note>
251 234
252<p> 235<p>
253Congratulations, by the time you have reached this step you should have a 236Congratulations, by the time you have reached this step you should have a
254running Gentoo/FreeBSD system! If you want, you can now rebuild the system's 237running Gentoo/FreeBSD system! If you want, you can now rebuild the system's
255core packages. 238core packages.
420 Some init scripts depend on the clock service which we don't provide right 403 Some init scripts depend on the clock service which we don't provide right
421 now. You can just remove it from the dependencies of the script and report 404 now. You can just remove it from the dependencies of the script and report
422 that on our <uri link="http://bugs.gentoo.org/">bugzilla</uri>. Please 405 that on our <uri link="http://bugs.gentoo.org/">bugzilla</uri>. Please
423 remember to use the "Gentoo BSD" product for your submission. 406 remember to use the "Gentoo BSD" product for your submission.
424 </li> 407 </li>
425 <li>
426 Some ebuilds have hardcoded -ldl flags to link against libdl to get
427 <c>dlopen()</c>. This needs to be fixed (for further information, please
428 consult our <uri link="/proj/en/gentoo-alt/bsd/maintnotes.xml#doc_chap3">
429 our Gentoo/*BSD Technotes Guide</uri>.
430 </li>
431 <li>glib and gnome in general need a lot of fixes to be backported.</li> 408 <li>glib and gnome in general need a lot of fixes to be backported.</li>
432</ul> 409</ul>
433 410
434</body> 411</body>
435</section> 412</section>

Legend:
Removed from v.1.6  
changed lines
  Added in v.1.7

  ViewVC Help
Powered by ViewVC 1.1.20