1 |
plasmaroo 05/07/25 20:28:53 |
2 |
|
3 |
Modified: xml/htdocs/doc/en genkernel.xml |
4 |
Log: |
5 |
Update to 3.3; remove a few of the internal options that shouldn't be touched by users as they are reserved for internal catalyst usage. |
6 |
|
7 |
Revision Changes Path |
8 |
1.18 +78 -85 xml/htdocs/doc/en/genkernel.xml |
9 |
|
10 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/genkernel.xml?rev=1.18&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
11 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/genkernel.xml?rev=1.18&content-type=text/plain&cvsroot=gentoo |
12 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/genkernel.xml.diff?r1=1.17&r2=1.18&cvsroot=gentoo |
13 |
|
14 |
Index: genkernel.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v |
17 |
retrieving revision 1.17 |
18 |
retrieving revision 1.18 |
19 |
diff -u -r1.17 -r1.18 |
20 |
--- genkernel.xml 24 Jul 2005 16:51:15 -0000 1.17 |
21 |
+++ genkernel.xml 25 Jul 2005 20:28:53 -0000 1.18 |
22 |
@@ -1,5 +1,5 @@ |
23 |
<?xml version='1.0' encoding="UTF-8"?> |
24 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.17 2005/07/24 16:51:15 plasmaroo Exp $ --> |
25 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.18 2005/07/25 20:28:53 plasmaroo Exp $ --> |
26 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
27 |
|
28 |
<guide link="/doc/en/genkernel.xml"> |
29 |
@@ -26,8 +26,8 @@ |
30 |
|
31 |
<license/> |
32 |
|
33 |
-<version>1.2</version> |
34 |
-<date>2005-07-24</date> |
35 |
+<version>1.3</version> |
36 |
+<date>July 24, 2005</date> |
37 |
|
38 |
<chapter> |
39 |
<title>Introduction</title> |
40 |
@@ -244,22 +244,18 @@ |
41 |
</ul> |
42 |
|
43 |
<ul> |
44 |
- <li> |
45 |
- <b>--callback="<c>echo hello</c>"</b>: Calls the specified arguments |
46 |
- (<c>echo hello</c>, in this case) after the kernel and the relevant modules |
47 |
- have been built, but before building the initrd image. This may be useful |
48 |
- if you want to install external modules in the initrd image by emerging the |
49 |
- relevant item using the callback feature, and then redefining a genkernel |
50 |
- module group. |
51 |
- </li> |
52 |
+ <li> |
53 |
+ <b>--callback="<c>echo hello</c>"</b>: Calls the specified arguments |
54 |
+ (<c>echo hello</c>, in this case) after the kernel and the relevant |
55 |
+ modules have been built, but before building the initrd image. This may |
56 |
+ be useful if you want to install external modules in the initrd image by |
57 |
+ emerging the relevant item(s) with the callback feature, and then |
58 |
+ redefining a genkernel module group. |
59 |
+ </li> |
60 |
</ul> |
61 |
|
62 |
<ul> |
63 |
<li> |
64 |
- <b>--udev</b>: Activates support for the userspace device file system |
65 |
- (udev) in the initrd image. |
66 |
- </li> |
67 |
- <li> |
68 |
<b>--<c>no-</c>install</b>: Activates <e>[or deactivates]</e> the |
69 |
<c>make install</c> command, which installs your new kernel image, |
70 |
configuration file, initrd image and system map onto your mounted boot |
71 |
@@ -390,42 +386,64 @@ |
72 |
</p> |
73 |
|
74 |
<ul> |
75 |
- <li> |
76 |
- <b>--<c>no-</c>bootsplash</b>: Activates <e>[or deactivates]</e> |
77 |
- bootsplash support in the genkernel-built initrd image. The bootsplash |
78 |
- feature is supported on a limited number of architectures, and a kernel |
79 |
- that supports bootsplash is also required. Bootsplash is only supported |
80 |
- on 2.4 series kernels. |
81 |
- </li> |
82 |
- <li> |
83 |
- <b>--<c>no-</c>gensplash</b>: Activates <e>[or deactivates]</e> |
84 |
- gensplash support in the genkernel-built initrd image. The gensplash |
85 |
- utility is intended to be a replacement for bootsplash, and is designed for |
86 |
- use with 2.6.x series kernels. |
87 |
- </li> |
88 |
- <li> |
89 |
- <b>--do-keymap-auto</b>: Specifies which keymap to use during the boot |
90 |
- sequence. |
91 |
- </li> |
92 |
- <li> |
93 |
- <b>--lvm2</b>: Includes support for storage using via Logical Volume |
94 |
- Management (LVM2) from static binaries, if available to the system. |
95 |
- Relevant (static) LVM2 binaries are compiled if they are unavailable. |
96 |
- Be sure to install the lvm2 package on your system with <c>emerge |
97 |
- lvm2</c> before enabling this flag, and review the <uri |
98 |
+ <li> |
99 |
+ <b>--<c>no-</c>bootsplash</b>: Activates <e>[or deactivates]</e> support |
100 |
+ for <uri link="http://www.bootsplash.org/">bootsplash</uri> in the |
101 |
+ genkernel-built initrd image. The bootsplash feature is supported on a |
102 |
+ limited number of architectures, and a kernel that supports bootsplash |
103 |
+ is also required. |
104 |
+ </li> |
105 |
+ <li> |
106 |
+ <b>--<c>no-</c>gensplash</b>: Activates <e>[or deactivates]</e> support |
107 |
+ for <uri link="http://dev.gentoo.org/~spock/projects/gensplash/">gensplash</uri> |
108 |
+ support in the genkernel-built initrd image. The gensplash utility is |
109 |
+ intended to be a replacement for bootsplash, and is designed for use with |
110 |
+ 2.6.x series kernels. To override the default theme used by gensplash, |
111 |
+ use <b>--gensplash=<c>PreferredTheme</c></b> (where <c>PreferredTheme</c> |
112 |
+ is the title of one of the directories inside the |
113 |
+ <path>/etc/splash/</path> directory. |
114 |
+ </li> |
115 |
+ <li> |
116 |
+ <b>--gensplash-res=<c>PreferredResolution</c></b>: This flag allows you |
117 |
+ to select which splash screen resolutions will be supported in the initrd |
118 |
+ during the start-up of the system. This is useful for two reasons: First, |
119 |
+ you are able to select only the splash screen resolution(s) relevant to |
120 |
+ your system. Second, you avoid the unnecessary increase in the disk space |
121 |
+ required by initrd (since the initrd does not have to support resolutions |
122 |
+ that are irrelevant for your system configuration.) However, you may want |
123 |
+ to omit this flag if the kernel is being compiled for an Installation CD; |
124 |
+ this allows gensplash support for all possible resolutions. |
125 |
+ </li> |
126 |
+ <li> |
127 |
+ <b>--do-keymap-auto</b>: Force keymap selection during the boot |
128 |
+ sequence. |
129 |
+ </li> |
130 |
+ <li> |
131 |
+ <b>--lvm2</b>: Includes support for storage using via <uri |
132 |
+ link="http://sources.redhat.com/lvm2/">Logical Volume Management</uri> |
133 |
+ (LVM2) from <e>static</e> binaries, if available to the system. Relevant |
134 |
+ (static) LVM2 binaries are compiled if they are unavailable. Be sure to |
135 |
+ install the lvm2 package on your system with <c>emerge lvm2</c> before |
136 |
+ enabling this flag, and review the <uri |
137 |
link="http://www.gentoo.org/doc/en/lvm2.xml">Gentoo LVM2 |
138 |
Installation</uri> guide. |
139 |
</li> |
140 |
<li> |
141 |
- <b>--evms2</b>: Includes support for storage using the Enterprise Volume |
142 |
- Management System (EVMS/EVMS2), if available. Be sure to install the evms |
143 |
- package on your system with <c>emerge evms</c> before using this flag. |
144 |
+ <b>--evms2</b>: Includes support for storage using the <uri |
145 |
+ link="http://evms.sourceforge.net/">Enterprise Volume Management |
146 |
+ System</uri> (EVMS2), if available. Be sure to install the evms package |
147 |
+ on your system with <c>USE=static emerge evms2</c> before using this |
148 |
+ (genkernel) flag. <e>(Omitting the </e><c>USE=static</c> <e>flag during |
149 |
+ package installation will fail to include the necessary static binaries.) |
150 |
+ </e> |
151 |
</li> |
152 |
<li> |
153 |
- <b>--dmraid</b>: Includes support for the DMRAID, the utility which |
154 |
- creates RAID mappings using the kernel device-mapper subsystem. DMRAID |
155 |
- discovers, activates, deactivates and displays properties of software |
156 |
- RAID sets (ATARAID, for example) and contained DOS partitions. |
157 |
+ <b>--dmraid</b>: Includes support for <uri |
158 |
+ link="http://people.redhat.com/~heinzm/sw/dmraid/readme">DMRAID</uri>; |
159 |
+ the utility which creates RAID mappings using the kernel device-mapper |
160 |
+ subsystem. DMRAID discovers, activates, deactivates and displays |
161 |
+ properties of software RAID sets (ATARAID, for example) and contained |
162 |
+ DOS partitions. |
163 |
</li> |
164 |
<li> |
165 |
<b>--linuxrc=/path/to/your/linuxrc</b>: Specifies a user-created |
166 |
@@ -443,6 +461,11 @@ |
167 |
<b>--tempdir=/path/to/new/tempdir/</b>: Specifies the location of the |
168 |
temporary directory used by genkernel while compiling the kernel. |
169 |
</li> |
170 |
+ <li> |
171 |
+ <b>--unionfs</b>: Includes support for the <uri |
172 |
+ link="http://www.fsl.cs.sunysb.edu/project-unionfs.html">Unification File |
173 |
+ System</uri> in the initrd image. |
174 |
+ </li> |
175 |
</ul> |
176 |
|
177 |
</body> |
178 |
@@ -465,40 +488,10 @@ |
179 |
partition on a file system (if needed). |
180 |
</li> |
181 |
<li> |
182 |
- <b>--arch-override=<c>someArch</c></b>: Overrides the architecture |
183 |
- genkernel assumes for the kernel compilation process. This flag is useful |
184 |
- if the auto-detection mechanism fails (please file a bug if it does!) or |
185 |
- if you wish to cross-compile a kernel. The list of supported |
186 |
- architectures is available in the <path>/usr/share/genkernel/</path> |
187 |
- directory. |
188 |
- </li> |
189 |
-</ul> |
190 |
- |
191 |
-<ul> |
192 |
- <li> |
193 |
- <b>--busybox-config=<path>/path/to/busybox-config</path></b>: Overrides |
194 |
- the default Busybox configuration with the specified file. |
195 |
- </li> |
196 |
- <li> |
197 |
- <b>--busybox-bin=<path>/path/to/busybox-binary.tar.bz2</path></b>: Using |
198 |
- this option means that a (static) Busybox binary will not be compiled; |
199 |
- the specified tarball would be used instead. |
200 |
- </li> |
201 |
-</ul> |
202 |
- |
203 |
-<ul> |
204 |
- <li> |
205 |
- <b>--maxkernpackage=<path>/output/to/yourkernel.tar.bz2</path></b>: |
206 |
- Creates a package that includes the kernel, the initrd image, the |
207 |
- kernel's modules (located in <path>/lib/modules/</path>) and |
208 |
- configuration file. |
209 |
- </li> |
210 |
- <li> |
211 |
- <b>--minkernpackage=<path>/output/to/yourkernel.tar.bz2</path></b>: |
212 |
- Creates a package that includes the kernel, and initrd image. The |
213 |
|
214 |
|
215 |
|
216 |
-- |
217 |
gentoo-doc-cvs@g.o mailing list |