1 | .\" Process this file with |
---|
2 | .\" groff -man -Tascii libao.conf.5 |
---|
3 | .\" |
---|
4 | .TH libao.conf 5 "September 1, 2003" "" "libao configuration" |
---|
5 | |
---|
6 | .SH NAME |
---|
7 | libao.conf \- configuration for libao. |
---|
8 | |
---|
9 | .SH SYNOPSIS |
---|
10 | |
---|
11 | .B /etc/libao.conf |
---|
12 | |
---|
13 | .B ~/.libao |
---|
14 | |
---|
15 | .SH DESCRIPTION |
---|
16 | .B libao.conf |
---|
17 | and |
---|
18 | .B .libao |
---|
19 | are configuration files for libao, the audio output library. They |
---|
20 | specify various options to libao, as described below. |
---|
21 | .B libao.conf |
---|
22 | sets system-wide options, whereas |
---|
23 | .B ~/.libao |
---|
24 | sets user-specific options. When an option is set in |
---|
25 | both places, the option in |
---|
26 | .B ~/.libao |
---|
27 | takes precedence. |
---|
28 | |
---|
29 | .SH FILE FORMAT |
---|
30 | The file consists of comments and key-value pairs. Comments are on separate lines that start with a |
---|
31 | .B # |
---|
32 | symbol. The key-value pairs are of the form: |
---|
33 | .RS |
---|
34 | .BR |
---|
35 | .B key=value |
---|
36 | .RE |
---|
37 | where |
---|
38 | .B key |
---|
39 | contains no whitespace and no equal signs. |
---|
40 | .B value |
---|
41 | will be all of the text after the equal sign until (but not including) |
---|
42 | the ending newline. Beware of extra spaces at the end of the line! |
---|
43 | They will probably be interpreted as part of the option value. |
---|
44 | |
---|
45 | Valid option keys are: |
---|
46 | .RS |
---|
47 | .IP default_driver |
---|
48 | The short name of the driver libao should use by default. Valid values |
---|
49 | include (not all are available on every platform): oss, esd, arts, alsa, |
---|
50 | alsa09, nas, irix, and sun. Note that "sun" is used on many BSD |
---|
51 | systems as well as Solaris. The "alsa" driver is for the 0.5.x ALSA API, |
---|
52 | whereas the "alsa09" driver is for the 0.9.x API. |
---|
53 | .RE |
---|
54 | |
---|
55 | .SH EXAMPLE |
---|
56 | |
---|
57 | Here is an example |
---|
58 | .B libao.conf |
---|
59 | that forces the OSS driver to be used by default: |
---|
60 | |
---|
61 | # This is a comment. |
---|
62 | default_driver=oss |
---|
63 | |
---|
64 | .SH BUGS |
---|
65 | |
---|
66 | .B libao.conf |
---|
67 | is missing a number of potentially useful options. |
---|
68 | |
---|
69 | .SH AUTHORS |
---|
70 | |
---|
71 | .br |
---|
72 | Stan Seibert <volsung@xiph.org> |
---|