1NASD.CONF(5)                  File Formats Manual                 NASD.CONF(5)
2
3
4

NAME

6       nasd.conf - Configuration file for NAS servers.
7

DESCRIPTION

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

THE CONFIG FILE SYNTAX

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

SEE ALSO

112       nas(1), nasd(1), auinfo(1), auplay(1), auctl(1)
113

BUGS

115       Absolutely none.
116

AUTHORS

118       Stephen  Hocking  (sysseh@devetir.qld.gov.au),  Jon  Trulson  (jon@rad‐
119       scan.com)
120
121
122
123NAS                                                               NASD.CONF(5)
Impressum