Asgi(1)								      Asgi(1)



NAME
  Asgi - a network-transparent audio server for	SGI Indigo workstations

SYNOPSIS
  The AF audio server is a network transparent	system developed at Digital
  CRL.	The audio server described in this manual page supports	the SGI
  Indigo audio hardware	and software.

DESCRIPTION
  Asgi is an AF	server with device dependent support for SGI Indigo and
  Indigo2 workstations.

STARTING UP
  Asgi [:portOffset] [options] &

OPTIONS

  -help
       Use the help switch to determine	device independent arguments.

  -rate	sampling-rate
       Specify the sampling rate.  Valid sampling rates	are all	rates sup-
       ported by the SGI Indigo	audio hardware:	8000, 11025, 16000, 22050,
       32000, 44100 and	48000 samples/sec.  The	default	is 8000.  The sam-
       pling rate is used both for recording and for playback, and should not
       be changed using	the apanel utility (in fact the	server resets it when
       it detects it is	changed).

AUDIO DEVICES
  This server supports three devices, which provide different types of acces
  to a single audio device: device 0 accepts mono U-LAW	samples, device	1
  accepts mono 16-bit linear samples, device 1 accepts stereo 16-bit samples.
  (Don't confuse these devices with the	portOffset in the connection name
  explained below.)

  The hardware has a choice of three input sources: input 0 is the line	input
  jack,	input 1	is the microphone, input 2 is the digital input.  Exactly one
  of these is selected at any time.

CONNECTION NAME
  From the user's prospective, every AF	server has an audio connection of the
  form:

			      hostname:portOffset

  This information is used by the application to determine how it should con-
  nect to the server.

  hostname
	  The hostname specifies the name of the machine to which the audio
	  device is physically connected.  If omitted, the local machine is
	  used and the fastest available protocol is chosen (e.g. UNIX sock-
	  ets or shared	memory).

  portOffset
	  The portOffset is used to identify the audio server's	port on	host-
	  name.	 For example, to simultaneously	run two	audio servers on a
	  given	host, you might	select 0 or 1 for portOffset.

  If the connection name to an audio server is not specified, then the
  environment variables	AUDIOFILE or DISPLAY will be used.

ACCESS CONTROL
  The sample server provides two types of access control: an authorization
  protocol which provides a list of ``magic cookies'' clients can send to
  request access, and a	list of	hosts from which connections are always
  accepted.

BUGS
  At high sampling rates the server uses too much CPU when sounds are
  recorded and played.

  If you encounter a repeatable	bug in the SGI dependent code, please submit
  a problem report to guido@cwi.nl and include the source code if possible.

SEE ALSO
  AF(1)
  Aaxp(1), Amaxine(1), Alofi(1), Ajv(1), Asparc(1), Amsb(1), Aj300(1),
  aplay(1), arecord(1),	apass(1), aset(1), abrowse(1), afft(1),	ahost(1),
  aphone(1), aprop(1), ahs(1), axset(1), xpow(1), afxctl(1), aname2num(1),
  alsatoms(1), aevents(1), abob(1)

  See also apanel(1) and the Digital Audio and MIDI Programming	Guide by Sil-
  icon Graphics.

COPYRIGHT
  See the COPYRIGHTS file.

  Copyright 1991-1993, Digital Equipment Corporation and the Massachusetts
  Institute of Technology.

  SGI device dependent code:

  Copyright 1993 by Stichting Mathematisch Centrum, Amsterdam, The Nether-
  lands.

			      All Rights Reserved

  Permission to	use, copy, modify, and distribute this software	and its	docu-
  mentation for	any purpose and	without	fee is hereby granted, provided	that
  the above copyright notice appear in all copies and that both	that copy-
  right	notice and this	permission notice appear in supporting documentation,
  and that the names of	Stichting Mathematisch Centrum or CWI not be used in
  advertising or publicity pertaining to distribution of the software without
  specific, written prior permission.

  STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
  SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF	MERCHANTABILITY	AND FITNESS,
  IN NO	EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE FOR ANY SPECIAL,
  INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING	FROM
  LOSS OF USE, DATA OR PROFITS,	WHETHER	IN AN ACTION OF	CONTRACT, NEGLIGENCE
  OR OTHER TORTIOUS ACTION, ARISING OUT	OF OR IN CONNECTION WITH THE USE OR
  PERFORMANCE OF THIS SOFTWARE.

AUTHORS
  Digital Cambridge Research Lab (device-independent code)
  Guido	van Rossum, CWI, Amsterdam (SGI	device-dependent code)