Changeset 1d13710


Ignore:
Timestamp:
05/09/2005 06:59:16 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 12.2, 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, gimp3, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/for-12.3, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/spidermonkey128, xry111/test-20220226, xry111/xf86-video-removal
Children:
05d3187
Parents:
b6eda3a5
Message:

Tagged alsa-utils.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • multimedia/libdriv/alsa-utils.xml

    rb6eda3a5 r1d13710  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
    12<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
    23   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    … …  
    1314
    1415<sect1 id="alsa-utils" xreflabel="ALSA Utilities-&alsa-utils-version;">
    15 <sect1info>
    16 <othername>$LastChangedBy$</othername>
    17 <date>$Date$</date>
    18 </sect1info>
    19 <?dbhtml filename="alsa-utils.html"?>
    20 <title>ALSA Utilities-&alsa-utils-version;</title>
    21 <indexterm zone="alsa-utils">
    22 <primary sortas="a-ALSA-Utilities">ALSA Utilities</primary></indexterm>
    23 
    24 <sect2>
    25 <title>Introduction to <application><acronym>ALSA</acronym>
    26 Utilities</application></title>
    27 
    28 <para>The <application><acronym>ALSA</acronym> Utilities</application> package
    29 contains various utilities which are useful for controlling your sound
    30 card.</para>
    31 
    32 <sect3><title>Package information</title>
    33 <itemizedlist spacing='compact'>
    34 <listitem><para>Download (HTTP):
    35 <ulink url="&alsa-utils-download-http;"/></para></listitem>
    36 <listitem><para>Download (FTP):
    37 <ulink url="&alsa-utils-download-ftp;"/></para></listitem>
    38 <listitem><para>Download MD5 sum: &alsa-utils-md5sum;</para></listitem>
    39 <listitem><para>Download size: &alsa-utils-size;</para></listitem>
    40 <listitem><para>Estimated disk space required:
    41 &alsa-utils-buildsize;</para></listitem>
    42 <listitem><para>Estimated build time:
    43 &alsa-utils-time;</para></listitem></itemizedlist>
    44 </sect3>
    45 
    46 <sect3><title><application><acronym>ALSA</acronym> Utilities</application>
    47 dependencies</title>
    48 <sect4><title>Required</title>
    49 <para><xref linkend="alsa-lib"/></para>
    50 </sect4>
    51 </sect3>
    52 
    53 </sect2>
    54 
    55 <sect2>
    56 <title>Installation of <application><acronym>ALSA</acronym>
    57 Utilities</application></title>
    58 
    59 <para>Install <application><acronym>ALSA</acronym> Utilities</application> by
    60 running the following commands:</para>
    61 
    62 <screen><userinput><command>./configure &amp;&amp;
    63 make</command></userinput></screen>
    64 
    65 <para>This package does not come with a test suite.</para>
    66 
    67 <para>Now, as the root user:</para>
    68 
    69 <screen><userinput role='root'><command>make install</command></userinput></screen>
    70 
    71 </sect2>
    72 
    73 <sect2>
    74 <title>Configuring <application><acronym>ALSA</acronym>
    75 Utilities</application></title>
    76 
    77 <sect3 id="alsa-utils-config"><title>Config files</title>
    78 <para><filename>/etc/asound.state</filename></para>
    79 <indexterm zone="alsa-utils alsa-utils-config">
    80 <primary sortas="e-etc-asound.state">/etc/asound.state</primary></indexterm>
    81 </sect3>
    82 
    83 <sect3 id="alsa-utils-init"><title>Configuration Information</title>
    84 <para>Probably the easiest way to store mixer levels is to set and retrieve
    85 them using a bootscript.</para>
    86 <indexterm zone="alsa-utils alsa-utils-init">
    87 <primary sortas="f-alsa">alsa</primary></indexterm>
    88 
    89 <para>As the root user, install the init script
    90 <filename>/etc/rc.d/init.d/alsa</filename> included in the
    91 <xref linkend="intro-important-bootscripts"/> package.</para>
    92 
    93 <screen><userinput role='root'><command>make install-alsa</command></userinput></screen>
    94 
    95 <para>Note that all channels of your sound card are muted by default. You can
    96 use the <command>alsamixer</command> program from
    97 <application><acronym>ALSA</acronym> Utilities</application> (or any other
    98 <acronym>OSS</acronym> mixer) to change this.</para>
    99 
    100 <para>The first time the above script is run, it will complain that
    101 there is no state in <filename>/etc/asound.state</filename>.  You can
    102 prevent this by running the following commands as the root user after
    103 installing <application><acronym>ALSA</acronym> Utilities</application>:</para>
    104 
    105 <screen><userinput role='root'><command>touch /etc/asound.state &amp;&amp;
    106 alsactl store</command></userinput></screen>
    107 
    108 <para>A final note is that the lines loading <filename>sfxload</filename>
    109 are commented out.  They are there as an example of other things you may
    110 wish to do in the startup script.  <filename>sfxload</filename> is a
    111 separate package of interest to SoundBlaster AWE and Live!
    112 users.  It is designed for loading "sound-fonts" (which are used for
    113 <acronym>MIDI</acronym> output).  You may wish to delete these lines and add
    114 your own or, if you have the relevant sound card, install
    115 <filename>sfxload</filename> and uncomment them.</para>
    116 
    117 </sect3>
    118 
    119 </sect2>
    120 
    121 <sect2>
    122 <title>Contents</title>
    123 
    124 <segmentedlist>
    125 <segtitle>Installed Programs</segtitle>
    126 <segtitle>Installed Libraries</segtitle>
    127 <segtitle>Installed Directories</segtitle>
    128 
    129 <seglistitem>
    130 <seg>aconnect, alsaconf, alsactl, alsamixer, amidi, amixer, aplay, aplaymidi,
    131 arecord, arecordmidi, aseqnet, iecset and speaker-test</seg>
    132 <seg>None</seg>
    133 <seg>None</seg>
    134 </seglistitem>
    135 </segmentedlist>
    136 
    137 <variablelist>
    138 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    139 <?dbfo list-presentation="list"?>
    140 
    141 <varlistentry id="aconnect">
    142 <term><command>aconnect</command></term>
    143 <listitem><para>is a utility for connecting and disconnecting two existing
    144 ports in the <acronym>ALSA</acronym> sequencer system.</para>
    145 <indexterm zone="alsa-utils aconnect">
    146 <primary sortas="b-aconnect">aconnect</primary>
    147 </indexterm></listitem>
    148 </varlistentry>
    149 
    150 <varlistentry id="alsaconf">
    151 <term><command>alsaconf</command></term>
    152 <listitem><para>is a configuration tool which tries to detect the sound cards
    153 on your system and write a suitable configuration file for
    154 <acronym>ALSA</acronym>.</para>
    155 <indexterm zone="alsa-utils alsaconf">
    156 <primary sortas="b-alsaconf">alsaconf</primary>
    157 </indexterm></listitem>
    158 </varlistentry>
    159 
    160 <varlistentry id="alsactl">
    161 <term><command>alsactl</command></term>
    162 <listitem><para>is used to control advanced settings for the
    163 <acronym>ALSA</acronym> sound card drivers.</para>
    164 <indexterm zone="alsa-utils alsactl">
    165 <primary sortas="b-alsactl">alsactl</primary>
    166 </indexterm></listitem>
    167 </varlistentry>
    168 
    169 <varlistentry id="alsamixer">
    170 <term><command>alsamixer</command></term>
    171 <listitem><para>is an ncurses-based mixer program for use with the
    172 <acronym>ALSA</acronym> sound card drivers.</para>
    173 <indexterm zone="alsa-utils alsamixer">
    174 <primary sortas="b-alsamixer">alsamixer</primary>
    175 </indexterm></listitem>
    176 </varlistentry>
    177 
    178 <varlistentry id="amidi">
    179 <term><command>amidi</command></term>
    180 <listitem><para>is used to read from and write to <acronym>ALSA</acronym>
    181 RawMIDI ports.</para>
    182 <indexterm zone="alsa-utils amidi">
    183 <primary sortas="b-amidi">amidi</primary>
    184 </indexterm></listitem>
    185 </varlistentry>
    186 
    187 <varlistentry id="amixer">
    188 <term><command>amixer</command></term>
    189 <listitem><para> allows command-line control of the mixers for the
    190 <acronym>ALSA</acronym> sound card drivers.</para>
    191 <indexterm zone="alsa-utils amixer">
    192 <primary sortas="b-amixer">amixer</primary>
    193 </indexterm></listitem>
    194 </varlistentry>
    195 
    196 <varlistentry id="aplay">
    197 <term><command>aplay</command></term>
    198 <listitem><para>is a command-line soundfile player for the
    199 <acronym>ALSA</acronym> sound card drivers.</para>
    200 <indexterm zone="alsa-utils aplay">
    201 <primary sortas="b-aplay">aplay</primary>
    202 </indexterm></listitem>
    203 </varlistentry>
    204 
    205 <varlistentry id="aplaymidi">
    206 <term><command>aplaymidi</command></term>
    207 <listitem><para>is a command-line utility that plays the specified
    208 <acronym>MIDI</acronym> file(s) to one or more <acronym>ALSA</acronym>
    209 sequencer ports.</para>
    210 <indexterm zone="alsa-utils aplaymidi">
    211 <primary sortas="b-aplaymidi">aplaymidi</primary>
    212 </indexterm></listitem>
    213 </varlistentry>
    214 
    215 <varlistentry id="arecord">
    216 <term><command>arecord</command></term>
    217 <listitem><para>is a command-line soundfile recorder for the
    218 <acronym>ALSA</acronym> sound card drivers.</para>
    219 <indexterm zone="alsa-utils arecord">
    220 <primary sortas="b-arecord">arecord</primary>
    221 </indexterm></listitem>
    222 </varlistentry>
    223 
    224 <varlistentry id="arecordmidi">
    225 <term><command>arecordmidi</command></term>
    226 <listitem><para>is a command-line utility that records a standard
    227 <acronym>MIDI</acronym> file from one or more <acronym>ALSA</acronym>
    228 sequencer ports.</para>
    229 <indexterm zone="alsa-utils arecordmidi">
    230 <primary sortas="b-arecordmidi">arecordmidi</primary>
    231 </indexterm></listitem>
    232 </varlistentry>
    233 
    234 <varlistentry id="aseqnet">
    235 <term><command>aseqnet</command></term>
    236 <listitem><para>is an <acronym>ALSA</acronym> sequencer client which sends
    237 and receives event packets over a network.</para>
    238 <indexterm zone="alsa-utils aseqnet">
    239 <primary sortas="b-aseqnet">aseqnet</primary>
    240 </indexterm></listitem>
    241 </varlistentry>
    242 
    243 <varlistentry id="iecset">
    244 <term><command>iecset</command></term>
    245 <listitem><para>is a small utility to set or dump the IEC958 (or so-called
    246 <quote>S/<acronym>PDIF</acronym></quote>) status bits of the specified sound
    247 card via the <acronym>ALSA</acronym> control <acronym>API</acronym>.</para>
    248 <indexterm zone="alsa-utils iecset">
    249 <primary sortas="b-iecset">iecset</primary>
    250 </indexterm></listitem>
    251 </varlistentry>
    252 
    253 <varlistentry id="speaker-test">
    254 <term><command>speaker-test</command></term>
    255 <listitem><para>is a command-line speaker test tone generator for
    256 <acronym>ALSA</acronym>.</para>
    257 <indexterm zone="alsa-utils speaker-test">
    258 <primary sortas="b-speaker-test">speaker-test</primary>
    259 </indexterm></listitem>
    260 </varlistentry>
    261 </variablelist>
    262 
    263 </sect2>
     16  <?dbhtml filename="alsa-utils.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>ALSA Utilities-&alsa-utils-version;</title>
     24
     25  <indexterm zone="alsa-utils">
     26    <primary sortas="a-ALSA-Utilities">ALSA Utilities</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to ALSA Utilities</title>
     31
     32    <para>The <application>ALSA Utilities</application> package contains
     33    various utilities which are useful for controlling your sound card.</para>
     34
     35    <bridgehead renderas="sect3">Package Information</bridgehead>
     36    <itemizedlist spacing="compact">
     37      <listitem>
     38        <para>Download (HTTP): <ulink url="&alsa-utils-download-http;"/></para>
     39      </listitem>
     40      <listitem>
     41        <para>Download (FTP): <ulink url="&alsa-utils-download-ftp;"/></para>
     42      </listitem>
     43      <listitem>
     44        <para>Download MD5 sum: &alsa-utils-md5sum;</para>
     45      </listitem>
     46      <listitem>
     47        <para>Download size: &alsa-utils-size;</para>
     48      </listitem>
     49      <listitem>
     50        <para>Estimated disk space required: &alsa-utils-buildsize;</para>
     51      </listitem>
     52      <listitem>
     53        <para>Estimated build time: &alsa-utils-time;</para>
     54      </listitem>
     55    </itemizedlist>
     56
     57    <bridgehead renderas="sect3">ALSA Utilities Dependencies</bridgehead>
     58
     59    <bridgehead renderas="sect4">Required</bridgehead>
     60    <para><xref linkend="alsa-lib"/></para>
     61
     62  </sect2>
     63
     64  <sect2 role="installation">
     65    <title>Installation of ALSA Utilities</title>
     66
     67    <para>Install <application>ALSA Utilities</application> by
     68    running the following commands:</para>
     69
     70<screen><userinput>./configure &amp;&amp;
     71make</userinput></screen>
     72
     73    <para>This package does not come with a test suite.</para>
     74
     75    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     76
     77<screen role="root"><userinput>make install</userinput></screen>
     78
     79  </sect2>
     80
     81  <sect2 role="configuration">
     82    <title>Configuring ALSA Utilities</title>
     83
     84    <sect3 id="alsa-utils-config">
     85      <title>Config Files</title>
     86
     87      <para><filename>/etc/asound.state</filename></para>
     88
     89      <indexterm zone="alsa-utils alsa-utils-config">
     90        <primary sortas="e-etc-asound.state">/etc/asound.state</primary>
     91      </indexterm>
     92
     93    </sect3>
     94
     95    <sect3 id="alsa-utils-init">
     96      <title>Configuration Information</title>
     97
     98      <para>Probably the easiest way to store mixer levels is to set and
     99      retrieve them using a bootscript.</para>
     100
     101      <indexterm zone="alsa-utils alsa-utils-init">
     102        <primary sortas="f-alsa">alsa</primary>
     103      </indexterm>
     104
     105      <para>As the <systemitem class="username">root</systemitem> user,
     106      install the init script <filename>/etc/rc.d/init.d/alsa</filename> included
     107      in the <xref linkend="intro-important-bootscripts"/> package.</para>
     108
     109<screen role="root"><userinput>make install-alsa</userinput></screen>
     110
     111      <para>Note that all channels of your sound card are muted by default.
     112      You can use the <command>alsamixer</command> program from
     113      <application>ALSA Utilities</application> (or any other
     114      OSS mixer) to change this.</para>
     115
     116      <para>The first time the above script is run, it will complain that
     117      there is no state in <filename>/etc/asound.state</filename>.  You can
     118      prevent this by running the following commands as the
     119      <systemitem class="username">root</systemitem> user after
     120      installing <application>ALSA Utilities</application>:</para>
     121
     122<screen role="root"><userinput>touch /etc/asound.state &amp;&amp;
     123alsactl store</userinput></screen>
     124
     125      <para>A final note is that the lines loading <filename>sfxload</filename>
     126      are commented out.  They are there as an example of other things you may
     127      wish to do in the startup script.  <filename>sfxload</filename> is a
     128      separate package of interest to SoundBlaster AWE and Live!
     129      users.  It is designed for loading "sound-fonts" (which are used for
     130      MIDI output).  You may wish to delete these lines and add
     131      your own or, if you have the relevant sound card, install
     132      <filename>sfxload</filename> and uncomment them.</para>
     133
     134    </sect3>
     135
     136  </sect2>
     137
     138  <sect2 role="content">
     139    <title>Contents</title>
     140
     141    <segmentedlist>
     142      <segtitle>Installed Programs</segtitle>
     143      <segtitle>Installed Libraries</segtitle>
     144      <segtitle>Installed Directories</segtitle>
     145
     146      <seglistitem>
     147        <seg>aconnect, alsaconf, alsactl, alsamixer, amidi, amixer, aplay, aplaymidi,
     148        arecord, arecordmidi, aseqnet, iecset, and speaker-test</seg>
     149        <seg>None</seg>
     150        <seg>None</seg>
     151      </seglistitem>
     152    </segmentedlist>
     153
     154    <variablelist>
     155      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     156      <?dbfo list-presentation="list"?>
     157      <?dbhtml list-presentation="table"?>
     158
     159      <varlistentry id="aconnect">
     160        <term><command>aconnect</command></term>
     161        <listitem>
     162          <para>is a utility for connecting and disconnecting two existing
     163          ports in the ALSA sequencer system.</para>
     164          <indexterm zone="alsa-utils aconnect">
     165            <primary sortas="b-aconnect">aconnect</primary>
     166          </indexterm>
     167        </listitem>
     168      </varlistentry>
     169
     170      <varlistentry id="alsaconf">
     171        <term><command>alsaconf</command></term>
     172        <listitem>
     173          <para>is a configuration tool which tries to detect the sound cards
     174          on your system and write a suitable configuration file for ALSA.</para>
     175          <indexterm zone="alsa-utils alsaconf">
     176            <primary sortas="b-alsaconf">alsaconf</primary>
     177          </indexterm>
     178        </listitem>
     179      </varlistentry>
     180
     181      <varlistentry id="alsactl">
     182        <term><command>alsactl</command></term>
     183        <listitem>
     184          <para>is used to control advanced settings for the
     185          ALSA sound card drivers.</para>
     186          <indexterm zone="alsa-utils alsactl">
     187            <primary sortas="b-alsactl">alsactl</primary>
     188          </indexterm>
     189        </listitem>
     190      </varlistentry>
     191
     192      <varlistentry id="alsamixer">
     193        <term><command>alsamixer</command></term>
     194        <listitem>
     195          <para>is an ncurses-based mixer program for use with the
     196          ALSA sound card drivers.</para>
     197          <indexterm zone="alsa-utils alsamixer">
     198            <primary sortas="b-alsamixer">alsamixer</primary>
     199          </indexterm>
     200        </listitem>
     201      </varlistentry>
     202
     203      <varlistentry id="amidi">
     204        <term><command>amidi</command></term>
     205        <listitem>
     206          <para>is used to read from and write to ALSA
     207          RawMIDI ports.</para>
     208          <indexterm zone="alsa-utils amidi">
     209            <primary sortas="b-amidi">amidi</primary>
     210          </indexterm>
     211        </listitem>
     212      </varlistentry>
     213
     214      <varlistentry id="amixer">
     215        <term><command>amixer</command></term>
     216        <listitem>
     217          <para> allows command-line control of the mixers for the
     218          ALSA sound card drivers.</para>
     219          <indexterm zone="alsa-utils amixer">
     220            <primary sortas="b-amixer">amixer</primary>
     221          </indexterm>
     222        </listitem>
     223      </varlistentry>
     224
     225      <varlistentry id="aplay">
     226        <term><command>aplay</command></term>
     227        <listitem>
     228          <para>is a command-line soundfile player for the
     229          ALSA sound card drivers.</para>
     230          <indexterm zone="alsa-utils aplay">
     231            <primary sortas="b-aplay">aplay</primary>
     232          </indexterm>
     233        </listitem>
     234      </varlistentry>
     235
     236      <varlistentry id="aplaymidi">
     237        <term><command>aplaymidi</command></term>
     238        <listitem>
     239          <para>is a command-line utility that plays the specified
     240          MIDI file(s) to one or more ALSA sequencer ports.</para>
     241          <indexterm zone="alsa-utils aplaymidi">
     242            <primary sortas="b-aplaymidi">aplaymidi</primary>
     243          </indexterm>
     244        </listitem>
     245      </varlistentry>
     246
     247      <varlistentry id="arecord">
     248        <term><command>arecord</command></term>
     249        <listitem>
     250          <para>is a command-line soundfile recorder for the
     251          ALSA sound card drivers.</para>
     252          <indexterm zone="alsa-utils arecord">
     253            <primary sortas="b-arecord">arecord</primary>
     254          </indexterm>
     255        </listitem>
     256      </varlistentry>
     257
     258      <varlistentry id="arecordmidi">
     259        <term><command>arecordmidi</command></term>
     260        <listitem>
     261          <para>is a command-line utility that records a standard
     262          MIDI file from one or more ALSA sequencer ports.</para>
     263          <indexterm zone="alsa-utils arecordmidi">
     264            <primary sortas="b-arecordmidi">arecordmidi</primary>
     265          </indexterm>
     266        </listitem>
     267      </varlistentry>
     268
     269      <varlistentry id="aseqnet">
     270        <term><command>aseqnet</command></term>
     271        <listitem>
     272          <para>is an ALSA sequencer client which sends
     273          and receives event packets over a network.</para>
     274          <indexterm zone="alsa-utils aseqnet">
     275            <primary sortas="b-aseqnet">aseqnet</primary>
     276          </indexterm>
     277        </listitem>
     278      </varlistentry>
     279
     280      <varlistentry id="iecset">
     281        <term><command>iecset</command></term>
     282        <listitem>
     283          <para>is a small utility to set or dump the IEC958 (or so-called
     284          <quote>S/PDIF</quote>) status bits of the specified sound
     285          card via the ALSA control API.</para>
     286          <indexterm zone="alsa-utils iecset">
     287            <primary sortas="b-iecset">iecset</primary>
     288          </indexterm>
     289        </listitem>
     290      </varlistentry>
     291
     292      <varlistentry id="speaker-test">
     293        <term><command>speaker-test</command></term>
     294        <listitem>
     295          <para>is a command-line speaker test tone generator for ALSA.</para>
     296          <indexterm zone="alsa-utils speaker-test">
     297            <primary sortas="b-speaker-test">speaker-test</primary>
     298          </indexterm>
     299        </listitem>
     300      </varlistentry>
     301
     302    </variablelist>
     303
     304  </sect2>
    264305
    265306</sect1>
Note: See TracChangeset for help on using the changeset viewer.