chapter05/bash.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-tools-bash" role="wrap">
   9   <?dbhtml filename="bash.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>bash</productname>
  13     <productnumber>&bash-version;</productnumber>
  14     <address>&bash-url;</address>
  15   </sect1info>
  16
  17   <title>Bash-&bash-version;</title>
  18
  19   <indexterm zone="ch-tools-bash">
  20     <primary sortas="a-Bash">Bash</primary>
  21     <secondary>tools</secondary>
  22   </indexterm>
  23
  24   <sect2 role="package">
  25     <title/>
  26
  27     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  28     href="../chapter06/bash.xml"
  29     xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
  30
  31     <segmentedlist>
  32       <segtitle>&buildtime;</segtitle>
  33       <segtitle>&diskspace;</segtitle>
  34
  35       <seglistitem>
  36         <seg>&bash-ch5-sbu;</seg>
  37         <seg>&bash-ch5-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Bash</title>
  45 <!--
  46     <para>First, apply the following patch to fix various bugs that have been
  47     addressed upstream:</para>
  48
  49 <screen><userinput remap="pre">patch -Np1 -i ../&bash-fixes-patch;</userinput></screen>
  50 -->
  51     <para>Prepare Bash for compilation:</para>
  52
  53 <screen><userinput remap="configure">./configure --prefix=/tools --without-bash-malloc</userinput></screen>
  54
  55     <variablelist>
  56       <title>The meaning of the configure options:</title>
  57
  58       <varlistentry>
  59         <term><parameter>--without-bash-malloc</parameter></term>
  60         <listitem>
  61           <para>This option turns off the use of Bash's memory allocation
  62           (<function>malloc</function>) function which is known to cause
  63           segmentation faults. By turning this option off, Bash will use
  64           the <function>malloc</function> functions from Glibc which are
  65           more stable.</para>
  66         </listitem>
  67       </varlistentry>
  68
  69     </variablelist>
  70
  71     <para>Compile the package:</para>
  72
  73 <screen><userinput remap="make">make</userinput></screen>
  74
  75     <para>Compilation is now complete. As discussed earlier, running the test
  76     suite is not mandatory for the temporary tools here in this chapter. To run
  77     the Bash test suite anyway, issue the following command:</para>
  78
  79
  80 <screen><userinput remap="test">make tests</userinput></screen>
  81
  82     <para>Install the package:</para>
  83
  84 <screen><userinput remap="install">make install</userinput></screen>
  85
  86     <para>Make a link for the programs that use <command>sh</command> for
  87     a shell:</para>
  88
  89 <screen><userinput remap="install">ln -sv bash /tools/bin/sh</userinput></screen>
  90
  91   </sect2>
  92
  93   <sect2 role="content">
  94     <title/>
  95
  96     <para>Details on this package are located in
  97     <xref linkend="contents-bash" role="."/></para>
  98
  99   </sect2>
 100
 101 </sect1>