source: BOOK/boot/x86/kernel.xml @ fe5e5a6

clfs-3.0.0-systemdsystemd
Last change on this file since fe5e5a6 was fe5e5a6, checked in by Chris Staub <chris@…>, 10 years ago

Added config flags to kernel pages

  • Property mode set to 100644
File size: 5.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-boot-kernel" role="wrap">
9  <?dbhtml filename="kernel.html"?>
10
11  <title>Linux-&linux-version2;</title>
12
13  <indexterm zone="ch-boot-kernel">
14    <primary sortas="a-Linux">Linux</primary>
15    <secondary>boot</secondary>
16  </indexterm>
17
18  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
19  href="../../bootable/x86/kernel.xml"
20  xpointer="xpointer(//*[@role='package'])"/>
21
22  <sect2 role="installation">
23    <title>Installation of the kernel</title>
24
25    <warning os="aa">
26      <para>Here a temporary cross-compiled kernel will be built. When
27      configuring it, select the minimal amount of options required to
28      boot the target machine and build the final system. I.e., no support
29      for sound, printers, etc. will be needed.</para>
30
31      <para>Also, try to avoid the use of modules if possible, and don't
32      use the resulting kernel image for production systems.</para>
33    </warning>
34
35    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
36    href="../../bootable/x86/kernel.xml"
37    xpointer="xpointer(//*[@os='a'])"/>
38
39    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
40    href="../../bootable/x86/kernel.xml"
41    xpointer="xpointer(//*[@os='p1'])"/>
42
43    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
44    href="../../bootable/x86/kernel.xml"
45    xpointer="xpointer(//*[@os='p2'])"/>
46
47    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
48    href="../../bootable/x86/kernel.xml"
49    xpointer="xpointer(//*[@os='b'])"/>
50
51    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
52    href="../../bootable/x86/kernel.xml"
53    xpointer="xpointer(//*[@os='c'])"/>
54
55    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
56    href="../../bootable/x86/kernel.xml"
57    xpointer="xpointer(//*[@os='d'])"/>
58
59    <note os="kc"><para>A good starting place for setting up the kernel
60    configuration is to run <command>make defconfig</command>. This will set the    base configuration to a good state that takes your current system
61    architecture into account.</para>
62
63    <para>Be sure to enable or disable following features or the system might
64    not work correctly or boot at all:</para>
65
66    <screen role="nodump">Device Drivers  ---&gt;
67  Generic Driver Options  ---&gt;
68    ()  path to uevent helper (CONFIG_UEVENT_HELPER_PATH)
69    [*] Maintain a devtmpfs filesystem to mount at /dev (CONFIG_DEVTMPFS)
70    [ ] Fallback user-helper invocation for firmware loading (CONFIG_FW_LOADER_USER_HELPER)</screen></note>
71
72    <para os="ae">Configure the kernel via a menu-driven interface:</para>
73
74<screen><userinput>make ARCH=i386 CROSS_COMPILE=${CLFS_TARGET}- menuconfig</userinput></screen>
75
76    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
77    href="../../bootable/x86/kernel.xml"
78    xpointer="xpointer(//*[@os='m'])"/>
79
80<screen><userinput>make ARCH=i386 CROSS_COMPILE=${CLFS_TARGET}-</userinput></screen>
81
82    <para os="af">If the use of kernel modules can't be avoided, an
83    <filename>/etc/modprobe.conf</filename> file may be needed.
84    Information pertaining to modules and kernel configuration is
85    located in the kernel documentation in the <filename
86    class="directory">Documentation</filename> directory of the kernel
87    sources tree. The <filename>modprobe.conf</filename> man page may also
88    be of interest.</para>
89
90    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
91    href="../../bootable/x86/kernel.xml"
92    xpointer="xpointer(//*[@os='s'])"/>
93
94<screen><userinput>make ARCH=i386 CROSS_COMPILE=${CLFS_TARGET}- \
95    INSTALL_MOD_PATH=/tools modules_install</userinput></screen>
96
97    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
98    href="../../bootable/x86/kernel.xml"
99    xpointer="xpointer(//*[@os='s2'])"/>
100
101<screen><userinput>make ARCH=i386 CROSS_COMPILE=${CLFS_TARGET}- \
102    INSTALL_MOD_PATH=/tools firmware_install</userinput></screen>
103
104    <para os="u">After kernel compilation is complete, additional steps are
105    required to complete the installation. Some files need to be copied to
106    the <filename class="directory">/tools/boot</filename> directory.</para>
107
108    <para os="v">Issue the following commands to install the kernel:</para>
109
110<screen><userinput>mkdir -pv /tools/boot
111cp -v arch/i386/boot/bzImage /tools/boot/vmlinuz-clfs-&linux-version2;</userinput></screen>
112
113    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
114    href="../../bootable/x86/kernel.xml"
115    xpointer="xpointer(//*[@os='w'])"/>
116
117<screen os="w1"><userinput>cp -v System.map /tools/boot/System.map-&linux-version2;</userinput></screen>
118
119    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
120    href="../../bootable/x86/kernel.xml"
121    xpointer="xpointer(//*[@os='x'])"/>
122
123<screen os="x1"><userinput>cp -v .config /tools/boot/config-&linux-version2;</userinput></screen>
124
125  </sect2>
126
127  <sect2 role="content">
128    <title/>
129
130    <para>Details on this package are located in <xref
131    linkend="contents-kernel" role="."/></para>
132
133  </sect2>
134
135</sect1>
Note: See TracBrowser for help on using the repository browser.