source: postlfs/shells/dash.xml@ 57cc7a3

trunk
Last change on this file since 57cc7a3 was 57cc7a3, checked in by Bruce Dubbs <bdubbs@…>, 8 weeks ago

Package updates.
Update to gnome-terminal-3.40.2.
Update to vte-0.64.2.
Update to libogg-1.3.5.
Update to nfs-utils-2.5.3.
Update to librsvg-2.50.7.
Update to libqmi-1.28.6.
Update to dash-0.5.11.4.

  • Property mode set to 100644
File size: 5.9 KB
Line 
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 <!ENTITY dash-download-http "http://gondor.apana.org.au/~herbert/dash/files/dash-&dash-version;.tar.gz">
8 <!ENTITY dash-download-ftp " ">
9 <!ENTITY dash-md5sum "39d6fb8ab465be82a2276060bc3759d3">
10 <!ENTITY dash-size "236 KB">
11 <!ENTITY dash-buildsize "2.7 MB">
12 <!ENTITY dash-time "less than 0.1 SBU">
13]>
14
15<sect1 id="dash" xreflabel="Dash-&dash-version;">
16 <?dbhtml filename="dash.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Dash-&dash-version;</title>
23
24 <indexterm zone="dash">
25 <primary sortas="a-Dash">Dash</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Dash</title>
30
31 <para>
32 <application>Dash</application> is a POSIX compliant shell. It can be
33 installed as /bin/sh or as the default shell for either <systemitem
34 class="username">root</systemitem> or a second user with a userid of 0.
35 It depends on fewer libraries than the <application>Bash</application>
36 shell and is therefore less likely to be affected by an upgrade problem
37 or disk failure. <application>Dash</application> is also useful for
38 checking that a script is completely compatible with POSIX syntax.
39 </para>
40
41 &lfs101_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&dash-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&dash-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &dash-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &dash-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &dash-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &dash-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Dash Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional">
81 <ulink url="http://www.thrysoee.dk/editline/">libedit</ulink>
82 (command line editor library)
83 </para>
84
85 <para condition="html" role="usernotes">User Notes:
86 <ulink url="&blfs-wiki;/dash"/></para>
87
88 </sect2>
89
90 <sect2 role="installation">
91 <title>Installation of Dash</title>
92
93 <para>
94 Install <application>Dash</application> by running the following
95 commands:
96 </para>
97
98<screen><userinput>./configure --bindir=/bin --mandir=/usr/share/man &amp;&amp;
99make</userinput></screen>
100
101 <para>
102 This package does not come with a test suite.
103 </para>
104
105 <para>
106 Now, as the <systemitem class="username">root</systemitem> user:
107 </para>
108
109<screen role="root"><userinput>make install</userinput></screen>
110
111 <para>
112 If you would like to make <command>dash</command> the default
113 <command>sh</command>, recreate the <filename>/bin/sh</filename>
114 symlink as the <systemitem class="username">root</systemitem> user:
115 </para>
116
117 <note>
118 <para>
119 If you create the symbolic link from <command>dash</command>
120 to <command>sh</command>, you will need to reset the link to
121 <command>bash</command> to build LFS.
122 </para>
123 </note>
124
125<screen role="nodump"><userinput>ln -svf dash /bin/sh</userinput></screen>
126
127 </sect2>
128
129 <sect2 role="commands">
130 <title>Command Explanations</title>
131
132 <para>
133 <parameter>--bindir=/bin</parameter>: This parameter places the
134 <command>dash</command> binary into the root filesystem.
135 </para>
136
137 <para>
138 <option>--with-libedit</option>: To compile
139 <application>Dash</application> with libedit support.
140 </para>
141
142 </sect2>
143
144 <sect2 role="configuration">
145 <title>Configuring Dash</title>
146
147 <sect3 id="dash-config">
148 <title>Config Files</title>
149
150 <para>
151 <application>Dash</application> sources
152 <filename>/etc/profile</filename> and
153 <filename>~/.profile</filename>
154 </para>
155
156 <indexterm zone="dash dash-config">
157 <primary sortas="e-etc-profile">/etc/profile</primary>
158 </indexterm>
159
160 <indexterm zone="dash dash-config">
161 <primary sortas="e-AA.profile">~/.profile</primary>
162 </indexterm>
163
164 </sect3>
165
166 <sect3>
167 <title>Configuration Information</title>
168
169 <para>
170 Update <filename>/etc/shells</filename> to include the
171 <application>Dash</application> shell by issuing the following command
172 as the <systemitem class="username">root</systemitem> user:
173 </para>
174
175<screen role="root"><userinput>cat &gt;&gt; /etc/shells &lt;&lt; "EOF"
176<literal>/bin/dash</literal>
177EOF</userinput></screen>
178
179 </sect3>
180
181 </sect2>
182
183 <sect2 role="content">
184 <title>Contents</title>
185
186 <segmentedlist>
187 <segtitle>Installed Program</segtitle>
188 <segtitle>Installed Libraries</segtitle>
189 <segtitle>Installed Directories</segtitle>
190
191 <seglistitem>
192 <seg>dash</seg>
193 <seg>None</seg>
194 <seg>None</seg>
195 </seglistitem>
196 </segmentedlist>
197
198 <variablelist>
199 <bridgehead renderas="sect3">Short Description</bridgehead>
200 <?dbfo list-presentation="list"?>
201 <?dbhtml list-presentation="table"?>
202
203 <varlistentry id="dash-prog">
204 <term><command>dash</command></term>
205 <listitem>
206 <para>
207 is a POSIX compliant shell
208 </para>
209 <indexterm zone="dash dash-prog">
210 <primary sortas="b-dash">dash</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 </variablelist>
216
217 </sect2>
218
219</sect1>
Note: See TracBrowser for help on using the repository browser.