Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NASD.CONF(5)		       File Formats Manual		    NASD.CONF(5)

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 & maxi-
     mum 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 tun-
     ing 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 pars-
     ing the config file, and setting debug messages on. The remaining two  sec-
     tions  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-initial-
     ized  only if it is initialized at startup (see MixerInit option). This op-
     tion 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 vari-
     ous 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  fre-
     quency 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 de-
     fault 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)

NAS								    NASD.CONF(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nasd.conf&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help