source: multimedia/libdriv/alsa-utils.xml@ b93a076

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b93a076 was b93a076, checked in by Bruce Dubbs <bdubbs@…>, 6 years ago

Update to elfutils-0.166.
Update to mariadb-10.1.13.
Update to gedit-3.20.1.
Update to glibmm-2.48.1.
Update to alsa-lib, alsa-plugins, alsa-utils-1.1.1.

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

  • Property mode set to 100644
File size: 13.4 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 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 "f8d00ad5fba757b4c3735d066cc288e2">
10 <!ENTITY alsa-utils-size "1.1 MB">
11 <!ENTITY alsa-utils-buildsize "9.4 MB">
12 <!ENTITY alsa-utils-time "0.1 SBU">
13]>
14
15<sect1 id="alsa-utils" xreflabel="alsa-utils-&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-utils-&alsa-utils-version;</title>
24
25 <indexterm zone="alsa-utils">
26 <primary sortas="a-alsa-utils">alsa-utils</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to ALSA Utilities</title>
31
32 <para>
33 The <application>ALSA Utilities</application> package contains
34 various utilities which are useful for controlling your sound
35 card.
36 </para>
37
38 &lfs79_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&alsa-utils-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&alsa-utils-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &alsa-utils-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &alsa-utils-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &alsa-utils-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &alsa-utils-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">ALSA Utilities Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="alsa-lib"/>
79 </para>
80
81 <bridgehead renderas="sect4">Optional</bridgehead>
82 <para role="optional">
83 <xref linkend="libsamplerate"/>,
84 <xref linkend="xmlto"/>,
85 <ulink url="http://hightek.org/dialog/">Dialog</ulink>, and
86 <ulink url="http://www.fftw.org/">FFTW</ulink>
87 </para>
88
89 <para condition="html" role="usernotes">User Notes:
90 <ulink url="&blfs-wiki;/alsa-utils"/>
91 </para>
92 </sect2>
93
94 <sect2 role="installation">
95 <title>Installation of ALSA Utilities</title>
96
97 <para>
98 Install <application>ALSA Utilities</application> by
99 running the following commands:
100 </para>
101
102<screen><userinput>./configure --disable-alsaconf \
103 --disable-bat \
104 --disable-xmlto \
105 --with-curses=ncursesw &amp;&amp;
106make</userinput></screen>
107
108 <para>
109 This package does not come with a test suite.
110 </para>
111
112 <para>
113 Now, as the <systemitem class="username">root</systemitem> user:
114 </para>
115
116<screen role="root"><userinput>make install</userinput></screen>
117
118 </sect2>
119
120 <sect2 role="commands">
121 <title>Command Explanations</title>
122
123 <para>
124 <option>--disable-alsaconf</option>: This switch disables building the
125 <command>alsaconf</command> configuration tool which is incompatible with
126 <application>Udev</application>.
127 </para>
128
129 <para>
130 <option>--disable-xmlto</option>: Omit this switch if you have installed
131 <xref linkend="xmlto"/> and want to regenerate the man pages.
132 </para>
133
134 <para>
135 <option>--disable-bat</option>: Omit this switch if you have installed
136 <ulink url="http://www.fftw.org/">FFTW</ulink> and wish to install
137 the Basic Audio Tester (BAT).
138 </para>
139
140 <para>
141 <option>--with-curses=ncursesw</option>: This switch forces the use of
142 wide-character ncurses libraries.
143 </para>
144
145 </sect2>
146
147 <sect2 role="configuration">
148 <title>Configuring ALSA Utilities</title>
149
150 <sect3 id="alsa-utils-config">
151 <title>Config Files</title>
152
153 <para>
154 <filename>/var/lib/alsa/asound.state</filename>
155 </para>
156
157 <indexterm zone="alsa-utils alsa-utils-config">
158 <primary sortas="e-var-lib-alsa-asound.state">/var/lib/alsa/asound.state</primary>
159 </indexterm>
160
161 </sect3>
162
163 <sect3>
164 <title>Configuration Information</title>
165
166 <para>
167 Note that all channels of your sound card are muted by default.
168 You can use the <command>alsamixer</command> program to change
169 this. Use <command>speaker-test</command> to check that your
170 settings have been applied correctly. You should hear
171 <quote>pink noise</quote> on your speakers.
172 </para>
173
174 <para>
175 The <filename>alsactl</filename> program is normally run from a
176 standard <application>udev</application> rule. The first time it
177 is run, it will complain that there is no state in
178 <filename>/var/lib/alsa/asound.state</filename>. You can prevent
179 this by running the following commands as the
180 <systemitem class="username">root</systemitem> user:
181 </para>
182
183<screen role="root"><userinput>alsactl -L store</userinput></screen>
184
185 <para>
186 The volume settings should be restored from the saved state by
187 <application>Udev</application> when the device is detected
188 (during boot or when plugged in for USB devices).
189 </para>
190
191 <para>
192 All sound devices are not accessible for any user except
193 <systemitem class="username">root</systemitem> and members of the
194 <systemitem class="groupname">audio</systemitem> group. Add any
195 users that might use the sound devices to that group:
196 </para>
197
198<screen role="root"><userinput>usermod -a -G audio <replaceable>&lt;username&gt;</replaceable></userinput></screen>
199
200 <note>
201 <para>
202 You may need to log out and back in again to refresh your group
203 memberships. '<command>su <replaceable>&lt;username&gt;</replaceable></command>'
204 should work as well.
205 </para>
206 </note>
207
208 </sect3>
209
210 <sect3 id="alsa-utils-init">
211 <title>Boot Script</title>
212
213 <indexterm zone="alsa-utils alsa-utils-init">
214 <primary sortas="f-alsa">alsa</primary>
215 </indexterm>
216
217 <para>
218 To automatically store and restore volume settings (if udev rule doesn't
219 work for you) when the system is rebooted, install the
220 <filename>/etc/rc.d/init.d/alsa</filename> boot script from the <xref
221 linkend="bootscripts"/> package.
222 </para>
223
224<screen role="root"><userinput>make install-alsa</userinput></screen>
225
226 </sect3>
227
228 </sect2>
229
230 <sect2 role="content">
231 <title>Contents</title>
232
233 <segmentedlist>
234 <segtitle>Installed Programs</segtitle>
235 <segtitle>Installed Libraries</segtitle>
236 <segtitle>Installed Directories</segtitle>
237
238 <seglistitem>
239 <seg>
240 aconnect, alsaloop, alsamixer, alsatplg,
241 alsaucm, amidi, amixer, aplay, aplaymidi, arecord (symlink),
242 arecordmidi, aseqdump, iaseqnet, iecset, and speaker-test
243 </seg>
244 <seg>
245 None
246 </seg>
247 <seg>
248 /usr/share/sounds/alsa and /var/lib/alsa
249 </seg>
250 </seglistitem>
251 </segmentedlist>
252
253 <variablelist>
254 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
255 <?dbfo list-presentation="list"?>
256 <?dbhtml list-presentation="table"?>
257
258 <varlistentry id="aconnect">
259 <term><command>aconnect</command></term>
260 <listitem>
261 <para>
262 is a utility for connecting and disconnecting two
263 existing ports in the ALSA sequencer system.
264 </para>
265 <indexterm zone="alsa-utils aconnect">
266 <primary sortas="b-aconnect">aconnect</primary>
267 </indexterm>
268 </listitem>
269 </varlistentry>
270
271 <varlistentry id="alsaloop">
272 <term><command>alsaloop</command></term>
273 <listitem>
274 <para>
275 allows creation of a PCM loopback between a PCM capture
276 device and a PCM playback device.
277 </para>
278 <indexterm zone="alsa-utils alsaloop">
279 <primary sortas="b-alsaloop">alsaloop</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="alsamixer">
285 <term><command>alsamixer</command></term>
286 <listitem>
287 <para>
288 is an Ncurses based mixer program for use with
289 the ALSA sound card drivers.
290 </para>
291 <indexterm zone="alsa-utils alsamixer">
292 <primary sortas="b-alsamixer">alsamixer</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="alsaucm">
298 <term><command>alsaucm</command></term>
299 <listitem>
300 <para>
301 allows applications to access the hardware in an abstracted manner
302 </para>
303 <indexterm zone="alsa-utils alsaucm">
304 <primary sortas="b-alsaucm">alsaucm</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="amidi">
310 <term><command>amidi</command></term>
311 <listitem>
312 <para>
313 is used to read from and write to ALSA
314 RawMIDI ports.
315 </para>
316 <indexterm zone="alsa-utils amidi">
317 <primary sortas="b-amidi">amidi</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="amixer">
323 <term><command>amixer</command></term>
324 <listitem>
325 <para> allows command-line control of the mixers for the
326 ALSA sound card drivers.</para>
327 <indexterm zone="alsa-utils amixer">
328 <primary sortas="b-amixer">amixer</primary>
329 </indexterm>
330 </listitem>
331 </varlistentry>
332
333 <varlistentry id="aplay">
334 <term><command>aplay</command></term>
335 <listitem>
336 <para>
337 is a command-line soundfile player for the
338 ALSA sound card drivers.
339 </para>
340 <indexterm zone="alsa-utils aplay">
341 <primary sortas="b-aplay">aplay</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="aplaymidi">
347 <term><command>aplaymidi</command></term>
348 <listitem>
349 <para>
350 is a command-line utility that plays the specified
351 MIDI file(s) to one or more ALSA sequencer ports.
352 </para>
353 <indexterm zone="alsa-utils aplaymidi">
354 <primary sortas="b-aplaymidi">aplaymidi</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="arecord">
360 <term><command>arecord</command></term>
361 <listitem>
362 <para>
363 is a command-line soundfile recorder for the
364 ALSA sound card drivers.
365 </para>
366 <indexterm zone="alsa-utils arecord">
367 <primary sortas="b-arecord">arecord</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="arecordmidi">
373 <term><command>arecordmidi</command></term>
374 <listitem>
375 <para>
376 is a command-line utility that records a standard
377 MIDI file from one or more ALSA sequencer ports.
378 </para>
379 <indexterm zone="alsa-utils arecordmidi">
380 <primary sortas="b-arecordmidi">arecordmidi</primary>
381 </indexterm>
382 </listitem>
383 </varlistentry>
384
385 <varlistentry id="aseqdump">
386 <term><command>aseqdump</command></term>
387 <listitem>
388 <para>
389 is a command-line utility that prints the sequencer events it
390 receives as text.
391 </para>
392 <indexterm zone="alsa-utils aseqdump">
393 <primary sortas="b-aseqdump">aseqdump</primary>
394 </indexterm>
395 </listitem>
396 </varlistentry>
397
398 <varlistentry id="aseqnet">
399 <term><command>aseqnet</command></term>
400 <listitem>
401 <para>
402 is an ALSA sequencer client which sends and
403 receives event packets over a network.
404 </para>
405 <indexterm zone="alsa-utils aseqnet">
406 <primary sortas="b-aseqnet">aseqnet</primary>
407 </indexterm>
408 </listitem>
409 </varlistentry>
410
411 <varlistentry id="iecset">
412 <term><command>iecset</command></term>
413 <listitem>
414 <para>
415 is a small utility to set or dump the IEC958 (or so-called
416 <quote>S/PDIF</quote>) status bits of the specified sound
417 card via the ALSA control API.
418 </para>
419 <indexterm zone="alsa-utils iecset">
420 <primary sortas="b-iecset">iecset</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="speaker-test">
426 <term><command>speaker-test</command></term>
427 <listitem>
428 <para>
429 is a command-line speaker test tone generator for ALSA.
430 </para>
431 <indexterm zone="alsa-utils speaker-test">
432 <primary sortas="b-speaker-test">speaker-test</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 </variablelist>
438
439 </sect2>
440
441</sect1>
Note: See TracBrowser for help on using the repository browser.