source: postlfs/shells/dash.xml@ 5603a81

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5603a81 was 5603a81, checked in by Andrew Benton <andy@…>, 9 years ago

Added some checked tags

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