Update to tcl-8.6.11
[linux_from_scratch.git] / BOOK / chapter08 / strippingagain.xml
blob891d2e000a52e62ce82648aac4c45962dd3a0c4a
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 ]>
8 <sect1 id="ch-system-strippingagain">
9   <?dbhtml filename="strippingagain.html"?>
11   <title>Stripping Again</title>
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 2 GB 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>
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>
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>
33 <!-- also of interest are libgfortan, libgo, libgomp, and libobjc from GCC -->
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"
38 cd /lib
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    
46 save_usrlib="libquadmath.so.&libquadmath-version; libstdc++.so.&libstdcpp-version;
47              libitm.so.&libitm-version; libatomic.so.&libatomic-version;" <!-- libcilkrts.so.&libcilkrts-version;-->
49 cd /usr/lib
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
57 unset LIB save_lib save_usrlib</userinput></screen>
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>
62 <screen role="nodump"><userinput>exec /tools/bin/bash</userinput></screen>
63   
64   <para>Now the binaries and libraries can be safely stripped:</para>
65 -->
66   <para>Now the binaries and libraries can be stripped:</para>
67 <screen><userinput>find /usr/lib -type f -name \*.a \
68    -exec strip --strip-debug {} ';'
70 find /lib /usr/lib -type f -name \*.so* ! -name \*dbg \
71    -exec strip --strip-unneeded {} ';'
73 find /{bin,sbin} /usr/{bin,sbin,libexec} -type f \
74     -exec strip --strip-all {} ';'</userinput></screen>
76   <para>A large number of files will be reported as having their file
77   format not recognized. These warnings can be safely ignored. These
78   warnings indicate that those files are scripts instead of
79   binaries.</para>
81 </sect1>