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

10.0 10.1 11.0 11.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 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since d7ecaa6 was d7ecaa6, checked in by Randy McMurchy <randy@…>, 17 years ago

Removed spaces from blank lines and excess spaces from the end of XML data

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

  • Property mode set to 100644
File size: 7.2 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-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 "c677299ed39d069c9a4b6a999e34ffe7">
10 <!ENTITY alsa-lib-size "682 KB">
11 <!ENTITY alsa-lib-buildsize "34.2 MB (additional 11.4 MB to build and install docs)">
12 <!ENTITY alsa-lib-time "0.56 SBU">
13]>
14
15<sect1 id="alsa-lib" xreflabel="ALSA Library-&alsa-lib-version;">
16 <?dbhtml filename="alsa-lib.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>ALSA Library-&alsa-lib-version;</title>
24
25 <indexterm zone="alsa-lib">
26 <primary sortas="a-ALSA-Library">ALSA Library</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to ALSA Library</title>
31
32 <para>The <application>ALSA Library</application> package contains
33 the ALSA library. This is used by programs (including <application>ALSA
34 Utilities</application>) requiring access to the ALSA sound interface.</para>
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&alsa-lib-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&alsa-lib-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &alsa-lib-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &alsa-lib-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &alsa-lib-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &alsa-lib-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <bridgehead renderas="sect3">ALSA Library Dependencies</bridgehead>
59
60 <bridgehead renderas="sect4">Optional</bridgehead>
61 <para><ulink url="http://jackit.sourceforge.net/">JACK</ulink> and
62 <xref linkend="doxygen"/></para>
63
64 </sect2>
65
66 <sect2 role="kernel" id="alsa-lib-kernel">
67 <title>Kernel Configuration</title>
68
69 <para>In the <quote>Sound</quote> section of the kernel configuration, edit
70 <emphasis role="bold">Advanced Linux Sound Architecture</emphasis>
71 options to match your audio hardware and disable deprecated
72 <emphasis role="bold">Open Sound System</emphasis>.
73 Recompile and install your new kernel.</para>
74
75 <indexterm zone="alsa-lib alsa-lib-kernel">
76 <primary sortas="d-ALSA">ALSA</primary>
77 </indexterm>
78
79 </sect2>
80
81 <sect2 role="installation">
82 <title>Installation of ALSA Library</title>
83
84 <para>Install <application>ALSALibrary</application> by
85 running the following commands:</para>
86
87<screen><userinput>./configure --enable-static &amp;&amp;
88make</userinput></screen>
89
90 <para>To test the results, issue: <command>make check</command>.</para>
91
92 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
93
94<screen role="root"><userinput>make install</userinput></screen>
95
96 <para>If you have <application>JACK</application> installed
97 and you wish to build the <application>JACK</application>
98 PCM plugin library, run the following commands:</para>
99
100<screen><userinput>cd src/pcm/ext &amp;&amp;
101make jack</userinput></screen>
102
103 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
104
105<screen role="root"><userinput>make install-jack</userinput></screen>
106
107 <para>Ensure the unprivileged user's current working directory is the root of
108 the source tree:</para>
109
110<screen><userinput>cd ../../..</userinput></screen>
111
112 <para>If you have <application>Doxygen</application> installed and you wish to
113 build the library API documentation, run the following
114 commands from the top-level directory of the source tree:</para>
115
116<screen><userinput>make doc</userinput></screen>
117
118 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
119
120<screen role="root"><userinput>install -v -d -m755 /usr/share/alsa/doc/html &amp;&amp;
121install -v -m644 doc/doxygen/html/* /usr/share/alsa/doc/html</userinput></screen>
122
123 </sect2>
124
125 <sect2 role="commands">
126 <title>Command Explanations</title>
127
128 <para><parameter>--enable-static</parameter>: This switch is used to enable
129 building the static library because some programs link against it.</para>
130
131 </sect2>
132
133 <sect2 role="configuration">
134 <title>Configuring ALSA Library</title>
135
136 <sect3 id="alsa-lib-config">
137 <title>Config Files</title>
138
139 <para><filename>~/.asoundrc</filename>,
140 <filename>/etc/asound.conf</filename>,
141 <filename>/usr/share/alsa/alsa.conf</filename>, and
142 <filename>/usr/share/alsa/{cards,pcm}/*.conf</filename></para>
143
144 <indexterm zone="alsa-lib alsa-lib-config">
145 <primary sortas="e-AA.asoundrc">~/.asoundrc</primary>
146 </indexterm>
147
148 <indexterm zone="alsa-lib alsa-lib-config">
149 <primary sortas="e-etc-asound.conf">/etc/asound.conf</primary>
150 </indexterm>
151
152 <indexterm zone="alsa-lib alsa-lib-config">
153 <primary sortas="e-usr-share-alsa-alsa.conf">/usr/share/alsa/alsa.conf</primary>
154 </indexterm>
155
156 <indexterm zone="alsa-lib alsa-lib-config">
157 <primary sortas="e-usr-share-alsa-alsa1">.../alsa/{cards,pcm}/*.conf</primary>
158 </indexterm>
159
160 </sect3>
161
162 <sect3>
163 <title>Configuration Information</title>
164
165 <para>The default <filename>alsa.conf</filename> is adequate for most
166 installations. For extra functionality and/or advanced control of your sound
167 device, you may need to create additional configuration files. For
168 information on the available configuration parameters, including setup of the
169 <application>JACK</application> PCM plugin, visit <ulink
170 url="http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php"/>.</para>
171
172 </sect3>
173
174 </sect2>
175
176 <sect2 role="content">
177 <title>Contents</title>
178
179 <segmentedlist>
180 <segtitle>Installed Programs</segtitle>
181 <segtitle>Installed Libraries</segtitle>
182 <segtitle>Installed Directories</segtitle>
183
184 <seglistitem>
185 <seg>alsalisp and aserver</seg>
186 <seg>libasound.[so,a] and optionally, libasound_module_pcm_jack.[so,a]</seg>
187 <seg>/usr/include/alsa, /usr/lib/alsa-lib, and /usr/share/alsa</seg>
188 </seglistitem>
189 </segmentedlist>
190
191 <variablelist>
192 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
193 <?dbfo list-presentation="list"?>
194 <?dbhtml list-presentation="table"?>
195
196 <varlistentry id="libasound">
197 <term><filename class='libraryfile'>libasound.[so,a]</filename></term>
198 <listitem>
199 <para>provides ALSA functions for application programs.</para>
200 <indexterm zone="alsa-lib libasound">
201 <primary sortas="c-libasound">libasound.[so,a]</primary>
202 </indexterm>
203 </listitem>
204 </varlistentry>
205
206 </variablelist>
207
208 </sect2>
209
210</sect1>
Note: See TracBrowser for help on using the repository browser.