Gentoo Archives: gentoo-doc-cvs

From: Xavier Neys <neysx@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: gentoo-freebsd.xml
Date: Tue, 28 Mar 2006 10:30:03
Message-Id: 200603281030.k2SAUFwj026842@robin.gentoo.org
1 neysx 06/03/28 10:30:14
2
3 Modified: gentoo-freebsd.xml
4 Log:
5 Update from #127477
6
7 Revision Changes Path
8 1.15 xml/htdocs/doc/en/gentoo-freebsd.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.15&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml?rev=1.15&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-freebsd.xml.diff?r1=1.14&r2=1.15&cvsroot=gentoo
13
14 Index: gentoo-freebsd.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v
17 retrieving revision 1.14
18 retrieving revision 1.15
19 diff -u -r1.14 -r1.15
20 --- gentoo-freebsd.xml 2 Mar 2006 13:32:47 -0000 1.14
21 +++ gentoo-freebsd.xml 28 Mar 2006 10:30:14 -0000 1.15
22 @@ -1,5 +1,5 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.14 2006/03/02 13:32:47 yoswink Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-freebsd.xml,v 1.15 2006/03/28 10:30:14 neysx Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 <guide link="/doc/en/gentoo-freebsd.xml">
29 @@ -28,8 +28,8 @@
30 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
31 <license/>
32
33 -<version>2.1</version>
34 -<date>2006-03-02</date>
35 +<version>2.2</version>
36 +<date>2006-03-24</date>
37
38 <chapter>
39 <title>Introduction to FreeBSD</title>
40 @@ -43,11 +43,13 @@
41 Unix-like operating system. Back in 1993 when development of <uri
42 link="http://www.386bsd.org/">386BSD</uri> stopped, two projects were born:
43 <uri link="http://www.netbsd.org/">NetBSD</uri>, commonly known to run on a
44 -huge number of architetures, and FreeBSD which focuses mainly on the x86
45 -platform. FreeBSD is renowned for its stability, performance and security, thus
46 -being used from small to huge companies all over the world. FreeBSD's current
47 -production release version is 5.4, which is also used as the foundation for the
48 -Gentoo/FreeBSD project.
49 +huge number of architetures, and FreeBSD which supports the x86, amd64, ia64,
50 +sparc64 and alpha platforms.FreeBSD is renowned for its stability, performance
51 +and security, thus being used from small to huge companies all over the world.
52 +FreeBSD's current production release version is 6.0, which is also used as the
53 +foundation for the Gentoo/FreeBSD project. The previous 5.x branch is being
54 +continued by the FreeBSD project as a service release, but is no more worked on by
55 +the Gentoo/FreeBSD developers.
56 </p>
57
58 </body>
59 @@ -57,10 +59,10 @@
60 <body>
61
62 <p>
63 -Gentoo/FreeBSD is an effort to provide a fully-capable FreeBSD operating system
64 -with Gentoo's design sensibilities. The long-term goal of the Gentoo/BSD project
65 -is to allow users to choose any combination of *BSD or Linux kernels, *BSD or
66 -GNU libc, and *BSD or GNU userland tools.
67 +<uri link="proj/en/gentoo-alt/bsd/fbsd/">Gentoo/FreeBSD</uri> is a subproject of the
68 +<uri link="proj/en/gentoo-alt/">Gentoo/Alt project</uri>, with the goal of providing
69 +a fully-capable FreeBSD operating system featuring the design sensibilities known from
70 +Gentoo Linux, like the init system and the portage package management system.
71 </p>
72
73 </body>
74 @@ -135,13 +137,29 @@
75 an installation medium for Gentoo/FreeBSD.
76 </p>
77
78 +<note>
79 +If you are intending to use FreeSBIE for installing Gentoo/FreeBSD, please make
80 +sure to use a version based on FreeBSD 6.0! Experimental versions can be downloaded
81 +from <uri link="http://torrent.freesbie.org/">FreeSBIE's Bittorrent tracker</uri> and
82 +version 20060118 has been tested to work for the purposes described in this document.
83 +</note>
84 +
85 <p>
86 Before you can begin with the installation, you have to setup a hard disk for
87 use with Gentoo/FreeBSD. This can either be done via <c>sysinstall</c>
88 (available from a current FreeBSD installation as well as from within FreeSBIE)
89 -or by manually using the commands <c>fdisk</c>, <c>disklabel</c> and
90 -<c>newfs</c>. If you have never set up a FreeBSD system before,
91 -<c>sysinstall</c> may be the better option for you. If you face difficulties
92 +or by manually using the commands <c>fdisk</c>, <c>disklabel</c> and <c>newfs</c>.
93 +If you have never set up a FreeBSD system before, <c>sysinstall</c> may be the
94 +better option for you. In that case make sure that you don't use the sysinstall
95 +launched by FreeBSD's or FreeSBIE's installers, but use the following command instead:
96 +</p>
97 +
98 +<pre caption="Partitioning with sysinstall">
99 +# <i>sysinstall diskPartitionEditor diskPartitionWrite diskLabelEditor diskLabelCommit</i>
100 +</pre>
101 +
102 +<p>
103 +If you face difficulties
104 while partitioning or formatting your hard disks, have a look at the great
105 <uri link="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
106 Handbook</uri> or hop onto <c>#gentoo-bsd</c> on the Freenode IRC server.
107 @@ -159,6 +177,18 @@
108 </pre>
109
110 <p>
111 +If you're using the FreeSBIE LiveCD and you already had an UFS partition on
112 +your hard disk, it has already been mounted read-only to <path>/mnt/ufs.1</path>.
113 +If you want to use that location for your installation, you'll have to remount it
114 +in read-write mode:
115 +</p>
116 +
117 +<pre caption="Remounting a partition in read-write mode">
118 +# <i>ount -u -o rw /mnt/ufs.1</i>
119 +</pre>
120 +
121 +
122 +<p>
123 Now that you have mounted the target partition, it is time to fetch and unpack
124 a stage3 tarball.
125 </p>
126 @@ -166,10 +196,10 @@
127 <pre caption="Obtaining and unpacking a stage3 tarball">
128 # <i>cd /mnt/gentoo/</i>
129 <comment>(Any other Gentoo mirror which includes the experimental/ directory will also work.)</comment>
130 -# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/stage3-x86-fbsd-20051020.tar.bz2</i>
131 -# <i>tar -jxvpf stage3-x86-fbsd-20051020.tar.bz2</i>
132 +# <i>wget http://gentoo.osuosl.org/experimental/x86/freebsd/stages/gentoo-freebsd-6.0-stage-20060221.tar.bz2</i>
133 +# <i>tar -jxvpf gentoo-freebsd-6.0-stage-20060221</i>
134 <comment>(You can delete the tarball with the following command if you want to.)</comment>
135 -# <i>rm stage3-x86-fbsd-20051020.tar.bz2</i>
136 +# <i>rm gentoo-freebsd-6.0-stage-20060221</i>
137 </pre>
138
139 <p>
140 @@ -215,16 +245,21 @@
141 </p>
142
143 <pre caption="Setting up the profile and editing /etc/make.conf">
144 -# <i>ln -sf /usr/local/portage/portage-alt-overlay/profiles/default-bsd/fbsd/5.4/x86/ /etc/make.profile</i>
145 +# <i>ln -sf /usr/local/portage/portage-alt-overlay/profiles/default-bsd/fbsd/6.0/x86/ /etc/make.profile</i>
146 <comment>(FreeBSD's standard editor is ee, which is used to edit /etc/make.conf)</comment>
147 # <i>ee /etc/make.conf</i>
148 <comment>(Please make sure you add at least the following entries:)</comment>
149 -CHOST="i686-gentoo-freebsd5.4"
150 +CHOST="i686-gentoo-freebsd6.0"
151 ACCEPT_KEYWORDS="~x86-fbsd ~x86"
152 FEATURES="-sandbox collision-protect"
153 PORTDIR_OVERLAY="/usr/local/portage/portage-alt-overlay"
154 </pre>
155
156 +<note>
157 +If you're installing using an old 5.4 stage, please replace "5.4" by "6.0" when symlinking the profile and
158 +setting the CHOST variable.
159 +</note>
160 +
161 <p>
162 In order to boot correctly, you will need to create the <path>/proc</path>
163 directory.
164 @@ -279,9 +314,16 @@
165 supported on Gentoo/FreeBSD! Also note that <c>make install</c> will probably
166 ask you for a <path>/boot/device.hints</path> file. A default version can be
167 found in the <path>conf</path> subdirectory of the <c>GENERIC</c> configuration
168 -and is called <path>GENERIC.hints</path>
169 +and is called <path>GENERIC.hints</path>.
170 </p>
171
172 +<note>
173 +When building a kernel, you should use the command "make WERROR=NO_WERROR"
174 +because the Gentoo/FreeBSD developers have not yet been able to patch out all
175 +occurences of -Werror and the currently used GCC doesn't accept FreeBSD's
176 +extensions to the printf() funktion.
177 +</note>
178 +
179 <p>
180 Now is the time to do some basic system configuration and settings. First, we
181 are going to setup the filesystem mounting points in <path>/etc/fstab</path>.
182 @@ -353,7 +395,7 @@
183 <comment>(Leave the chroot environment)</comment>
184 # <i>exit</i>
185 <comment>(Issued from outside the chroot)</comment>
186 -# <i>fdisk -b -B /mnt/gentoo/boot/boot0 /dev/adX</i>
187 +# <i>fdisk -B -b /mnt/gentoo/boot/boot0 /dev/adX</i>
188 # <i>chroot /mnt/gentoo /bin/bash</i>
189 # <i>disklabel -B adXsY</i>
190 </pre>
191 @@ -403,10 +445,6 @@
192
193 <ul>
194 <li>
195 - We need GCC and binutils hackers who are able to port FreeBSD's patches to
196 - the original versions of these tools provided by our main Portage tree.
197 - </li>
198 - <li>
199 Working on current ebuilds: this means working closely with ebuild
200 maintainers in order to create patches or modify ebuilds in a way that can
201 be accepted into the main tree.
202 @@ -436,63 +474,7 @@
203
204 </body>
205 </section>
206 -<section>
207 -<title>Building the system and dealing with issues</title>
208 -<body>
209 -
210 -<p>
211 -Although Linux and FreeBSD both are Unix-like operating systems, there are some
212 -important differences you have to know about if you want to contribute to our
213 -development effort:
214 -</p>
215
216 -<ul>
217 - <li>
218 - FreeBSD doesn't use the GNU autotools (autoconf, automake, autoheader).
219 - Instead, it uses its own implementation of <c>make</c>, putting
220 - configuration options in external files and some .mk files that are
221 - included with each Makefile. Although a lot of work has been put into
222 - those .mk files, it is not hard to find some installations failing due to
223 - a missing <c>${INSTALL}&nbsp;-d</c> somewhere. The easy way to deal with
224 - this kind of problem is to read the Makefile to find the accompanying .mk
225 - file, then open that file and try to figure out which part failed (this is
226 - not really hard once you figure out where in the installation process it
227 - stopped).
228 - </li>
229 - <li>
230 - Besides, due to the fact that FreeBSD is a complete operating system, you
231 - won't find things like a FreeBSD kernel tarball for download on a web site.
232 - The system is meant to be concise, thus whenever you start making an ebuild
233 - for something that uses system sources, you are very likely to run into
234 - problems when it tries to access non-existent files or directories. This
235 - generally occurs when a Makefile points to <path>${.CURDIR}/../sys</path>,
236 - or when a Makefile has a source dependency on another system package. There
237 - is no default rule on dealing with such issues, but generally one of the
238 - following procedures helps:
239 - <ul>
240 - <li>
241 - If the ebuild is trying to access kernel sources, patch it to point to
242 - <path>/usr/src/sys</path>
243 - </li>
244 - <li>
245 - If it's trying to access some other source that is provided by the
246 - system, it's easier to add it to <c>$SRC_URI</c> and unpack it to
247 - <c>$WORKDIR</c>
248 - </li>
249 - </ul>
250 - </li>
251 - <li>
252 - In order to maintain a concise buildsystem, we have several tarballs which
253 - are grouped by their functionality. This means that system libraries can be
254 - found in the freebsd-lib tarball, which contains the sources you would
255 - usually find in /usr/src/lib. On the other hand, freebsd-usrsbin contains
256 - <path>/usr/sbin/*</path> tools and consists of sources from
257 - <path>/usr/src/usr.sbin</path>.
258 - </li>
259 -</ul>
260 -
261 -</body>
262 -</section>
263 <section>
264 <title>Known issues</title>
265 <body>
266 @@ -510,6 +492,11 @@
267 remember to use the "Gentoo BSD" product for your submission.
268 </li>
269 <li>glib and gnome in general need a lot of fixes to be backported.</li>
270 + <li>
271 + The init system currently provided by Gentoo/FreeBSD's baselayout package is
272 + not the same version used by Gentoo Linux and lacks some of its features. Work
273 + on making newer versions working is underway.
274 + </li>
275 </ul>
276
277 </body>
278
279
280
281 --
282 gentoo-doc-cvs@g.o mailing list