[Clfs-commits] [CLFS Embedded]Cross-LFS Embedded Book branch, master, updated. dcf5785aaa69db6dad4abd16d97dfc8843ea253a

git git at clfs.org
Fri Oct 27 07:01:48 PDT 2017


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Cross-LFS Embedded Book".

The branch, master has been updated
       via  dcf5785aaa69db6dad4abd16d97dfc8843ea253a (commit)
       via  05e0cf75e45eab52c3cb80fc8994529044ce6eb3 (commit)
       via  e3742c152efc975c37b2b71f1a58ef8a7819dc86 (commit)
       via  8112a8d4ae5a0e88154f58f17d6bfc33ecd4a589 (commit)
       via  0b3adee12d825d572a2a82be63e8f6f264c3bc5d (commit)
       via  adfc846ad6ebda9761b1cb0a5c86c8914860a7c6 (commit)
       via  faf50d8a165e4dfc6177e46e8717c572f7497638 (commit)
       via  422ad1fe2fe44e6055a0269b782864963cdfc736 (commit)
       via  0958ca9c41160b7760e4a5d06380f7afd0b2baec (commit)
       via  dd92ea4acff9218126ed658d8a76b462c4db0c2a (commit)
       via  573e70c74bd4b549a575bb70663b37f5f08c5726 (commit)
       via  81b4464973701bea9dca31b38c3d12dff3dab446 (commit)
       via  e24b7ec7b0b61307fa6c869a2278ef92d0acb8d1 (commit)
       via  5d8ddbf6526b363b1ca130272b51f34d155083a2 (commit)
       via  fc35affc5a825dcc5efeb5c7ad2939edfb7e9f9b (commit)
       via  31fac76144b2aac32b923e953cc9e46a84ccf07f (commit)
       via  1a152761948647b5293cbbbdb78f6ba0b99f89a0 (commit)
       via  241f9a94bf8c3578383e9f377ab1a24be8666f5a (commit)
       via  cc565e2715a8447490ab6cb08cf0466314a860ca (commit)
       via  2ac72a815339adc4a8d61efeba94974de07a8557 (commit)
       via  06c81a1a7c20495e74a76bbdfef4c1b1c5b8ae82 (commit)
       via  40d238ab7c8a6e62427e661ea8ffd0bffbb1019f (commit)
       via  8704f34393222a923cc57f2f2212b25a17f90a50 (commit)
       via  83a31c36aea7aa147c6c0ea9ac766d316ba90f94 (commit)
       via  73d79973ec4415776e3ecd3c7602d6879772cb56 (commit)
       via  2d6f66baae660ef4cfa37fcb4d08fb83466cc524 (commit)
       via  a67ab5796e492f5521396e3151b4c9850a5e63a7 (commit)
       via  7f6542c9d0a163283edc0e9176b3249df75b747d (commit)
       via  b74d39b8093d64a9ba00912dd74a0803ce15d107 (commit)
       via  e1ede421a9d08bff031ea2663fa81d46ea1cb64a (commit)
       via  82ad5902ebe18cc2f0d6f8413987754c8d335e69 (commit)
       via  e065f44f41d4a23837ca48966028495719ae244e (commit)
       via  ccc6724689550b286950ed60abb30dd5882c8d89 (commit)
       via  6590da60c33fccf2381a4451f07aa47142246b30 (commit)
       via  c4d9f4b2e939b7c029ef387c0a86ee665a27931f (commit)
       via  e1348bba3de996abb60aed68009ea663148baf66 (commit)
       via  1f12b5df9085ab871ab2d85cb824fefb2015397b (commit)
       via  4d9350dee0d652a166f532945862327611d628ad (commit)
       via  1dfe239904de2fdc9ba43efc698d0e9b7af0d251 (commit)
       via  a3957dd881d3e0e0eecf1ea6fd19a00b249ec0c5 (commit)
       via  a5d6c2377116cb70eb443f2dc0198143dbb7b54b (commit)
       via  5a5d7ef5458a5ab28183f0f5a53af28b3c997db7 (commit)
      from  173cc96fc136fe34ea4d46c31b387012aa253f10 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit dcf5785aaa69db6dad4abd16d97dfc8843ea253a
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 15:17:59 2017 -0400

    Update date

diff --git a/BOOK/general.ent b/BOOK/general.ent
index 57848cd..829face 100644
--- a/BOOK/general.ent
+++ b/BOOK/general.ent
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 
-<!ENTITY month "12"> <!-- Use two digits -->
-<!ENTITY month_name "December">
-<!ENTITY day "28"> <!-- Use two digits -->
-<!ENTITY year "2016"> <!-- Use four digits -->
+<!ENTITY month "10"> <!-- Use two digits -->
+<!ENTITY month_name "October">
+<!ENTITY day "12"> <!-- Use two digits -->
+<!ENTITY year "2017"> <!-- Use four digits -->
 
 <!ENTITY releasedate "&month_name; &day;, &year;">
 

commit 05e0cf75e45eab52c3cb80fc8994529044ce6eb3
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 15:17:53 2017 -0400

    Update changelog

diff --git a/BOOK/preface/common/changelog.xml b/BOOK/preface/common/changelog.xml
index a7d943c..b3ba30e 100644
--- a/BOOK/preface/common/changelog.xml
+++ b/BOOK/preface/common/changelog.xml
@@ -36,6 +36,30 @@
     </listitem>
 -->
     <listitem>
+      <para>October 12, 2017</para>
+      <itemizedlist>
+        <listitem>
+          <para>[abradford] - Many small fixes submitted by "selk" on IRC and
+            "akhiezer" via email.</para>
+        </listitem>
+        <listitem>
+          <para>[abradford] - Update Linux to v4.9.22.</para>
+        </listitem>
+        <listitem>
+          <para>[abradford] - Update musl to version 1.1.16.</para>
+        </listitem>
+        <listitem>
+          <para>[abradford] - Add new concept of "targetfs" directory parallel
+            to the cross-tools which allows easier retaining of cross-tools
+            across target builds.</para>
+        </listitem>
+        <listitem>
+          <para>[abradford] - Remove utmp, wtmp, and btmp creation.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>December 28, 2016</para>
       <itemizedlist>
         <listitem>

commit e3742c152efc975c37b2b71f1a58ef8a7819dc86
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 15:25:12 2017 -0400

    final-system: libc: Only install the libs into targetfs
    
    By default some tools and headers would be installed using 'make
    install' but we don't want any of those, we just need the libs.

diff --git a/BOOK/final-system/common/libc.xml b/BOOK/final-system/common/libc.xml
index b7a139b..cc65c8b 100644
--- a/BOOK/final-system/common/libc.xml
+++ b/BOOK/final-system/common/libc.xml
@@ -42,9 +42,9 @@
 
 <screen os="i"><userinput>make</userinput></screen>
 
-    <para os="l">Install the package:</para>
+    <para os="l">Install just the shared library:</para>
 
-<screen os="j"><userinput>DESTDIR=${CLFS}/targetfs make install</userinput></screen>
+<screen os="j"><userinput>DESTDIR=${CLFS}/targetfs make install-libs</userinput></screen>
 
   </sect2>
 

commit 8112a8d4ae5a0e88154f58f17d6bfc33ecd4a589
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 14:55:26 2017 -0400

    cleanup: chowning: Remove mention of /var/run/utmp
    
    We've previously modified the book to not create this file so no need to
    chgrp it.

diff --git a/BOOK/cleanup/chowning.xml b/BOOK/cleanup/chowning.xml
index 6a9da38..85f01fa 100644
--- a/BOOK/cleanup/chowning.xml
+++ b/BOOK/cleanup/chowning.xml
@@ -29,10 +29,10 @@
 
 <screen><userinput>chown -Rv root:root ${CLFS}/targetfs</userinput></screen>
 
-  <para>The following files should not to belong to the
-  <systemitem class="groupname">root</systemitem> group, they should belong
+  <para>The following file should not to belong to the
+  <systemitem class="groupname">root</systemitem> group, it should belong
   to the <systemitem class="groupname">utmp</systemitem> group (group 13):</para>
 
-<screen><userinput>chgrp -v 13 ${CLFS}/targetfs/var/run/utmp ${CLFS}/targetfs/var/log/lastlog</userinput></screen>
+<screen><userinput>chgrp -v 13 ${CLFS}/targetfs/var/log/lastlog</userinput></screen>
 
 </sect1>

commit 0b3adee12d825d572a2a82be63e8f6f264c3bc5d
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 14:53:23 2017 -0400

    cleanup: Remove copylibs section
    
    It is no longer needed, we should already have all the libs we actually
    need present in the targetfs/lib/ directory as we've been installing
    them as we go.

diff --git a/BOOK/cleanup/chapter.xml b/BOOK/cleanup/chapter.xml
index 6ba03c8..63bbd10 100644
--- a/BOOK/cleanup/chapter.xml
+++ b/BOOK/cleanup/chapter.xml
@@ -11,7 +11,6 @@
 
   <title>Backup and Cleanup</title>
 
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="copylibs.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chowning.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="copy-to-target.xml"/>
 
