libao documentation | libao version 1.1.0 - 20110221

# libao Configuration Files

When libao is initialized, it reads two configuration files: the system-wide configuration in "/etc/libao.conf" and the user configuration in "~/.libao". Neither file needs to be present on the system for libao to load. If both are present, the system configuration file is read first, followed by the user configuration file. Options set in the user configuration will take precedence.

Options are specified in these files in the form:

    option=value

There can be no extra spaces anywhere on the line. Comment lines begin with a `#` symbol.

## AO Options

default_driver
  Set this equal to the short name of the driver you want the system to use by default. If this is not specified in any of the configuration files, the library will try to guess an appropriate driver to use.
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.

## Driver Options

Driver options may be set in the configuration files using `option=value` pairs, just as they would be set by passing options to ao_open_live() or ao_open_file(). Options passed to ao_open_live() or ao_open_file() take precedence over options specified in a configuration file. Options specified in a configuration file will be passed to whatever driver is eventually opened; they cannot be set specific to a single driver.

copyright © 2001-2003 Stan Seibert, 2010-2011 Monty | xiph.org monty@xiph.org
libao documentation | libao version 1.1.0 - 20110221