chapter06/strippingagain.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4   <!ENTITY % general-entities SYSTEM "../general.ent">
   5   %general-entities;
   6 ]>
   7
   8 <sect1 id="ch-system-strippingagain">
   9   <?dbhtml filename="strippingagain.html"?>
  10
  11   <title>Stripping Again</title>
  12
  13   <para>This section is optional.  If the intended user is not a
  14   programmer and does not plan to do
  15   any debugging on the system software, the system size can be decreased
  16   by about 90 MB by removing the debugging symbols from binaries and
  17   libraries. This causes no inconvenience other than not being able to
  18   debug the software fully anymore.</para>
  19
  20   <para>Most people who use the commands mentioned below do not
  21   experience any difficulties. However, it is easy to make a typo and
  22   render the new system unusable, so before running the
  23   <command>strip</command> commands, it is a good idea to make a
  24   backup of the LFS system in its current state.</para>
  25
  26   <para>First place the debugging symbols for selected libraries
  27   in separate files.  This debugging information is needed if running
  28   regression tests that use <ulink
  29   url='&blfs-book;/general/valgrind.html'>valgrind</ulink> or <ulink
  30   url='&blfs-book;/general/gdb.html'>gdb</ulink> later in BLFS.
  31   </para>
  32
  33 <!-- also of interest are libgfortan, libgo, libgomp, and libobjc from gcc -->
  34
  35 <!--<screen><userinput>save_lib="ld-2.25.so libc-2.25.so libpthread-2.25.so libthread_db-1.0.so"-->
  36 <screen><userinput>save_lib="ld-&glibc-version;.so libc-&glibc-version;.so libpthread-&glibc-version;.so libthread_db-&libthread_db-version;.so"
  37
  38 cd /lib
  39
  40 for LIB in $save_lib; do
  41     objcopy --only-keep-debug $LIB $LIB.dbg
  42     strip --strip-unneeded $LIB
  43     objcopy --add-gnu-debuglink=$LIB.dbg $LIB
  44 done
  45
  46 save_usrlib="libquadmath.so.&libquadmath-version; libstdc++.so.&libstdcpp-version;
  47              libmpx.so.&libmpx-version; libmpxwrappers.so.&libmpxwrap-version; libitm.so.&libitm-version;
  48              libcilkrts.so.&libcilkrts-version; libatomic.so.&libatomic-version;"
  49
  50 cd /usr/lib
  51
  52 for LIB in $save_usrlib; do
  53     objcopy --only-keep-debug $LIB $LIB.dbg
  54     strip --strip-unneeded $LIB
  55     objcopy --add-gnu-debuglink=$LIB.dbg $LIB
  56 done
  57
  58 unset LIB save_lib save_usrlib</userinput></screen>
  59
  60   <para>Before performing the stripping, take special care to ensure that
  61   none of the binaries that are about to be stripped are running. If
  62   unsure whether the user entered chroot with the command given in
  63   <xref linkend="ch-system-chroot" role=","/> first exit from
  64   chroot:</para>
  65
  66 <screen role="nodump"><userinput>logout</userinput></screen>
  67
  68   <para>Then reenter it with:</para>
  69
  70 <screen role="nodump"><userinput>chroot $LFS /tools/bin/env -i          \
  71     HOME=/root TERM=$TERM              \
  72     PS1='(lfs chroot) \u:\w\$ '        \
  73     PATH=/bin:/usr/bin:/sbin:/usr/sbin \
  74     /tools/bin/bash --login</userinput></screen>
  75
  76   <para>Now the binaries and libraries can be safely stripped:</para>
  77
  78 <screen><userinput>/tools/bin/find /usr/lib -type f -name \*.a \
  79    -exec /tools/bin/strip --strip-debug {} ';'
  80
  81 /tools/bin/find /lib /usr/lib -type f \( -name \*.so* -a ! -name \*dbg \) \
  82    -exec /tools/bin/strip --strip-unneeded {} ';'
  83
  84 /tools/bin/find /{bin,sbin} /usr/{bin,sbin,libexec} -type f \
  85     -exec /tools/bin/strip --strip-all {} ';'</userinput></screen>
  86
  87   <para>A large number of files will be reported as having their file
  88   format not recognized. These warnings can be safely ignored. These
  89   warnings indicate that those files are scripts instead of
  90   binaries.</para>
  91
  92 </sect1>