aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/linux-headers.xml
diff options
context:
space:
mode:
authorPierre Labastie <pieere@linuxfromscratch.org>2020-05-03 21:02:51 +0000
committerPierre Labastie <pieere@linuxfromscratch.org>2020-05-03 21:02:51 +0000
commitefcb3933433838b71f3a4a53ec1ac6d899aaec0b (patch)
treef0b1fb24d5ac7ebb93cc2deddefbc16938ea49d0 /chapter06/linux-headers.xml
parent9d719e24c33f9a2ecf8a5582cd811c43a8fa46c2 (diff)
Make the new book
git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/cross-chap5@11831 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter06/linux-headers.xml')
-rw-r--r--chapter06/linux-headers.xml209
1 files changed, 0 insertions, 209 deletions
diff --git a/chapter06/linux-headers.xml b/chapter06/linux-headers.xml
deleted file mode 100644
index f1d4cb14e..000000000
--- a/chapter06/linux-headers.xml
+++ /dev/null
@@ -1,209 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
- "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
- <!ENTITY % general-entities SYSTEM "../general.ent">
- %general-entities;
-]>
-
-<sect1 id="ch-system-linux-headers" role="wrap">
- <?dbhtml filename="linux-headers.html"?>
-
- <sect1info condition="script">
- <productname>linux-headers</productname>
- <productnumber>&linux-version;</productnumber>
- <address>&linux-url;</address>
- </sect1info>
-
- <title>Linux-&linux-version; API Headers</title>
-
- <indexterm zone="ch-system-linux-headers">
- <primary sortas="a-Linux">Linux</primary>
- <secondary>API headers</secondary>
- </indexterm>
-
- <sect2 role="package">
- <title/>
-
- <para>The Linux API Headers (in linux-&linux-version;.tar.xz) expose the
- kernel's API for use by Glibc.</para>
-
- <segmentedlist>
- <segtitle>&buildtime;</segtitle>
- <segtitle>&diskspace;</segtitle>
-
- <seglistitem>
- <seg>&linux-headers-ch6-sbu;</seg>
- <seg>&linux-headers-ch6-du;</seg>
- </seglistitem>
- </segmentedlist>
-
- </sect2>
-
- <sect2 role="installation">
- <title>Installation of Linux API Headers</title>
-
- <para>The Linux kernel needs to expose an Application Programming Interface
- (API) for the system's C library (Glibc in LFS) to use. This is done
- by way of sanitizing various C header files that are shipped in the Linux
- kernel source tarball.</para>
-
- <para>Make sure there are no stale files and dependencies lying around
- from previous activity:</para>
-
-<screen><userinput remap="pre">make mrproper</userinput></screen>
-
- <para>Now extract the user-visible kernel headers from the source.
- The recommended make target <quote>headers_install</quote> cannot be
- used, because it requires <application>rsync</application>, which is
- not available in <filename class="directory">/tools</filename>. The
- headers are first placed in <filename class="directory">./usr</filename>,
- then some files used by the kernel developers are removed, then
- the files are copied to their final location.</para>
-
-<screen><userinput remap="make">make headers
-find usr/include -name '.*' -delete
-rm usr/include/Makefile
-</userinput><userinput remap="install">cp -rv usr/include/* /usr/include</userinput></screen>
-
- </sect2>
-
- <sect2 id="contents-linux-headers" role="content">
- <title>Contents of Linux API Headers</title>
-
- <segmentedlist>
- <segtitle>Installed headers</segtitle>
- <segtitle>Installed directories</segtitle>
-
- <seglistitem>
- <seg>/usr/include/asm/*.h, /usr/include/asm-generic/*.h,
- /usr/include/drm/*.h, /usr/include/linux/*.h, /usr/include/misc/*.h,
- /usr/include/mtd/*.h, /usr/include/rdma/*.h, /usr/include/scsi/*.h,
- /usr/include/sound/*.h, /usr/include/video/*.h,
- and /usr/include/xen/*.h</seg>
- <seg>/usr/include/asm, /usr/include/asm-generic, /usr/include/drm,
- /usr/include/linux, /usr/include/misc, /usr/include/mtd,
- /usr/include/rdma, /usr/include/scsi, /usr/include/sound,
- /usr/include/video, and /usr/include/xen</seg>
- </seglistitem>
- </segmentedlist>
-
- <variablelist>
- <bridgehead renderas="sect3">Short Descriptions</bridgehead>
- <?dbfo list-presentation="list"?>
- <?dbhtml list-presentation="table"?>
-
- <varlistentry id="asm">
- <term><filename class="headerfile">/usr/include/asm/*.h</filename></term>
- <listitem>
- <para>The Linux API ASM Headers</para>
- <indexterm zone="ch-system-linux-headers asm">
- <primary sortas="e-/usr/include/asm/*.h">/usr/include/asm/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="asm-generic">
- <term><filename class="headerfile">/usr/include/asm-generic/*.h</filename></term>
- <listitem>
- <para>The Linux API ASM Generic Headers</para>
- <indexterm zone="ch-system-linux-headers asm-generic">
- <primary sortas="e-/usr/include/asm-generic/*.h">/usr/include/asm-generic/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="drm">
- <term><filename class="headerfile">/usr/include/drm/*.h</filename></term>
- <listitem>
- <para>The Linux API DRM Headers</para>
- <indexterm zone="ch-system-linux-headers drm">
- <primary sortas="e-/usr/include/drm/*.h">/usr/include/drm/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="linux">
- <term><filename class="headerfile">/usr/include/linux/*.h</filename></term>
- <listitem>
- <para>The Linux API Linux Headers</para>
- <indexterm zone="ch-system-linux-headers linux">
- <primary sortas="e-/usr/include/linux/*.h">/usr/include/linux/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="misc">
- <term><filename class="headerfile">/usr/include/misc/*.h</filename></term>
- <listitem>
- <para>The Linux API Miscellaneous Headers</para>
- <indexterm zone="ch-system-linux-headers misc">
- <primary sortas="e-/usr/include/misc/*.h">/usr/include/misc/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="mtd">
- <term><filename class="headerfile">/usr/include/mtd/*.h</filename></term>
- <listitem>
- <para>The Linux API MTD Headers</para>
- <indexterm zone="ch-system-linux-headers mtd">
- <primary sortas="e-/usr/include/mtd/*.h">/usr/include/mtd/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="rdma">
- <term><filename class="headerfile">/usr/include/rdma/*.h</filename></term>
- <listitem>
- <para>The Linux API RDMA Headers</para>
- <indexterm zone="ch-system-linux-headers rdma">
- <primary sortas="e-/usr/include/rdma/*.h">/usr/include/rdma/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="scsi">
- <term><filename class="headerfile">/usr/include/scsi/*.h</filename></term>
- <listitem>
- <para>The Linux API SCSI Headers</para>
- <indexterm zone="ch-system-linux-headers scsi">
- <primary sortas="e-/usr/include/scsi/*.h">/usr/include/scsi/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="sound">
- <term><filename class="headerfile">/usr/include/sound/*.h</filename></term>
- <listitem>
- <para>The Linux API Sound Headers</para>
- <indexterm zone="ch-system-linux-headers sound">
- <primary sortas="e-/usr/include/sound/*.h">/usr/include/sound/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="video">
- <term><filename class="headerfile">/usr/include/video/*.h</filename></term>
- <listitem>
- <para>The Linux API Video Headers</para>
- <indexterm zone="ch-system-linux-headers video">
- <primary sortas="e-/usr/include/video/*.h">/usr/include/video/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- <varlistentry id="xen">
- <term><filename class="headerfile">/usr/include/xen/*.h</filename></term>
- <listitem>
- <para>The Linux API Xen Headers</para>
- <indexterm zone="ch-system-linux-headers xen">
- <primary sortas="e-/usr/include/xen/*.h">/usr/include/xen/*.h</primary>
- </indexterm>
- </listitem>
- </varlistentry>
-
- </variablelist>
-
- </sect2>
-
-</sect1>