[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[b06ca36] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[673b0d8] | 4 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 | ]>
|
---|
[81109e3] | 7 |
|
---|
[9652249] | 8 | <sect1 id="ch-tools-bash" role="wrap">
|
---|
[81109e3] | 9 | <?dbhtml filename="bash.html"?>
|
---|
| 10 |
|
---|
[e747759] | 11 | <sect1info condition="script">
|
---|
| 12 | <productname>bash</productname>
|
---|
| 13 | <productnumber>&bash-version;</productnumber>
|
---|
| 14 | <address>&bash-url;</address>
|
---|
| 15 | </sect1info>
|
---|
| 16 |
|
---|
[81109e3] | 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/>
|
---|
[6370fa6] | 26 |
|
---|
[81109e3] | 27 | <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
|
---|
| 28 | href="../chapter06/bash.xml"
|
---|
| 29 | xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
|
---|
[3554fa3a] | 30 |
|
---|
[81109e3] | 31 | <segmentedlist>
|
---|
| 32 | <segtitle>&buildtime;</segtitle>
|
---|
| 33 | <segtitle>&diskspace;</segtitle>
|
---|
[673b0d8] | 34 |
|
---|
[81109e3] | 35 | <seglistitem>
|
---|
[e4a5635] | 36 | <seg>&bash-ch5-sbu;</seg>
|
---|
| 37 | <seg>&bash-ch5-du;</seg>
|
---|
[81109e3] | 38 | </seglistitem>
|
---|
| 39 | </segmentedlist>
|
---|
[673b0d8] | 40 |
|
---|
[81109e3] | 41 | </sect2>
|
---|
[73aedd1d] | 42 |
|
---|
[81109e3] | 43 | <sect2 role="installation">
|
---|
| 44 | <title>Installation of Bash</title>
|
---|
[73aedd1d] | 45 |
|
---|
[81109e3] | 46 | <para>Prepare Bash for compilation:</para>
|
---|
[73aedd1d] | 47 |
|
---|
[b772130] | 48 | <screen><userinput remap="configure">./configure --prefix=/tools --without-bash-malloc \
|
---|
| 49 | ac_cv_func_working_mktime=yes</userinput></screen>
|
---|
[73aedd1d] | 50 |
|
---|
[81109e3] | 51 | <variablelist>
|
---|
[b772130] | 52 | <title>The meaning of the configure options:</title>
|
---|
[81fd230] | 53 |
|
---|
[81109e3] | 54 | <varlistentry>
|
---|
| 55 | <term><parameter>--without-bash-malloc</parameter></term>
|
---|
| 56 | <listitem>
|
---|
[28bb0634] | 57 | <para>This option turns off the use of Bash's memory allocation
|
---|
[81109e3] | 58 | (<function>malloc</function>) function which is known to cause
|
---|
| 59 | segmentation faults. By turning this option off, Bash will use
|
---|
| 60 | the <function>malloc</function> functions from Glibc which are
|
---|
| 61 | more stable.</para>
|
---|
| 62 | </listitem>
|
---|
| 63 | </varlistentry>
|
---|
[b772130] | 64 | <varlistentry>
|
---|
[1fa0f19] | 65 | <term><parameter>ac_cv_func_working_mktime=yes</parameter></term>
|
---|
| 66 | <listitem>
|
---|
| 67 | <para>This parameter bypasses the search for mktime in configure
|
---|
| 68 | and uses the version in glibc. The is necessary due to a change in
|
---|
| 69 | gcc that has not been incorporated into this package yet.</para>
|
---|
| 70 | </listitem>
|
---|
[b772130] | 71 | </varlistentry>
|
---|
[81fd230] | 72 |
|
---|
[81109e3] | 73 | </variablelist>
|
---|
| 74 |
|
---|
| 75 | <para>Compile the package:</para>
|
---|
[73aedd1d] | 76 |
|
---|
[0445a3d] | 77 | <screen><userinput remap="make">make</userinput></screen>
|
---|
[73aedd1d] | 78 |
|
---|
[1fa0f19] | 79 | <para>Compilation is now complete. As discussed earlier, running the test
|
---|
| 80 | suite is not mandatory for the temporary tools here in this chapter. To run
|
---|
| 81 | the Bash test suite anyway, issue the following command:</para>
|
---|
| 82 |
|
---|
[0445a3d] | 83 |
|
---|
| 84 | <screen><userinput remap="test">make tests</userinput></screen>
|
---|
[73aedd1d] | 85 |
|
---|
[81109e3] | 86 | <para>Install the package:</para>
|
---|
[73aedd1d] | 87 |
|
---|
[0445a3d] | 88 | <screen><userinput remap="install">make install</userinput></screen>
|
---|
[73aedd1d] | 89 |
|
---|
[81109e3] | 90 | <para>Make a link for the programs that use <command>sh</command> for
|
---|
| 91 | a shell:</para>
|
---|
[3d36131c] | 92 |
|
---|
[0445a3d] | 93 | <screen><userinput remap="install">ln -vs bash /tools/bin/sh</userinput></screen>
|
---|
[73aedd1d] | 94 |
|
---|
[81109e3] | 95 | </sect2>
|
---|
[6370fa6] | 96 |
|
---|
[81109e3] | 97 | <sect2 role="content">
|
---|
| 98 | <title/>
|
---|
[81fd230] | 99 |
|
---|
[81109e3] | 100 | <para>Details on this package are located in
|
---|
| 101 | <xref linkend="contents-bash" role="."/></para>
|
---|
[81fd230] | 102 |
|
---|
[81109e3] | 103 | </sect2>
|
---|
| 104 |
|
---|
| 105 | </sect1>
|
---|