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
       frequently a link or a copy of the appropriate server binary  for  dri-
       ving 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/au-
       dio.  Note, that	if ReleaseDevice is  set  to  TRUE  [default]  in  the
       nasd.conf  file,	nasd will relinquish control of	the audio device when-
       ever 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 cur-
       rently playing a	song.	If  ReleaseDevice  is  set  to	FALSE  in  the
       nasd.conf  file,	 applications  that attempt to access /dev/audio them-
       selves 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 off-
	   set.

       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 inte-
	       ger.   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 Net-
	       working 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 follow-
       ing signals:

       SIGHUP  This  signal  causes  the  server to close all existing connec-
	       tions, 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 un-
       til 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,  Ray-
       mond  Drewry,  Philip  Karlton, and Todd	Newman,	from Digital Equipment
       Corporation, with support from a	large cast.  It	has since been	exten-
       sively 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+14.3.quarterly>

home | help