source: multimedia/libdriv/alsa-utils.xml@ 5e82411c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 5e82411c was 5e82411c, checked in by DJ Lucas <dj@…>, 19 years ago

Update Postfix instructions to 2.2.5, cleanup alsa-utils

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4862 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 11.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY alsa-utils-download-http "&alsa-download-http;/utils/alsa-utils-&alsa-utils-version;.tar.bz2">
8 <!ENTITY alsa-utils-download-ftp "&alsa-download-ftp;/utils/alsa-utils-&alsa-utils-version;.tar.bz2">
9 <!ENTITY alsa-utils-md5sum "d4b77e9fe0311772293e402fdd634ad2">
10 <!ENTITY alsa-utils-size "935 KB">
11 <!ENTITY alsa-utils-buildsize "5.9 MB">
12 <!ENTITY alsa-utils-time "0.1 SBU">
13]>
14
15<sect1 id="alsa-utils" xreflabel="ALSA Utilities-&alsa-utils-version;">
16 <?dbhtml filename="alsa-utils.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>ALSA Utilities-&alsa-utils-version;</title>
24
25 <indexterm zone="alsa-utils">
26 <primary sortas="a-ALSA-Utilities">ALSA Utilities</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to ALSA Utilities</title>
31
32 <para>The <application>ALSA Utilities</application> package contains
33 various utilities which are useful for controlling your sound card.</para>
34
35 <bridgehead renderas="sect3">Package Information</bridgehead>
36 <itemizedlist spacing="compact">
37 <listitem>
38 <para>Download (HTTP): <ulink url="&alsa-utils-download-http;"/></para>
39 </listitem>
40 <listitem>
41 <para>Download (FTP): <ulink url="&alsa-utils-download-ftp;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download MD5 sum: &alsa-utils-md5sum;</para>
45 </listitem>
46 <listitem>
47 <para>Download size: &alsa-utils-size;</para>
48 </listitem>
49 <listitem>
50 <para>Estimated disk space required: &alsa-utils-buildsize;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated build time: &alsa-utils-time;</para>
54 </listitem>
55 </itemizedlist>
56
57 <bridgehead renderas="sect3">ALSA Utilities Dependencies</bridgehead>
58
59 <bridgehead renderas="sect4">Required</bridgehead>
60 <para><xref linkend="alsa-lib"/></para>
61
62 </sect2>
63
64 <sect2 role="installation">
65 <title>Installation of ALSA Utilities</title>
66
67 <para>Install <application>ALSA Utilities</application> by
68 running the following commands:</para>
69
70<screen><userinput>./configure &amp;&amp;
71make</userinput></screen>
72
73 <para>This package does not come with a test suite.</para>
74
75 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
76
77<screen role="root"><userinput>make install</userinput></screen>
78
79 </sect2>
80
81 <sect2 role="configuration">
82 <title>Configuring ALSA Utilities</title>
83
84 <sect3 id="alsa-utils-config">
85 <title>Config Files</title>
86
87 <para><filename>/etc/asound.state</filename></para>
88
89 <indexterm zone="alsa-utils alsa-utils-config">
90 <primary sortas="e-etc-asound.state">/etc/asound.state</primary>
91 </indexterm>
92
93 </sect3>
94
95 <sect3 id="alsa-utils-init">
96 <title>Configuration Information</title>
97
98 <para> Use a bootscript to store the values at shutdown.</para>
99
100 <indexterm zone="alsa-utils alsa-utils-init">
101 <primary sortas="f-alsa">alsa</primary>
102 </indexterm>
103
104 <para>As the <systemitem class="username">root</systemitem> user,
105 install the init script <filename>/etc/rc.d/init.d/alsa</filename> included
106 in the <xref linkend="intro-important-bootscripts"/> package.</para>
107
108<screen role="root"><userinput>make install-alsa</userinput></screen>
109
110 <para>Note that all channels of your sound card are muted by default.
111 You can use the <command>alsamixer</command> program from
112 <application>ALSA Utilities</application> to change this.</para>
113
114 <para>The first time the dev.d script below is run, it will complain
115 that there is no state in <filename>/etc/asound.state</filename>.
116 You can prevent this by running the following commands while still
117 the <systemitem class="username">root</systemitem> user (after
118 installing <application>ALSA Utilities</application>):</para>
119
120<screen role="root"><userinput>touch /etc/asound.state &amp;&amp;
121alsactl store</userinput></screen>
122
123 <para>The volumes will be restored using the saved settings by a
124 dev.d handler script that will execute when the device is detected
125 durring boot (when pluged in for USB devices). While still the
126 <systemitem class="username">root</systemitem> user, create the dev.d
127 script with the following commands:</para>
128
129<screen role="root"><userinput>install -d -m755 /etc/dev.d/snd &amp;&amp;
130cat &gt;&gt; /etc/dev.d/snd/alsa.dev &lt;&lt; "EOF" &amp;&amp;
131#!/bin/sh -e
132DEV_BASENAME="${DEVNAME##*/}"
133N="${DEV_BASENAME#controlC}"
134case "$DEV_BASENAME" in
135 controlC[0-7])
136 x=0
137 while [ $x -lt 20 ]
138 do
139 sleep 1
140 if [ -f /usr/sbin/alsactl ]; then
141 /usr/sbin/alsactl restore $N
142 exit 0
143 else
144 if [ $x -eq 20 ]; then
145 exit 1
146 fi
147 fi
148 done &amp;
149 ;;
150esac
151exit 0
152EOF
153chmod 755 /etc/dev.d/snd/alsa.dev</userinput></screen>
154
155
156 <para>You may wish to do additional configuration on a per card basis.
157 For example, if you wish to load soundfont banks into the first
158 device (card0), use the following sample script:</para>
159
160<screen>#!/bin/sh -e
161# Begin /etc/dev.d/snd/controlC0/asfxload.dev
162
163# Load GM8.sf2 for soundcard 0
164/usr/bin/asfxload /usr/share/sounds/sf2/8mbgmsfx.sf2 -D "hw:0,2"
165
166# End /etc/dev.d/snd/controlC0/sfxload.dev</screen>
167
168 </sect3>
169
170 </sect2>
171
172 <sect2 role="content">
173 <title>Contents</title>
174
175 <segmentedlist>
176 <segtitle>Installed Programs</segtitle>
177 <segtitle>Installed Libraries</segtitle>
178 <segtitle>Installed Directories</segtitle>
179
180 <seglistitem>
181 <seg>aconnect, alsaconf, alsactl, alsamixer, amidi, amixer, aplay, aplaymidi,
182 arecord, arecordmidi, aseqnet, aseqdump, iecset, and speaker-test</seg>
183 <seg>None</seg>
184 <seg>None</seg>
185 </seglistitem>
186 </segmentedlist>
187
188 <variablelist>
189 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
190 <?dbfo list-presentation="list"?>
191 <?dbhtml list-presentation="table"?>
192
193 <varlistentry id="aconnect">
194 <term><command>aconnect</command></term>
195 <listitem>
196 <para>is a utility for connecting and disconnecting two existing
197 ports in the ALSA sequencer system.</para>
198 <indexterm zone="alsa-utils aconnect">
199 <primary sortas="b-aconnect">aconnect</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="alsaconf">
205 <term><command>alsaconf</command></term>
206 <listitem>
207 <para>is a configuration tool which tries to detect the sound cards
208 on your system and write a suitable configuration file for ALSA.</para>
209 <indexterm zone="alsa-utils alsaconf">
210 <primary sortas="b-alsaconf">alsaconf</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 <varlistentry id="alsactl">
216 <term><command>alsactl</command></term>
217 <listitem>
218 <para>is used to control advanced settings for the
219 ALSA sound card drivers.</para>
220 <indexterm zone="alsa-utils alsactl">
221 <primary sortas="b-alsactl">alsactl</primary>
222 </indexterm>
223 </listitem>
224 </varlistentry>
225
226 <varlistentry id="alsamixer">
227 <term><command>alsamixer</command></term>
228 <listitem>
229 <para>is an ncurses-based mixer program for use with the
230 ALSA sound card drivers.</para>
231 <indexterm zone="alsa-utils alsamixer">
232 <primary sortas="b-alsamixer">alsamixer</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="amidi">
238 <term><command>amidi</command></term>
239 <listitem>
240 <para>is used to read from and write to ALSA
241 RawMIDI ports.</para>
242 <indexterm zone="alsa-utils amidi">
243 <primary sortas="b-amidi">amidi</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="amixer">
249 <term><command>amixer</command></term>
250 <listitem>
251 <para> allows command-line control of the mixers for the
252 ALSA sound card drivers.</para>
253 <indexterm zone="alsa-utils amixer">
254 <primary sortas="b-amixer">amixer</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="aplay">
260 <term><command>aplay</command></term>
261 <listitem>
262 <para>is a command-line soundfile player for the
263 ALSA sound card drivers.</para>
264 <indexterm zone="alsa-utils aplay">
265 <primary sortas="b-aplay">aplay</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="aplaymidi">
271 <term><command>aplaymidi</command></term>
272 <listitem>
273 <para>is a command-line utility that plays the specified
274 MIDI file(s) to one or more ALSA sequencer ports.</para>
275 <indexterm zone="alsa-utils aplaymidi">
276 <primary sortas="b-aplaymidi">aplaymidi</primary>
277 </indexterm>
278 </listitem>
279 </varlistentry>
280
281 <varlistentry id="arecord">
282 <term><command>arecord</command></term>
283 <listitem>
284 <para>is a command-line soundfile recorder for the
285 ALSA sound card drivers.</para>
286 <indexterm zone="alsa-utils arecord">
287 <primary sortas="b-arecord">arecord</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="arecordmidi">
293 <term><command>arecordmidi</command></term>
294 <listitem>
295 <para>is a command-line utility that records a standard
296 MIDI file from one or more ALSA sequencer ports.</para>
297 <indexterm zone="alsa-utils arecordmidi">
298 <primary sortas="b-arecordmidi">arecordmidi</primary>
299 </indexterm>
300 </listitem>
301 </varlistentry>
302
303 <varlistentry id="aseqdump">
304 <term><command>aseqdump</command></term>
305 <listitem>
306 <para>is a command-line utility that prints the sequencer events it
307 receives as text.</para>
308 <indexterm zone="alsa-utils aseqdump">
309 <primary sortas="b-aseqdump">aseqdump</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="aseqnet">
315 <term><command>aseqnet</command></term>
316 <listitem>
317 <para>is an ALSA sequencer client which sends
318 and receives event packets over a network.</para>
319 <indexterm zone="alsa-utils aseqnet">
320 <primary sortas="b-aseqnet">aseqnet</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="iecset">
326 <term><command>iecset</command></term>
327 <listitem>
328 <para>is a small utility to set or dump the IEC958 (or so-called
329 <quote>S/PDIF</quote>) status bits of the specified sound
330 card via the ALSA control API.</para>
331 <indexterm zone="alsa-utils iecset">
332 <primary sortas="b-iecset">iecset</primary>
333 </indexterm>
334 </listitem>
335 </varlistentry>
336
337 <varlistentry id="speaker-test">
338 <term><command>speaker-test</command></term>
339 <listitem>
340 <para>is a command-line speaker test tone generator for ALSA.</para>
341 <indexterm zone="alsa-utils speaker-test">
342 <primary sortas="b-speaker-test">speaker-test</primary>
343 </indexterm>
344 </listitem>
345 </varlistentry>
346
347 </variablelist>
348
349 </sect2>
350
351</sect1>
Note: See TracBrowser for help on using the repository browser.