Author: krejzi Date: 2012-09-12 11:18:06 -0600 (Wed, 12 Sep 2012) New Revision: 10657
Modified: trunk/BOOK/general.ent trunk/BOOK/introduction/welcome/changelog.xml trunk/BOOK/multimedia/libdriv/alsa-lib.xml trunk/BOOK/multimedia/libdriv/alsa-plugins.xml trunk/BOOK/multimedia/libdriv/alsa-utils.xml Log: ALSA 1.0.26. Modified: trunk/BOOK/general.ent =================================================================== --- trunk/BOOK/general.ent 2012-09-12 15:58:34 UTC (rev 10656) +++ trunk/BOOK/general.ent 2012-09-12 17:18:06 UTC (rev 10657) @@ -1031,10 +1031,10 @@ <!-- Chapter 38 --> <!ENTITY alsa-download-http "http://gd.tuwien.ac.at/opsys/linux/alsa";> <!ENTITY alsa-download-ftp "ftp://ftp.alsa-project.org/pub";> -<!ENTITY alsa-version "1.0.25"> -<!ENTITY alsa-lib-version "1.0.25"> -<!ENTITY alsa-plugins-version "1.0.25"> -<!ENTITY alsa-utils-version "1.0.25"> +<!ENTITY alsa-version "1.0.26"> +<!ENTITY alsa-lib-version "1.0.26"> +<!ENTITY alsa-plugins-version "1.0.26"> +<!ENTITY alsa-utils-version "1.0.26"> <!ENTITY alsa-tools-version "1.0.25"> <!ENTITY alsa-firmware-version "1.0.25"> <!ENTITY alsa-oss-version "1.0.25"> Modified: trunk/BOOK/introduction/welcome/changelog.xml =================================================================== --- trunk/BOOK/introduction/welcome/changelog.xml 2012-09-12 15:58:34 UTC (rev 10656) +++ trunk/BOOK/introduction/welcome/changelog.xml 2012-09-12 17:18:06 UTC (rev 10657) @@ -47,6 +47,15 @@ <para>September 12th, 2012</para> <itemizedlist> <listitem> + <para>[krejzi] - ALSA Library 1.0.26.</para> + </listitem> + <listitem> + <para>[krejzi] - ALSA Plugins 1.0.26.</para> + </listitem> + <listitem> + <para>[krejzi] - ALSA Utilities 1.0.26.</para> + </listitem> + <listitem> <para>[krejzi] - Linux PAM 1.1.6.</para> </listitem> <listitem> Modified: trunk/BOOK/multimedia/libdriv/alsa-lib.xml =================================================================== --- trunk/BOOK/multimedia/libdriv/alsa-lib.xml 2012-09-12 15:58:34 UTC (rev 10656) +++ trunk/BOOK/multimedia/libdriv/alsa-lib.xml 2012-09-12 17:18:06 UTC (rev 10657) @@ -6,10 +6,10 @@ <!ENTITY alsa-lib-download-http "&alsa-download-http;/lib/alsa-lib-&alsa-lib-version;.tar.bz2"> <!ENTITY alsa-lib-download-ftp "&alsa-download-ftp;/lib/alsa-lib-&alsa-lib-version;.tar.bz2"> - <!ENTITY alsa-lib-md5sum "06fe5819020c6684b991dcffc5471304"> - <!ENTITY alsa-lib-size "820 KB"> - <!ENTITY alsa-lib-buildsize "32 MB (additional 17 MB to build and install docs)"> - <!ENTITY alsa-lib-time "0.3 SBU (less than 0.1 SBU to build and install docs)"> + <!ENTITY alsa-lib-md5sum "2dfa35d28471d721e592b616beedf965"> + <!ENTITY alsa-lib-size "864 KB"> + <!ENTITY alsa-lib-buildsize "16 MB"> + <!ENTITY alsa-lib-time "0.2 SBU"> ]> <sect1 id="alsa-lib" xreflabel="alsa-lib-&alsa-lib-version;"> @@ -23,60 +23,79 @@ <title>alsa-lib-&alsa-lib-version;</title> <indexterm zone="alsa-lib"> - <primary sortas="a-ALSA-Library">ALSA Library</primary> + <primary sortas="a-alsa-lib">alsa-lib</primary> </indexterm> <sect2 role="package"> <title>Introduction to ALSA Library</title> - <para>The <application>ALSA Library</application> package contains - the ALSA library. This is used by programs (including <application>ALSA - Utilities</application>) requiring access to the ALSA sound interface.</para> + <para> + The <application>ALSA Library</application> package contains + the ALSA library used by programs (including <application>ALSA + Utilities</application>) requiring access to the ALSA sound + interface. + </para> &lfs72_checked; <bridgehead renderas="sect3">Package Information</bridgehead> <itemizedlist spacing="compact"> <listitem> - <para>Download (HTTP): <ulink url="&alsa-lib-download-http;"/></para> + <para> + Download (HTTP): <ulink url="&alsa-lib-download-http;"/> + </para> </listitem> <listitem> - <para>Download (FTP): <ulink url="&alsa-lib-download-ftp;"/></para> + <para> + Download (FTP): <ulink url="&alsa-lib-download-ftp;"/> + </para> </listitem> <listitem> - <para>Download MD5 sum: &alsa-lib-md5sum;</para> + <para> + Download MD5 sum: &alsa-lib-md5sum; + </para> </listitem> <listitem> - <para>Download size: &alsa-lib-size;</para> + <para> + Download size: &alsa-lib-size; + </para> </listitem> <listitem> - <para>Estimated disk space required: &alsa-lib-buildsize;</para> + <para> + Estimated disk space required: &alsa-lib-buildsize; + </para> </listitem> <listitem> - <para>Estimated build time: &alsa-lib-time;</para> + <para> + Estimated build time: &alsa-lib-time; + </para> </listitem> </itemizedlist> <bridgehead renderas="sect3">ALSA Library Dependencies</bridgehead> <bridgehead renderas="sect4">Optional</bridgehead> - <para role="optional"><xref linkend="doxygen"/> and - <ulink url="ftp://ftp.lst.de/pub/people/okir/resmgr/";>resmgr</ulink></para> + <para role="optional"> + <xref linkend="doxygen"/> and + <xref linkend="python2"/> + </para> <para condition="html" role="usernotes">User Notes: - <ulink url="&blfs-wiki;/alsa-lib"/></para> - + <ulink url="&blfs-wiki;/alsa-lib"/> + </para> </sect2> <sect2 role="kernel" id="alsa-lib-kernel"> <title>Kernel Configuration</title> - <para>In the Device Drivers ⇒ Sound card support ⇒ Advanced Linux - Sound Architecture section of the kernel configuration, select the settings - and drivers appropriate for your hardware. Ensure that the deprecated Device - Drivers ⇒ Sound card support ⇒ Open Sound System is - <emphasis>not</emphasis> selected. If necessary, recompile and install your - new kernel.</para> + <para> + In the Device Drivers ⇒ Sound card support ⇒ Advanced Linux + Sound Architecture section of the kernel configuration, select the settings + and drivers appropriate for your hardware. Ensure that the deprecated Device + Drivers ⇒ Sound card support ⇒ Open Sound System is + <emphasis>not</emphasis> selected. If necessary, recompile and install your + new kernel. + </para> <indexterm zone="alsa-lib alsa-lib-kernel"> <primary sortas="d-ALSA">ALSA</primary> @@ -87,65 +106,52 @@ <sect2 role="installation"> <title>Installation of ALSA Library</title> - <para>Install <application>ALSA Library</application> by - running the following commands:</para> + <para> + Install <application>ALSA Library</application> by + running the following commands: + </para> <screen><userinput>./configure && make</userinput></screen> - <para>This package does not come with a test suite.</para> + <para> + This package does not come with a test suite. + </para> - <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + <para> + Now, as the <systemitem class="username">root</systemitem> user: + </para> -<screen role="root"><userinput>make install && -install -v -m644 -D doc/asoundrc.txt \ - /usr/share/doc/alsa-lib-&alsa-lib-version;/asoundrc.txt</userinput></screen> +<screen role="root"><userinput>make install</userinput></screen> - <para>If you have <application>Doxygen</application> installed and you wish to - build the library API documentation, run the following - commands from the top-level directory of the source tree:</para> + <para> + If you have <application>Doxygen</application> installed and you wish to + build the library API documentation, run the following + commands from the top-level directory of the source tree: + </para> <screen><userinput>make doc</userinput></screen> - <para>Now, to install the API documentation, as the <systemitem - class="username">root</systemitem> user:</para> + <para> + To install the API documentation, run the following command as + the <systemitem class="username">root</systemitem> user: + </para> <screen role="root"><userinput>install -v -d -m755 /usr/share/doc/alsa-lib-&alsa-lib-version;/html && install -v -m644 doc/doxygen/html/* /usr/share/doc/alsa-&alsa-lib-version;/html</userinput></screen> - <para>Due to bug in libtool script it is no longer possible to build - shared and static libraries together. If you need static alsa library, - issue following commands:</para> - - <screen><userinput>make clean && -./configure --disable-shared --enable-static && -make</userinput></screen> - - <para>Now, as the <systemitem class="username">root</systemitem> user - run: </para> - - <screen role="root"><userinput>install -m644 src/.libs/libasound.a /usr/lib</userinput></screen> - </sect2> - <sect2 role="commands"> - <title>Command Explanations</title> - - <para><parameter>--enable-static</parameter>: This switch is used to enable - building the static library as some programs link against it.</para> - - </sect2> - <sect2 role="configuration"> <title>Configuring ALSA Library</title> <sect3 id="alsa-lib-config"> <title>Config Files</title> - <para><filename>~/.asoundrc</filename>, - <filename>/etc/asound.conf</filename>, - <filename>/usr/share/alsa/alsa.conf</filename>, and - <filename>/usr/share/alsa/{cards,pcm}/*.conf</filename></para> + <para> + <filename>~/.asoundrc</filename> and + <filename>/etc/asound.conf</filename> + </para> <indexterm zone="alsa-lib alsa-lib-config"> <primary sortas="e-AA.asoundrc">~/.asoundrc</primary> @@ -155,24 +161,18 @@ <primary sortas="e-etc-asound.conf">/etc/asound.conf</primary> </indexterm> - <indexterm zone="alsa-lib alsa-lib-config"> - <primary sortas="e-usr-share-alsa-alsa.conf">/usr/share/alsa/alsa.conf</primary> - </indexterm> - - <indexterm zone="alsa-lib alsa-lib-config"> - <primary sortas="e-usr-share-alsa-alsa1">/usr/share/alsa/{cards,pcm}/*.conf</primary> - </indexterm> - </sect3> <sect3> <title>Configuration Information</title> - <para>The default <filename>alsa.conf</filename> is adequate for most - installations. For extra functionality and/or advanced control of your sound - device, you may need to create additional configuration files. For - information on the available configuration parameters, visit <ulink - url="http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php"/>.</para> + <para> + The default <filename>alsa.conf</filename> is adequate for most + installations. For extra functionality and/or advanced control of your + sound device, you may need to create additional configuration files. + For information on the available configuration parameters, visit + <ulink url="http://www.alsa-project.org/alsa-doc/doc-php/asoundrc.php"/>. + </para> </sect3> @@ -183,14 +183,21 @@ <segmentedlist> <segtitle>Installed Program</segtitle> - <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Library</segtitle> <segtitle>Installed Directories</segtitle> <seglistitem> - <seg>aserver</seg> - <seg>libasound.{so,a} and smixer-*.{so,a}</seg> - <seg>/usr/include/alsa, /usr/lib/alsa-lib, /usr/share/alsa and - /usr/share/doc/alsa-lib-&alsa-lib-version;</seg> + <seg> + aserver + </seg> + <seg> + libasound.so + </seg> + <seg> + /usr/include/alsa, + /usr/lib/alsa-lib, + /usr/share/alsa and + /usr/share/doc/alsa-lib-&alsa-lib-version;</seg> </seglistitem> </segmentedlist> @@ -202,7 +209,9 @@ <varlistentry id="aserver"> <term><command>aserver</command></term> <listitem> - <para>provides the ALSA server.</para> + <para> + is the ALSA server. + </para> <indexterm zone="alsa-lib aserver"> <primary sortas="b-aserver">aserver</primary> </indexterm> @@ -210,25 +219,17 @@ </varlistentry> <varlistentry id="libasound"> - <term><filename class='libraryfile'>libasound.{so,a}</filename></term> + <term><filename class="libraryfile">libasound.so</filename></term> <listitem> - <para>provides ALSA functions for application programs.</para> + <para> + contains the ALSA API functions. + </para> <indexterm zone="alsa-lib libasound"> - <primary sortas="c-libasound">libasound.{so,a}</primary> + <primary sortas="c-libasound">libasound.so</primary> </indexterm> </listitem> </varlistentry> - <varlistentry id="smixer"> - <term><filename class='libraryfile'>smixer-*.{so,a}</filename></term> - <listitem> - <para>provides hardware dependent ALSA mixer functions.</para> - <indexterm zone="alsa-lib smixer"> - <primary sortas="c-smixer">smixer-*.{so,a}</primary> - </indexterm> - </listitem> - </varlistentry> - </variablelist> </sect2> Modified: trunk/BOOK/multimedia/libdriv/alsa-plugins.xml =================================================================== --- trunk/BOOK/multimedia/libdriv/alsa-plugins.xml 2012-09-12 15:58:34 UTC (rev 10656) +++ trunk/BOOK/multimedia/libdriv/alsa-plugins.xml 2012-09-12 17:18:06 UTC (rev 10657) @@ -6,18 +6,12 @@ <!ENTITY alsa-plugins-download-http "&alsa-download-http;/plugins/alsa-plugins-&alsa-plugins-version;.tar.bz2"> <!ENTITY alsa-plugins-download-ftp "&alsa-download-ftp;/plugins/alsa-plugins-&alsa-plugins-version;.tar.bz2"> - <!ENTITY alsa-plugins-md5sum "038c023eaa51171f018fbf7141255185"> - <!ENTITY alsa-plugins-size "328 KB"> - <!ENTITY alsa-plugins-buildsize "4 MB"> + <!ENTITY alsa-plugins-md5sum "4facd408326ef5567a7d4ceb6589e6b0"> + <!ENTITY alsa-plugins-size "356 KB"> + <!ENTITY alsa-plugins-buildsize "5.0 MB"> <!ENTITY alsa-plugins-time "less than 0.1 SBU"> ]> - <!-- - Editors: please examine the output from the configure command to see if - there are any new dependencies. There has been a bunch of work on the - plugins the last couple of releases, and that trend may continue. - --> - <sect1 id="alsa-plugins" xreflabel="alsa-plugins-&alsa-plugins-version;"> <?dbhtml filename="alsa-plugins.html"?> @@ -29,36 +23,50 @@ <title>alsa-plugins-&alsa-plugins-version;</title> <indexterm zone="alsa-plugins"> - <primary sortas="a-ALSA-Plugins">ALSA Plugins</primary> + <primary sortas="a-alsa-plugins">alsa-plugins</primary> </indexterm> <sect2 role="package"> <title>Introduction to ALSA Plugins</title> - <para>The <application>ALSA Plugins</application> package contains - plugins for various audio libraries and sound servers.</para> + <para> + The <application>ALSA Plugins</application> package contains + plugins for various audio libraries and sound servers. + </para> &lfs72_checked; <bridgehead renderas="sect3">Package Information</bridgehead> <itemizedlist spacing="compact"> <listitem> - <para>Download (HTTP): <ulink url="&alsa-plugins-download-http;"/></para> + <para> + Download (HTTP): <ulink url="&alsa-plugins-download-http;"/> + </para> </listitem> <listitem> - <para>Download (FTP): <ulink url="&alsa-plugins-download-ftp;"/></para> + <para> + Download (FTP): <ulink url="&alsa-plugins-download-ftp;"/> + </para> </listitem> <listitem> - <para>Download MD5 sum: &alsa-plugins-md5sum;</para> + <para> + Download MD5 sum: &alsa-plugins-md5sum; + </para> </listitem> <listitem> - <para>Download size: &alsa-plugins-size;</para> + <para> + Download size: &alsa-plugins-size; + </para> </listitem> <listitem> - <para>Estimated disk space required: &alsa-plugins-buildsize;</para> + <para> + Estimated disk space required: &alsa-plugins-buildsize; + </para> </listitem> <listitem> - <para>Estimated build time: &alsa-plugins-time;</para> + <para> + Estimated build time: &alsa-plugins-time; + </para> </listitem> </itemizedlist> @@ -89,28 +97,31 @@ </para> <para condition="html" role="usernotes">User Notes: - <ulink url="&blfs-wiki;/alsa-plugins"/></para> - + <ulink url="&blfs-wiki;/alsa-plugins"/> + </para> </sect2> <sect2 role="installation"> <title>Installation of ALSA Plugins</title> - <para>Install <application>ALSA Plugins</application> by - running the following commands:</para> + <para> + Install <application>ALSA Plugins</application> by + running the following commands: + </para> <screen><userinput>patch -Np1 -i ../alsa-plugins-&alsa-plugins-version;-ffmpeg-1.patch && -CFLAGS="-D_GNU_SOURCE" ./configure && +./configure && make</userinput></screen> - <para>This package does not come with a test suite.</para> + <para> + This package does not come with a test suite. + </para> - <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + <para> + Now, as the <systemitem class="username">root</systemitem> user: + </para> -<screen role="root"><userinput>make install && -install -v -m755 -d /usr/share/doc/alsa-plugins-&alsa-plugins-version; && -install -v -m644 doc/{README*,*.txt} \ - /usr/share/doc/alsa-plugins-&alsa-plugins-version;</userinput></screen> +<screen role="root"><userinput>make install</userinput></screen> </sect2> @@ -118,18 +129,15 @@ <title>Contents</title> <segmentedlist> - <segtitle>Installed Programs</segtitle> <segtitle>Installed Libraries</segtitle> - <segtitle>Installed Directory</segtitle> <seglistitem> - <seg>None</seg> - <seg>Numerous libasound_module_<replaceable><module></replaceable>.so - modules including ctl_oss, pcm_oss, pcm_upmix, pcm_usb_stream, pcm_vdownmix, - rate_speexrate, rate_speexrate_best, rate_speexrate_medium, and optionally - ctl_pulse, pcm_pulse, pcm_a52, pcm_jack and - rate_samplerate*</seg> - <seg>/usr/share/doc/alsa-plugins-&alsa-plugins-version;</seg> + <seg> + Numerous libasound_module_<replaceable><module></replaceable>.so + modules including ctl_oss, ctl_pulse, pcm_a52, pcm_jack, pcm_oss, + pcm_pulse, pcm_upmix, pcm_usb_stream, pcm_vdownmix, + rate_samplerate* and rate_speexrate* + </seg> </seglistitem> </segmentedlist> @@ -139,10 +147,12 @@ <?dbhtml list-presentation="table"?> <varlistentry id="libasound_module_pcm_oss.so"> - <term><filename class='libraryfile'>libasound_module_pcm_oss.so</filename></term> + <term><filename class="libraryfile">libasound_module_pcm_oss.so</filename></term> <listitem> - <para>Allows native <application>ALSA</application> applications to - run on <application>OSS</application>.</para> + <para> + Allows native <application>ALSA</application> applications to + run on <application>OSS</application>. + </para> <indexterm zone="alsa-plugins libasound_module_pcm_oss.so"> <primary sortas="c-libasound_module_pcm_oss">libasound_module_pcm_oss.so</primary> </indexterm> @@ -150,9 +160,11 @@ </varlistentry> <varlistentry id="libasound_module_pcm_upmix.so"> - <term><filename class='libraryfile'>libasound_module_pcm_upmix.so</filename></term> + <term><filename class="libraryfile">libasound_module_pcm_upmix.so</filename></term> <listitem> - <para>Allows upmixing sound to 4 or 6 channels.</para> + <para> + Allows upmixing sound to 4 or 6 channels. + </para> <indexterm zone="alsa-plugins libasound_module_pcm_upmix.so"> <primary sortas="c-libasound_module_pcm_upmix">libasound_module_pcm_upmix.so</primary> </indexterm> @@ -160,10 +172,12 @@ </varlistentry> <varlistentry id="libasound_module_pcm_vdownmix.so"> - <term><filename class='libraryfile'>libasound_module_pcm_vdownmix.so</filename></term> + <term><filename class="libraryfile">libasound_module_pcm_vdownmix.so</filename></term> <listitem> - <para>Allows downmixing sound from 4-6 channels to 2 - channel stereo output.</para> + <para> + Allows downmixing sound from 4-6 channels to 2 + channel stereo output. + </para> <indexterm zone="alsa-plugins libasound_module_pcm_vdownmix.so"> <primary sortas="c-libasound_module_pcm_vdownmix">libasound_module_pcm_vdownmix.so</primary> </indexterm> @@ -171,10 +185,12 @@ </varlistentry> <varlistentry id="libasound_module_pcm_jack.so"> - <term><filename class='libraryfile'>libasound_module_pcm_jack.so</filename></term> + <term><filename class="libraryfile">libasound_module_pcm_jack.so</filename></term> <listitem> - <para>Allows native <application>ALSA</application> applications to - work with <command>jackd</command>.</para> + <para> + Allows native <application>ALSA</application> applications to + work with <command>jackd</command>. + </para> <indexterm zone="alsa-plugins libasound_module_pcm_jack.so"> <primary sortas="c-libasound_module_pcm_jack">libasound_module_pcm_jack.so</primary> </indexterm> @@ -182,11 +198,13 @@ </varlistentry> <varlistentry id="libasound_module_pcm_pulse.so"> - <term><filename class='libraryfile'>libasound_module_pcm_pulse.so</filename></term> + <term><filename class="libraryfile">libasound_module_pcm_pulse.so</filename></term> <listitem> - <para>Allows native <application>ALSA</application> applications - to access a <application>PulseAudio</application> sound - daemon.</para> + <para> + Allows native <application>ALSA</application> applications + to access a <application>PulseAudio</application> sound + daemon. + </para> <indexterm zone="alsa-plugins libasound_module_pcm_pulse.so"> <primary sortas="c-libasound_module_pcm_pulse">libasound_module_pcm_pulse.so</primary> </indexterm> @@ -194,10 +212,12 @@ </varlistentry> <varlistentry id="libasound_module_pcm_a52.so"> - <term><filename class='libraryfile'>libasound_module_pcm_a52.so</filename></term> + <term><filename class="libraryfile">libasound_module_pcm_a52.so</filename></term> <listitem> - <para>Converts S16 linear sound format to A52 compressed format - and sends it to an SPDIF output.</para> + <para> + Converts S16 linear sound format to A52 compressed format + and sends it to an SPDIF output. + </para> <indexterm zone="alsa-plugins libasound_module_pcm_a52.so"> <primary sortas="c-libasound_module_pcm_a52">libasound_module_pcm_a52.so</primary> </indexterm> @@ -205,10 +225,12 @@ </varlistentry> <varlistentry id="libasound_module_rate_samplerate.so"> - <term><filename class='libraryfile'>libasound_module_rate_samplerate.so</filename></term> + <term><filename class="libraryfile">libasound_module_rate_samplerate.so</filename></term> <listitem> - <para>Provides an external rate converter through - <filename class='libraryfile'>libsamplerate</filename>.</para> + <para> + Provides an external rate converter through + <filename class="libraryfile">libsamplerate</filename>. + </para> <indexterm zone="alsa-plugins libasound_module_rate_samplerate.so"> <primary sortas="c-libasound_module_rate_samplerate">libasound_module_rate_samplerate.so</primary> </indexterm> Modified: trunk/BOOK/multimedia/libdriv/alsa-utils.xml =================================================================== --- trunk/BOOK/multimedia/libdriv/alsa-utils.xml 2012-09-12 15:58:34 UTC (rev 10656) +++ trunk/BOOK/multimedia/libdriv/alsa-utils.xml 2012-09-12 17:18:06 UTC (rev 10657) @@ -6,7 +6,7 @@ <!ENTITY alsa-utils-download-http "&alsa-download-http;/utils/alsa-utils-&alsa-utils-version;.tar.bz2"> <!ENTITY alsa-utils-download-ftp "&alsa-download-ftp;/utils/alsa-utils-&alsa-utils-version;.tar.bz2"> - <!ENTITY alsa-utils-md5sum "f81f9dcb9a014fd32cb3a70066a5b9a9"> + <!ENTITY alsa-utils-md5sum "4dcf1017fafc91603af96705c073eca9"> <!ENTITY alsa-utils-size "1.1 MB"> <!ENTITY alsa-utils-buildsize "11 MB"> <!ENTITY alsa-utils-time "0.1 SBU"> @@ -24,36 +24,51 @@ <title>alsa-utils-&alsa-utils-version;</title> <indexterm zone="alsa-utils"> - <primary sortas="a-ALSA-Utilities">ALSA Utilities</primary> + <primary sortas="a-alsa-utils">alsa-utils</primary> </indexterm> <sect2 role="package"> <title>Introduction to ALSA Utilities</title> - <para>The <application>ALSA Utilities</application> package contains - various utilities which are useful for controlling your sound card.</para> + <para> + The <application>ALSA Utilities</application> package contains + various utilities which are useful for controlling your sound + card. + </para> &lfs72_checked; <bridgehead renderas="sect3">Package Information</bridgehead> <itemizedlist spacing="compact"> <listitem> - <para>Download (HTTP): <ulink url="&alsa-utils-download-http;"/></para> + <para> + Download (HTTP): <ulink url="&alsa-utils-download-http;"/> + </para> </listitem> <listitem> - <para>Download (FTP): <ulink url="&alsa-utils-download-ftp;"/></para> + <para> + Download (FTP): <ulink url="&alsa-utils-download-ftp;"/> + </para> </listitem> <listitem> - <para>Download MD5 sum: &alsa-utils-md5sum;</para> + <para> + Download MD5 sum: &alsa-utils-md5sum; + </para> </listitem> <listitem> - <para>Download size: &alsa-utils-size;</para> + <para> + Download size: &alsa-utils-size; + </para> </listitem> <listitem> - <para>Estimated disk space required: &alsa-utils-buildsize;</para> + <para> + Estimated disk space required: &alsa-utils-buildsize; + </para> </listitem> <listitem> - <para>Estimated build time: &alsa-utils-time;</para> + <para> + Estimated build time: &alsa-utils-time; + </para> </listitem> </itemizedlist> @@ -66,41 +81,50 @@ <bridgehead renderas="sect4">Optional</bridgehead> <para role="optional"> - <xref linkend="xmlto"/>, - <ulink url="http://hightek.org/dialog/";>dialog</ulink> (for alsaconf) + <ulink url="http://hightek.org/dialog/";>Dialog</ulink> and + <xref linkend="xmlto"/> </para> <bridgehead renderas="sect3">Additional Downloads</bridgehead> - <itemizedlist spacing="compact"> - <listitem> - <para>Optional patch: <ulink - url="&patch-root;/&alsa-utils-patch;"/></para> - </listitem> - </itemizedlist> + <itemizedlist spacing="compact"> + <listitem> + <para> + Optional patch: + <ulink url="&patch-root;/&alsa-utils-patch;"/> + </para> + </listitem> + </itemizedlist> - <para condition="html" role="usernotes">User Notes: - <ulink url="&blfs-wiki;/alsa-utils"/></para> - + <ulink url="&blfs-wiki;/alsa-utils"/> + </para> </sect2> <sect2 role="installation"> <title>Installation of ALSA Utilities</title> - <para>If you have not installed the optional dependency <xref linkend='xmlto'/>, - apply the following patch:</para> + <para> + If you have not installed the optional dependency <xref linkend="xmlto"/>, + apply the following patch: + </para> <screen><userinput>patch -Np1 -i ../&alsa-utils-patch;</userinput></screen> - <para>Install <application>ALSA Utilities</application> by - running the following commands:</para> + <para> + Install <application>ALSA Utilities</application> by + running the following commands: + </para> <screen><userinput>./configure --without-systemdsystemunitdir && make</userinput></screen> - <para>This package does not come with a test suite.</para> + <para> + This package does not come with a test suite. + </para> - <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + <para> + Now, as the <systemitem class="username">root</systemitem> user: + </para> <screen role="root"><userinput>make install</userinput></screen> @@ -109,8 +133,12 @@ <sect2 role="commands"> <title>Command Explanations</title> - <para><option>--without-systemdsystemunitdir</option>: - Do not install systemd units.</para> + <para> + <option>--without-systemdsystemunitdir</option>: + This switch disables instalation of + <application>Systemd</application> units which are + not necesary for BLFS. + </para> </sect2> @@ -120,7 +148,9 @@ <sect3 id="alsa-utils-config"> <title>Config Files</title> - <para><filename>/var/lib/alsa/asound.state</filename></para> + <para> + <filename>/var/lib/alsa/asound.state</filename> + </para> <indexterm zone="alsa-utils alsa-utils-config"> <primary sortas="e-var-lib-alsa-asound.state">/var/lib/alsa/asound.state</primary> @@ -131,50 +161,63 @@ <sect3 id="alsa-utils-init"> <title>Configuration Information</title> - <para> Use a bootscript to store the values at shutdown.</para> + <para> + Use a bootscript to store the values at shutdown. + </para> <indexterm zone="alsa-utils alsa-utils-init"> <primary sortas="f-alsa">alsa</primary> </indexterm> - <para>As the <systemitem class="username">root</systemitem> user, - install the init script <filename>/etc/rc.d/init.d/alsa</filename> included - in the <xref linkend="bootscripts"/> package.</para> + <para> + As the <systemitem class="username">root</systemitem> user, + install the init script <filename>/etc/rc.d/init.d/alsa</filename> included + in the <xref linkend="bootscripts"/> package. + </para> <screen role="root"><userinput>make install-alsa</userinput></screen> - <para>Note that all channels of your sound card are muted by default. - You can use the <command>alsamixer</command> program from the - <application>ALSA Utilities</application> to change this. Use - <command>speaker-test</command> to check that your settings have - been applied correctly. You should hear <quote>pink noise</quote> on your - speakers.</para> + <para> + Note that all channels of your sound card are muted by default. + You can use the <command>alsamixer</command> program to change + this. Use <command>speaker-test</command> to check that your + settings have been applied correctly. You should hear + <quote>pink noise</quote> on your speakers. + </para> - <para>The <filename>alsactl</filename> program is normally run from a - standard <application>udev</application> rule. The first time it is - run, it will complain that there is no state in - <filename>/var/lib/alsa/asound.state</filename>. You can prevent this by - running the following commands as the <systemitem - class="username">root</systemitem> user:</para> + <para> + The <filename>alsactl</filename> program is normally run from a + standard <application>udev</application> rule. The first time it + is run, it will complain that there is no state in + <filename>/var/lib/alsa/asound.state</filename>. You can prevent + this by running the following commands as the + <systemitem class="username">root</systemitem> user: + </para> <screen role="root"><userinput>touch /var/lib/alsa/asound.state && alsactl store</userinput></screen> - <para>The volume settings will be restored from the saved state by - <application>Udev</application> when the device is detected (during boot - or when plugged in for USB devices).</para> + <para> + The volume settings will be restored from the saved state by + <application>Udev</application> when the device is detected + (during boot or when plugged in for USB devices). + </para> - <para>All sound devices are not accessible for any user except - <systemitem class="username">root</systemitem> and members of the - <systemitem class="groupname">audio</systemitem> group. Add any users - that might use the sound devices to that group:</para> + <para> + All sound devices are not accessible for any user except + <systemitem class="username">root</systemitem> and members of the + <systemitem class="groupname">audio</systemitem> group. Add any + users that might use the sound devices to that group: + </para> <screen role="root"><userinput>usermod -a -G audio <replaceable><username></replaceable></userinput></screen> <note> - <para>You may need to log out and back in again to refresh your group - memberships. '<command>su <replaceable><username></replaceable></command>' - should work as well.</para> + <para> + You may need to log out and back in again to refresh your group + memberships. '<command>su <replaceable><username></replaceable></command>' + should work as well. + </para> </note> </sect3> @@ -189,10 +232,15 @@ <segtitle>Installed Directory</segtitle> <seglistitem> - <seg>aconnect, alsaconf, alsactl, alsamixer, amidi, - amixer, aplay, aplaymidi, arecord, arecordmidi, aseqdump, - aseqnet, iecset, and speaker-test</seg> - <seg>/var/lib/alsa and /usr/share/sounds/alsa</seg> + <seg> + aconnect, alsaconf, alsactl, alsaloop, alsamixer, + alsaucm, amidi, amixer, aplay, aplaymidi, arecord, + arecordmidi, aseqdump, aseqnet, iecset and + speaker-test + </seg> + <seg> + /usr/share/sounds/alsa and /var/lib/alsa + </seg> </seglistitem> </segmentedlist> @@ -204,8 +252,10 @@ <varlistentry id="aconnect"> <term><command>aconnect</command></term> <listitem> - <para>is a utility for connecting and disconnecting two existing - ports in the ALSA sequencer system.</para> + <para> + is a utility for connecting and disconnecting two + existing ports in the ALSA sequencer system. + </para> <indexterm zone="alsa-utils aconnect"> <primary sortas="b-aconnect">aconnect</primary> </indexterm> @@ -215,9 +265,11 @@ <varlistentry id="alsaconf"> <term><command>alsaconf</command></term> <listitem> - <para>is a configuration tool which tries to detect the sound cards - on your system and write a suitable configuration file for ALSA. - This program is incompatible with udev and hotplug.</para> + <para> + is a configuration tool which tries to detect the sound cards + on your system and write a suitable configuration file for ALSA. + This program is incompatible with Udev. + </para> <indexterm zone="alsa-utils alsaconf"> <primary sortas="b-alsaconf">alsaconf</primary> </indexterm> @@ -227,19 +279,36 @@ <varlistentry id="alsactl"> <term><command>alsactl</command></term> <listitem> - <para>is used to control advanced settings for the - ALSA sound card drivers.</para> + <para> + is used to control advanced settings for the + ALSA sound card drivers. + </para> <indexterm zone="alsa-utils alsactl"> <primary sortas="b-alsactl">alsactl</primary> </indexterm> </listitem> </varlistentry> + <varlistentry id="alsaloop"> + <term><command>alsaloop</command></term> + <listitem> + <para> + allows create a PCM loopback between a PCM capture + device and a PCM playback device. + </para> + <indexterm zone="alsa-utils alsaloop"> + <primary sortas="b-alsaloop">alsaloop</primary> + </indexterm> + </listitem> + </varlistentry> + <varlistentry id="alsamixer"> <term><command>alsamixer</command></term> <listitem> - <para>is an ncurses-based mixer program for use with the - ALSA sound card drivers.</para> + <para> + is an Ncurses based mixer program for use with + the ALSA sound card drivers. + </para> <indexterm zone="alsa-utils alsamixer"> <primary sortas="b-alsamixer">alsamixer</primary> </indexterm> @@ -249,8 +318,10 @@ <varlistentry id="amidi"> <term><command>amidi</command></term> <listitem> - <para>is used to read from and write to ALSA - RawMIDI ports.</para> + <para> + is used to read from and write to ALSA + RawMIDI ports. + </para> <indexterm zone="alsa-utils amidi"> <primary sortas="b-amidi">amidi</primary> </indexterm> @@ -271,8 +342,10 @@ <varlistentry id="aplay"> <term><command>aplay</command></term> <listitem> - <para>is a command-line soundfile player for the - ALSA sound card drivers.</para> + <para> + is a command-line soundfile player for the + ALSA sound card drivers. + </para> <indexterm zone="alsa-utils aplay"> <primary sortas="b-aplay">aplay</primary> </indexterm> @@ -282,8 +355,10 @@ <varlistentry id="aplaymidi"> <term><command>aplaymidi</command></term> <listitem> - <para>is a command-line utility that plays the specified - MIDI file(s) to one or more ALSA sequencer ports.</para> + <para> + is a command-line utility that plays the specified + MIDI file(s) to one or more ALSA sequencer ports. + </para> <indexterm zone="alsa-utils aplaymidi"> <primary sortas="b-aplaymidi">aplaymidi</primary> </indexterm> @@ -293,8 +368,10 @@ <varlistentry id="arecord"> <term><command>arecord</command></term> <listitem> - <para>is a command-line soundfile recorder for the - ALSA sound card drivers.</para> + <para> + is a command-line soundfile recorder for the + ALSA sound card drivers. + </para> <indexterm zone="alsa-utils arecord"> <primary sortas="b-arecord">arecord</primary> </indexterm> @@ -304,8 +381,10 @@ <varlistentry id="arecordmidi"> <term><command>arecordmidi</command></term> <listitem> - <para>is a command-line utility that records a standard - MIDI file from one or more ALSA sequencer ports.</para> + <para> + is a command-line utility that records a standard + MIDI file from one or more ALSA sequencer ports. + </para> <indexterm zone="alsa-utils arecordmidi"> <primary sortas="b-arecordmidi">arecordmidi</primary> </indexterm> @@ -315,8 +394,10 @@ <varlistentry id="aseqdump"> <term><command>aseqdump</command></term> <listitem> - <para>is a command-line utility that prints the sequencer events it - receives as text.</para> + <para> + is a command-line utility that prints the sequencer events it + receives as text. + </para> <indexterm zone="alsa-utils aseqdump"> <primary sortas="b-aseqdump">aseqdump</primary> </indexterm> @@ -326,8 +407,10 @@ <varlistentry id="aseqnet"> <term><command>aseqnet</command></term> <listitem> - <para>is an ALSA sequencer client which sends - and receives event packets over a network.</para> + <para> + is an ALSA sequencer client which sends and + receives event packets over a network. + </para> <indexterm zone="alsa-utils aseqnet"> <primary sortas="b-aseqnet">aseqnet</primary> </indexterm> @@ -337,9 +420,11 @@ <varlistentry id="iecset"> <term><command>iecset</command></term> <listitem> - <para>is a small utility to set or dump the IEC958 (or so-called - <quote>S/PDIF</quote>) status bits of the specified sound - card via the ALSA control API.</para> + <para> + is a small utility to set or dump the IEC958 (or so-called + <quote>S/PDIF</quote>) status bits of the specified sound + card via the ALSA control API. + </para> <indexterm zone="alsa-utils iecset"> <primary sortas="b-iecset">iecset</primary> </indexterm> @@ -349,7 +434,9 @@ <varlistentry id="speaker-test"> <term><command>speaker-test</command></term> <listitem> - <para>is a command-line speaker test tone generator for ALSA.</para> + <para> + is a command-line speaker test tone generator for ALSA. + </para> <indexterm zone="alsa-utils speaker-test"> <primary sortas="b-speaker-test">speaker-test</primary> </indexterm> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
