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

git git at cross-lfs.org
Wed Mar 23 15:47:52 PDT 2011


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  2ef84660d2aeacafaad9b61df91b2b18d76e41b1 (commit)
       via  a7230636620c1b3b5a45823544f312d8f16a724b (commit)
       via  1897712d60a8400dfbe4c6da5cddb7a8c0d4e68b (commit)
       via  3e496b8448b22a5fc305f7d418ba888873b77992 (commit)
       via  2a0b49e525707bca324ef63c8ef634ecff39daae (commit)
       via  373cf47364db9d8aa6d1dce8503c30bce76edb2f (commit)
       via  08718a41c516aff0a0e02a8267b0190b456f0d9d (commit)
      from  3961d27a054872cb10b1948288d6f5dd27bd99d9 (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 2ef84660d2aeacafaad9b61df91b2b18d76e41b1
Author: Andrew Bradford <bradfa at gmail.com>
Date:   Tue Mar 22 06:53:32 2011 -0400

    Added ${CLFS}-final/build dir to be rm'ed
    
    In the Copy to Target section, a $CLFS/build directory is created.
    Should this not be the first time you do the Remove Unnecessary Files
    section, a $CLFS/build directory will exist.  Need to ensure it gets
    deleted from ${CLFS}-final/ since it contains tarballs that aren't needed
    on the final system.

diff --git a/BOOK/cleanup/remove-files.xml b/BOOK/cleanup/remove-files.xml
index 3da1810..5b6bf54 100644
--- a/BOOK/cleanup/remove-files.xml
+++ b/BOOK/cleanup/remove-files.xml
@@ -25,7 +25,8 @@ cp -arv ${CLFS}/* ${CLFS}-final/</userinput></screen>
 rm -rfv ${CLFS}-final/usr/src/*
 rm -rfv ${CLFS}-final/usr/include
 rm -rfv ${CLFS}-final/usr/man
-rm -rfv ${CLFS}-final/usr/share/man</userinput></screen>
+rm -rfv ${CLFS}-final/usr/share/man
+rm -rfv ${CLFS}-final/build</userinput></screen>
 
   <para>Remove the static libaries:</para>
 

commit a7230636620c1b3b5a45823544f312d8f16a724b
Author: Andrew Bradford <bradfa at gmail.com>
Date:   Tue Mar 22 06:49:38 2011 -0400

    Moved chowning.xml to cleanup chapter, edited it
    
    Moved bootable/common/chowning.xml to the cleanup chapter as that's a
    more appropriate place for it.  Chowning everything to root should only
    happen to the ${CLFS}-final directory (our copy) so as to not disrupt
    the ability to go back and compile more packages as clfs user.
    
    Also edited chowning.xml to only operate on the ${CLFS}-final directory
    and to update chgrp command to use group "13" rather than "utmp" since
    utmp group may not be group 13 on the build machine.

diff --git a/BOOK/cleanup/chapter.xml b/BOOK/cleanup/chapter.xml
index 07e6b6b..f46980f 100644
--- a/BOOK/cleanup/chapter.xml
+++ b/BOOK/cleanup/chapter.xml
@@ -12,6 +12,7 @@
   <title>Backup and Cleanup</title>
 
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="remove-files.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"/>
 
 </chapter>
diff --git a/BOOK/bootable/common/chowning.xml b/BOOK/cleanup/chowning.xml
similarity index 58%
rename from BOOK/bootable/common/chowning.xml
rename to BOOK/cleanup/chowning.xml
index 9fc3648..f45a13c 100644
--- a/BOOK/bootable/common/chowning.xml
+++ b/BOOK/cleanup/chowning.xml
@@ -1,14 +1,14 @@
 <?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">
+  <!ENTITY % general-entities SYSTEM "../general.ent">
   %general-entities;
 ]>
 
 <sect1 id="ch-bootable-chowning">
   <?dbhtml filename="chowning.html"?>
 
-  <title>Changing the Ownership Of The CLFS System</title>
+  <title>Changing the Ownership of the CLFS System</title>
 
   <para>Throughout the book, every package has been compiled and installed as
   the <systemitem class="username">clfs</systemitem> user. The final system
@@ -16,7 +16,7 @@
 
   <important>
 
-    <para>The commands in the remainder of this book must be performed while
+    <para>The commands on this page of the book must be performed while
     logged in as <systemitem class="username">root</systemitem>. Check that
     ${CLFS} is still set:</para>
 
@@ -27,11 +27,12 @@
   <para>Make <systemitem class="username">root</systemitem> the owner of the
   entire CLFS system:</para>
 
-<screen><userinput>chown -Rv root:root ${CLFS}</userinput></screen>
+<screen><userinput>chown -Rv root:root ${CLFS}-final</userinput></screen>
 
-  <para>The following files are not to be owned by
-  <systemitem class="username">root</systemitem>:</para>
+  <para>The following files should not to belong to the
+  <systemitem class="groupname">root</systemitem> group, they should belong
+  to the <systemitem class="groupname">utmp</systemitem> group (group 13):</para>
 
-<screen><userinput>chgrp -v utmp ${CLFS}/var/run/utmp ${CLFS}/var/log/lastlog</userinput></screen>
+<screen><userinput>chgrp -v 13 ${CLFS}-final/var/run/utmp ${CLFS}-final/var/log/lastlog</userinput></screen>
 
 </sect1>

commit 1897712d60a8400dfbe4c6da5cddb7a8c0d4e68b
Author: Andrew Bradford <bradfa at gmail.com>
Date:   Mon Mar 21 07:35:04 2011 -0400

    Copy to Target tarball permissions preservation & grammar
    
    Permissions should be preserved when extracting the tarball to the target.
    Grammar cleanup & removal of blank line

diff --git a/BOOK/cleanup/copy-to-target.xml b/BOOK/cleanup/copy-to-target.xml
index 7309a97..28c5e88 100644
--- a/BOOK/cleanup/copy-to-target.xml
+++ b/BOOK/cleanup/copy-to-target.xml
@@ -11,17 +11,18 @@
   <title>Copy to Target</title>
 
   <para>We just created a cleaned-up version of our build, now
-  we can compress it so we can move it to our target.</para>
+  compress it so it can be archived and transferred to the target.</para>
 
-  <para>Let's Create A tarball of our build:</para>
+  <para>Create a tarball of the build:</para>
 
 <screen><userinput>install -dv ${CLFS}/build
 cd ${CLFS}-final
-tar jcfv ${CLFS}/build/clfs-embedded.tar.bz2 *
-</userinput></screen>
+tar jcfv ${CLFS}/build/clfs-embedded.tar.bz2 *</userinput></screen>
 
   <para>Now you can move your compressed tarball to your target
-  system. This is something that is going to be different on
-  every embedded device.</para>
+  system. This will be different on  every embedded device.</para>
+
+  <para>When uncompressing the tarball, make sure to pass tar the "-p"
+  switch to ensure permissions are preserved.</para>
 
 </sect1>

commit 3e496b8448b22a5fc305f7d418ba888873b77992
Author: Andrew Bradford <bradfa at gmail.com>
Date:   Mon Mar 21 07:28:51 2011 -0400

    Rename create-tarball to copy-to-target

diff --git a/BOOK/cleanup/chapter.xml b/BOOK/cleanup/chapter.xml
index bd46172..07e6b6b 100644
--- a/BOOK/cleanup/chapter.xml
+++ b/BOOK/cleanup/chapter.xml
@@ -12,6 +12,6 @@
   <title>Backup and Cleanup</title>
 
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="remove-files.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="create-tarball.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="copy-to-target.xml"/>
 
 </chapter>
diff --git a/BOOK/cleanup/create-tarball.xml b/BOOK/cleanup/copy-to-target.xml
similarity index 85%
rename from BOOK/cleanup/create-tarball.xml
rename to BOOK/cleanup/copy-to-target.xml
index 8cfcd0d..7309a97 100644
--- a/BOOK/cleanup/create-tarball.xml
+++ b/BOOK/cleanup/copy-to-target.xml
@@ -5,10 +5,10 @@
   %general-entities;
 ]>
 
-<sect1 id="ch-cleanup-create-tarball">
-  <?dbhtml filename="create-tarball.html"?>
+<sect1 id="ch-cleanup-copy-to-target">
+  <?dbhtml filename="copy-to-target.html"?>
 
-  <title>Create Tarball of Build</title>
+  <title>Copy to Target</title>
 
   <para>We just created a cleaned-up version of our build, now
   we can compress it so we can move it to our target.</para>

commit 2a0b49e525707bca324ef63c8ef634ecff39daae
Author: Andrew Bradford <bradfa at gmail.com>
Date:   Mon Mar 21 07:21:34 2011 -0400

    Slight rewording and grammar cleanup of remove-files.xml

diff --git a/BOOK/cleanup/remove-files.xml b/BOOK/cleanup/remove-files.xml
index 3838d6a..3da1810 100644
--- a/BOOK/cleanup/remove-files.xml
+++ b/BOOK/cleanup/remove-files.xml
@@ -10,16 +10,16 @@
 
   <title>Remove Unnecessary Files</title>
 
-  <para>Well we have this system finished, we can make it smaller by
-  removing files that are not necessary for our build. On this page
-  we remove the bloat from our build.</para>
+  <para>The system is almost finished.  It can be made smaller by removing
+  files that are not necessary.</para>
 
-  <para>Now let's create a backup of our build:</para>
+  <para>Create a copy of the file system in case changes need to be made
+  to it later:</para>
 
 <screen><userinput>install -dv ${CLFS}-final
 cp -arv ${CLFS}/* ${CLFS}-final/</userinput></screen>
 
-  <para>Let's remove the files we don't need anymore:</para>
+  <para>Remove files that aren't needed:</para>
 
 <screen><userinput>rm -rfv ${CLFS}-final/cross-tools
 rm -rfv ${CLFS}-final/usr/src/*
@@ -27,7 +27,7 @@ rm -rfv ${CLFS}-final/usr/include
 rm -rfv ${CLFS}-final/usr/man
 rm -rfv ${CLFS}-final/usr/share/man</userinput></screen>
 
-  <para>Let's remove the static libaries:</para>
+  <para>Remove the static libaries:</para>
 
 <screen><userinput>FILES="$(ls ${CLFS}-final/lib/*.a ${CLFS}-final/usr/lib/*.a)"
 for file in $FILES; do

commit 373cf47364db9d8aa6d1dce8503c30bce76edb2f
Author: Andrew Bradford <bradfa at gmail.com>
Date:   Mon Mar 21 06:17:03 2011 -0400

    Removed inclusion of chowning section
    
    Removed the inclusion of the bootable/common/chowning.xml section from
    all books.  It happens too early on embedded since we don't boot the
    target until pretty much the end of the book.  If you perform the chowning
    and then want to do anything else (fix something, do bclfs, etc), it has
    to be done as root rather than the "clfs" user.  That's not a good idea,
    too much risk of typing the wrong path and messing up the host.
    
    This does not delete the bootable/common/chowning.xml file, just stops it
    from being included.

diff --git a/BOOK/bootable/arm-chapter.xml b/BOOK/bootable/arm-chapter.xml
index 6a16ada..97daef7 100644
--- a/BOOK/bootable/arm-chapter.xml
+++ b/BOOK/bootable/arm-chapter.xml
@@ -14,6 +14,5 @@
   <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/fstab.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="arm/kernel.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/chowning.xml"/>
 
 </chapter>
diff --git a/BOOK/bootable/mips-chapter.xml b/BOOK/bootable/mips-chapter.xml
index 7f43de0..aeca479 100644
--- a/BOOK/bootable/mips-chapter.xml
+++ b/BOOK/bootable/mips-chapter.xml
@@ -14,6 +14,5 @@
   <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/fstab.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips/kernel.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/chowning.xml"/>
 
 </chapter>
diff --git a/BOOK/bootable/wrt-chapter.xml b/BOOK/bootable/wrt-chapter.xml
index 5721ae5..c549cd3 100644
--- a/BOOK/bootable/wrt-chapter.xml
+++ b/BOOK/bootable/wrt-chapter.xml
@@ -14,6 +14,5 @@
   <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/fstab.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wrt/kernel.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/chowning.xml"/>
 
 </chapter>
diff --git a/BOOK/bootable/x86-chapter.xml b/BOOK/bootable/x86-chapter.xml
index 0fbd264..fc30d35 100644
--- a/BOOK/bootable/x86-chapter.xml
+++ b/BOOK/bootable/x86-chapter.xml
@@ -14,6 +14,5 @@
   <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/fstab.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x86/kernel.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/chowning.xml"/>
 
 </chapter>

commit 08718a41c516aff0a0e02a8267b0190b456f0d9d
Author: Andrew Bradford <bradfa at gmail.com>
Date:   Mon Mar 21 06:05:57 2011 -0400

    Don't mknod /dev/console and /dev/null
    
    mdev will create both /dev/console and /dev/null for us automatically
    at boot time, so there's no reason to manually create them.

diff --git a/BOOK/bootable/common/chowning.xml b/BOOK/bootable/common/chowning.xml
index a4d141a..9fc3648 100644
--- a/BOOK/bootable/common/chowning.xml
+++ b/BOOK/bootable/common/chowning.xml
@@ -34,10 +34,4 @@
 
 <screen><userinput>chgrp -v utmp ${CLFS}/var/run/utmp ${CLFS}/var/log/lastlog</userinput></screen>
 
-  <para>The following device nodes need to be created for the system to
-  boot:</para>
-
-<screen><userinput>mknod -m 0666 ${CLFS}/dev/null c 1 3
-mknod -m 0600 ${CLFS}/dev/console c 5 1</userinput></screen>
-
 </sect1>

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

Summary of changes:
 BOOK/bootable/arm-chapter.xml                  |    1 -
 BOOK/bootable/mips-chapter.xml                 |    1 -
 BOOK/bootable/wrt-chapter.xml                  |    1 -
 BOOK/bootable/x86-chapter.xml                  |    1 -
 BOOK/cleanup/chapter.xml                       |    3 +-
 BOOK/{bootable/common => cleanup}/chowning.xml |   21 ++++++-----------
 BOOK/cleanup/copy-to-target.xml                |   28 ++++++++++++++++++++++++
 BOOK/cleanup/create-tarball.xml                |   27 -----------------------
 BOOK/cleanup/remove-files.xml                  |   15 ++++++------
 9 files changed, 46 insertions(+), 52 deletions(-)
 rename BOOK/{bootable/common => cleanup}/chowning.xml (54%)
 create mode 100644 BOOK/cleanup/copy-to-target.xml
 delete mode 100644 BOOK/cleanup/create-tarball.xml


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



More information about the Clfs-commits mailing list