Changeset b925729


Ignore:
Timestamp:
May 11, 2014, 11:47:04 AM (11 years ago)
Author:
Chris Staub <chris@…>
Branches:
clfs-3.0.0-systemd, clfs-3.0.0-sysvinit, master, systemd, sysvinit
Children:
c54a540
Parents:
9b519e2
Message:

Added command explanations for symlinks

Location:
BOOK
Files:
8 edited

Legend:

Unmodified
Added
Removed

  • BOOK/boot/64/createfiles.xml

    r9b519e2 rb925729  
    2121  xpointer="xpointer(//*[@os='b'])"/>
    2222
    23   <para os="e">To enable some C++ tests in the Glibc and Binutils testsuites
    24   to link, create a directory and make some symbolic links:</para>
    25 
    26 <screen os="f"><userinput>mkdir -pv ${CLFS}/usr/lib64
    27 ln -sv /tools/lib/libstdc++.so{.6,} ${CLFS}/usr/lib64</userinput></screen>
    28 
    2923  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    3024  href="../common/createfiles.xml"
    3125  xpointer="xpointer(//*[@os='c'])"/>
     26
     27  <para os="f">To enable some C++ tests in the Glibc and Binutils testsuites
     28  to link, create a directory and make some symbolic links:</para>
     29
     30<screen os="g"><userinput>mkdir -pv ${CLFS}/usr/lib64
     31ln -sv /tools/lib/libstdc++.so{.6,} ${CLFS}/usr/lib64</userinput></screen>
    3232
    3333  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    … …  
    3535  xpointer="xpointer(//*[@os='d'])"/>
    3636
     37  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     38  href="../common/createfiles.xml"
     39  xpointer="xpointer(//*[@os='e'])"/>
     40
    3741</sect1>

  • BOOK/boot/common/createfiles.xml

    r9b519e2 rb925729  
    2626ln -sv /tools/etc/{login.{access,defs},limits} ${CLFS}/etc</userinput></screen>
    2727
    28   <para os="c">Historically, Linux maintains a list of the mounted file systems
     28  <variablelist os="c">
     29    <title>The purpose of each link:</title>
     30
     31    <varlistentry os="c1">
     32      <term><parameter><filename>/bin/bash</filename></parameter></term>
     33      <listitem>
     34        <para>Many <command>bash</command> scripts specify
     35        <filename>/bin/bash</filename>.</para>
     36      </listitem>
     37    </varlistentry>
     38
     39    <varlistentry os="c2">
     40      <term><parameter><filename>/bin/cat</filename></parameter></term>
     41      <listitem>
     42        <para>This pathname is hard-coded into Glibc's configure script.</para>
     43      </listitem>
     44    </varlistentry>
     45
     46    <varlistentry os="c3">
     47      <term><parameter><filename>/bin/echo</filename></parameter></term>
     48      <listitem>
     49        <para>This is to satisfy one of the tests in Glibc's testsuite, which
     50        will fail in <command>echo</command> is not found in
     51        <filename class="directory">/bin</filename>.</para>
     52      </listitem>
     53    </varlistentry>
     54
     55    <varlistentry os="c4">
     56      <term><parameter><filename>/bin/grep</filename></parameter></term>
     57      <listitem>
     58        <para>This to avoid a hard-coded
     59        <filename class="directory">/tools</filename> reference in Libtool.</para>
     60      </listitem>
     61    </varlistentry>
     62
     63    <varlistentry os="c5">
     64      <term><parameter><filename>/bin/login</filename></parameter></term>
     65      <listitem>
     66        <para>The <command>agetty</command> program expects to find
     67        <command>login</command> in <filename class="directory">/bin</filename>.</para>
     68      </listitem>
     69    </varlistentry>
     70
     71    <varlistentry os="c6">
     72      <term><parameter><filename>/bin/pwd</filename></parameter></term>
     73      <listitem>
     74        <para>Some <command>configure</command> scripts, particularly Glibc's,
     75        have this pathname hard-coded.</para>
     76      </listitem>
     77    </varlistentry>
     78
     79    <varlistentry os="c7">
     80      <term><parameter><filename>/bin/stty</filename></parameter></term>
     81      <listitem>
     82        <para>This pathname is hard-coded into Expect, therefore it is needed
     83        for Binutils and GCC testsuites to pass.</para>
     84      </listitem>
     85    </varlistentry>
     86
     87    <varlistentry os="c8">
     88      <term><parameter><filename>/usr/bin/file</filename></parameter></term>
     89      <listitem>
     90        <para>Binutils' <command>configure</command> scripts specify this
     91        command location.</para>
     92      </listitem>
     93    </varlistentry>
     94
     95    <varlistentry os="c9">
     96      <term><parameter><filename>/usr/lib/libgcc_s.so{,.1}</filename></parameter></term>
     97      <listitem>
     98        <para>Glibc needs this for the pthreads library to work.</para>
     99      </listitem>
     100    </varlistentry>
     101
     102    <varlistentry os="c10">
     103      <term><parameter><filename>/usr/lib/libstdc++{,.6}</filename></parameter></term>
     104      <listitem>
     105        <para>This is needed by several tests in Glibc's testsuite, as well as
     106        for C++ support in GMP.</para>
     107      </listitem>
     108    </varlistentry>
     109
     110    <varlistentry os="c11">
     111      <term><parameter><filename>/usr/lib/libstdc++.la</filename></parameter></term>
     112      <listitem>
     113        <para>This prevents a <filename class="directory">/tools</filename>
     114        reference that would be in <filename>/usr/lib/libstdc++.la</filename>.</para>
     115      </listitem>
     116    </varlistentry>
     117
     118    <varlistentry os="c12">
     119      <term><parameter><filename>/bin/sh</filename></parameter></term>
     120      <listitem>
     121        <para>Many shell scripts hard-code <filename>/bin/sh</filename>.</para>
     122      </listitem>
     123    </varlistentry>
     124
     125    <varlistentry os="c13">
     126      <term><parameter><filename>/var/run</filename></parameter></term>
     127      <listitem>
     128        <para>This is to account for any applications that have not yet
     129        migrated to using <filename class="directory">/run</filename>.</para>
     130      </listitem>
     131    </varlistentry>
     132
     133    <varlistentry os="c14">
     134      <term><parameter><filename>/sbin/init</filename></parameter></term>
     135      <listitem>
     136        <para>This is where the kernel expects to find <command>init</command>.</para>
     137      </listitem>
     138    </varlistentry>
     139
     140    <varlistentry os="c15">
     141      <term><parameter><filename>/etc/{login.{access,defs},limits}</filename></parameter></term>
     142      <listitem>
     143        <para>These are configuration files used by Shadow and are expected to
     144        be found in <filename class="directory">/etc</filename>, for programs
     145        such as <command>login</command> and <command>su</command> to work.</para>
     146      </listitem>
     147    </varlistentry>
     148
     149  </variablelist>
     150
     151  <para os="d">Historically, Linux maintains a list of the mounted file systems
    29152  in the file <filename>/etc/mtab</filename>. Modern kernels maintain this list
    30153  internally and expose it to the user via the
    … …  
    33156  following symbolic link:</para>
    34157
    35 <screen os="d"><userinput>ln -sv /proc/self/mounts ${CLFS}/etc/mtab</userinput></screen>
     158<screen os="e"><userinput>ln -sv /proc/self/mounts ${CLFS}/etc/mtab</userinput></screen>
    36159
    37160</sect1>

  • BOOK/boot/mips64/createfiles.xml

    r9b519e2 rb925729  
    3737  xpointer="xpointer(//*[@os='d'])"/>
    3838
     39  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     40  href="../common/createfiles.xml"
     41  xpointer="xpointer(//*[@os='e'])"/>
     42
    3943</sect1>

  • BOOK/boot/multilib/createfiles.xml

    r9b519e2 rb925729  
    3535  xpointer="xpointer(//*[@os='d'])"/>
    3636
     37  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     38  href="../common/createfiles.xml"
     39  xpointer="xpointer(//*[@os='e'])"/>
     40
    3741</sect1>

  • BOOK/chroot/64/createfiles.xml

    r9b519e2 rb925729  
    2626
    2727  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     28  href="../../boot/common/createfiles.xml"
     29  xpointer="xpointer(//*[@os='c'])"/>
     30
     31  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    2832  href="../../boot/64/createfiles.xml"
    29   xpointer="xpointer(//*[@os='e'])"/>
     33  xpointer="xpointer(//*[@os='f'])"/>
    3034
    3135<screen><userinput>mkdir -pv /usr/lib64
    … …  
    3337
    3438    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    35     href="../../boot/common/createfiles.xml"
    36     xpointer="xpointer(//*[@os='c'])"/>
     39    href="../common/createfiles.xml"
     40    xpointer="xpointer(//*[@os='d'])"/>
    3741
    3842    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    3943    href="../common/createfiles.xml"
    40     xpointer="xpointer(//*[@os='d'])"/>
     44    xpointer="xpointer(//*[@os='e'])"/>
    4145
    4246</sect1>

  • BOOK/chroot/common/createfiles.xml

    r9b519e2 rb925729  
    2323ln -sv /run /var/run</userinput></screen>
    2424
     25    <variablelist os="c">
     26      <title>The purpose of each link:</title>
     27
     28      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     29      href="../../boot/common/createfiles.xml"
     30      xpointer="xpointer(//*[@os='c1'])"/>
     31
     32      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     33      href="../../boot/common/createfiles.xml"
     34      xpointer="xpointer(//*[@os='c2'])"/>
     35
     36      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     37      href="../../boot/common/createfiles.xml"
     38      xpointer="xpointer(//*[@os='c3'])"/>
     39
     40      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     41      href="../../boot/common/createfiles.xml"
     42      xpointer="xpointer(//*[@os='c4'])"/>
     43
     44      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     45      href="../../boot/common/createfiles.xml"
     46      xpointer="xpointer(//*[@os='c6'])"/>
     47
     48      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     49      href="../../boot/common/createfiles.xml"
     50      xpointer="xpointer(//*[@os='c7'])"/>
     51
     52      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     53      href="../../boot/common/createfiles.xml"
     54      xpointer="xpointer(//*[@os='c8'])"/>
     55
     56      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     57      href="../../boot/common/createfiles.xml"
     58      xpointer="xpointer(//*[@os='c9'])"/>
     59
     60      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     61      href="../../boot/common/createfiles.xml"
     62      xpointer="xpointer(//*[@os='c10'])"/>
     63
     64      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     65      href="../../boot/common/createfiles.xml"
     66      xpointer="xpointer(//*[@os='c11'])"/>
     67
     68      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     69      href="../../boot/common/createfiles.xml"
     70      xpointer="xpointer(//*[@os='c12'])"/>
     71
     72      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     73      href="../../boot/common/createfiles.xml"
     74      xpointer="xpointer(//*[@os='c13'])"/>
     75
     76    </variablelist>
     77
    2578    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    2679    href="../../boot/common/createfiles.xml"
    27     xpointer="xpointer(//*[@os='c'])"/>
     80    xpointer="xpointer(//*[@os='d'])"/>
    2881
    29 <screen os="d"><userinput>ln -sv /proc/self/mounts /etc/mtab</userinput></screen>
     82<screen os="e"><userinput>ln -sv /proc/self/mounts /etc/mtab</userinput></screen>
    3083
    3184</sect1>

  • BOOK/chroot/multilib/createfiles.xml

    r9b519e2 rb925729  
    3232    xpointer="xpointer(//*[@os='d'])"/>
    3333
     34    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     35    href="../common/createfiles.xml"
     36    xpointer="xpointer(//*[@os='d'])"/>
     37
    3438</sect1>

  • BOOK/introduction/common/changelog.xml

    r9b519e2 rb925729  
    3737-->
    3838    <listitem>
     39      <para>11 May 2014</para>
     40      <itemizedlist>
     41        <listitem>
     42          <para>[Chris] - Added explanations for Essential Symlinks.</para>
     43        </listitem>
     44      </itemizedlist>
     45    </listitem>
     46
     47    <listitem>
    3948      <para>08 May 2014</para>
    4049      <itemizedlist>
Note: See TracChangeset for help on using the changeset viewer.