bash.xml 2.9 KB

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