~ubuntu-branches/debian/squeeze/nas/squeeze

« back to all changes in this revision

Viewing changes to server/dda/voxware/auvoxware.man

  • Committer: Bazaar Package Importer
  • Author(s): Steve McIntyre
  • Date: 2008-10-08 01:18:19 UTC
  • mfrom: (4.1.7 intrepid)
  • Revision ID: james.westby@ubuntu.com-20081008011819-wmr4h2w0298k8t7z
Tags: 1.9.1-5
* Fix pending l10n issues. Debconf translations:
* Swedish. Closes: #491766 (thanks to brother@bsnet.se)
* Arabic. Closes: #500437 (thanks to Ossama Khayat)
* Basque. Closes: #500533 (thanks to Piarres Beobide)
* Brazilian Portuguese. Closes: #500973 (thanks to Felipe
  Augusto van de Wiel)
* Many thanks again to Christian Perrier for his i18n efforts,
  co-ordinating the above.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" $NCDId: @(#)auvoxware.man,v 1.1 1996/04/24 17:05:45 greg Exp $
2
 
.TH AUVOXWARE 1 "" ""
3
 
.SH NAME
4
 
auvoxware \- Network Audio System server for PCs with the VOXware audio interface
5
 
.SH SYNOPSIS
6
 
.B auvoxware
7
 
[:listen port offset] [\-option ...]
8
 
.SH DESCRIPTION
9
 
.I auvoxware
10
 
is the NAS server used on PC Unix platforms that support the VOXware device
11
 
drivers for popular sound cards. It is able to discover what each device has
12
 
in the way of ability and configure itself appropriately. The known list of
13
 
platforms that support the VOXware interface are Linux, FreeBSD, SCO,
14
 
Unixware and the generic SVR4.2 unixes.
15
 
.SH "STARTING THE SERVER"
16
 
The server is usually started from /etc/rc or a user's startup script.
17
 
.PP
18
 
When the Network Audio System server starts up, it takes over /dev/dsp &
19
 
/dev/dsp1, according to the instructions in its configuration file, if any.
20
 
Note
21
 
that applications that attempt to access these devices themselves will
22
 
fail while it is running.
23
 
It will look for a configuration file of the name nasd.conf in the
24
 
config directory, e.g. /etc/nas/nasd.conf. If it finds one, it will
25
 
then open it and parse the contents, setting up the inputs and outputs as
26
 
required.
27
 
.SH OPTIONS
28
 
All of the Network Audio System servers accept the following command line options:
29
 
.TP 8
30
 
.B \-aa
31
 
Allows clients on any host to connect.  By default, access is allowed
32
 
only to clients on the local host.
33
 
.SH SIGNALS
34
 
The Network Audio System server attaches special meaning to the following signals:
35
 
.TP 8
36
 
.I SIGHUP
37
 
This signal causes the server to close all existing connections, free all
38
 
resources, and restore all defaults.
39
 
.TP 8
40
 
.I SIGTERM
41
 
This signal causes the server to exit cleanly.
42
 
.TP 8
43
 
.I SIGUSR1
44
 
This signal is used quite differently from either of the above.  When the
45
 
server starts, it checks to see if it has inherited SIGUSR1 as SIG_IGN
46
 
instead of the usual SIG_DFL.  In this case, the server sends a SIGUSR1 to
47
 
its parent process after it has set up the various connection schemes.
48
 
.SH DIAGNOSTICS
49
 
Too numerous to list them all.
50
 
If run from \fIinit(8)\fP, errors are typically logged
51
 
in the file \fI/usr/adm/audio*msgs\fP,
52
 
.SH FILES
53
 
.TP 30
54
 
/tmp/.sockets/audio*
55
 
Unix domain socket
56
 
.TP 30
57
 
/usr/adm/audio*msgs
58
 
.TP 30
59
 
/dev/audio
60
 
Audio device
61
 
.SH "SEE ALSO"
62
 
nas(1), auinfo(1), auplay(1), auctl(1), nasd.conf(1)
63
 
.SH BUGS
64
 
.PP
65
 
If
66
 
.I au
67
 
dies before its clients, new clients won't be able to connect until all
68
 
existing connections have their TCP TIME_WAIT timers expire.
69
 
.PP
70
 
The current access control support is weak at best.
71
 
.PP
72
 
.SH COPYRIGHT
73
 
Copyright 1993, Network Computing Devices, Inc.
74
 
.br
75
 
.SH AUTHORS
76
 
The auvoxware server contains much code from the sun sample server, written
77
 
originally by Greg Renda and Dave Lemke of NCD, who in turn borrowed much
78
 
code from the sample X server. The original VOXware server for Linux was
79
 
written by Amancio Hasty (hasty@rah.star-gate.com) and was merged with the
80
 
SVR4 VOXware server, written by Stephen Hocking (sysseh@devetir.qld.gov.au).
81
 
Christian Schlichtherle (s_schli@ira.uka.de) then added some more Linux
82
 
fixes, code to allow full duplex operation on those cards that supported it
83
 
(GUS, PAS16, AudioTriX) and did some work on the 16 bit code. Stephen Hocking
84
 
made sure it ran under FreeBSD. Shawn M. (shawnm@sco.com) fixed it up to run
85
 
under SCO Unix and added code to dynamically adjust the buffer sizes.
86
 
Stephen Hocking then added code for the server to use a configuration file.
87
 
.sp
88
 
The sample X server was originally written by Susan Angebranndt, Raymond
89
 
Drewry, Philip Karlton, and Todd Newman, from Digital Equipment
90
 
Corporation, with support from a large cast.  It has since been
91
 
extensively rewritten by Keith Packard and Bob Scheifler, from MIT.