source: BOOK/final-system/common/linux-headers.xml@ 4e7ed7a

clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 4e7ed7a was 12ce7b9, checked in by Chris Staub <chris@…>, 12 years ago

Added command explanation to linux-headers

  • Property mode set to 100644
File size: 3.7 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-system-linux-headers" role="wrap">
9 <?dbhtml filename="linux-headers.html"?>
10
11 <title>Linux-Headers-&linux-version;</title>
12
13 <indexterm zone="ch-system-linux-headers">
14 <primary sortas="a-Linux-Headers">Linux-Headers</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Linux Kernel contains a make target that installs
21 <quote>sanitized</quote> kernel headers.</para>
22
23 </sect2>
24
25 <sect2 role="installation">
26 <title>Installation of Linux-Headers</title>
27
28 <para os="a">For this step you will need the kernel tarball.</para>
29
30 <para os="b">Install the kernel header files:</para>
31
32<screen os="c"><userinput>make mrproper
33make headers_check
34make INSTALL_HDR_PATH=dest headers_install
35cp -rv dest/include/* /usr/include
36find /usr/include -name .install -or -name ..install.cmd | xargs rm -fv</userinput></screen>
37
38 <variablelist os="d">
39 <title>The meaning of the make commands:</title>
40
41 <varlistentry os="d1">
42 <term><parameter>make mrproper</parameter></term>
43 <listitem>
44 <para>Ensures that the kernel source dir is clean.</para>
45 </listitem>
46 </varlistentry>
47
48 <varlistentry os="d2">
49 <term><parameter>make headers_check</parameter></term>
50 <listitem>
51 <para>Sanitizes the raw kernel headers so that they can be used
52 by userspace programs.</para>
53 </listitem>
54 </varlistentry>
55
56 <varlistentry os="d3">
57 <term><parameter>make INSTALL_HDR_PATH=dest headers_install</parameter></term>
58 <listitem>
59 <para>Normally the headers_install target removes the entire
60 destination directory (default
61 <filename class="directory">/usr/include</filename>) before
62 installing the headers. To prevent this, we tell the kernel to
63 install the headers to a directory inside the source dir.</para>
64 </listitem>
65 </varlistentry>
66
67 <varlistentry os="d4">
68 <term><parameter>find /usr/include -name .install -or -name ..install.cmd | xargs rm -fv</parameter></term>
69 <listitem>
70 <para>Removes a number of unneeded debugging files that were installed.</para>
71 </listitem>
72 </varlistentry>
73
74 </variablelist>
75
76 </sect2>
77
78 <sect2 id="contents-linux-headers" role="content">
79 <title>Contents of Linux-Headers</title>
80
81 <segmentedlist>
82 <segtitle>Installed headers</segtitle>
83 <segtitle>Installed directories</segtitle>
84
85 <seglistitem>
86 <seg>/usr/include/{asm,asm-generic,drm,linux,mtd,rdma,scsi,sound,video,xen}/*.h</seg>
87 <seg>/usr/include/asm, /usr/include/asm-generic, /usr/include/drm,
88 /usr/include/linux, /usr/include/mtd, /usr/include/rdma,
89 /usr/include/scsi, /usr/include/sound, /usr/include/video, /usr/include/xen</seg>
90 </seglistitem>
91 </segmentedlist>
92
93 <variablelist>
94 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
95 <?dbfo list-presentation="list"?>
96 <?dbhtml list-presentation="table"?>
97
98 <varlistentry id="linux-headers">
99 <term><filename
100 class="headerfile">/usr/include/{asm,asm-generic,drm,linux,mtd,rdma,sound,video}/*.h</filename></term>
101 <listitem>
102 <para>The Linux API headers</para>
103 <indexterm zone="ch-system-linux-headers linux-headers">
104 <primary
105 sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary>
106 </indexterm>
107 </listitem>
108 </varlistentry>
109
110 </variablelist>
111
112 </sect2>
113
114</sect1>
Note: See TracBrowser for help on using the repository browser.