NAME

       nasd - Network Audio System server

SYNOPSIS

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

DESCRIPTION

       nasd  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.

STARTING THE SERVER

       The server is usually started from /etc/rc or a user's startup script.

       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.

NETWORK CONNECTIONS

       The Network Audio System server supports connections made  using  the  following  reliable
       byte-streams:

       TCPIP
           The server listens on port 8000+n, where n is the listen port offset.

       Unix Domain
           The  X server uses /tmp/.sockets/audion as the filename for the socket, where n is the
           display number.

OPTIONS

       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.

       -aa     Allows any client to connect.  By default, access is allowed only to authenticated
               clients.

       -local  Allows  only  clients on the local host to connect.  By default, access is allowed
               to local and remote hosts.

       -v      Enable verbose messages.  This option overrides the nasd.conf file setting.

       -V      Print version information and exit (ignoring other options).

       -b      Fork a child to run in the background and exit (daemon mode).  Messages  are  sent
               to syslog instead of stderr.

       -d n    Enable debugging output at level n, where n 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.

       -pn

       -nopn [default]
               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.

       -config file
               Use the config file file, instead of the default (/etc/nasd/nasd.conf).

SIGNALS

       The Network Audio System server attaches special meaning to the following signals:

       SIGHUP  This  signal  causes  the  server  to  close  all  existing  connections, free all
               resources, and restore all defaults.

       SIGTERM This signal causes the server to exit cleanly.

       SIGUSR1 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.

DIAGNOSTICS

       Too numerous to list them all.

FILES

       /tmp/.sockets/audio*          Unix domain socket

       /usr/adm/audio*msgs

       /dev/audio                    Audio device

SEE ALSO

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

BUGS

       If  au  dies  before  its clients, new clients won't be able to connect until all existing
       connections have their TCP TIME_WAIT timers expire.

       The current access control support is weak at best.

COPYRIGHT

       Copyright 1993, Network Computing Devices, Inc.

AUTHORS

       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.

       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.

                                                                                          NASD(1)