Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
NASD(1) 		     General Commands Manual			 NASD(1)

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 fre-
     quently 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  Re-
     leaseDevice  is  set  to FALSE in the nasd.conf file, applications that at-
     tempt to access /dev/audio themselves will fail while nasd is running.

NETWORK CONNECTIONS
     The Network Audio System server supports connections made using the follow-
     ing 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 com-
     mand line options.  Options specific to a particular  server  may	also  be
     available,  and are not listed here.  Try 'nasd -?' for a list of those op-
     tions, 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, ac-
	     cess 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).  Mes-
	     sages 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	Network-
	     ing 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  SI-
	     GUSR1  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	Corpora-
     tion,  with  support  from  a  large  cast.   It has since been extensively
     rewritten by Keith Packard and Bob Scheifler, from MIT.

									 NASD(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nasd&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help