bionic (5) nasd.conf.5nas.gz

Provided by: nas_1.9.4-6_amd64 bug

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)