r158 - in trunk/BOOK: chapter05 chapter06

manuel at linuxfromscratch.org manuel at linuxfromscratch.org
Thu Feb 10 14:30:10 PST 2005


Author: manuel
Date: 2005-02-10 15:30:10 -0700 (Thu, 10 Feb 2005)
New Revision: 158

Added:
   trunk/BOOK/chapter05/linux-libc-headers.xml
   trunk/BOOK/chapter06/linux-libc-headers.xml
Modified:
   trunk/BOOK/chapter05/chapter05.xml
   trunk/BOOK/chapter06/chapter06.xml
Log:
Preparing chapter0{5,6}. Added the first files.

Modified: trunk/BOOK/chapter05/chapter05.xml
===================================================================
--- trunk/BOOK/chapter05/chapter05.xml	2005-02-09 22:12:31 UTC (rev 157)
+++ trunk/BOOK/chapter05/chapter05.xml	2005-02-10 22:30:10 UTC (rev 158)
@@ -9,23 +9,22 @@
 <?dbhtml filename="chapter05.html"?>
 
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="introduction.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="linux-libc-headers.xml"/>
 <!--
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hostreqs.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="toolchaintechnotes.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="binutils-pass1.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc-pass1.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="linux-libc-headers.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="glibc-headers.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="uclibc-headers.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="binutils-cross.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc-cross.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="glibc.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="uclibc.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="adjusting.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tcl.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="expect.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dejagnu.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc-pass2.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="binutils-pass2.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="binutils-native.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc-native.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gawk.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="coreutils.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bzip2.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gzip.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="diffutils.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="findutils.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="make.xml"/>
@@ -35,6 +34,8 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ncurses.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="patch.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tar.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bzip2.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gzip.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="texinfo.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bash.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="m4.xml"/>

Added: trunk/BOOK/chapter05/linux-libc-headers.xml
===================================================================
--- trunk/BOOK/chapter05/linux-libc-headers.xml	2005-02-09 22:12:31 UTC (rev 157)
+++ trunk/BOOK/chapter05/linux-libc-headers.xml	2005-02-10 22:30:10 UTC (rev 158)
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-tools-linux-libc-headers" role="wrap">
+<title>Linux-Libc-Headers-&linux-libc-headers-version;</title>
+<?dbhtml filename="linux-libc-headers.html"?>
+
+<indexterm zone="ch-tools-linux-libc-headers">
+<primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
+<secondary>tools</secondary></indexterm>
+
+<sect2 role="package"><title/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+href="../chapter06/linux-libc-headers.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>?? SBU</seg><seg>?? MB</seg></seglistitem>
+</segmentedlist>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+href="../chapter06/linux-libc-headers.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
+
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Linux-Libc-Headers</title>
+
+<para>Apply a patch to ... EDIT ME</para>
+
+<screen><userinput>patch --no-backup-if-mismatch -Np1 -i \
+    ../linux-libc-headers-2.6-frandom-2.patch</userinput></screen>
+    
+<para>The meaning of the patch option:</para>
+
+<variablelist>
+<varlistentry>
+<term><parameter>--no-backup-if-mismatch</parameter></term>
+<listitem><para>Prevents <command>patch</command> from creating 
+<filename class="extension">.orig</filename> files, so they don't get installed to 
+<filename class="directory">/tools/include</filename>. <filename 
+class="extension">.orig</filename> files might be named something else 
+depending on the version of <command>patch</command>.</para></listitem>
+</varlistentry>
+</variablelist>
+
+<para>Install the headers files:</para>
+
+<screen><userinput>install -d /tools/include
+cp -R include/asm-i386 /tools/include/asm
+cp -R include/linux /tools/include</userinput></screen>
+
+</sect2>
+
+<sect2 role="content"><title/>
+<para>Details on this package are located in <xref
+linkend="contents-linux-libc-headers" role="."/></para>
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter05/linux-libc-headers.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"

Modified: trunk/BOOK/chapter06/chapter06.xml
===================================================================
--- trunk/BOOK/chapter06/chapter06.xml	2005-02-09 22:12:31 UTC (rev 157)
+++ trunk/BOOK/chapter06/chapter06.xml	2005-02-10 22:30:10 UTC (rev 158)
@@ -16,10 +16,11 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="creatingdirs.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="createfiles.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pwdgroup.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="devices.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="linux-libc-headers.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="devices.xml"/>-->
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="linux-libc-headers.xml"/><!--
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="man-pages.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="glibc.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="uclibc.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="readjusting.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="binutils.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc.xml"/>
@@ -63,12 +64,13 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="procps.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="psmisc.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="shadow.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="util-linux.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libol.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="syslogng.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sysvinit.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tar.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="udev.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="util-linux.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="paxctl.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="aboutdebug.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="strippingagain.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="revisedchroot.xml"/>

Added: trunk/BOOK/chapter06/linux-libc-headers.xml
===================================================================
--- trunk/BOOK/chapter06/linux-libc-headers.xml	2005-02-09 22:12:31 UTC (rev 157)
+++ trunk/BOOK/chapter06/linux-libc-headers.xml	2005-02-10 22:30:10 UTC (rev 158)
@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-system-linux-libc-headers" role="wrap">
+<title>Linux-Libc-Headers-&linux-libc-headers-version;</title>
+<?dbhtml filename="linux-libc-headers.html"?>
+
+<indexterm zone="ch-system-linux-libc-headers">
+<primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
+</indexterm>
+
+<sect2 role="package"><title/>
+<para>The Linux-Libc-Headers package contains the
+<quote>sanitized</quote> kernel headers.</para>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>?? SBU</seg><seg>?? MB</seg></seglistitem>
+</segmentedlist>
+
+<segmentedlist>
+<segtitle>Linux-Libc-Headers installation depends on</segtitle>
+<seglistitem><seg>Coreutils</seg></seglistitem>
+</segmentedlist>
+
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Linux-Libc-Headers</title>
+
+<para>Apply a patch to ... EDIT ME</para>
+
+<screen><userinput>patch --no-backup-if-mismatch -Np1 -i \
+    ../linux-libc-headers-2.6-frandom-2.patch</userinput></screen>
+
+<para>Install the headers files:</para>
+
+<screen><userinput>cp -R include/asm-i386 /usr/include/asm
+cp -R include/linux /usr/include</userinput></screen>
+
+<para>Ensure that all the headers are owned by root:</para>
+
+<screen><userinput>chown -R root:root /usr/include/{asm,linux}</userinput></screen>
+
+<para>Make sure the users can read the headers:</para>
+
+<screen><userinput>find /usr/include/{asm,linux} -type d -exec chmod 755 {} \;
+find /usr/include/{asm,linux} -type f -exec chmod 644 {} \;</userinput></screen>
+
+</sect2>
+
+
+<sect2 id="contents-linux-libc-headers" role="content"><title>Contents of Linux-Libc-Headers</title>
+
+<segmentedlist>
+<segtitle>Installed headers</segtitle>
+<seglistitem><seg>/usr/include/{asm,linux}/*.h</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="linux-libc-headers">
+<term><filename class="headerfile">/usr/include/{asm,linux}/*.h</filename></term>
+<listitem>
+<para>The Linux headers API</para>
+<indexterm zone="ch-system-linux-libc-headers linux-libc-headers"><primary sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter06/linux-libc-headers.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"




More information about the hlfs-dev mailing list