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} -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 |