1NASD(1)                     General Commands Manual                    NASD(1)
2
3
4

NAME

6       nasd - Network Audio System server
7

SYNOPSIS

9       nasd [:listen port offset] [-option ...]
10

DESCRIPTION

12       nasd  is  the  generic name for the Network Audio System server.  It is
13       frequently a link or a copy of the appropriate server binary for  driv‐
14       ing the most frequently used server on a given machine.
15

STARTING THE SERVER

17       The server is usually started from /etc/rc or a user's startup script.
18
19       When  the  Network  Audio  System  server  starts  up,  it  takes  over
20       /dev/audio.  Note, that if ReleaseDevice is set to  TRUE  [default]  in
21       the  nasd.conf  file,  nasd will relinquish control of the audio device
22       whenever it has finished playing a sound.  This means you can use other
23       non-NAS  applications  when nasd is running, as long as nasd isn't cur‐
24       rently playing a song.   If  ReleaseDevice  is  set  to  FALSE  in  the
25       nasd.conf  file,  applications  that attempt to access /dev/audio them‐
26       selves will fail while nasd is running.
27

NETWORK CONNECTIONS

29       The Network Audio System server supports  connections  made  using  the
30       following reliable byte-streams:
31
32       TCPIP
33           The  server listens on port 8000+n, where n is the listen port off‐
34           set.
35
36       Unix Domain
37           The X server uses /tmp/.sockets/audion  as  the  filename  for  the
38           socket, where n is the display number.
39

OPTIONS

41       All  of  the  Network Audio System servers accept the following generic
42       command line options.  Options specific to a particular server may also
43       be  available,  and  are  not listed here.  Try 'nasd -?' for a list of
44       those options, if available.
45
46       -aa     Allows any client to connect.  By default,  access  is  allowed
47               only to authenticated clients.
48
49       -local  Allows  only clients on the local host to connect.  By default,
50               access is allowed to local and remote hosts.
51
52       -v      Enable verbose messages.  This option overrides  the  nasd.conf
53               file setting.
54
55       -V      Print version information and exit (ignoring other options).
56
57       -b      Fork a child to run in the background and exit (daemon mode).
58
59       -d n    Enable debugging output at level n, where n is a positive inte‐
60               ger.  The higher the level, the more output you  will  get.   A
61               value  of  0  [default] disables debugging output.  This option
62               overrides  the  nasd.conf  file  setting.   When  debugging  is
63               enabled,  stderr  is  not  closed  by the nasd process, and all
64               debugging messages are written there.
65
66       -pn
67
68       -nopn [default]
69               Enables or disables Partial Networking.  Enabling Partial  Net‐
70               working  allows  the server to start, even if the server cannot
71               establish all of its well-known sockets (connection points  for
72               clients), but establishes at least one.
73
74       -config file
75               Use   the   config   file   file,   instead   of   the  default
76               (/etc/nasd/nasd.conf).
77

SIGNALS

79       The Network Audio System server attaches special meaning to the follow‐
80       ing signals:
81
82       SIGHUP  This  signal  causes  the  server to close all existing connec‐
83               tions, free all resources, and restore all defaults.
84
85       SIGTERM This signal causes the server to exit cleanly.
86
87       SIGUSR1 This signal is used quite differently from either of the above.
88               When  the  server  starts, it checks to see if it has inherited
89               SIGUSR1 as SIG_IGN instead of the usual SIG_DFL.  In this case,
90               the  server  sends a SIGUSR1 to its parent process after it has
91               set up the various connection schemes.
92

DIAGNOSTICS

94       Too numerous to list them all.
95

FILES

97       /tmp/.sockets/audio*          Unix domain socket
98
99       /usr/adm/audio*msgs
100
101       /dev/audio                    Audio device
102

SEE ALSO

104       nas(1), auinfo(1), auplay(1), auctl(1), nasd.conf(1)
105

BUGS

107       If au dies before its clients, new clients won't  be  able  to  connect
108       until all existing connections have their TCP TIME_WAIT timers expire.
109
110       The current access control support is weak at best.
111

113       Copyright 1993, Network Computing Devices, Inc.
114

AUTHORS

116       The  Network  Audio  System server was originally written by Greg Renda
117       and Dave Lemke, with large amounts of code borrowed from the  sample  X
118       server.
119
120       The  sample  X server was originally written by Susan Angebranndt, Ray‐
121       mond Drewry, Philip Karlton, and Todd Newman,  from  Digital  Equipment
122       Corporation,  with support from a large cast.  It has since been exten‐
123       sively rewritten by Keith Packard and Bob Scheifler, from MIT.
124
125
126
127                                                                       NASD(1)
Impressum