Changeset b4f5af8 for BOOK


Ignore:
Timestamp:
Feb 21, 2006, 1:29:15 AM (19 years ago)
Author:
Jim Gifford <clfs@…>
Branches:
clfs-1.2, clfs-2.1, clfs-3.0.0-systemd, clfs-3.0.0-sysvinit, master, systemd, sysvinit
Children:
db1bc75
Parents:
48c7e86
Message:

r803@server (orig r801): jim | 2005-12-02 08:36:39 -0800

r880@server: jim | 2005-12-02 08:36:09 -0800
Text Updates from G. Moko


Location:
BOOK
Files:
4 added
8 edited

Legend:

Unmodified
Added
Removed
  • BOOK/final-system/common/aboutdebug.xml

    r48c7e86 rb4f5af8  
    1111  <title>About Debugging Symbols</title>
    1212
    13   <para>Most programs and libraries are, by default, compiled with debugging
     13  <para os="a">Most programs and libraries are, by default, compiled with debugging
    1414  symbols included (with <command>gcc</command>'s <option>-g</option> option).
    1515  This means that when debugging a program or library that was compiled with
     
    1717  addresses, but also the names of the routines and variables.</para>
    1818
    19   <para>However, the inclusion of these debugging symbols enlarges a
     19  <para os="b">However, the inclusion of these debugging symbols enlarges a
    2020  program or library significantly. The following is an example of the
    2121  amount of space these symbols occupy:</para>
    2222
    23   <itemizedlist>
    24     <listitem>
     23  <itemizedlist os="c">
     24    <listitem os="c1">
    2525      <para>a bash binary with debugging symbols: 1200 KB</para>
    2626    </listitem>
    27     <listitem>
     27    <listitem os="c2">
    2828      <para>a bash binary without debugging symbols: 480 KB</para>
    2929    </listitem>
    30     <listitem>
     30    <listitem os="c3">
    3131      <para>Glibc and GCC files (<filename class="directory">/lib</filename>
    3232      and <filename class="directory">/usr/lib</filename>) with debugging
    3333      symbols: 87 MB</para>
    3434    </listitem>
    35     <listitem>
     35    <listitem os="c4">
    3636      <para>Glibc and GCC files without debugging symbols: 16 MB</para>
    3737    </listitem>
    3838  </itemizedlist>
    3939
    40   <para>Sizes may vary depending on which compiler and C library were used,
     40  <para os="d">Sizes may vary depending on which compiler and C library were used,
    4141  but when comparing programs with and without debugging symbols, the
    4242  difference will usually be a factor between two and five.</para>
    4343
    44   <para>Because most users will never use a debugger on their system software,
     44  <para os="e">Because most users will never use a debugger on their system software,
    4545  a lot of disk space can be regained by removing these symbols. The next
    4646  section shows how to strip all debugging symbols from the programs and
  • BOOK/final-system/common/shadow.xml

    r48c7e86 rb4f5af8  
    105105    etc/login.defs &gt; /etc/login.defs</userinput></screen>
    106106
    107     <para os="r">Move a misplaced program to their proper location:</para>
     107    <para os="r">Move a misplaced program to its proper location:</para>
    108108
    109109<screen os="s"><userinput>mv /usr/bin/passwd /bin</userinput></screen>
  • BOOK/final-system/common/stripping.xml

    r48c7e86 rb4f5af8  
    1111  <title>Stripping</title>
    1212
    13   <para>If the intended user is not a programmer and does not plan to do
     13  <para os="a">If the intended user is not a programmer and does not plan to do
    1414  any debugging on the system software, the system size can be decreased
    1515  by about 200 MB by removing the debugging symbols from binaries and
     
    1717  debug the software fully anymore.</para>
    1818
    19   <para>Most people who use the command mentioned below do not
     19  <para os="b">Most people who use the command mentioned below do not
    2020  experience any difficulties. However, it is easy to make a typo and
    2121  render the new system unusable, so before running the
     
    2323  backup of the current situation.</para>
    2424
    25   <para>Before performing the stripping, take special care to ensure that
     25  <para os="c">Before performing the stripping, take special care to ensure that
    2626  none of the binaries that are about to be stripped are running. If
    2727  unsure whether the user entered chroot with the command given in
     
    2929  chroot:</para>
    3030
    31 <screen><userinput>logout</userinput></screen>
     31<screen os="d"><userinput>logout</userinput></screen>
    3232
    33     <para>Then reenter it with:</para>
     33    <para os="e">Then reenter it with:</para>
    3434
    35 <screen><userinput>chroot $LFS /tools/bin/env -i \
     35<screen os="f"><userinput>chroot $LFS /tools/bin/env -i \
    3636    HOME=/root TERM=$TERM PS1='\u:\w\$ ' \
    3737    PATH=/bin:/usr/bin:/sbin:/usr/sbin \
    3838    /tools/bin/bash --login</userinput></screen>
    3939
    40     <para>Now the binaries and libraries can be safely stripped:</para>
     40    <para os="g">Now the binaries and libraries can be safely stripped:</para>
    4141
    42 <screen><userinput>/tools/bin/find /{,usr/}{bin,lib,sbin} -type f \
     42<screen os="h"><userinput>/tools/bin/find /{,usr/}{bin,lib,sbin} -type f \
    4343   -exec /tools/bin/strip --strip-debug '{}' ';'</userinput></screen>
    4444
    45     <para>A large number of files will be reported as having their file
     45    <para os="i">A large number of files will be reported as having their file
    4646    format not recognized. These warnings can be safely ignored. These
    4747    warnings indicate that those files are scripts instead of
    4848    binaries.</para>
    4949
    50     <para>If disk space is very tight, the <option>--strip-all</option>
     50    <para os="j">If disk space is very tight, the <option>--strip-all</option>
    5151    option can be used on the binaries in <filename
    5252    class="directory">/{,usr/}{bin,sbin}</filename> to gain several more
  • BOOK/final-system/mips64-chapter.xml

    r48c7e86 rb4f5af8  
    9090  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips64/dvhtool.xml"/>
    9191  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips64/arcload.xml"/>
    92   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/aboutdebug.xml"/>
    93   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/stripping.xml"/>
     92  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips64/aboutdebug.xml"/>
     93  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips64/stripping.xml"/>
    9494
    9595</chapter>
  • BOOK/final-system/multilib/perl-64bit.xml

    r48c7e86 rb4f5af8  
    9999    xpointer="xpointer(//*[@os='j'])"/>
    100100
     101    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     102    href="../common/perl.xml"
     103    xpointer="xpointer(//*[@os='k'])"/>
     104
    101105  </sect2>
    102106
  • BOOK/final-system/sparc64-chapter.xml

    r48c7e86 rb4f5af8  
    7777  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sparc64/elftoaout.xml"/>
    7878  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sparc64/silo.xml"/>
    79   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/aboutdebug.xml"/>
    80   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/stripping.xml"/>
     79  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multilib/aboutdebug.xml"/>
     80  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multilib/stripping.xml"/>
    8181
    8282</chapter>
  • BOOK/final-system/x86_64-chapter.xml

    r48c7e86 rb4f5af8  
    7676  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/hotplug.xml"/>
    7777  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x86_64/grub.xml"/>
    78   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/aboutdebug.xml"/>
    79   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/stripping.xml"/>
     78  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multilib/aboutdebug.xml"/>
     79  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multilib/stripping.xml"/>
    8080
    8181</chapter>
  • BOOK/introduction/common/acknowledgements.xml

    r48c7e86 rb4f5af8  
    5757      <para>Alexander E. Patrakov - Udev/Hotplug Integration</para>
    5858    </listitem>
     59    <listitem>
     60      <para>G. Moko - Text updates and Typos</para>
     61    </listitem>
    5962  </itemizedlist>
    6063
Note: See TracChangeset for help on using the changeset viewer.