source: chapter05/linux-headers.xml@ 04ab8f1

11.2
Last change on this file since 04ab8f1 was 04ab8f1, checked in by Pierre Labastie <pierre.labastie@…>, 5 months ago

Remove all non header files in linux headers

Report by Joe Locash that a perl script was left in /usr/include
with our current instructions

  • Property mode set to 100644
File size: 7.4 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-tools-linux-headers" role="wrap">
9 <?dbhtml filename="linux-headers.html"?>
10
11 <sect1info condition="script">
12 <productname>linux-headers</productname>
13 <productnumber>&linux-version;</productnumber>
14 <address>&linux-url;</address>
15 </sect1info>
16
17 <title>Linux-&linux-version; API Headers</title>
18
19 <indexterm zone="ch-tools-linux-headers">
20 <primary sortas="a-Linux">Linux</primary>
21 <secondary>tools, API headers</secondary>
22 </indexterm>
23
24 <sect2 role="package">
25 <title/>
26
27 <para>The Linux API Headers (in linux-&linux-version;.tar.xz) expose the
28 kernel's API for use by Glibc.</para>
29
30 <segmentedlist>
31 <segtitle>&buildtime;</segtitle>
32 <segtitle>&diskspace;</segtitle>
33
34 <seglistitem>
35 <seg>&linux-headers-tmp-sbu;</seg>
36 <seg>&linux-headers-tmp-du;</seg>
37 </seglistitem>
38 </segmentedlist>
39
40 </sect2>
41
42 <sect2 role="installation">
43 <title>Installation of Linux API Headers</title>
44
45 <para>The Linux kernel needs to expose an Application Programming Interface
46 (API) for the system's C library (Glibc in LFS) to use. This is done
47 by way of sanitizing various C header files that are shipped in the Linux
48 kernel source tarball.</para>
49
50 <para>Make sure there are no stale files embedded in the package:</para>
51
52<screen><userinput remap="pre">make mrproper</userinput></screen>
53
54 <para>Now extract the user-visible kernel headers from the source.
55 The recommended make target <quote>headers_install</quote> cannot be
56 used, because it requires <application>rsync</application>, which may not
57 be available. The headers are first placed in
58 <filename class="directory">./usr</filename>, then copied to the needed
59 location.</para>
60
61<screen><userinput remap="make">make headers
62find usr/include -type f ! -name '*.h' -delete
63</userinput><userinput remap="install">cp -rv usr/include $LFS/usr</userinput></screen>
64
65 </sect2>
66
67 <sect2 id="contents-linux-headers" role="content">
68 <title>Contents of Linux API Headers</title>
69
70 <segmentedlist>
71 <segtitle>Installed headers</segtitle>
72 <segtitle>Installed directories</segtitle>
73
74 <seglistitem>
75 <seg>/usr/include/asm/*.h, /usr/include/asm-generic/*.h,
76 /usr/include/drm/*.h, /usr/include/linux/*.h, /usr/include/misc/*.h,
77 /usr/include/mtd/*.h, /usr/include/rdma/*.h, /usr/include/scsi/*.h,
78 /usr/include/sound/*.h, /usr/include/video/*.h,
79 and /usr/include/xen/*.h</seg>
80 <seg>/usr/include/asm, /usr/include/asm-generic, /usr/include/drm,
81 /usr/include/linux, /usr/include/misc, /usr/include/mtd,
82 /usr/include/rdma, /usr/include/scsi, /usr/include/sound,
83 /usr/include/video, and /usr/include/xen</seg>
84 </seglistitem>
85 </segmentedlist>
86
87 <variablelist>
88 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
89 <?dbfo list-presentation="list"?>
90 <?dbhtml list-presentation="table"?>
91
92 <varlistentry id="asm">
93 <term><filename class="headerfile">/usr/include/asm/*.h</filename></term>
94 <listitem>
95 <para>The Linux API ASM Headers</para>
96 <indexterm zone="ch-tools-linux-headers asm">
97 <primary sortas="e-/usr/include/asm/*.h">/usr/include/asm/*.h</primary>
98 </indexterm>
99 </listitem>
100 </varlistentry>
101
102 <varlistentry id="asm-generic">
103 <term><filename class="headerfile">/usr/include/asm-generic/*.h</filename></term>
104 <listitem>
105 <para>The Linux API ASM Generic Headers</para>
106 <indexterm zone="ch-tools-linux-headers asm-generic">
107 <primary sortas="e-/usr/include/asm-generic/*.h">/usr/include/asm-generic/*.h</primary>
108 </indexterm>
109 </listitem>
110 </varlistentry>
111
112 <varlistentry id="drm">
113 <term><filename class="headerfile">/usr/include/drm/*.h</filename></term>
114 <listitem>
115 <para>The Linux API DRM Headers</para>
116 <indexterm zone="ch-tools-linux-headers drm">
117 <primary sortas="e-/usr/include/drm/*.h">/usr/include/drm/*.h</primary>
118 </indexterm>
119 </listitem>
120 </varlistentry>
121
122 <varlistentry id="linux">
123 <term><filename class="headerfile">/usr/include/linux/*.h</filename></term>
124 <listitem>
125 <para>The Linux API Linux Headers</para>
126 <indexterm zone="ch-tools-linux-headers linux">
127 <primary sortas="e-/usr/include/linux/*.h">/usr/include/linux/*.h</primary>
128 </indexterm>
129 </listitem>
130 </varlistentry>
131
132 <varlistentry id="misc">
133 <term><filename class="headerfile">/usr/include/misc/*.h</filename></term>
134 <listitem>
135 <para>The Linux API Miscellaneous Headers</para>
136 <indexterm zone="ch-tools-linux-headers misc">
137 <primary sortas="e-/usr/include/misc/*.h">/usr/include/misc/*.h</primary>
138 </indexterm>
139 </listitem>
140 </varlistentry>
141
142 <varlistentry id="mtd">
143 <term><filename class="headerfile">/usr/include/mtd/*.h</filename></term>
144 <listitem>
145 <para>The Linux API MTD Headers</para>
146 <indexterm zone="ch-tools-linux-headers mtd">
147 <primary sortas="e-/usr/include/mtd/*.h">/usr/include/mtd/*.h</primary>
148 </indexterm>
149 </listitem>
150 </varlistentry>
151
152 <varlistentry id="rdma">
153 <term><filename class="headerfile">/usr/include/rdma/*.h</filename></term>
154 <listitem>
155 <para>The Linux API RDMA Headers</para>
156 <indexterm zone="ch-tools-linux-headers rdma">
157 <primary sortas="e-/usr/include/rdma/*.h">/usr/include/rdma/*.h</primary>
158 </indexterm>
159 </listitem>
160 </varlistentry>
161
162 <varlistentry id="scsi">
163 <term><filename class="headerfile">/usr/include/scsi/*.h</filename></term>
164 <listitem>
165 <para>The Linux API SCSI Headers</para>
166 <indexterm zone="ch-tools-linux-headers scsi">
167 <primary sortas="e-/usr/include/scsi/*.h">/usr/include/scsi/*.h</primary>
168 </indexterm>
169 </listitem>
170 </varlistentry>
171
172 <varlistentry id="sound">
173 <term><filename class="headerfile">/usr/include/sound/*.h</filename></term>
174 <listitem>
175 <para>The Linux API Sound Headers</para>
176 <indexterm zone="ch-tools-linux-headers sound">
177 <primary sortas="e-/usr/include/sound/*.h">/usr/include/sound/*.h</primary>
178 </indexterm>
179 </listitem>
180 </varlistentry>
181
182 <varlistentry id="video">
183 <term><filename class="headerfile">/usr/include/video/*.h</filename></term>
184 <listitem>
185 <para>The Linux API Video Headers</para>
186 <indexterm zone="ch-tools-linux-headers video">
187 <primary sortas="e-/usr/include/video/*.h">/usr/include/video/*.h</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
191
192 <varlistentry id="xen">
193 <term><filename class="headerfile">/usr/include/xen/*.h</filename></term>
194 <listitem>
195 <para>The Linux API Xen Headers</para>
196 <indexterm zone="ch-tools-linux-headers xen">
197 <primary sortas="e-/usr/include/xen/*.h">/usr/include/xen/*.h</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 </variablelist>
203
204 </sect2>
205
206</sect1>
Note: See TracBrowser for help on using the repository browser.