<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="ch-system-stripping">
  <?dbhtml filename="stripping.html"?>

  <title>Stripping</title>

  <para os="a">If the intended user is not a programmer and does not plan to do
  any debugging on the system software, the system size can be decreased
  by about 200 MB by removing the debugging symbols from binaries and
  libraries. This causes no inconvenience other than not being able to
  debug the software fully anymore.</para>

  <para os="b">Most people who use the command mentioned below do not
  experience any difficulties. However, it is easy to make a typo and
  render the new system unusable, so before running the
  <command>strip</command> command, it is a good idea to make a
  backup of the current situation.</para>

  <para os="c">Before performing the stripping, take special care to ensure that
  none of the binaries that are about to be stripped are running. If
  unsure whether the user entered chroot with the command given in
  <xref linkend="chapter-chroot" role=","/> first exit from
  chroot:</para>

<screen os="d" role="nodump"><userinput>logout</userinput></screen>

    <para os="e">Then reenter it with:</para>

<screen os="f" role="nodump"><userinput>chroot $CLFS /tools/bin/env -i \
    HOME=/root TERM=$TERM PS1='\u:\w\$ ' \
    PATH=/bin:/usr/bin:/sbin:/usr/sbin \
    /tools/bin/bash --login</userinput></screen>

    <para os="g">Now the binaries and libraries can be safely stripped:</para>

<screen os="h"><userinput>/tools/bin/find /{,usr/}{bin,lib,sbin} -type f \
   -exec /tools/bin/strip --strip-debug '{}' ';'</userinput></screen>

    <para os="i">A large number of files will be reported as having their file
    format not recognized. These warnings can be safely ignored. These
    warnings indicate that those files are scripts instead of
    binaries.</para>

    <para os="j">If disk space is very tight, the <option>--strip-all</option>
    option can be used on the binaries in <filename
    class="directory">/{,usr/}{bin,sbin}</filename> to gain several more
    megabytes. Do not use this option on libraries&mdash;they will be
    destroyed.</para>

</sect1>
