[Clfs-commits] [Cross-LFS]Cross-LFS Book branch, systemd, updated. clfs-2.1.0-996-gb925729
git
git at cross-lfs.org
Sun May 11 11:47:08 PDT 2014
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 Book".
The branch, systemd has been updated
via b925729f3be30ac9dfcf8cb0c520884cfcfd8373 (commit)
from 9b519e232530f2584a2afa79c48d8cfcac5e2ba4 (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 b925729f3be30ac9dfcf8cb0c520884cfcfd8373
Author: Chris Staub <chris at beaker67.com>
Date: Sun May 11 14:47:04 2014 -0400
Added command explanations for symlinks
diff --git a/BOOK/boot/64/createfiles.xml b/BOOK/boot/64/createfiles.xml
index 0026ab3..7e689f6 100644
--- a/BOOK/boot/64/createfiles.xml
+++ b/BOOK/boot/64/createfiles.xml
@@ -20,18 +20,22 @@
href="../common/createfiles.xml"
xpointer="xpointer(//*[@os='b'])"/>
- <para os="e">To enable some C++ tests in the Glibc and Binutils testsuites
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c'])"/>
+
+ <para os="f">To enable some C++ tests in the Glibc and Binutils testsuites
to link, create a directory and make some symbolic links:</para>
-<screen os="f"><userinput>mkdir -pv ${CLFS}/usr/lib64
+<screen os="g"><userinput>mkdir -pv ${CLFS}/usr/lib64
ln -sv /tools/lib/libstdc++.so{.6,} ${CLFS}/usr/lib64</userinput></screen>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../common/createfiles.xml"
- xpointer="xpointer(//*[@os='c'])"/>
+ xpointer="xpointer(//*[@os='d'])"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../common/createfiles.xml"
- xpointer="xpointer(//*[@os='d'])"/>
+ xpointer="xpointer(//*[@os='e'])"/>
</sect1>
diff --git a/BOOK/boot/common/createfiles.xml b/BOOK/boot/common/createfiles.xml
index 860fa9f..4f35457 100644
--- a/BOOK/boot/common/createfiles.xml
+++ b/BOOK/boot/common/createfiles.xml
@@ -25,13 +25,136 @@ ln -sv ../run ${CLFS}/var/run
ln -sv /tools/sbin/init ${CLFS}/sbin
ln -sv /tools/etc/{login.{access,defs},limits} ${CLFS}/etc</userinput></screen>
- <para os="c">Historically, Linux maintains a list of the mounted file systems
+ <variablelist os="c">
+ <title>The purpose of each link:</title>
+
+ <varlistentry os="c1">
+ <term><parameter><filename>/bin/bash</filename></parameter></term>
+ <listitem>
+ <para>Many <command>bash</command> scripts specify
+ <filename>/bin/bash</filename>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c2">
+ <term><parameter><filename>/bin/cat</filename></parameter></term>
+ <listitem>
+ <para>This pathname is hard-coded into Glibc's configure script.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c3">
+ <term><parameter><filename>/bin/echo</filename></parameter></term>
+ <listitem>
+ <para>This is to satisfy one of the tests in Glibc's testsuite, which
+ will fail in <command>echo</command> is not found in
+ <filename class="directory">/bin</filename>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c4">
+ <term><parameter><filename>/bin/grep</filename></parameter></term>
+ <listitem>
+ <para>This to avoid a hard-coded
+ <filename class="directory">/tools</filename> reference in Libtool.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c5">
+ <term><parameter><filename>/bin/login</filename></parameter></term>
+ <listitem>
+ <para>The <command>agetty</command> program expects to find
+ <command>login</command> in <filename class="directory">/bin</filename>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c6">
+ <term><parameter><filename>/bin/pwd</filename></parameter></term>
+ <listitem>
+ <para>Some <command>configure</command> scripts, particularly Glibc's,
+ have this pathname hard-coded.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c7">
+ <term><parameter><filename>/bin/stty</filename></parameter></term>
+ <listitem>
+ <para>This pathname is hard-coded into Expect, therefore it is needed
+ for Binutils and GCC testsuites to pass.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c8">
+ <term><parameter><filename>/usr/bin/file</filename></parameter></term>
+ <listitem>
+ <para>Binutils' <command>configure</command> scripts specify this
+ command location.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c9">
+ <term><parameter><filename>/usr/lib/libgcc_s.so{,.1}</filename></parameter></term>
+ <listitem>
+ <para>Glibc needs this for the pthreads library to work.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c10">
+ <term><parameter><filename>/usr/lib/libstdc++{,.6}</filename></parameter></term>
+ <listitem>
+ <para>This is needed by several tests in Glibc's testsuite, as well as
+ for C++ support in GMP.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c11">
+ <term><parameter><filename>/usr/lib/libstdc++.la</filename></parameter></term>
+ <listitem>
+ <para>This prevents a <filename class="directory">/tools</filename>
+ reference that would be in <filename>/usr/lib/libstdc++.la</filename>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c12">
+ <term><parameter><filename>/bin/sh</filename></parameter></term>
+ <listitem>
+ <para>Many shell scripts hard-code <filename>/bin/sh</filename>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c13">
+ <term><parameter><filename>/var/run</filename></parameter></term>
+ <listitem>
+ <para>This is to account for any applications that have not yet
+ migrated to using <filename class="directory">/run</filename>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c14">
+ <term><parameter><filename>/sbin/init</filename></parameter></term>
+ <listitem>
+ <para>This is where the kernel expects to find <command>init</command>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry os="c15">
+ <term><parameter><filename>/etc/{login.{access,defs},limits}</filename></parameter></term>
+ <listitem>
+ <para>These are configuration files used by Shadow and are expected to
+ be found in <filename class="directory">/etc</filename>, for programs
+ such as <command>login</command> and <command>su</command> to work.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para os="d">Historically, Linux maintains a list of the mounted file systems
in the file <filename>/etc/mtab</filename>. Modern kernels maintain this list
internally and expose it to the user via the
<filename class="directory">/proc</filename> filesystem. To satisfy utilities
that expect the presence of <filename>/etc/mtab</filename>, create the
following symbolic link:</para>
-<screen os="d"><userinput>ln -sv /proc/self/mounts ${CLFS}/etc/mtab</userinput></screen>
+<screen os="e"><userinput>ln -sv /proc/self/mounts ${CLFS}/etc/mtab</userinput></screen>
</sect1>
diff --git a/BOOK/boot/mips64/createfiles.xml b/BOOK/boot/mips64/createfiles.xml
index 8a9bdaf..2584d55 100644
--- a/BOOK/boot/mips64/createfiles.xml
+++ b/BOOK/boot/mips64/createfiles.xml
@@ -36,4 +36,8 @@ ln -sv /tools/etc/{login.{access,defs},limits} ${CLFS}/etc</userinput></screen>
href="../common/createfiles.xml"
xpointer="xpointer(//*[@os='d'])"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../common/createfiles.xml"
+ xpointer="xpointer(//*[@os='e'])"/>
+
</sect1>
diff --git a/BOOK/boot/multilib/createfiles.xml b/BOOK/boot/multilib/createfiles.xml
index aa891b5..bc5fa98 100644
--- a/BOOK/boot/multilib/createfiles.xml
+++ b/BOOK/boot/multilib/createfiles.xml
@@ -34,4 +34,8 @@ ln -sv /tools/etc/{login.{access,defs},limits} ${CLFS}/etc</userinput></screen>
href="../common/createfiles.xml"
xpointer="xpointer(//*[@os='d'])"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../common/createfiles.xml"
+ xpointer="xpointer(//*[@os='e'])"/>
+
</sect1>
diff --git a/BOOK/chroot/64/createfiles.xml b/BOOK/chroot/64/createfiles.xml
index f28a529..b96fb12 100644
--- a/BOOK/chroot/64/createfiles.xml
+++ b/BOOK/chroot/64/createfiles.xml
@@ -25,18 +25,22 @@ ln -sv bash /bin/sh
ln -sv /run /var/run</userinput></screen>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../boot/64/createfiles.xml"
- xpointer="xpointer(//*[@os='e'])"/>
+ xpointer="xpointer(//*[@os='f'])"/>
<screen><userinput>mkdir -pv /usr/lib64
ln -sv /tools/lib/libstdc++.so{.6,} /usr/lib64</userinput></screen>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
- href="../../boot/common/createfiles.xml"
- xpointer="xpointer(//*[@os='c'])"/>
+ href="../common/createfiles.xml"
+ xpointer="xpointer(//*[@os='d'])"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../common/createfiles.xml"
- xpointer="xpointer(//*[@os='d'])"/>
+ xpointer="xpointer(//*[@os='e'])"/>
</sect1>
diff --git a/BOOK/chroot/common/createfiles.xml b/BOOK/chroot/common/createfiles.xml
index 6dc5d3c..9440a46 100644
--- a/BOOK/chroot/common/createfiles.xml
+++ b/BOOK/chroot/common/createfiles.xml
@@ -22,10 +22,63 @@ sed -e 's/tools/usr/' /tools/lib/libstdc++.la > /usr/lib/libstdc++.la
ln -sv bash /bin/sh
ln -sv /run /var/run</userinput></screen>
+ <variablelist os="c">
+ <title>The purpose of each link:</title>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c1'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c2'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c3'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c4'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c6'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c7'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c8'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c9'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c10'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c11'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c12'])"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../../boot/common/createfiles.xml"
+ xpointer="xpointer(//*[@os='c13'])"/>
+
+ </variablelist>
+
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../boot/common/createfiles.xml"
- xpointer="xpointer(//*[@os='c'])"/>
+ xpointer="xpointer(//*[@os='d'])"/>
-<screen os="d"><userinput>ln -sv /proc/self/mounts /etc/mtab</userinput></screen>
+<screen os="e"><userinput>ln -sv /proc/self/mounts /etc/mtab</userinput></screen>
</sect1>
diff --git a/BOOK/chroot/multilib/createfiles.xml b/BOOK/chroot/multilib/createfiles.xml
index f2547af..768f81c 100644
--- a/BOOK/chroot/multilib/createfiles.xml
+++ b/BOOK/chroot/multilib/createfiles.xml
@@ -31,4 +31,8 @@ ln -sv /run /var/run</userinput></screen>
href="../common/createfiles.xml"
xpointer="xpointer(//*[@os='d'])"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="../common/createfiles.xml"
+ xpointer="xpointer(//*[@os='d'])"/>
+
</sect1>
diff --git a/BOOK/introduction/common/changelog.xml b/BOOK/introduction/common/changelog.xml
index b0cbea1..0954a78 100644
--- a/BOOK/introduction/common/changelog.xml
+++ b/BOOK/introduction/common/changelog.xml
@@ -36,6 +36,15 @@
</listitem>
-->
<listitem>
+ <para>11 May 2014</para>
+ <itemizedlist>
+ <listitem>
+ <para>[Chris] - Added explanations for Essential Symlinks.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para>08 May 2014</para>
<itemizedlist>
<listitem>
-----------------------------------------------------------------------
Summary of changes:
BOOK/boot/64/createfiles.xml | 12 ++-
BOOK/boot/common/createfiles.xml | 127 +++++++++++++++++++++++++++++++-
BOOK/boot/mips64/createfiles.xml | 4 +
BOOK/boot/multilib/createfiles.xml | 4 +
BOOK/chroot/64/createfiles.xml | 12 ++-
BOOK/chroot/common/createfiles.xml | 57 ++++++++++++++-
BOOK/chroot/multilib/createfiles.xml | 4 +
BOOK/introduction/common/changelog.xml | 9 ++
8 files changed, 217 insertions(+), 12 deletions(-)
hooks/post-receive
--
Cross-LFS Book
More information about the Clfs-commits
mailing list