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	 driv-
       ing 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)

NAME | SYNOPSIS | DESCRIPTION | STARTING THE SERVER | NETWORK CONNECTIONS | OPTIONS | SIGNALS | DIAGNOSTICS | FILES | SEE ALSO | BUGS | COPYRIGHT | AUTHORS

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

home | help