BOOK/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              libitm.so.&libitm-version; libatomic.so.&libatomic-version;" <!-- libcilkrts.so.&libcilkrts-version;-->
  48
  49 cd /usr/lib
  50
  51 for LIB in $save_usrlib; do
  52     objcopy --only-keep-debug $LIB $LIB.dbg
  53     strip --strip-unneeded $LIB
  54     objcopy --add-gnu-debuglink=$LIB.dbg $LIB
  55 done
  56
  57 unset LIB save_lib save_usrlib</userinput></screen>
  58
  59   <para>Before performing the stripping, take special care to ensure that
  60   none of the binaries that are about to be stripped are running:</para>
  61
  62 <screen role="nodump"><userinput>exec /tools/bin/bash</userinput></screen>
  63
  64   <!--
  65   If
  66   unsure whether the user entered chroot with the command given in
  67   <xref linkend="ch-system-chroot" role=","/> first use the version
  68   of bash we created in
  69   chroot:</para>
  70
  71 <screen role="nodump"><userinput>logout</userinput></screen>
  72
  73   <para>Then reenter it with:</para>
  74
  75 <screen role="nodump"><userinput>chroot $LFS /tools/bin/env -i          \
  76     HOME=/root TERM=$TERM              \
  77     PS1='(lfs chroot) \u:\w\$ '        \
  78     PATH=/bin:/usr/bin:/sbin:/usr/sbin \
  79     /tools/bin/bash - -login</userinput></screen>-->
  80
  81   <para>Now the binaries and libraries can be safely stripped:</para>
  82
  83 <screen><userinput>/tools/bin/find /usr/lib -type f -name \*.a \
  84    -exec /tools/bin/strip --strip-debug {} ';'
  85
  86 /tools/bin/find /lib /usr/lib -type f \( -name \*.so* -a ! -name \*dbg \) \
  87    -exec /tools/bin/strip --strip-unneeded {} ';'
  88
  89 /tools/bin/find /{bin,sbin} /usr/{bin,sbin,libexec} -type f \
  90     -exec /tools/bin/strip --strip-all {} ';'</userinput></screen>
  91
  92   <para>A large number of files will be reported as having their file
  93   format not recognized. These warnings can be safely ignored. These
  94   warnings indicate that those files are scripts instead of
  95   binaries.</para>
  96
  97 </sect1>