1libao.conf(5) libao configuration libao.conf(5)
2
3
4
6 libao.conf - configuration for libao.
7
8
10 /etc/libao.conf
11
12 ~/.libao
13
14
16 libao.conf and .libao are configuration files for libao, the audio out‐
17 put library. They specify various options to libao, as described
18 below. libao.conf sets system-wide options, whereas ~/.libao sets
19 user-specific options. When an option is set in both places, the
20 option in ~/.libao takes precedence.
21
22
24 The file consists of comments and key-value pairs. Comments are on
25 separate lines that start with a # symbol. The key-value pairs are of
26 the form:
27 key=value
28 where key contains no whitespace and no equal signs. value will be all
29 of the text after the equal sign until (but not including) the ending
30 newline. Beware of extra spaces at the end of the line! They will
31 probably be interpreted as part of the option value.
32
33 The following is a list of valid global option keys. Any driver spe‐
34 cific option may be used as well as those keys.
35
36 default_driver
37 The short name of the driver libao should use by default.
38 Valid values include (not all are available on every
39 platform): oss, esd, arts, alsa, nas, irix, sun, roar and
40 sndio. Note that "sun" is used on many BSD systems as
41 well as Solaris.
42
43 debug (Value optional/ignored)
44 Sets all the drivers as well as AO itself into debugging
45 output mode. Unlike passing the debug option to a
46 driver, debug will also print debugging information from
47 driver loading and testing.
48
49 quiet (Value optional/ignored)
50 Sets all the drivers as well as AO itself into silent
51 mode. Errors will return only error codes; neither ao
52 nor the drivers will print any output whatsoever to
53 stderr.
54
55 verbose (Value optional/ignored)
56 Sets all the drivers as well as AO itself into verbose
57 mode.
58
59
61 Here is an example libao.conf that forces the OSS driver to be used by
62 default:
63
64 # This is a comment.
65 default_driver=oss
66
67
69 libao.conf is missing a number of potentially useful options.
70
71
73 Stan Seibert <volsung@xiph.org>
74
75
76
77 September 1, 2003 libao.conf(5)