1NASD.CONF(5) File Formats Manual NASD.CONF(5)
2
3
4
6 nasd.conf - Configuration file for NAS servers.
7
9 nasd.conf Is a file that can be used to configure the behaiviour of the
10 NAS server, including what devices it will attempt to use, the minimum
11 & maximum frequencies used, if the device should be used in 8bit or
12 16bit mode, what fragment size and number of fragments should be used
13 (useful for tuning the server's latency) and if the server should be
14 verbose when starting or output debugging information. Not all options
15 are supported for all servers, see the /etc/nas/nasd.conf.eg file for
16 information on what options are supported for which servers.
17
19 There are up to three section in the config file. The first section
20 deals with global options, some of which just turn on verbose messages
21 when parsing the config file, and setting debug messages on. The
22 remaining two sections will, if present, adjust various parameters of
23 the input and output devices, for those servers that understand them.
24
25 verbose Sets a flag telling the server to report what it's trying to do
26 with each setting in the config file. This option is off by default.
27
28 debug <number> Sets the debug flag, which will provide a trace of the
29 server's activities on stderr. Set <number> to 0 to disable debug mes‐
30 sages, 99 for *alot* of debug messages. This option defaults to 0.
31
32 ReleaseDevice YES | NO Set to YES or NO. Defines whether the server
33 should release the audio device when finished playing or recording a
34 sound. This option defaults to YES. (voxware, hpux, sun)
35
36 KeepMixer YES | NO Set to YES or NO. Defines whether the server should
37 keep the mixer open when releasing the audio device. Without an open
38 mixer device the server will always report the default gain and line
39 mode and cannot change them either. This option defaults to YES.
40 (voxware)
41
42 MixerInit YES | NO Set to YES or NO. Defines whether the server will
43 init the mixer device on startup. Later changes of gain or input mode
44 will change the mixer settings. This option defaults to NO. (voxware)
45
46 ReInitMixer YES | NO Set to YES or NO. Defines whether the server will
47 re-init the mixer device on every audio device open. The mixer is re-
48 initialized only if it is initialized at startup (see MixerInit
49 option). This option defaults to NO. (voxware)
50
51 OutDevType EXT | INT For HPUX servers, define to EXT to use the exter‐
52 nal output device (headphone/speakers) or INT for the internal output
53 device (internal speaker). Defaults to EXT.
54
55 outputsection Marks the beginning of the output section, which allows
56 various parameters of the output device to be set up.
57
58 inputsection Marks the beginning of the input section, which allows
59 various parameters of the input device to be set up.
60
61 end Marks the end of the input section or output section.
62
63 device <devname> Specifies what device is used. An example is device
64 "/dev/dsp". With the voxware server you can use the empty string "" to
65 disable the device.
66
67 mixer <mixername> Specifies what mixer device is used. An example is
68 mixer "/dev/mixer". If <mixername> is set to the empty string "" no
69 mixer is used in this section.
70
71 gain <number> Specifies the default volume (0-100). The default is 50.
72
73 gainscale <number> This factor (expressed as a percentage) is applied
74 to all volume-setting requests. This lets the server transparently
75 limit the actual maximum volume that can be set by clients. The default
76 is 100.
77
78 maxrate <number> The maximum number of samples per second that we'll
79 drive the card at.
80
81 minrate <number> The minimum number of samples per second that the card
82 will be driven at.
83
84 maxfrags <number> The maximum number of of kernel buffers that will be
85 used for the device. the number is dynamically adjusted as the sam‐
86 pling frequency varies.
87
88 minfrags <number> The minimum number of kernel buffers that will be
89 used.
90
91 fragsize <number> The size of each buffer - note that the size must be
92 a power of 2.
93
94 wordsize <number> The number of bits per sample. Allowable values are 8
95 and 16.
96
97 numchans <number> Used to decide if the card is run in stereo or mono
98 mode. Allowable values are 1 or 2.
99
100
101 forcerate no | yes Forces the output rate to the current rate. The
102 default is no.
103
104 autoOpen no | yes Whether to open the device at init time (if
105 ReleaseDevice = no). The default is yes.
106
107 readwrite no | yes Whether or not to open the device read-write. The
108 default is no. If set to yes, then the device will be opened
109 read-write. There should be no need to set this to yes, but...
110
112 nas(1), nasd(1), auinfo(1), auplay(1), auctl(1)
113
115 Absolutely none.
116
118 Stephen Hocking (sysseh@devetir.qld.gov.au), Jon Trulson (jon@rad‐
119 scan.com)
120
121
122
123NAS NASD.CONF(5)