man-pages/man5/libao.conf.5.html
2021-03-31 01:06:50 +01:00

139 lines
3.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of libao.conf</TITLE>
</HEAD><BODY>
<H1>libao.conf</H1>
Section: libao configuration (5)<BR>Updated: September 1, 2003<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<P>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
libao.conf - configuration for libao.
<P>
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<P>
<B>/etc/libao.conf</B>
<P>
<B>~/.libao</B>
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>libao.conf</B>
and
<B>.libao</B>
are configuration files for libao, the audio output library. They
specify various options to libao, as described below.
<B>libao.conf</B>
sets system-wide options, whereas
<B>~/.libao</B>
sets user-specific options. When an option is set in
both places, the option in
<B>~/.libao</B>
takes precedence.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>FILE FORMAT</H2>
The file consists of comments and key-value pairs. Comments are on separate lines that start with a
<B>#</B>
symbol. The key-value pairs are of the form:
<DL COMPACT><DT id="1"><DD>
<B>key=value</B>
</DL>
where
<B>key</B>
contains no whitespace and no equal signs.
<B>value</B>
will be all of the text after the equal sign until (but not including)
the ending newline. Beware of extra spaces at the end of the line!
They will probably be interpreted as part of the option value.
<P>
The following is a list of valid global option keys. Any driver specific option
may be used as well as those keys.
<DL COMPACT><DT id="2"><DD>
<DL COMPACT>
<DT id="3">default_driver<DD>
The short name of the driver libao should use by default. Valid values
include (not all are available on every platform): pulse, oss, esd, arts, alsa,
nas, irix, sun, and sndio. Note that &quot;sun&quot; is used on many BSD
systems as well as Solaris.
<DT id="4">debug (Value optional/ignored)<DD>
Sets all the drivers as well as AO itself into debugging output mode.
Unlike passing the debug option to a driver, debug will also print
debugging information from driver loading and testing.
<DT id="5">quiet (Value optional/ignored)<DD>
Sets all the drivers as well as AO itself into silent mode.
Errors will return only error codes; neither ao nor the drivers will
print any output whatsoever to stderr.
<DT id="6">verbose (Value optional/ignored)<DD>
Sets all the drivers as well as AO itself into verbose mode.
</DL>
</DL>
<P>
<A NAME="lbAF">&nbsp;</A>
<H2>EXAMPLE</H2>
<P>
Here is an example
<B>libao.conf</B>
that forces the OSS driver to be used by default:
<P>
<BR>&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;This&nbsp;is&nbsp;a&nbsp;comment.
<BR>&nbsp;&nbsp;&nbsp;&nbsp;default_driver=oss
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>BUGS</H2>
<P>
<B>libao.conf</B>
is missing a number of potentially useful options.
<P>
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHORS</H2>
<P>
<BR>
Stan Seibert &lt;<A HREF="mailto:volsung@xiph.org">volsung@xiph.org</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="10"><A HREF="#lbAE">FILE FORMAT</A><DD>
<DT id="11"><A HREF="#lbAF">EXAMPLE</A><DD>
<DT id="12"><A HREF="#lbAG">BUGS</A><DD>
<DT id="13"><A HREF="#lbAH">AUTHORS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:03 GMT, March 31, 2021
</BODY>
</HTML>