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               Messages are sent to syslog instead of stderr.
59
60       -d n    Enable debugging output at level n, where n is a positive inte‐
61               ger.   The  higher  the level, the more output you will get.  A
62               value of 0 [default] disables debugging  output.   This  option
63               overrides the nasd.conf file setting.
64
65       -pn
66
67       -nopn [default]
68               Enables  or disables Partial Networking.  Enabling Partial Net‐
69               working allows the server to start, even if the  server  cannot
70               establish  all of its well-known sockets (connection points for
71               clients), but establishes at least one.
72
73       -config file
74               Use  the   config   file   file,   instead   of   the   default
75               (/etc/nasd/nasd.conf).
76

SIGNALS

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

DIAGNOSTICS

93       Too numerous to list them all.
94

FILES

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

SEE ALSO

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

BUGS

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

112       Copyright 1993, Network Computing Devices, Inc.
113

AUTHORS

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