source: multimedia/libdriv/alsa-utils.xml@ 05eb990a

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 05eb990a was 75b1a338, checked in by Xi Ruoyao <xry111@…>, 16 months ago

Update more URLs to use https

Mostly plain http -> https replace, if https works. If there is a HTTP
redirection, use the redirect target (unless it's a mirror or l10n like
"https://kde.org/zh-cn/").

Some non-trivial change:

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