source: multimedia/libdriv/alsa-utils.xml@ 758f3f6

10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 758f3f6 was 758f3f6, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Update to xfsprogs-5.9.0
Update to alsa-lib, alsa-utils, and alsa-firmware-1.2.4
Update to faad2-2_10_0
Update to poppler-data-0.4.10
Update to List-MoreUtils-XS-0.430 (Perl Module)
Update to List-MoreUtils-0.430 (Perl Module)
Update to URI-5.05 (Perl Module)
Update to bind9 and bind-utils 9.16.8
Update to nfs-utils-2.5.2

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

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