source: postlfs/shells/dash.xml@ be2215e

10.0 10.1 11.0 8.4 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since be2215e was be2215e, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tag packages in postlfs part

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

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