source: multimedia/libdriv/alsa-lib.xml@ 9f12e36

10.0 10.1 11.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 9f12e36 was 9f12e36, checked in by Randy McMurchy <randy@…>, 15 years ago

Removed 'keywordset' blocks and extra spaces from the XML files (note this was by accident as I meant to do just in the gnome directory but I was in the root of BOOK when I ran the script, but this was going to happen anyway so I don't think it is a big deal)

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6192 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 "ef7ae78a0ef08cbeacb295f2518886ab">
10 <!ENTITY alsa-lib-size "696 KB">
11 <!ENTITY alsa-lib-buildsize "31.8 MB (additional 15.2 MB to build and install docs)">
12 <!ENTITY alsa-lib-time "0.7 SBU (less than 0.1 SBU to build and install docs)">
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 role="optional"><xref linkend="doxygen"/> and
62 <ulink url="ftp://ftp.lst.de/pub/people/okir/resmgr/">resmgr</ulink></para>
63
64 <para condition="html" role="usernotes">User Notes:
65 <ulink url="&blfs-wiki;/alsa-lib"/></para>
66
67 </sect2>
68
69 <sect2 role="kernel" id="alsa-lib-kernel">
70 <title>Kernel Configuration</title>
71
72 <para>In the Device Drivers &rArr; Sound &rArr; Advanced Linux Sound
73 Architecture section of the kernel configuration, select the settings and
74 drivers appropriate for your hardware. Ensure that the deprecated Device
75 Drivers &rArr; Sound &rArr; Open Sound System is <emphasis>not</emphasis>
76 selected. If necessary, recompile and install your new kernel.</para>
77
78 <indexterm zone="alsa-lib alsa-lib-kernel">
79 <primary sortas="d-ALSA">ALSA</primary>
80 </indexterm>
81
82 </sect2>
83
84 <sect2 role="installation">
85 <title>Installation of ALSA Library</title>
86
87 <para>Install <application>ALSA Library</application> by
88 running the following commands:</para>
89
90<screen><userinput>./configure --enable-static &amp;&amp;
91make</userinput></screen>
92
93 <para>This package does not come with a test suite.</para>
94
95 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
96
97<screen role="root"><userinput>make install &amp;&amp;
98install -v -m644 -D doc/asoundrc.txt \
99 /usr/share/doc/alsa-lib-&alsa-lib-version;/asoundrc.txt</userinput></screen>
100
101 <para>If you have <application>Doxygen</application> installed and you wish to
102 build the library API documentation, run the following
103 commands from the top-level directory of the source tree:</para>
104
105<screen><userinput>make doc</userinput></screen>
106
107 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
108
109<screen role="root"><userinput>install -v -d -m755 /usr/share/alsa/doc/html &amp;&amp;
110install -v -m644 doc/doxygen/html/* /usr/share/alsa/doc/html</userinput></screen>
111
112 </sect2>
113
114 <sect2 role="commands">
115 <title>Command Explanations</title>
116
117 <para><parameter>--enable-static</parameter>: This switch is used to enable
118 building the static library as some programs link against it.</para>
119
120 </sect2>
121
122 <sect2 role="configuration">
123 <title>Configuring ALSA Library</title>
124
125 <sect3 id="alsa-lib-config">
126 <title>Config Files</title>
127
128 <para><filename>~/.asoundrc</filename>,
129 <filename>/etc/asound.conf</filename>,
130 <filename>/usr/share/alsa/alsa.conf</filename>, and
131 <filename>/usr/share/alsa/{cards,pcm}/*.conf</filename></para>
132
133 <indexterm zone="alsa-lib alsa-lib-config">
134 <primary sortas="e-AA.asoundrc">~/.asoundrc</primary>
135 </indexterm>
136
137 <indexterm zone="alsa-lib alsa-lib-config">
138 <primary sortas="e-etc-asound.conf">/etc/asound.conf</primary>
139 </indexterm>
140
141 <indexterm zone="alsa-lib alsa-lib-config">
142 <primary sortas="e-usr-share-alsa-alsa.conf">/usr/share/alsa/alsa.conf</primary>
143 </indexterm>
144
145 <indexterm zone="alsa-lib alsa-lib-config">
146 <primary sortas="e-usr-share-alsa-alsa1">.../alsa/{cards,pcm}/*.conf</primary>
147 </indexterm>
148
149 </sect3>
150
151 <sect3>
152 <title>Configuration Information</title>
153
154 <para>The default <filename>alsa.conf</filename> is adequate for most
155 installations. For extra functionality and/or advanced control of your sound
156 device, you may need to create additional configuration files. For
157 information on the available configuration parameters, visit <ulink
158 url="http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php"/>.</para>
159
160 </sect3>
161
162 </sect2>
163
164 <sect2 role="content">
165 <title>Contents</title>
166
167 <segmentedlist>
168 <segtitle>Installed Programs</segtitle>
169 <segtitle>Installed Library</segtitle>
170 <segtitle>Installed Directories</segtitle>
171
172 <seglistitem>
173 <seg>aserver</seg>
174 <seg>libasound.{so,a} and smixer-*.{so,a}</seg>
175 <seg>/usr/include/alsa, /usr/lib/alsa-lib, /usr/share/alsa and
176 /usr/share/doc/alsa-lib-&alsa-lib-version;</seg>
177 </seglistitem>
178 </segmentedlist>
179
180 <variablelist>
181 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
182 <?dbfo list-presentation="list"?>
183 <?dbhtml list-presentation="table"?>
184
185 <varlistentry id="libasound">
186 <term><filename class='libraryfile'>libasound.{so,a}</filename></term>
187 <listitem>
188 <para>provides ALSA functions for application programs.</para>
189 <indexterm zone="alsa-lib libasound">
190 <primary sortas="c-libasound">libasound.{so,a}</primary>
191 </indexterm>
192 </listitem>
193 </varlistentry>
194
195 <varlistentry id="smixer">
196 <term><filename class='libraryfile'>smixer-*.{so,a}</filename></term>
197 <listitem>
198 <para>provides hardware dependent ALSA mixer functions.</para>
199 <indexterm zone="alsa-lib smixer">
200 <primary sortas="c-smixer">smixer-*.{so,a}</primary>
201 </indexterm>
202 </listitem>
203 </varlistentry>
204
205 </variablelist>
206
207 </sect2>
208
209</sect1>
Note: See TracBrowser for help on using the repository browser.