diff --git a/BOOK/cleanup/copylibs.xml b/BOOK/cleanup/copylibs.xml
deleted file mode 100644
index 029719b..0000000
--- a/BOOK/cleanup/copylibs.xml
+++ /dev/null
@@ -1,23 +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-cleanup-copy-libs">
-  <?dbhtml filename="copylibs.html"?>
-
-  <title>Copy Libraries</title>
-
-  <para>Since the cross compiler was built within
-    <filename>${CLFS}/cross-tools</filename>, the generated libraries need to be
-    copied to the target:</para>
-
-<screen><userinput>cp -vP ${CLFS}/cross-tools/${CLFS_TARGET}/lib/*.so* ${CLFS}/targetfs/lib/</userinput></screen>
-
-  <para>Optionally, strip the libraries to reduce their size:</para>
-
-<screen><userinput>${CLFS_TARGET}-strip ${CLFS}/targetfs/lib/*</userinput></screen>
-
-</sect1>

commit adfc846ad6ebda9761b1cb0a5c86c8914860a7c6
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 14:49:49 2017 -0400

    beyond: dropbear: Add note that dropbear depends on zlib

diff --git a/BOOK/beyond/common/dropbear.xml b/BOOK/beyond/common/dropbear.xml
index c3f282f..30c0766 100644
--- a/BOOK/beyond/common/dropbear.xml
+++ b/BOOK/beyond/common/dropbear.xml
@@ -22,6 +22,8 @@
      the same features as OpenSSH. It does not depend on OpenSSL and it has a MIT
      style license.</para>
 
+    <para>Dropbear depends on zlib.</para>
+
   </sect2>
 
   <sect2 role="installation">

commit faf50d8a165e4dfc6177e46e8717c572f7497638
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 14:15:58 2017 -0400

    beyond: zlib: Install into both cross-tools and targetfs
    
    So that we have headers and libs all provided in the cross tools to
    enable compiling things that use zlib but also so we have the runtime
    shared object in the targetfs.

diff --git a/BOOK/beyond/common/zlib.xml b/BOOK/beyond/common/zlib.xml
index e56f4b4..0dc1bef 100644
--- a/BOOK/beyond/common/zlib.xml
+++ b/BOOK/beyond/common/zlib.xml
@@ -45,10 +45,16 @@
 
 <screen os="d"><userinput>make</userinput></screen>
 
-    <para os="e">Install the package:</para>
+    <para os="e">Install the package into the cross-tools:</para>
 
 <screen os="f"><userinput>make prefix=${CLFS}/cross-tools/${CLFS_TARGET} install</userinput></screen>
 
+    <para os="g">Copy only the shared library into the target file system and
+      ensure that its symlink is present so the runtime loader can find it:</para>
+
+    <screen os="h"><userinput>cp -v ${CLFS}/cross-tools/${CLFS_TARGET}/lib/libz.so.&zlib-version; ${CLFS}/targetfs/lib/
+ln -sv libz.so.&zlib-version; ${CLFS}/targetfs/lib/libz.so.1</userinput></screen>
+
   </sect2>
 
   <sect2 id="contents-zlib" role="content">

commit 422ad1fe2fe44e6055a0269b782864963cdfc736
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 13:59:27 2017 -0400

    bootscripts: profile: Consistently use spaces around "<<"

diff --git a/BOOK/bootscripts/common/profile.xml b/BOOK/bootscripts/common/profile.xml
index 263d012..7f57d7e 100644
--- a/BOOK/bootscripts/common/profile.xml
+++ b/BOOK/bootscripts/common/profile.xml
@@ -18,7 +18,7 @@
 
   <para os="a">Now we will create the profile file for use with our system:</para>
 
-<screen os="b"><userinput>cat > ${CLFS}/targetfs/etc/profile<< "EOF"
+<screen os="b"><userinput>cat > ${CLFS}/targetfs/etc/profile << "EOF"
 <literal># /etc/profile
 
 # Set the initial path

commit 0958ca9c41160b7760e4a5d06380f7afd0b2baec
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 13:54:27 2017 -0400

    final-system: Only build shared version of musl
    
    We don't need libc.a in our targetfs, it's only needed in the
    cross-tools as we won't ever run a compiler in the final system.

diff --git a/BOOK/final-system/common/libc.xml b/BOOK/final-system/common/libc.xml
index 665e5be..b7a139b 100644
--- a/BOOK/final-system/common/libc.xml
+++ b/BOOK/final-system/common/libc.xml
@@ -22,7 +22,8 @@
     the basic routines for allocating memory, searching directories, opening and
     closing files, reading and writing files, string handling, pattern matching,
     arithmetic, and so on.  We build it again here so that it can be installed
-    into our targetfs sysroot.</para>
+    into our targetfs sysroot but this time we only build the shared object
+    version.</para>
 
   </sect2>
 
@@ -34,6 +35,7 @@
 <screen os="i"><userinput>./configure \
   CROSS_COMPILE=${CLFS_TARGET}- \
   --prefix=/ \
+  --disable-static \
   --target=${CLFS_TARGET}</userinput></screen>
 
     <para os="h">Compile the package:</para>

commit dd92ea4acff9218126ed658d8a76b462c4db0c2a
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu Oct 12 13:50:57 2017 -0400

    final-system: Add libgcc.so copying to targetfs
    
    Since we're compiling applications to use shared libs, we need to
    provide a copy of libgcc in the targetfs.

diff --git a/BOOK/final-system/chapter.xml b/BOOK/final-system/chapter.xml
index c18523c..f4c3b41 100644
--- a/BOOK/final-system/chapter.xml
+++ b/BOOK/final-system/chapter.xml
@@ -14,6 +14,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/introduction.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/creatingdirs.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/creatingfiles.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/libgcc.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/libc.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/busybox.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/iana-etc.xml"/>
diff --git a/BOOK/final-system/common/libgcc.xml b/BOOK/final-system/common/libgcc.xml
new file mode 100644
index 0000000..58ce339
--- /dev/null
+++ b/BOOK/final-system/common/libgcc.xml
@@ -0,0 +1,41 @@
+<?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-final-system-libgcc" role="wrap">
+  <?dbhtml filename="libgcc.html"?>
+
+  <title>libgcc-&gcc-version;</title>
+
+  <indexterm zone="ch-final-system-libgcc">
+    <primary sortas="a-libgcc">libgcc</primary>
+    <secondary>final system</secondary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title/>
+
+    <para>When compiling dynamically linked software using GCC, GCC requires
+      that libgcc be able to be loaded during runtime when executing the
+      software.  Hence, we must be sure to provide the final system with a copy
+      of the libgcc we previously built for our cross tools.</para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of libgcc</title>
+
+    <para os="a">Install the package:</para>
+
+    <screen os="b"><userinput>cp -v ${CLFS}/cross-tools/${CLFS_TARGET}/lib/libgcc_s.so.1 ${CLFS}/targetfs/lib/</userinput></screen>
+
+    <para os="c">Strip libgcc to make it smaller:</para>
+
+    <screen os="d"><userinput>${CLFS_TARGET}-strip ${CLFS}/targetfs/lib/libgcc_s.so.1</userinput></screen>
+
+  </sect2>
+
+</sect1>

commit 573e70c74bd4b549a575bb70663b37f5f08c5726
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Mon Jul 17 15:50:13 2017 -0400

    bootable/fstab: Remove / line
    
    Bootloader will tell Linux where rootfs is, we have no other file
    systems, so we can have an empty /etc/fstab.

diff --git a/BOOK/bootable/common/fstab.xml b/BOOK/bootable/common/fstab.xml
index bddf774..7fe3513 100644
--- a/BOOK/bootable/common/fstab.xml
+++ b/BOOK/bootable/common/fstab.xml
@@ -17,21 +17,15 @@
   <para os="a">The <filename>/etc/fstab</filename> file is used by some
   programs to determine where file systems are to be mounted by default,
   in which order, and which must be checked (for integrity errors) prior
-  to mounting. Create a new file systems table like this:</para>
+  to mounting.  For our embedded system, the bootloader will tell Linux where to
+  find the root file system and we will not mount any additional file systems,
+  so we can create an empty file system table like this:</para>
 
 <screen><userinput>cat > ${CLFS}/targetfs/etc/fstab << "EOF"
-<literal># file-system  mount-point  type   options          dump  fsck
-/dev/<replaceable>[xxx]</replaceable>     /            <replaceable>[fff]</replaceable>  defaults         1     1</literal>
+<literal># file-system  mount-point  type   options          dump  fsck</literal>
 EOF</userinput></screen>
 
-  <para os="b">Replace <replaceable>[xxx]</replaceable>
-  and <replaceable>[fff]</replaceable>
-  with the values appropriate for the system, for example, <filename
-  class="partition">mmcblk0p2</filename>
-  and <systemitem class="filesystem">ext4</systemitem>. For details on the 
-  fields in this file, see <command>man 5 fstab</command>.</para>
-
-  <para>You may also add any other file systems, such as swap or other partitions
-  or network file systems, to this fstab as well.</para>
+  <para>You may add any other file systems, such as swap or other partitions
+  or network file systems, to this fstab if you wish.</para>
 
 </sect1>

commit 81b4464973701bea9dca31b38c3d12dff3dab446
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Mon Jul 17 15:44:29 2017 -0400

    final-system/creatingfiles: Remove utmp, wtmp, and btmp creation
    
    musl doesn't properly support these files and we take them out of the
    busybox config when building it, so don't create the files in the first
    place.

diff --git a/BOOK/final-system/common/creatingfiles.xml b/BOOK/final-system/common/creatingfiles.xml
index 945b8a7..4e1b28a 100644
--- a/BOOK/final-system/common/creatingfiles.xml
+++ b/BOOK/final-system/common/creatingfiles.xml
@@ -8,7 +8,7 @@
 <sect1 id="ch-final-system-creatingfiles">
   <?dbhtml filename="creatingfiles.html"?>
 
-  <title>Creating the passwd, group, and log Files</title>
+  <title>Creating the passwd, group, and lastlog Files</title>
 
   <indexterm zone="ch-final-system-creatingfiles">
     <primary sortas="e-/etc/passwd">/etc/passwd</primary>
@@ -19,21 +19,9 @@
   </indexterm>
 
   <indexterm zone="ch-final-system-creatingfiles">
-    <primary sortas="e-/var/run/utmp">/var/run/utmp</primary>
-  </indexterm>
-
-  <indexterm zone="ch-final-system-creatingfiles">
-    <primary sortas="e-/var/log/btmp">/var/log/btmp</primary>
-  </indexterm>
-
-  <indexterm zone="ch-final-system-creatingfiles">
     <primary sortas="e-/var/log/lastlog">/var/log/lastlog</primary>
   </indexterm>
 
-  <indexterm zone="ch-final-system-creatingfiles">
-    <primary sortas="e-/var/log/wtmp">/var/log/wtmp</primary>
-  </indexterm>
-
   <para>A proper Linux system maintains a list of the mounted file systems in
   the file <filename>/etc/mtab</filename>.  With the way our embedded system is
   designed, we will be using a symlink to <filename>/proc/mounts</filename>:</para>
@@ -218,20 +206,13 @@ EOF</userinput></screen>
   rather use the group's name.</para>
 
   <para>The <command>login</command>, <command>agetty</command>, and
-  <command>init</command> programs (and others) use a number of log
-  files to record information such as who was logged into the system and
-  when. However, these programs will not write to the log files if they
-  do not already exist. Initialize the log files and give them
+  <command>init</command> programs (and others) use the lastlog
+  file to record information such as who was logged into the system and
+  when. However, these programs will not write to the lastlog file if it
+  does not already exist. Initialize the lastlog file and give it
   proper permissions:</para>
 
-<screen><userinput>touch ${CLFS}/targetfs/var/run/utmp ${CLFS}/targetfs/var/log/{btmp,lastlog,wtmp}
-chmod -v 664 ${CLFS}/targetfs/var/run/utmp ${CLFS}/targetfs/var/log/lastlog</userinput></screen>
-
-  <para>The <filename>/var/run/utmp</filename> file records the users
-  that are currently logged in. The <filename>/var/log/wtmp</filename>
-  file records all logins and logouts. The
-  <filename>/var/log/lastlog</filename> file records when
-  each user last logged in. The <filename>/var/log/btmp</filename> file
-  records the bad login attempts.</para>
+<screen><userinput>touch ${CLFS}/targetfs/var/log/lastlog
+chmod -v 664 ${CLFS}/targetfs/var/log/lastlog</userinput></screen>
 
 </sect1>

commit e24b7ec7b0b61307fa6c869a2278ef92d0acb8d1
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Mon Jul 17 14:32:58 2017 -0400

    final-preps/addinguser: Add notice that actions may need to be done by root

diff --git a/BOOK/final-preps/addinguser.xml b/BOOK/final-preps/addinguser.xml
index 9a26d23..259e464 100644
--- a/BOOK/final-preps/addinguser.xml
+++ b/BOOK/final-preps/addinguser.xml
@@ -17,7 +17,7 @@
   work environment, create a new user called <systemitem
   class="username">clfs</systemitem> as a member of a new group (also named
   <systemitem class="groupname">clfs</systemitem>) and use this user during
-  the installation process.</para>
+  the installation process.  You may need to do this as the root user:</para>
 
 <screen><userinput>sudo groupadd clfs
 sudo useradd -s /bin/bash -g clfs -m -k /dev/null clfs</userinput></screen>
@@ -72,13 +72,14 @@ sudo useradd -s /bin/bash -g clfs -m -k /dev/null clfs</userinput></screen>
   when logged in as <systemitem class="username">root</systemitem>, which
   does not require the <systemitem class="username">clfs</systemitem> user
   to have a password), give <systemitem class="username">clfs</systemitem>
-  a password:</para>
+  a password.  You may need to do this as the root user:</para>
 
 <screen><userinput>sudo passwd clfs</userinput></screen>
 
   <para>Grant <systemitem class="username">clfs</systemitem> full access to
   <filename class="directory">${CLFS}</filename> by making <systemitem
-  class="username">clfs</systemitem> the directory's owner:</para>
+  class="username">clfs</systemitem> the directory's owner.  You may need to do
+  this as the root user:</para>
 
 <screen><userinput>sudo chown -Rv clfs ${CLFS}</userinput></screen>
 

commit 5d8ddbf6526b363b1ca130272b51f34d155083a2
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Mon Jul 17 14:28:45 2017 -0400

    materials/creatingbuilddir: Add 'sudo' usage as needed
    
    In order to be consistent with later parts of the book which do use
    'sudo' in the commands given, use 'sudo' here, too, as we need root
    permissions usually to create a directory in /mnt/.

diff --git a/BOOK/materials/common/creatingbuilddir.xml b/BOOK/materials/common/creatingbuilddir.xml
index 60e71e1..ad67c1e 100644
--- a/BOOK/materials/common/creatingbuilddir.xml
+++ b/BOOK/materials/common/creatingbuilddir.xml
@@ -14,7 +14,7 @@
     but depending on the location you choose, you may need to do this as the
     root user: </para>
 
-<screen><userinput>mkdir -p /mnt/clfs</userinput></screen>
+<screen><userinput>sudo mkdir -p /mnt/clfs</userinput></screen>
 
   <para>Assign it to the <envar>CLFS</envar> environment variable:</para>
 
@@ -25,7 +25,7 @@
     the location of the <envar>CLFS</envar> directory, you may need to do this
     as the root user:</para>
 
-<screen><userinput>chmod 777 ${CLFS}</userinput></screen>
+<screen><userinput>sudo chmod 777 ${CLFS}</userinput></screen>
 
   <para>Downloaded packages and patches will need to be stored somewhere
   that is conveniently available throughout the entire build. A working

commit fc35affc5a825dcc5efeb5c7ad2939edfb7e9f9b
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Mon Jul 17 14:23:29 2017 -0400

    packages: Switch GCC download link from ftp to http
    
    The FSF provides all of what used to be hosted via FTP now also via HTTP
    so use HTTP as all other downloads already use HTTP.

diff --git a/BOOK/packages.ent b/BOOK/packages.ent
index 01182f8..98419d3 100644
--- a/BOOK/packages.ent
+++ b/BOOK/packages.ent
@@ -24,7 +24,7 @@
 
 <!ENTITY gcc-version "6.2.0">
 <!ENTITY gcc-size "97441 KB">
-<!ENTITY gcc-url "ftp://gcc.gnu.org/pub/gcc/releases/gcc-&gcc-version;/gcc-&gcc-version;.tar.bz2">
+<!ENTITY gcc-url "http://gcc.gnu.org/pub/gcc/releases/gcc-&gcc-version;/gcc-&gcc-version;.tar.bz2">
 <!ENTITY gcc-md5 "9768625159663b300ae4de2f4745fcc4">
 <!ENTITY gcc-home "http://gcc.gnu.org">
 

commit 31fac76144b2aac32b923e953cc9e46a84ccf07f
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 5 08:40:25 2017 -0400

    beyond/dropbear: Fix adventurous sentence structure
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing this out.

diff --git a/BOOK/beyond/common/dropbear.xml b/BOOK/beyond/common/dropbear.xml
index 727f794..c3f282f 100644
--- a/BOOK/beyond/common/dropbear.xml
+++ b/BOOK/beyond/common/dropbear.xml
@@ -36,7 +36,7 @@
 <screen os="b"><userinput>CC="${CC} -Os" ./configure --prefix=/usr --host=${CLFS_TARGET}</userinput></screen>
 
     <note os="e"><para>We are just telling dropbear to use the default
-        configuration plus scp.  For those for more adventureous, edit options.h
+        configuration plus scp.  For those who are more adventurous, edit options.h
         to further configure dropbear.</para></note>
 
     <para os="f">Compile the package:</para>

commit 1a152761948647b5293cbbbdb78f6ba0b99f89a0
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Jun 30 14:32:23 2017 -0400

    BOOK: s/BASEDIR/RENDERDIR/
    
    As pointed out by akhiezer <lfs65 at cruziero.com>, the BASEDIR variable
    doesn't actually exist and the way it is used in the
    documentation/comments means it is actually referring to the RENDERDIR
    variable.

diff --git a/BOOK/INSTALL.md b/BOOK/INSTALL.md
index 1f012a8..441e256 100644
--- a/BOOK/INSTALL.md
+++ b/BOOK/INSTALL.md
@@ -31,7 +31,7 @@ sudo apt install docbook-xml docbook-xsl fop libxml2-utils lynx make xsltproc ti
 ```
 
 To actually convert the Docbook XML source into rendered form, which will be
-located at ../render by default (override with BASEDIR=), execute:
+located at ../render by default (override with RENDERDIR=), execute:
 
 * To XHTML: `make`
 * To single file XHTML (nochunks): `make nochunks`
diff --git a/BOOK/stylesheets/lfs-xsl/pdf.xsl b/BOOK/stylesheets/lfs-xsl/pdf.xsl
index a1c9f19..8de29b2 100644
--- a/BOOK/stylesheets/lfs-xsl/pdf.xsl
+++ b/BOOK/stylesheets/lfs-xsl/pdf.xsl
@@ -19,7 +19,7 @@ $Date$
     <!-- Uncomment the next for debugging the raw FO code.
          Note that FOP will complaints about a lot of paragraph overflows
          due that verbatim output is also indented.
-         Remember to comment the "rm $(BASEDIR)/lfs-pdf.fo" in
+         Remember to comment the "rm $(RENDERDIR)/lfs-pdf.fo" in
          the Makefile. -->
   <!--<xsl:output  encoding="UTF-8" indent="yes" />-->
 

commit 241f9a94bf8c3578383e9f377ab1a24be8666f5a
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed May 10 10:37:58 2017 -0400

    Remove freshmeat references
    
    Apparently freshmeat.net is no longer (for some time), so remove all
    references to it.
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing this out.

diff --git a/BOOK/stylesheets/lfs-xsl/docbook-xsl-snapshot/VERSION b/BOOK/stylesheets/lfs-xsl/docbook-xsl-snapshot/VERSION
index 665ffa2..4e8423c 100644
--- a/BOOK/stylesheets/lfs-xsl/docbook-xsl-snapshot/VERSION
+++ b/BOOK/stylesheets/lfs-xsl/docbook-xsl-snapshot/VERSION
@@ -1,18 +1,17 @@
 <?xml version='1.0'?> <!-- -*- nxml -*- vim: set foldlevel=2: -->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-  xmlns:fm="http://freshmeat.net/projects/freshmeat-submit/"
   xmlns:sf="http://sourceforge.net/"
   xmlns:dyn="http://exslt.org/dynamic"
   xmlns:saxon="http://icl.com/saxon"
-  exclude-result-prefixes="fm sf"
+  exclude-result-prefixes="sf"
   version='1.0'>
 
 <xsl:output omit-xml-declaration="yes"/>
 
 <xsl:param name="get"/>
-<xsl:param name="VERSION" select="string(document('')//fm:Version[1])"/>
-<xsl:param name="Tag" select="concat('V',translate(string(document('')//fm:Version[1]),'.',''))"/>
-<xsl:param name="DistroTitle" select="string(document('')//fm:Branch[1])"/>
+<xsl:param name="VERSION" select="string(document('')//sf:Version[1])"/>
+<xsl:param name="Tag" select="concat('V',translate(string(document('')//sf:Version[1]),'.',''))"/>
+<xsl:param name="DistroTitle" select="string(document('')//sf:Branch[1])"/>
 <xsl:param name="sf-relid" select="0"/>
 
 <xsl:param name="DistroName">docbook-xsl</xsl:param>
@@ -21,17 +20,16 @@
 <xsl:param name="Revision">$Revision$</xsl:param>
 <xsl:param name="VersionFileURL">$URL: https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/xsl/VERSION $</xsl:param>
 
-<xsl:strip-space elements="fm:*"/>
+<xsl:strip-space elements="sf:*"/>
 
-<fm:project>
-  <fm:Project>DocBook</fm:Project>
-  <fm:Branch>XSL Stylesheets</fm:Branch>
-  <fm:Version>1.73.2</fm:Version>
+<sf:project>
+  <sf:Project>DocBook</sf:Project>
+  <sf:Branch>XSL Stylesheets</sf:Branch>
+  <sf:Version>1.73.2</sf:Version>
 <!--
-  <fm:License>MIT/X Consortium License</fm:License>
+  <sf:License>MIT/X Consortium License</sf:License>
 -->
-  <fm:Release-Focus>
-<!-- * Initial freshmeat announcement -->
+  <sf:Release-Focus>
 <!-- * Documentation -->
 <!-- * Code cleanup -->
 <!-- * Minor feature enhancements -->
@@ -40,17 +38,17 @@ Minor bugfixes
 <!-- * Major bugfixes -->
 <!-- * Minor security fixes -->
 <!-- * Major security fixes -->
-  </fm:Release-Focus>
-  <fm:Home-Page-URL>http://sourceforge.net/projects/docbook/</fm:Home-Page-URL>
-  <fm:Gzipped-Tar-URL>http://prdownloads.sourceforge.net/docbook/{DISTRONAME-VERSION}.tar.gz?download</fm:Gzipped-Tar-URL>
-  <fm:Zipped-Tar-URL>http://prdownloads.sourceforge.net/docbook/{DISTRONAME-VERSION}.zip?download</fm:Zipped-Tar-URL>
-  <fm:Bzipped-Tar-URL>http://prdownloads.sourceforge.net/docbook/{DISTRONAME-VERSION}.bz2?download</fm:Bzipped-Tar-URL>
-  <fm:Changelog-URL>http://sourceforge.net/project/shownotes.php?release_id={SFRELID}</fm:Changelog-URL>
-  <fm:CVS-URL>http://docbook.svn.sourceforge.net/viewvc/docbook/</fm:CVS-URL>
-  <fm:Mailing-List-URL>http://lists.oasis-open.org/archives/docbook-apps/</fm:Mailing-List-URL>
-  <fm:Changes>This is a bug-fix update to the 1.73.1 release.
-</fm:Changes>
-</fm:project>
+  </sf:Release-Focus>
+  <sf:Home-Page-URL>http://sourceforge.net/projects/docbook/</sf:Home-Page-URL>
+  <sf:Gzipped-Tar-URL>http://prdownloads.sourceforge.net/docbook/{DISTRONAME-VERSION}.tar.gz?download</sf:Gzipped-Tar-URL>
+  <sf:Zipped-Tar-URL>http://prdownloads.sourceforge.net/docbook/{DISTRONAME-VERSION}.zip?download</sf:Zipped-Tar-URL>
+  <sf:Bzipped-Tar-URL>http://prdownloads.sourceforge.net/docbook/{DISTRONAME-VERSION}.bz2?download</sf:Bzipped-Tar-URL>
+  <sf:Changelog-URL>http://sourceforge.net/project/shownotes.php?release_id={SFRELID}</sf:Changelog-URL>
+  <sf:CVS-URL>http://docbook.svn.sourceforge.net/viewvc/docbook/</sf:CVS-URL>
+  <sf:Mailing-List-URL>http://lists.oasis-open.org/archives/docbook-apps/</sf:Mailing-List-URL>
+  <sf:Changes>This is a bug-fix update to the 1.73.1 release.
+</sf:Changes>
+</sf:project>
 
 <xsl:template match="/" priority="-100">
   <xsl:choose>
@@ -72,20 +70,20 @@ Minor bugfixes
          <xsl:text>You must specify the sf-relid as a parameter.</xsl:text>
         </xsl:message>
       </xsl:if>
-      <xsl:apply-templates select="//fm:project"/>
+      <xsl:apply-templates select="//sf:project"/>
     </xsl:otherwise>
   </xsl:choose>
 </xsl:template>
 
-<xsl:template match="fm:project">
+<xsl:template match="sf:project">
   <xsl:apply-templates/>
   <xsl:text>
</xsl:text>
-  <xsl:apply-templates select="fm:Changes" mode="text"/>
+  <xsl:apply-templates select="sf:Changes" mode="text"/>
 </xsl:template>
 
-<xsl:template match="fm:Changes"/>
+<xsl:template match="sf:Changes"/>
 
-<xsl:template match="fm:Gzipped-Tar-URL|fm:Zipped-Tar-URL|fm:Bzipped-Tar-URL">
+<xsl:template match="sf:Gzipped-Tar-URL|sf:Zipped-Tar-URL|sf:Bzipped-Tar-URL">
   <xsl:value-of select="local-name(.)"/>
   <xsl:text>: </xsl:text>
   <xsl:value-of select="substring-before(., '{DISTRONAME-VERSION}')"/>
@@ -94,7 +92,7 @@ Minor bugfixes
   <xsl:text>
</xsl:text>
 </xsl:template>
 
-<xsl:template match="fm:Changelog-URL">
+<xsl:template match="sf:Changelog-URL">
   <xsl:value-of select="local-name(.)"/>
   <xsl:text>: </xsl:text>
   <xsl:value-of select="substring-before(., '{SFRELID}')"/>
@@ -103,7 +101,7 @@ Minor bugfixes
   <xsl:text>
</xsl:text>
 </xsl:template>
 
-<xsl:template match="fm:*">
+<xsl:template match="sf:*">
   <xsl:value-of select="local-name(.)"/>
   <xsl:text>: </xsl:text>
   <xsl:value-of select="normalize-space(.)"/>
diff --git a/BOOK/the-end/whatnow.xml b/BOOK/the-end/whatnow.xml
index c7b29be..a12f1a2 100644
--- a/BOOK/the-end/whatnow.xml
+++ b/BOOK/the-end/whatnow.xml
@@ -31,13 +31,6 @@
       <itemizedlist>
 
         <listitem>
-          <para>Freshmeat.net (<ulink url="http://freshmeat.net/"/>)</para>
-
-          <para>Freshmeat can notify you (via email) of new versions of
-          packages installed on your system.</para>
-        </listitem>
-
-        <listitem>
           <para><ulink url="http://www.cert.org/">CERT</ulink> (Computer
           Emergency Response Team)</para>
 

commit cc565e2715a8447490ab6cb08cf0466314a860ca
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu May 4 14:44:55 2017 -0400

    cross-tools/gcc: Put configure build/host/target options in alpha order
    
    To be consistent.
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing this out.

diff --git a/BOOK/cross-tools/arm/gcc-final.xml b/BOOK/cross-tools/arm/gcc-final.xml
index 0956732..bbb14c7 100644
--- a/BOOK/cross-tools/arm/gcc-final.xml
+++ b/BOOK/cross-tools/arm/gcc-final.xml
@@ -51,8 +51,8 @@
 <screen os="ae"><userinput>../gcc-&gcc-version;/configure \
   --prefix=${CLFS}/cross-tools \
   --build=${CLFS_HOST} \
-  --target=${CLFS_TARGET} \
   --host=${CLFS_HOST} \
+  --target=${CLFS_TARGET} \
   --with-sysroot=${CLFS}/cross-tools/${CLFS_TARGET} \
   --disable-nls \
   --enable-languages=c \
diff --git a/BOOK/cross-tools/common/gcc-final.xml b/BOOK/cross-tools/common/gcc-final.xml
index e3d6e0c..982d5c8 100644
--- a/BOOK/cross-tools/common/gcc-final.xml
+++ b/BOOK/cross-tools/common/gcc-final.xml
@@ -62,8 +62,8 @@ mv -v mpc-&mpc-version; mpc</userinput></screen>
 <screen os="ae"><userinput>../gcc-&gcc-version;/configure \
   --prefix=${CLFS}/cross-tools \
   --build=${CLFS_HOST} \
-  --target=${CLFS_TARGET} \
   --host=${CLFS_HOST} \
+  --target=${CLFS_TARGET} \
   --with-sysroot=${CLFS}/cross-tools/${CLFS_TARGET} \
   --disable-nls \
   --enable-languages=c \
diff --git a/BOOK/cross-tools/mips/gcc-final.xml b/BOOK/cross-tools/mips/gcc-final.xml
index 92b7c13..4938eaa 100644
--- a/BOOK/cross-tools/mips/gcc-final.xml
+++ b/BOOK/cross-tools/mips/gcc-final.xml
@@ -51,8 +51,8 @@
 <screen os="ae"><userinput>../gcc-&gcc-version;/configure \
   --prefix=${CLFS}/cross-tools \
   --build=${CLFS_HOST} \
-  --target=${CLFS_TARGET} \
   --host=${CLFS_HOST} \
+  --target=${CLFS_TARGET} \
   --with-sysroot=${CLFS}/cross-tools/${CLFS_TARGET} \
   --disable-nls \
   --enable-languages=c \
diff --git a/BOOK/cross-tools/x86/gcc-final.xml b/BOOK/cross-tools/x86/gcc-final.xml
index 0887a06..62b2cde 100644
--- a/BOOK/cross-tools/x86/gcc-final.xml
+++ b/BOOK/cross-tools/x86/gcc-final.xml
@@ -51,8 +51,8 @@
 <screen os="ae"><userinput>../gcc-&gcc-version;/configure \
   --prefix=${CLFS}/cross-tools \
   --build=${CLFS_HOST} \
-  --target=${CLFS_TARGET} \
   --host=${CLFS_HOST} \
+  --target=${CLFS_TARGET} \
   --with-sysroot=${CLFS}/cross-tools/${CLFS_TARGET} \
   --disable-nls \
   --enable-languages=c \

commit 2ac72a815339adc4a8d61efeba94974de07a8557
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Thu May 4 14:42:19 2017 -0400

    bootscripts/profile: Fix typo
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing this typo out.

diff --git a/BOOK/bootscripts/common/profile.xml b/BOOK/bootscripts/common/profile.xml
index b640aea..263d012 100644
--- a/BOOK/bootscripts/common/profile.xml
+++ b/BOOK/bootscripts/common/profile.xml
@@ -14,7 +14,7 @@
     <primary sortas="e-/etc/profile">/etc/profile</primary>
   </indexterm>
 
-  <para>Is the file that specifices how to your environment will function.</para>
+  <para>Is the file that specifices how your environment will function.</para>
 
   <para os="a">Now we will create the profile file for use with our system:</para>
 

commit 06c81a1a7c20495e74a76bbdfef4c1b1c5b8ae82
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Mon May 1 12:44:55 2017 -0400

    bootable/kernel: Fix 'without' typo
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing this out.

diff --git a/BOOK/bootable/common/kernel.xml b/BOOK/bootable/common/kernel.xml
index f159c4c..392c4d4 100644
--- a/BOOK/bootable/common/kernel.xml
+++ b/BOOK/bootable/common/kernel.xml
@@ -42,7 +42,7 @@
 
     <note os="f"><para>Since you are building for an embedded system make sure
         all key components are built into the kernel and not as modules. The key
-        components are console/video, disk, and network. With out these built
+        components are console/video, disk, and network. Without these built
         in, the system will not function properly. It is recommended to
         configure the kernel without modules in order to conserve disk space
         and to reduce the complexity of booting.</para></note>

commit 40d238ab7c8a6e62427e661ea8ffd0bffbb1019f
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Mon May 1 12:43:45 2017 -0400

    final-syste/busybox: Fix Note about menuconfig grammar
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing this out.

diff --git a/BOOK/final-system/common/busybox.xml b/BOOK/final-system/common/busybox.xml
index 6676471..60c1361 100644
--- a/BOOK/final-system/common/busybox.xml
+++ b/BOOK/final-system/common/busybox.xml
@@ -35,7 +35,7 @@
 <screen os="b"><userinput>make distclean</userinput></screen>
 
     <note os="e"> <para>We tell BusyBox to use the generic defconfig.  For those
-        for more adventurous, you can use <command>make menuconfig</command>,
+        who are more adventurous, you can use <command>make menuconfig</command>,
         and create a custom or modified configuration for your build.</para>
     </note>
 

commit 8704f34393222a923cc57f2f2212b25a17f90a50
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Mon May 1 10:47:03 2017 -0400

    cross-tools/binutils: Cleanup --target= description
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing out that this was
    unclearly referring to a --host= when we simply rely on the inferred
    finding for --host= and --build= as both will be the host machine.

diff --git a/BOOK/cross-tools/common/binutils.xml b/BOOK/cross-tools/common/binutils.xml
index 44973fd..7456ab1 100644
--- a/BOOK/cross-tools/common/binutils.xml
+++ b/BOOK/cross-tools/common/binutils.xml
@@ -61,9 +61,8 @@ cd ../binutils-build</userinput></screen>
       <varlistentry os="f3">
         <term><parameter>--target=${CLFS_TARGET}</parameter></term>
         <listitem>
-          <para>When used with --host, this creates a cross-architecture
-          executable that creates files for ${CLFS_TARGET} but runs on
-          the host system.</para>
+          <para>This creates a cross-architecture executable that creates files
+            for ${CLFS_TARGET} but runs on the host system.</para>
         </listitem>
       </varlistentry>
 

commit 83a31c36aea7aa147c6c0ea9ac766d316ba90f94
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Mon May 1 10:44:06 2017 -0400

    final-system/creatingdirs: Update FHS link
    
    Seems the Linux Foundation hosts the newer revisions of the FHS.  Thanks
    to akhiezer <lfs65 at cruziero.com> for pointing this out.

diff --git a/BOOK/final-system/common/creatingdirs.xml b/BOOK/final-system/common/creatingdirs.xml
index 43db6db..e41da0c 100644
--- a/BOOK/final-system/common/creatingdirs.xml
+++ b/BOOK/final-system/common/creatingdirs.xml
@@ -39,7 +39,7 @@ mkdir -pv ${CLFS}/targetfs/usr/{,local/}{bin,include,lib,sbin,share,src}</userin
     <title>FHS Compliance Note</title>
 
     <para>The directory tree is based on the Filesystem Hierarchy Standard (FHS)
-    (available at <ulink url="http://www.pathname.com/fhs/"/>).</para>
+    (available at <ulink url="http://refspecs.linuxfoundation.org/fhs.shtml"/>).</para>
 
   </sect2>
 

commit 73d79973ec4415776e3ecd3c7602d6879772cb56
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 28 13:50:04 2017 -0400

    bootscripts/inittab: Fixup ttyS0 getty comment for clarity
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing out the incorrect
    version of 'your' being used.

diff --git a/BOOK/bootscripts/common/inittab.xml b/BOOK/bootscripts/common/inittab.xml
index 809ac9d..bb82597 100644
--- a/BOOK/bootscripts/common/inittab.xml
+++ b/BOOK/bootscripts/common/inittab.xml
@@ -33,8 +33,9 @@ tty4::respawn:/sbin/getty 38400 tty4
 tty5::respawn:/sbin/getty 38400 tty5
 tty6::respawn:/sbin/getty 38400 tty6
 
-# Put a getty on the serial line (for a terminal)
-# uncomment this line if your using a serial console
+# Put a getty on the serial line (for a terminal).  Uncomment this line if
+# you're using a serial console on ttyS0, or uncomment and adjust it if using a
+# serial console on a different serial port.
 #::respawn:/sbin/getty -L ttyS0 115200 vt100
 
 ::shutdown:/etc/rc.d/shutdown

commit 2d6f66baae660ef4cfa37fcb4d08fb83466cc524
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Apr 26 06:00:15 2017 -0400

    final-system/busybox: Clarify and commonize depmod.pl install
    
    Clarify that the host needs be able to run depmod and then when
    installing depmod to cross-tools, use verbose options so we get a nice
    printout of what's done like every other time we use cp or chmod.

diff --git a/BOOK/final-system/common/busybox.xml b/BOOK/final-system/common/busybox.xml
index 38a96c4..6676471 100644
--- a/BOOK/final-system/common/busybox.xml
+++ b/BOOK/final-system/common/busybox.xml
@@ -72,10 +72,11 @@ sed -i 's/\(CONFIG_TCPSVD\)=y/# \1 is not set/' .config</userinput></screen>
   CONFIG_PREFIX="${CLFS}/targetfs" install</userinput></screen>
 
     <para os="l">If you're going to build your kernel with modules, you will need
-    to make sure <command>depmod.pl</command> is available:</para>
+    to make sure <command>depmod.pl</command> is available for your host to
+    execute:</para>
 
-<screen os="m"><userinput>cp examples/depmod.pl ${CLFS}/cross-tools/bin
-chmod 755 ${CLFS}/cross-tools/bin/depmod.pl</userinput></screen>
+<screen os="m"><userinput>cp -v examples/depmod.pl ${CLFS}/cross-tools/bin
+chmod -v 755 ${CLFS}/cross-tools/bin/depmod.pl</userinput></screen>
 
   </sect2>
 

commit a67ab5796e492f5521396e3151b4c9850a5e63a7
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Apr 26 05:57:19 2017 -0400

    final-system/busybox: Always put 'make' at the start of the command line
    
    This tells make to set these internal to it variables rather than having
    the shell set the variables and then launch make.  This is slightly
    safer and works correctly.

diff --git a/BOOK/final-system/common/busybox.xml b/BOOK/final-system/common/busybox.xml
index f22366e..38a96c4 100644
--- a/BOOK/final-system/common/busybox.xml
+++ b/BOOK/final-system/common/busybox.xml
@@ -42,7 +42,7 @@
     <para os="f">The following tells BusyBox to use the default
       configuration:</para>
 
-<screen os="g"><userinput>ARCH="${CLFS_ARCH}" make defconfig</userinput></screen>
+<screen os="g"><userinput>make ARCH="${CLFS_ARCH}" defconfig</userinput></screen>
 
     <para os="fa">Disable building both ifplugd and inetd as they both have
       issues building against musl:</para>
@@ -64,11 +64,11 @@ sed -i 's/\(CONFIG_TCPSVD\)=y/# \1 is not set/' .config</userinput></screen>
 
     <para os="h">Compile the package:</para>
 
-<screen os="i"><userinput>ARCH="${CLFS_ARCH}" CROSS_COMPILE="${CLFS_TARGET}-" make</userinput></screen>
+<screen os="i"><userinput>make ARCH="${CLFS_ARCH}" CROSS_COMPILE="${CLFS_TARGET}-"</userinput></screen>
 
     <para os="j">Install the package:</para>
 
-<screen os="k"><userinput>ARCH="${CLFS_ARCH}" CROSS_COMPILE="${CLFS_TARGET}-" make  \
+<screen os="k"><userinput>make ARCH="${CLFS_ARCH}" CROSS_COMPILE="${CLFS_TARGET}-"\
   CONFIG_PREFIX="${CLFS}/targetfs" install</userinput></screen>
 
     <para os="l">If you're going to build your kernel with modules, you will need

commit 7f6542c9d0a163283edc0e9176b3249df75b747d
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Apr 26 05:56:43 2017 -0400

    final-system/introduction: Clarify parallel compiling concern
    
    Using 'make -j 2' is OK, compiling busybox and musl at the same time is
    not.

diff --git a/BOOK/final-system/common/introduction.xml b/BOOK/final-system/common/introduction.xml
index 616768c..1563a35 100644
--- a/BOOK/final-system/common/introduction.xml
+++ b/BOOK/final-system/common/introduction.xml
@@ -25,10 +25,13 @@
   be strictly followed to ensure that no program accidentally acquires a
   path referring to <filename class="directory">${CLFS}/cross-tools</filename>
   hard-wired into it. For the same reason, do not compile packages in
-  parallel. Compiling in parallel may save time (especially on dual-CPU
-  machines), but it could result in a program containing a hard-wired
+  parallel. Compiling more than one package at a time may save time,
+  but it could result in a program containing a hard-wired
   path to <filename class="directory">${CLFS}/cross-tools</filename>, which will
   cause the program to stop working when that directory is
   removed.</para>
 
+  <para os="c">Compiling any single package using make's parallel job execution
+    option, "-j" is OK if you want to speed up compiling any one package.</para>
+
 </sect1>

commit b74d39b8093d64a9ba00912dd74a0803ce15d107
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Apr 26 05:43:04 2017 -0400

    final-system/creatingfiles: s/Udev/BusyBox/ as we don't use udev
    
    BusyBox dictates our user and group needs, not udev, we don't use udev.

diff --git a/BOOK/final-system/common/creatingfiles.xml b/BOOK/final-system/common/creatingfiles.xml
index 5f873d0..945b8a7 100644
--- a/BOOK/final-system/common/creatingfiles.xml
+++ b/BOOK/final-system/common/creatingfiles.xml
@@ -207,7 +207,7 @@ EOF</userinput></screen>
   </variablelist>
 
   <para>The created groups are not part of any standard—they are groups
-  decided on in part by the requirements of the Udev configuration in this
+  decided on in part by the requirements of BusyBox later in this
   chapter, and in part by common convention employed by a number of existing
   Linux distributions. The Linux Standard Base (LSB, available at <ulink
   url="http://www.linuxbase.org"/>) recommends only that, besides the group

commit e1ede421a9d08bff031ea2663fa81d46ea1cb64a
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 21 06:41:27 2017 -0400

    cross-tools/libc: Remove defining CC variable
    
    Since we now specify CROSS_COMPILE, musl's configure and Makefile setup
    will correctly define CC for us, no need to specify it ourselves.

diff --git a/BOOK/cross-tools/common/libc.xml b/BOOK/cross-tools/common/libc.xml
index b5dc07a..fdf8922 100644
--- a/BOOK/cross-tools/common/libc.xml
+++ b/BOOK/cross-tools/common/libc.xml
@@ -30,14 +30,14 @@
 
     <para os="h">Configure the package:</para>
 
-<screen os="i"><userinput>CC=${CLFS_TARGET}-gcc ./configure \
+<screen os="i"><userinput>./configure \
   CROSS_COMPILE=${CLFS_TARGET}- \
   --prefix=/ \
   --target=${CLFS_TARGET}</userinput></screen>
 
     <para os="h">Compile the package:</para>
 
-<screen os="i"><userinput>CC=${CLFS_TARGET}-gcc make</userinput></screen>
+<screen os="i"><userinput>make</userinput></screen>
 
     <para os="l">Install the package:</para>
 

commit 82ad5902ebe18cc2f0d6f8413987754c8d335e69
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 21 06:21:01 2017 -0400

    cross-tools/sysroot: Change section title to say Cross Tools
    
    Since we actually create 2 different sysroot directories, we should be
    clear that this one is for the cross tools sysroot.

diff --git a/BOOK/cross-tools/common/sysroot.xml b/BOOK/cross-tools/common/sysroot.xml
index 5202c04..a22fffb 100644
--- a/BOOK/cross-tools/common/sysroot.xml
+++ b/BOOK/cross-tools/common/sysroot.xml
@@ -8,7 +8,7 @@
 <sect1 id="ch-cross-tools-sysroot">
   <?dbhtml filename="sysroot.html"?>
 
-  <title>Create the Sysroot Directory</title>
+  <title>Create the Cross Tools Sysroot Directory</title>
 
   <para>Create a sysroot directory which will be used when building the cross
     compiler and link its <filename class="directory">usr</filename> directory

commit e065f44f41d4a23837ca48966028495719ae244e
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 21 06:12:47 2017 -0400

    materials/creatingbuilddir: Mention possible need to be root
    
    Just so that people have a heads up about this.

diff --git a/BOOK/materials/common/creatingbuilddir.xml b/BOOK/materials/common/creatingbuilddir.xml
index e180a1e..60e71e1 100644
--- a/BOOK/materials/common/creatingbuilddir.xml
+++ b/BOOK/materials/common/creatingbuilddir.xml
@@ -10,8 +10,9 @@
 
   <title>Creating Build and Sources Directories</title>
 
-  <para> Create a directory for the CLFS build (the exact location is up to
-    you): </para>
+  <para> Create a directory for the CLFS build.  The exact location is up to you
+    but depending on the location you choose, you may need to do this as the
+    root user: </para>
 
 <screen><userinput>mkdir -p /mnt/clfs</userinput></screen>
 
@@ -20,7 +21,9 @@
 <screen><userinput>export CLFS=/mnt/clfs</userinput></screen>
 
   <para>Ensure that this new directory has permissions that are not too
-    restrictive such that you can write to it as a non-root user.</para>
+    restrictive such that you can write to it as a non-root user.  Depending on
+    the location of the <envar>CLFS</envar> directory, you may need to do this
+    as the root user:</para>
 
 <screen><userinput>chmod 777 ${CLFS}</userinput></screen>
 

commit ccc6724689550b286950ed60abb30dd5882c8d89
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Apr 19 08:28:36 2017 -0400

    beyond/wireless_tools: Fix lack of space after comma typo
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing this out.

diff --git a/BOOK/beyond/common/wireless_tools.xml b/BOOK/beyond/common/wireless_tools.xml
index 342b4d3..083c91e 100644
--- a/BOOK/beyond/common/wireless_tools.xml
+++ b/BOOK/beyond/common/wireless_tools.xml
@@ -59,7 +59,7 @@ sed -i s/ranlib/\$\{CLFS\_TARGET\}\-ranlib/g Makefile</userinput></screen>
       <segtitle>Installed libraries</segtitle>
 
       <seglistitem>
-        <seg>iwconfig, iwevent, iwgetid, iwlist,iwpriv, and iwspy</seg>
+        <seg>iwconfig, iwevent, iwgetid, iwlist, iwpriv, and iwspy</seg>
         <seg>libiw.so</seg>
       </seglistitem>
     </segmentedlist>

commit 6590da60c33fccf2381a4451f07aa47142246b30
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Apr 19 08:27:08 2017 -0400

    final-sys/creatingfiles: Remove duplicate "is" typo
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing this out.

diff --git a/BOOK/final-system/common/creatingfiles.xml b/BOOK/final-system/common/creatingfiles.xml
index b82d6f3..5f873d0 100644
--- a/BOOK/final-system/common/creatingfiles.xml
+++ b/BOOK/final-system/common/creatingfiles.xml
@@ -36,7 +36,7 @@
 
   <para>A proper Linux system maintains a list of the mounted file systems in
   the file <filename>/etc/mtab</filename>.  With the way our embedded system is
-  is designed, we will be using a symlink to <filename>/proc/mounts</filename>:</para>
+  designed, we will be using a symlink to <filename>/proc/mounts</filename>:</para>
 
 <screen><userinput>ln -svf ../proc/mounts ${CLFS}/targetfs/etc/mtab</userinput></screen>
  

commit c4d9f4b2e939b7c029ef387c0a86ee665a27931f
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Apr 19 08:24:10 2017 -0400

    final-sys/creatingdirs: Create /var/tmp
    
    There is a description of the permissions set for /var/tmp but it is not
    actually created, nor does it have its permissions set to match the
    description.  Fix this so that the actions match the description.
    
    Thanks to akhiezer <lfs65 at cruziero.com> for pointing this out.

diff --git a/BOOK/final-system/common/creatingdirs.xml b/BOOK/final-system/common/creatingdirs.xml
index bb1a621..43db6db 100644
--- a/BOOK/final-system/common/creatingdirs.xml
+++ b/BOOK/final-system/common/creatingdirs.xml
@@ -17,7 +17,7 @@
 mkdir -pv ${CLFS}/targetfs/{mnt,opt,proc,sbin,srv,sys}
 mkdir -pv ${CLFS}/targetfs/var/{cache,lib,local,lock,log,opt,run,spool}
 install -dv -m 0750 ${CLFS}/targetfs/root
-install -dv -m 1777 ${CLFS}/targetfs/tmp
+install -dv -m 1777 ${CLFS}/targetfs/{var/,}tmp
 mkdir -pv ${CLFS}/targetfs/usr/{,local/}{bin,include,lib,sbin,share,src}</userinput></screen>
 
   <para>Directories are, by default, created with permission mode 755, but

commit e1348bba3de996abb60aed68009ea663148baf66
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 14 06:23:29 2017 -0400

    preface: Fix BusyBox typo

diff --git a/BOOK/preface/common/organization.xml b/BOOK/preface/common/organization.xml
index d5d9f75..8b79369 100644
--- a/BOOK/preface/common/organization.xml
+++ b/BOOK/preface/common/organization.xml
@@ -41,7 +41,7 @@
     <title>Part IV - Building the CLFS System</title>
 
     <para>Part IV shows you how to build the core CLFS system.  Compiling
-    and installing Buxybox and other required packages, making the system
+    and installing BusyBox and other required packages, making the system
     bootable, setting up the bootscripts, and installing a bootloader.</para>
 
   </sect2>

commit 1f12b5df9085ab871ab2d85cb824fefb2015397b
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 14 06:20:11 2017 -0400

    packages.ent: Update Linux to v4.9.22
    
    Latest stable longterm release.

diff --git a/BOOK/packages.ent b/BOOK/packages.ent
index 24d882a..01182f8 100644
--- a/BOOK/packages.ent
+++ b/BOOK/packages.ent
@@ -41,10 +41,10 @@
 <!ENTITY iana-etc-home "http://sethwklein.net/iana-etc">
 
 <!ENTITY linux-dl-version "4.x">
-<!ENTITY linux-version "4.4.21">
-<!ENTITY linux-size "85306 KB">
+<!ENTITY linux-version "4.9.22">
+<!ENTITY linux-size "91034 KB">
 <!ENTITY linux-url "&kernel;linux/kernel/v&linux-dl-version;/linux-&linux-version;.tar.xz">
-<!ENTITY linux-md5 "9a59fa5f60f47aab78aaa5f0691b24a2">
+<!ENTITY linux-md5 "b6390b3abc02ef4986644fb7051b4568">
 <!ENTITY linux-home "http://www.kernel.org">
 
 <!ENTITY mpc-version "1.0.3">

commit 4d9350dee0d652a166f532945862327611d628ad
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 14 06:17:31 2017 -0400

    final-system: Create new section to install musl, again
    
    This time it installs into the targetfs sysroot, as we've told the
    compiler and linker to use the targetfs sysroot for their header and
    library search needs.

diff --git a/BOOK/final-system/chapter.xml b/BOOK/final-system/chapter.xml
index f97bcff..c18523c 100644
--- a/BOOK/final-system/chapter.xml
+++ b/BOOK/final-system/chapter.xml
@@ -14,6 +14,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/introduction.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/creatingdirs.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/creatingfiles.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/libc.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/busybox.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/iana-etc.xml"/>
 
diff --git a/BOOK/final-system/common/libc.xml b/BOOK/final-system/common/libc.xml
new file mode 100644
index 0000000..665e5be
--- /dev/null
+++ b/BOOK/final-system/common/libc.xml
@@ -0,0 +1,57 @@
+<?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-final-system-libc" role="wrap">
+  <?dbhtml filename="libc.html"?>
+
+  <title>musl-&musl-version;</title>
+
+  <indexterm zone="ch-final-system-libc">
+    <primary sortas="a-libc">musl</primary>
+    <secondary>final system</secondary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title/>
+
+    <para>The musl package contains the main C library. This library provides
+    the basic routines for allocating memory, searching directories, opening and
+    closing files, reading and writing files, string handling, pattern matching,
+    arithmetic, and so on.  We build it again here so that it can be installed
+    into our targetfs sysroot.</para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of musl</title>
+
+    <para os="h">Configure the package:</para>
+
+<screen os="i"><userinput>./configure \
+  CROSS_COMPILE=${CLFS_TARGET}- \
+  --prefix=/ \
+  --target=${CLFS_TARGET}</userinput></screen>
+
+    <para os="h">Compile the package:</para>
+
+<screen os="i"><userinput>make</userinput></screen>
+
+    <para os="l">Install the package:</para>
+
+<screen os="j"><userinput>DESTDIR=${CLFS}/targetfs make install</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title/>
+
+    <para>Details on this package are located in
+      <xref linkend="contents-musl" role="."/></para>
+
+  </sect2>
+
+</sect1>

commit 1dfe239904de2fdc9ba43efc698d0e9b7af0d251
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 14 06:07:36 2017 -0400

    cross-tools/toolchain: Use --sysroot= for CC, CXX, and LD
    
    This allows the compiler and linker to use the targetfs directory
    structure as the sysroot for compiling but will mean that we have to
    build musl one more time in the final-system chapter.

diff --git a/BOOK/cross-tools/common/toolchain.xml b/BOOK/cross-tools/common/toolchain.xml
index bd98da4..a614dcb 100644
--- a/BOOK/cross-tools/common/toolchain.xml
+++ b/BOOK/cross-tools/common/toolchain.xml
@@ -10,14 +10,17 @@
 
   <title>ToolChain Variables</title>
 
-  <para>Setup target-specific variables for the compiler
-  and linkers. This time we keep them:</para>
+  <para>Setup target-specific variables for the compiler, linker, and other
+    compile-time tools.  For the compiler and linker, use the target file system
+    directory as a sysroot rather than the sysroot we setup before for the
+    cross-tools. This time we write them to <filename>~/.bashrc</filename> so
+    that they persist even if the clfs user logs out:</para>
 
-<screen><userinput>echo <literal>export CC=\""${CLFS_TARGET}-gcc\""</literal> >> ~/.bashrc
-echo <literal>export CXX=\""${CLFS_TARGET}-g++\""</literal> >> ~/.bashrc
+<screen><userinput>echo <literal>export CC=\""${CLFS_TARGET}-gcc --sysroot=${CLFS}/targetfs\""</literal> >> ~/.bashrc
+echo <literal>export CXX=\""${CLFS_TARGET}-g++ --sysroot=${CLFS}/targetfs\""</literal> >> ~/.bashrc
 echo <literal>export AR=\""${CLFS_TARGET}-ar\""</literal> >> ~/.bashrc
 echo <literal>export AS=\""${CLFS_TARGET}-as\""</literal> >> ~/.bashrc
-echo <literal>export LD=\""${CLFS_TARGET}-ld\""</literal> >> ~/.bashrc
+echo <literal>export LD=\""${CLFS_TARGET}-ld --sysroot=${CLFS}/targetfs\""</literal> >> ~/.bashrc
 echo <literal>export RANLIB=\""${CLFS_TARGET}-ranlib\""</literal> >> ~/.bashrc
 echo <literal>export READELF=\""${CLFS_TARGET}-readelf\""</literal> >> ~/.bashrc
 echo <literal>export STRIP=\""${CLFS_TARGET}-strip\""</literal> >> ~/.bashrc

commit a3957dd881d3e0e0eecf1ea6fd19a00b249ec0c5
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 14 05:56:58 2017 -0400

    cross-tools: Create a targetfs dir
    
    Do this before we set the toolchain variables for the clfs user in their
    .bashrc file so that we can pass the "--sysroot=" option to use this
    targetfs dir as the root file system for compiling.
    
    We will need to install musl into the targetfs in a future commit.

diff --git a/BOOK/cross-tools/arm-chapter.xml b/BOOK/cross-tools/arm-chapter.xml
index a4e460c..2e73469 100644
--- a/BOOK/cross-tools/arm-chapter.xml
+++ b/BOOK/cross-tools/arm-chapter.xml
@@ -20,6 +20,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="arm/gcc-static.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/libc.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="arm/gcc-final.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/create-targetfs.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/toolchain.xml"/>
 
 </chapter>
diff --git a/BOOK/cross-tools/common/create-targetfs.xml b/BOOK/cross-tools/common/create-targetfs.xml
new file mode 100644
index 0000000..b1428fe
--- /dev/null
+++ b/BOOK/cross-tools/common/create-targetfs.xml
@@ -0,0 +1,19 @@
+<?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-cross-tools-create-targetfs">
+  <?dbhtml filename="create-targetfs.html"?>
+
+  <title>Create the Target File System Directory</title>
+
+  <para>Create a target file system directory which will be used when building
+    the programs and libraries which will deploy to the target system:</para>
+
+<screen><userinput>mkdir -pv ${CLFS}/targetfs</userinput></screen>
+
+</sect1>
+

commit a5d6c2377116cb70eb443f2dc0198143dbb7b54b
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Apr 14 05:48:26 2017 -0400

    packages.ent: Update musl to version 1.1.16

diff --git a/BOOK/packages.ent b/BOOK/packages.ent
index 3981f75..24d882a 100644
--- a/BOOK/packages.ent
+++ b/BOOK/packages.ent
@@ -59,10 +59,10 @@
 <!ENTITY mpfr-md5 "b8a2f6b0e68bef46e53da2ac439e1cf4">
 <!ENTITY mpfr-home "http://www.mpfr.org/">
 
-<!ENTITY musl-version "1.1.15">
-<!ENTITY musl-size "891 KB">
+<!ENTITY musl-version "1.1.16">
+<!ENTITY musl-size "906 KB">
 <!ENTITY musl-url "http://www.musl-libc.org/releases/musl-&musl-version;.tar.gz">
-<!ENTITY musl-md5 "9590a9d47ee64f220b3c12f7afb864ca">
+<!ENTITY musl-md5 "ac52ccaec6b06ab0f289d37e8436859b">
 <!ENTITY musl-home "http://musl-libc.org/">
 
 <!-- Beyond CLFS library packages -->

commit 5a5d7ef5458a5ab28183f0f5a53af28b3c997db7
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Fri Nov 14 13:02:13 2014 -0500

    libc: Use CROSS_COMPILE to use cross-binutils
    
    As reported by selk on IRC.
    
    Without setting the CROSS_COMPILE variable, potentially the host's
    binutils may be used.  Usage of CC is also needed, so is kept.

diff --git a/BOOK/cross-tools/common/libc.xml b/BOOK/cross-tools/common/libc.xml
index c69e560..b5dc07a 100644
--- a/BOOK/cross-tools/common/libc.xml
+++ b/BOOK/cross-tools/common/libc.xml
@@ -31,6 +31,7 @@
     <para os="h">Configure the package:</para>
 
 <screen os="i"><userinput>CC=${CLFS_TARGET}-gcc ./configure \
+  CROSS_COMPILE=${CLFS_TARGET}- \
   --prefix=/ \
   --target=${CLFS_TARGET}</userinput></screen>
 

-----------------------------------------------------------------------

Summary of changes:
 BOOK/INSTALL.md                                    |    2 +-
 BOOK/beyond/common/dropbear.xml                    |    4 +-
 BOOK/beyond/common/wireless_tools.xml              |    2 +-
 BOOK/beyond/common/zlib.xml                        |    8 ++-
 BOOK/bootable/common/fstab.xml                     |   18 ++----
 BOOK/bootable/common/kernel.xml                    |    2 +-
 BOOK/bootscripts/common/inittab.xml                |    5 +-
 BOOK/bootscripts/common/profile.xml                |    4 +-
 BOOK/cleanup/chapter.xml                           |    1 -
 BOOK/cleanup/chowning.xml                          |    6 +-
 BOOK/cleanup/copylibs.xml                          |   23 --------
 BOOK/cross-tools/arm-chapter.xml                   |    1 +
 BOOK/cross-tools/arm/gcc-final.xml                 |    2 +-
 BOOK/cross-tools/common/binutils.xml               |    5 +-
 BOOK/cross-tools/common/create-targetfs.xml        |   19 ++++++
 BOOK/cross-tools/common/gcc-final.xml              |    2 +-
 BOOK/cross-tools/common/libc.xml                   |    5 +-
 BOOK/cross-tools/common/sysroot.xml                |    2 +-
 BOOK/cross-tools/common/toolchain.xml              |   13 +++--
 BOOK/cross-tools/mips/gcc-final.xml                |    2 +-
 BOOK/cross-tools/x86/gcc-final.xml                 |    2 +-
 BOOK/final-preps/addinguser.xml                    |    7 +-
 BOOK/final-system/chapter.xml                      |    2 +
 BOOK/final-system/common/busybox.xml               |   15 +++--
 BOOK/final-system/common/creatingdirs.xml          |    4 +-
 BOOK/final-system/common/creatingfiles.xml         |   37 +++---------
 BOOK/final-system/common/introduction.xml          |    7 ++-
 BOOK/final-system/common/libc.xml                  |   59 +++++++++++++++++++
 BOOK/final-system/common/libgcc.xml                |   41 +++++++++++++
 BOOK/general.ent                                   |    8 +-
 BOOK/materials/common/creatingbuilddir.xml         |   13 +++--
 BOOK/packages.ent                                  |   14 ++--
 BOOK/preface/common/changelog.xml                  |   24 ++++++++
 BOOK/preface/common/organization.xml               |    2 +-
 .../lfs-xsl/docbook-xsl-snapshot/VERSION           |   60 ++++++++++----------
 BOOK/stylesheets/lfs-xsl/pdf.xsl                   |    2 +-
 BOOK/the-end/whatnow.xml                           |    7 --
 37 files changed, 269 insertions(+), 161 deletions(-)
 delete mode 100644 BOOK/cleanup/copylibs.xml
 create mode 100644 BOOK/cross-tools/common/create-targetfs.xml
 create mode 100644 BOOK/final-system/common/libc.xml
 create mode 100644 BOOK/final-system/common/libgcc.xml


hooks/post-receive
-- 
Cross-LFS Embedded Book



More information about the Clfs-commits mailing list