source: postlfs/shells/dash.xml@ 64218c2

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 64218c2 was 64218c2, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

Jist tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23605 af4574ff-66df-0310-9fd7-8a98e5e911e0

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