NAME¶
nasd.conf - Configuration file for NAS servers.
DESCRIPTION¶
nasd.conf Is a file that can be used to configure the behaiviour of the
NAS server, including what devices it will attempt to use, the minimum &
maximum frequencies used, if the device should be used in 8bit or 16bit mode,
what fragment size and number of fragments should be used (useful for tuning
the server's latency) and if the server should be verbose when starting or
output debugging information. Not all options are supported for all servers,
see the
/etc/nas/nasd.conf.eg file for information on what options are
supported for which servers.
THE CONFIG FILE SYNTAX¶
There are up to three section in the config file. The first section deals with
global options, some of which just turn on verbose messages when parsing the
config file, and setting debug messages on. The remaining two sections will,
if present, adjust various parameters of the input and output devices, for
those servers that understand them.
verbose Sets a flag telling the server to report what it's trying to do
with each setting in the config file. This option is
off by default.
debug <number> Sets the debug flag, which will provide a trace of
the server's activities on stderr. Set <number> to
0 to disable
debug messages,
99 for *alot* of debug messages. This option defaults
to
0.
ReleaseDevice YES | NO Set to
YES or
NO. Defines whether
the server should release the audio device when finished playing or recording
a sound. This option defaults to
YES. (voxware, hpux, sun)
KeepMixer YES | NO Set to
YES or
NO. Defines whether the
server should keep the mixer open when releasing the audio device. Without an
open mixer device the server will always report the default gain and line mode
and cannot change them either. This option defaults to
YES. (voxware)
MixerInit YES | NO Set to
YES or
NO. Defines whether the
server will init the mixer device on startup. Later changes of gain or input
mode will change the mixer settings. This option defaults to
NO.
(voxware)
ReInitMixer YES | NO Set to
YES or
NO. Defines whether the
server will re-init the mixer device on every audio device open. The mixer is
re-initialized only if it is initialized at startup (see
MixerInit
option). This option defaults to
NO. (voxware)
OutDevType EXT | INT For HPUX servers, define to
EXT to use the
external output device (headphone/speakers) or
INT for the internal
output device (internal speaker). Defaults to
EXT.
outputsection Marks the beginning of the output section, which allows
various parameters of the output device to be set up.
inputsection Marks the beginning of the input section, which allows
various parameters of the input device to be set up.
end Marks the end of the input section or output section.
device <devname> Specifies what device is used. An example is
device "/dev/dsp". With the voxware server you can use the
empty string
"" to disable the device.
mixer <mixername> Specifies what mixer device is used. An example
is
mixer "/dev/mixer". If <mixername> is set to the
empty string
"" no mixer is used in this section.
gain <number> Specifies the default volume (
0-
100).
The default is
50.
gainscale <number> This factor (expressed as a percentage) is
applied to all volume-setting requests. This lets the server transparently
limit the actual maximum volume that can be set by clients. The default is
100.
maxrate <number> The maximum number of samples per second that
we'll drive the card at.
minrate <number> The minimum number of samples per second that the
card will be driven at.
maxfrags <number> The maximum number of of kernel buffers that will
be used for the device. the number is dynamically adjusted as the sampling
frequency varies.
minfrags <number> The minimum number of kernel buffers that will be
used.
fragsize <number> The size of each buffer - note that the size must
be a power of 2.
wordsize <number> The number of bits per sample. Allowable values
are
8 and
16.
numchans <number> Used to decide if the card is run in stereo or
mono mode. Allowable values are
1 or
2.
forcerate no | yes Forces the output rate to the current rate. The
default is
no.
autoOpen no | yes Whether to open the device at init time (if
ReleaseDevice =
no). The default is
yes.
readwrite no | yes Whether or not to open the device read-write. The
default is
no. If set to
yes, then the device will be opened
read-write. There should be no need to set this to
yes, but...
SEE ALSO¶
nas(1),
nasd(1),
auinfo(1),
auplay(1),
auctl(1)
BUGS¶
Absolutely none.
AUTHORS¶
Stephen Hocking (sysseh@devetir.qld.gov.au), Jon Trulson (jon@radscan.com)