source: BOOK/temp-system/common/bash.xml@ 8b9f539

<?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-temp-system-bash" role="wrap">
  <?dbhtml filename="bash.html"?>

  <title>Bash-&bash-version;</title>

  <indexterm zone="ch-temp-system-bash">
    <primary sortas="a-Bash">Bash</primary>
    <secondary>temporary system</secondary>
  </indexterm>

  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
  href="../../final-system/common/bash.xml"
  xpointer="xpointer(//*[@role='package'])"/>

  <sect2 role="installation">
    <title>Installation of Bash</title>

    <para os="c1">Remove a test that causes the build to fail:</para>

<screen os="c2"><userinput>echo "ac_cv_func_setvbuf_reversed=no" >> config.cache</userinput></screen>

    <para os="c3">When bash is cross-compiled, it cannot test for the presence
    of named pipes. We used <command>su</command> to become an unprivileged
    user, this combination will cause a build without <emphasis>process
    substitution</emphasis>, which will break one of the c++ test scripts in
    <literal>glibc</literal>. Prevent that by forcing the following definition:
    </para>

<screen os="c4"><userinput> echo "bash_cv_sys_named_pipes=yes" >> config.cache</userinput></screen>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../final-system/common/bash.xml"
    xpointer="xpointer(//*[@os='g'])"/>

<screen os="h"><userinput>./configure --prefix=/tools \
    --build=${CLFS_HOST} --host=${CLFS_TARGET} \
    --without-bash-malloc --cache-file=config.cache</userinput></screen>

    <variablelist os="ad">
      <title>The meaning of the configure option:</title>

      <varlistentry>
        <term><parameter>--without-bash-malloc</parameter></term>
        <listitem>
          <para>This option turns off the use of Bash's memory allocation
          (malloc) function which is known to cause segmentation faults.
          By turning this option off, Bash will use the malloc functions
          from Glibc which are more stable.</para>
        </listitem>
      </varlistentry>

    </variablelist>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../final-system/common/bash.xml"
    xpointer="xpointer(//*[@os='j'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../final-system/common/bash.xml"
    xpointer="xpointer(//*[@os='k'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../final-system/common/bash.xml"
    xpointer="xpointer(//*[@os='m'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../final-system/common/bash.xml"
    xpointer="xpointer(//*[@os='n'])"/>

    <para os="ae">Make a link for programs that use <command>sh</command> for
    a shell:</para>

<screen os="af"><userinput>ln -sv bash /tools/bin/sh</userinput></screen>

  </sect2>

  <sect2 role="content">
    <title/>

    <para>Details on this package are located in <xref
    linkend="contents-bash" role="."/></para>

  </sect2>

</sect1>