mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-02-11 05:44:38 +08:00
e1e58be454
neither firefox nor epiphany can download them, and they are not well maintained, because rarely tested. This is WIP because the "(HTTP)" part of "Download (HTTP)" will need to be removed too. But let's see what users think first...
270 lines
7.8 KiB
XML
270 lines
7.8 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!ENTITY alsa-lib-download-http "&alsa-download-http;/lib/alsa-lib-&alsa-lib-version;.tar.bz2">
|
|
<!ENTITY alsa-lib-download-ftp " ">
|
|
<!ENTITY alsa-lib-md5sum "aced5acdb6161ed86e5ca3bb10618ca1">
|
|
<!ENTITY alsa-lib-size "1.1 MB">
|
|
<!ENTITY alsa-lib-buildsize "46 MB (with tests and docs)">
|
|
<!ENTITY alsa-lib-time "0.3 SBU (with tests and docs)">
|
|
]>
|
|
|
|
<sect1 id="alsa-lib" xreflabel="alsa-lib-&alsa-lib-version;">
|
|
<?dbhtml filename="alsa-lib.html"?>
|
|
|
|
|
|
<title>alsa-lib-&alsa-lib-version;</title>
|
|
|
|
<indexterm zone="alsa-lib">
|
|
<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 used by programs (including <application>ALSA
|
|
Utilities</application>) requiring access to the ALSA sound
|
|
interface.
|
|
</para>
|
|
|
|
&lfs120_checked;
|
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Download (HTTP): <ulink url="&alsa-lib-download-http;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download (FTP): <ulink url="&alsa-lib-download-ftp;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download MD5 sum: &alsa-lib-md5sum;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &alsa-lib-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated disk space required: &alsa-lib-buildsize;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated build time: &alsa-lib-time;
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<bridgehead renderas="sect3">ALSA Library Dependencies</bridgehead>
|
|
|
|
<bridgehead renderas="sect4">Recommended (Runtime)</bridgehead>
|
|
<para role="runtime">
|
|
<phrase revision='sysv'><xref linkend='elogind'/></phrase>
|
|
<phrase revision='systemd'><xref linkend='systemd'/></phrase>
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
If the recommended runtime dependency is not installed, you may
|
|
need to run any application requiring ALSA library as the &root;
|
|
user or a user in the
|
|
<systemitem class='groupname'>audio</systemitem> group.
|
|
</para>
|
|
</note>
|
|
|
|
<bridgehead renderas="sect4">Optional</bridgehead>
|
|
<para role="optional">
|
|
<xref linkend="doxygen"/>,
|
|
<xref linkend="python2"/>, and
|
|
<ulink url="https://www.alsa-project.org/files/pub/lib/alsa-ucm-conf-&alsa-lib-version;.tar.bz2">alsa-ucm-conf</ulink>
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="kernel" id="alsa-lib-kernel">
|
|
<title>Kernel Configuration</title>
|
|
|
|
<para>
|
|
If needed, enable the following options in the kernel
|
|
configuration and recompile the kernel:
|
|
</para>
|
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="alsa-lib-kernel.xml"/>
|
|
|
|
<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. If necessary,
|
|
recompile and install your new kernel.
|
|
</para>
|
|
|
|
<indexterm zone="alsa-lib alsa-lib-kernel">
|
|
<primary sortas="d-ALSA">ALSA</primary>
|
|
</indexterm>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of ALSA Library</title>
|
|
|
|
<para>
|
|
Install <application>ALSA Library</application> by
|
|
running the following commands:
|
|
</para>
|
|
|
|
<screen><userinput>./configure &&
|
|
make</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>
|
|
|
|
<screen remap="doc"><userinput>make doc</userinput></screen>
|
|
|
|
<para>
|
|
To test the results, issue: <command>make check</command>.
|
|
</para>
|
|
|
|
<para>
|
|
Now, as the <systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>make install</userinput></screen>
|
|
|
|
<para>
|
|
To install the API documentation, run the following command as
|
|
the <systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<screen role="root"
|
|
remap="doc"><userinput>install -v -d -m755 /usr/share/doc/alsa-lib-&alsa-lib-version;/html/search &&
|
|
install -v -m644 doc/doxygen/html/*.* \
|
|
/usr/share/doc/alsa-lib-&alsa-lib-version;/html &&
|
|
install -v -m644 doc/doxygen/html/search/* \
|
|
/usr/share/doc/alsa-lib-&alsa-lib-version;/html/search</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="configuration">
|
|
<title>Configuring ALSA Library</title>
|
|
|
|
<sect3 id="alsa-lib-config">
|
|
<title>Config Files</title>
|
|
|
|
<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>
|
|
</indexterm>
|
|
|
|
<indexterm zone="alsa-lib alsa-lib-config">
|
|
<primary sortas="e-etc-asound.conf">/etc/asound.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="https://www.alsa-project.org/main/index.php/Asoundrc"/>.
|
|
</para>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Program</segtitle>
|
|
<segtitle>Installed Library</segtitle>
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
aserver
|
|
</seg>
|
|
<seg>
|
|
libasound.so and
|
|
libatopology.so
|
|
</seg>
|
|
<seg>
|
|
/usr/include/alsa,
|
|
/usr/share/alsa and
|
|
/usr/share/doc/alsa-lib-&alsa-lib-version;
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="aserver">
|
|
<term><command>aserver</command></term>
|
|
<listitem>
|
|
<para>
|
|
is the ALSA server
|
|
</para>
|
|
<indexterm zone="alsa-lib aserver">
|
|
<primary sortas="b-aserver">aserver</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libasound">
|
|
<term><filename class="libraryfile">libasound.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains the ALSA API functions
|
|
</para>
|
|
<indexterm zone="alsa-lib libasound">
|
|
<primary sortas="c-libasound">libasound.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libatopology">
|
|
<term><filename class="libraryfile">libatopology.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains API functions for the ALSA topologies
|
|
</para>
|
|
<indexterm zone="alsa-lib libatopology">
|
|
<primary sortas="c-libatopology">libatopology.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|