1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
<!--
$Id: nasd.1.html 243 2007-04-07 23:13:43Z jon $
-->
<!-- manual page source format generated by PolyglotMan v3.0.8+X.Org, -->
<!-- available at http://polyglotman.sourceforge.net/ -->
<html>
<head>
<title>NASD(1) manual page</title>
</head>
<body bgcolor='#efefef' text='black' link='blue' vlink='#551A8B' alink='red'>
<a href='#toc'>Table of Contents</a><p>
<h2><a name='sect0' href='#toc0'>Name</a></h2>
nasd - Network Audio System server
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<b>nasd</b> [:listen port offset]
[-option ...]
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<i>nasd</i> is the generic name for the Network Audio System
server. It is frequently a link or a copy of the appropriate server binary
for driving the most frequently used server on a given machine.
<h2><a name='sect3' href='#toc3'>Starting
the Server</a></h2>
The server is usually started from /etc/rc or a user's startup
script. <p>
When the Network Audio System server starts up, it takes over /dev/audio.
Note, that if ReleaseDevice is set to TRUE [default] in the nasd.conf file,
nasd will relinquish control of the audio device whenever it has finished
playing a sound. This means you can use other non-NAS applications when
nasd is running, as long as nasd isn't currently playing a song. If ReleaseDevice
is set to FALSE in the nasd.conf file, applications that attempt to access
/dev/audio themselves will fail while nasd is running.
<h2><a name='sect4' href='#toc4'>Network Connections</a></h2>
The
Network Audio System server supports connections made using the following
reliable byte-streams:
<dl>
<dt><i>TCP/IP</i> </dt>
<dd><br>
The server listens on port 8000+<i>n</i>, where <i>n</i> is the listen port offset. </dd>
<dt><i>Unix
Domain</i> </dt>
<dd>The X server uses <i>/tmp/.sockets/audio<b>n</b></i> as the filename for the socket,
where <i>n</i> is the display number. </dd>
</dl>
<h2><a name='sect5' href='#toc5'>Options</a></h2>
All of the Network Audio System servers
accept the following generic command line options. Options specific to
a particular server may also be available, and are not listed here. Try
'nasd -?' for a list of those options, if available.
<dl>
<dt><b>-aa</b> </dt>
<dd>Allows any client to
connect. By default, access is allowed only to authenticated clients. </dd>
<dt><b>-local</b>
</dt>
<dd>Allows only clients on the local host to connect. By default, access is
allowed to local and remote hosts. </dd>
<dt><b>-v</b> </dt>
<dd>Enable verbose messages. This option
overrides the nasd.conf file setting. </dd>
<dt><b>-V</b> </dt>
<dd>Print version information and exit
(ignoring other options). </dd>
<dt><b>-b</b> </dt>
<dd>Fork a child to run in the background and exit
(daemon mode). </dd>
<dt><b>-d <i>n</i></b> </dt>
<dd>Enable debugging output at level <i>n</i>, where <i>n</i> is a positive
integer. The higher the level, the more output you will get. A value of
0 [default] disables debugging output. This option overrides the nasd.conf
file setting. When debugging is enabled, stderr is not closed by the nasd
process, and all debugging messages are written there. </dd>
<dt><b>-pn</b> </dt>
<dd></dd>
<dt><b>-nopn [default]</b>
</dt>
<dd>Enables or disables Partial Networking. Enabling Partial Networking allows
the server to start, even if the server cannot establish all of its well-known
sockets (connection points for clients), but establishes at least one. </dd>
<dt><b>-config
<i>file</i></b> </dt>
<dd>Use the config file <i>file</i>, instead of the default (/etc/nasd/nasd.conf).
</dd>
</dl>
<h2><a name='sect6' href='#toc6'>Signals</a></h2>
The Network Audio System server attaches special meaning to the
following signals:
<dl>
<dt><i>SIGHUP</i> </dt>
<dd>This signal causes the server to close all existing
connections, free all resources, and restore all defaults. </dd>
<dt><i>SIGTERM</i> </dt>
<dd>This
signal causes the server to exit cleanly. </dd>
<dt><i>SIGUSR1</i> </dt>
<dd>This signal is used quite
differently from either of the above. When the server starts, it checks
to see if it has inherited SIGUSR1 as SIG_IGN instead of the usual SIG_DFL.
In this case, the server sends a SIGUSR1 to its parent process after it
has set up the various connection schemes. </dd>
</dl>
<h2><a name='sect7' href='#toc7'>Diagnostics</a></h2>
Too numerous to list
them all.
<h2><a name='sect8' href='#toc8'>Files</a></h2>
<dl>
<dt>/tmp/.sockets/audio* </dt>
<dd>Unix domain socket </dd>
<dt>/usr/adm/audio*msgs
</dt>
<dd></dd>
<dt>/dev/audio </dt>
<dd>Audio device </dd>
</dl>
<h2><a name='sect9' href='#toc9'>See Also</a></h2>
<a href='nas.1.html'>nas(1)</a>
, <a href='auinfo.1.html'>auinfo(1)</a>
, <a href='auplay.1.html'>auplay(1)</a>
, <a href='auctl.1.html'>auctl(1)</a>
,
<a href='nasd.conf.1.html'>nasd.conf(1)</a>
<h2><a name='sect10' href='#toc10'>Bugs</a></h2>
<p>
If <i>au</i> dies before its clients, new clients won't be able
to connect until all existing connections have their TCP TIME_WAIT timers
expire. <p>
The current access control support is weak at best. <p>
<h2><a name='sect11' href='#toc11'>Copyright</a></h2>
Copyright
1993, Network Computing Devices, Inc. <br>
<h2><a name='sect12' href='#toc12'>Authors</a></h2>
The Network Audio System server was originally written by Greg Renda
and Dave Lemke, with large amounts of code borrowed from the sample X server.
<p>
The sample X server was originally written by Susan Angebranndt, Raymond
Drewry, Philip Karlton, and Todd Newman, from Digital Equipment Corporation,
with support from a large cast. It has since been extensively rewritten
by Keith Packard and Bob Scheifler, from MIT. <p>
<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Starting the Server</a></li>
<li><a name='toc4' href='#sect4'>Network Connections</a></li>
<li><a name='toc5' href='#sect5'>Options</a></li>
<li><a name='toc6' href='#sect6'>Signals</a></li>
<li><a name='toc7' href='#sect7'>Diagnostics</a></li>
<li><a name='toc8' href='#sect8'>Files</a></li>
<li><a name='toc9' href='#sect9'>See Also</a></li>
<li><a name='toc10' href='#sect10'>Bugs</a></li>
<li><a name='toc11' href='#sect11'>Copyright</a></li>
<li><a name='toc12' href='#sect12'>Authors</a></li>
</ul>
</body>
</html>
|
