libao.conf(5) libao configuration libao.conf(5)

NAME

libao.conf - configuration for libao.

SYNOPSIS

/etc/libao.conf

~/.libao

DESCRIPTION

libao.conf and .libao are configuration files for libao, the audio
output library. They specify various options to libao, as described
below. libao.conf sets system-wide options, whereas ~/.libao sets
user-specific options. When an option is set in both places, the
option in ~/.libao takes precedence.

FILE FORMAT

The file consists of comments and key-value pairs. Comments are on
separate lines that start with a # symbol. The key-value pairs are
of the form:
key=value
where key contains no whitespace and no equal signs. value 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.

The following is a list of valid global option keys. Any driver
specific option may be used as well as those keys.

default_driver
The short name of the driver libao should use by
default. Valid values include (not all are available
on every platform): oss, esd, arts, alsa, nas, irix,
sun, roar and sndio. Note that "sun" is used on many
BSD systems as well as Solaris.

debug (Value optional/ignored)
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.

quiet (Value optional/ignored)
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.

verbose (Value optional/ignored)
Sets all the drivers as well as AO itself into verbose
mode.

EXAMPLE

Here is an example libao.conf that forces the OSS driver to be used
by default:

# This is a comment.
default_driver=oss

BUGS

libao.conf is missing a number of potentially useful options.

AUTHORS

Stan Seibert <volsung@xiph.org>

September 1, 2003 libao.conf(5)