source: multimedia/libdriv/alsa-lib.xml@ b5ad7a4

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since b5ad7a4 was b36aabe, checked in by Tim Tassonis <stuff@…>, 14 months ago

Update to alsa-lib alsa-utils 1.2.9.
  • Property mode set to 100644
File size: 8.1 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-lib-download-http "&alsa-download-http;/lib/alsa-lib-&alsa-lib-version;.tar.bz2">
8 <!ENTITY alsa-lib-download-ftp "&alsa-download-ftp;/lib/alsa-lib-&alsa-lib-version;.tar.bz2">
9 <!ENTITY alsa-lib-md5sum "d29f5ebe9a4ff1be70508ecbf6655318">
10 <!ENTITY alsa-lib-size "1.1 MB">
11 <!ENTITY alsa-lib-buildsize "45 MB (with tests and docs)">
12 <!ENTITY alsa-lib-time "0.3 SBU (with tests and docs)">
13]>
14
15<sect1 id="alsa-lib" xreflabel="alsa-lib-&alsa-lib-version;">
16 <?dbhtml filename="alsa-lib.html"?>
17
18
19 <title>alsa-lib-&alsa-lib-version;</title>
20
21 <indexterm zone="alsa-lib">
22 <primary sortas="a-alsa-lib">alsa-lib</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to ALSA Library</title>
27
28 <para>
29 The <application>ALSA Library</application> package contains
30 the ALSA library used by programs (including <application>ALSA
31 Utilities</application>) requiring access to the ALSA sound
32 interface.
33 </para>
34
35 &lfs113_checked;
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>
41 Download (HTTP): <ulink url="&alsa-lib-download-http;"/>
42 </para>
43 </listitem>
44 <listitem>
45 <para>
46 Download (FTP): <ulink url="&alsa-lib-download-ftp;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download MD5 sum: &alsa-lib-md5sum;
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download size: &alsa-lib-size;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Estimated disk space required: &alsa-lib-buildsize;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated build time: &alsa-lib-time;
67 </para>
68 </listitem>
69 </itemizedlist>
70
71 <bridgehead renderas="sect3">ALSA Library Dependencies</bridgehead>
72
73 <bridgehead renderas="sect4">Recommended (Runtime)</bridgehead>
74 <para role="runtime">
75 <phrase revision='sysv'><xref linkend='elogind'/></phrase>
76 <phrase revision='systemd'><xref linkend='systemd'/></phrase>
77 </para>
78
79 <note>
80 <para>
81 If the recommended runtime dependency is not installed, you may
82 need to run any application requiring ALSA library as the &root;
83 user or a user in the
84 <systemitem class='groupname'>audio</systemitem> group.
85 </para>
86 </note>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional">
90 <xref linkend="doxygen"/>,
91 <xref linkend="python2"/>, and
92 <ulink url="https://www.alsa-project.org/files/pub/lib/">alsa-ucm-conf</ulink>
93 </para>
94
95 <para condition="html" role="usernotes">User Notes:
96 <ulink url="&blfs-wiki;/alsa-lib"/>
97 </para>
98 </sect2>
99
100 <sect2 role="kernel" id="alsa-lib-kernel">
101 <title>Kernel Configuration</title>
102
103 <para>
104 If needed, enable the following options in the kernel
105 configuration and recompile the kernel:
106 </para>
107
108 <screen><literal>Device Drivers ---&gt;
109 &lt;*/M&gt; Sound card support ---&gt; [CONFIG_SOUND]
110 &lt;*/M&gt; Advanced Linux Sound Architecture ---&gt; [CONFIG_SND]
111 Select settings and drivers appropriate for your hardware.</literal></screen>
112
113 <para>
114 In the Device Drivers &rArr; Sound card support &rArr; Advanced Linux
115 Sound Architecture section of the kernel configuration, select the
116 settings and drivers appropriate for your hardware. If necessary,
117 recompile and install your new kernel.
118 </para>
119
120 <indexterm zone="alsa-lib alsa-lib-kernel">
121 <primary sortas="d-ALSA">ALSA</primary>
122 </indexterm>
123
124 </sect2>
125
126 <sect2 role="installation">
127 <title>Installation of ALSA Library</title>
128
129 <para>
130 Install <application>ALSA Library</application> by
131 running the following commands:
132 </para>
133
134<screen><userinput>./configure &amp;&amp;
135make</userinput></screen>
136
137 <para>
138 If you have <application>Doxygen</application> installed and you wish to
139 build the library API documentation, run the following
140 commands from the top-level directory of the source tree:
141 </para>
142
143<screen remap="doc"><userinput>make doc</userinput></screen>
144
145 <para>
146 To test the results, issue: <command>make check</command>.
147 </para>
148
149 <para>
150 Now, as the <systemitem class="username">root</systemitem> user:
151 </para>
152
153<screen role="root"><userinput>make install</userinput></screen>
154
155 <para>
156 To install the API documentation, run the following command as
157 the <systemitem class="username">root</systemitem> user:
158 </para>
159
160<screen role="root"
161 remap="doc"><userinput>install -v -d -m755 /usr/share/doc/alsa-lib-&alsa-lib-version;/html/search &amp;&amp;
162install -v -m644 doc/doxygen/html/*.* \
163 /usr/share/doc/alsa-lib-&alsa-lib-version;/html &amp;&amp;
164install -v -m644 doc/doxygen/html/search/* \
165 /usr/share/doc/alsa-lib-&alsa-lib-version;/html/search</userinput></screen>
166
167 </sect2>
168
169 <sect2 role="configuration">
170 <title>Configuring ALSA Library</title>
171
172 <sect3 id="alsa-lib-config">
173 <title>Config Files</title>
174
175 <para>
176 <filename>~/.asoundrc</filename> and
177 <filename>/etc/asound.conf</filename>
178 </para>
179
180 <indexterm zone="alsa-lib alsa-lib-config">
181 <primary sortas="e-AA.asoundrc">~/.asoundrc</primary>
182 </indexterm>
183
184 <indexterm zone="alsa-lib alsa-lib-config">
185 <primary sortas="e-etc-asound.conf">/etc/asound.conf</primary>
186 </indexterm>
187
188 </sect3>
189
190 <sect3>
191 <title>Configuration Information</title>
192
193 <para>
194 The default <filename>alsa.conf</filename> is adequate for most
195 installations. For extra functionality and/or advanced control of your
196 sound device, you may need to create additional configuration files.
197 For information on the available configuration parameters, visit
198 <ulink url="https://www.alsa-project.org/main/index.php/Asoundrc"/>.
199 </para>
200
201 </sect3>
202
203 </sect2>
204
205 <sect2 role="content">
206 <title>Contents</title>
207
208 <segmentedlist>
209 <segtitle>Installed Program</segtitle>
210 <segtitle>Installed Library</segtitle>
211 <segtitle>Installed Directories</segtitle>
212
213 <seglistitem>
214 <seg>
215 aserver
216 </seg>
217 <seg>
218 libasound.so and
219 libatopology.so
220 </seg>
221 <seg>
222 /usr/include/alsa,
223 /usr/share/alsa and
224 /usr/share/doc/alsa-lib-&alsa-lib-version;
225 </seg>
226 </seglistitem>
227 </segmentedlist>
228
229 <variablelist>
230 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
231 <?dbfo list-presentation="list"?>
232 <?dbhtml list-presentation="table"?>
233
234 <varlistentry id="aserver">
235 <term><command>aserver</command></term>
236 <listitem>
237 <para>
238 is the ALSA server
239 </para>
240 <indexterm zone="alsa-lib aserver">
241 <primary sortas="b-aserver">aserver</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="libasound">
247 <term><filename class="libraryfile">libasound.so</filename></term>
248 <listitem>
249 <para>
250 contains the ALSA API functions
251 </para>
252 <indexterm zone="alsa-lib libasound">
253 <primary sortas="c-libasound">libasound.so</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="libatopology">
259 <term><filename class="libraryfile">libatopology.so</filename></term>
260 <listitem>
261 <para>
262 contains API functions for the ALSA topologies
263 </para>
264 <indexterm zone="alsa-lib libatopology">
265 <primary sortas="c-libatopology">libatopology.so</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 </variablelist>
271
272 </sect2>
273
274</sect1>
Note: See TracBrowser for help on using the repository browser.