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)