arecord()							    arecord()



NAME
  arecord - An AF record client.

SYNOPSIS
  arecord [-server audioserver]	[-d device] [-l	length]	[-t time] [-
  silentlevel level (dB)] [-silenttime time] [-printpower] [-g gain] [-e
  encoding] [-B] [-L] [file]

DDESCRIPTION

  arecord reads	samples	from the audio server and writes the data to file, or
  stdout if file is not	specified.  The	file will be written in	a sample for-
  mat appropriate for the record device.  By default, the byte order of	any
  16 bit data will be that of the host on which	arecord	is executing.

OPTIONS

  -server audioserver

       Specifies which audio server to connect to in order to record the
       sound file.  If audioserver is not specified, arecord uses the default
       server.	See the	AUDIOFILE environment variable.

  -d device

       Specifies which audio device to record the sound	file from.  If device
       is not specified, arecord defaults to the first device that isn't con-
       nected to the telephone.

  -l length

       length of sound data to record, specified in seconds.

  -silentlevel level

       level (in dBm) below which the sound is deemed to be silent.  The
       default value is	-60

  -silenttime time

       time (in	seconds) of silence which will terminate the recording.	 The
       default value is	3.0.

       If either -silentlevel or -silenttime is	set, then arecord will ter-
       minate recording	after so many seconds of "silence".

  -e ncoding

       encoding	will specify the type of the data to be	written	to the file
       or standard output.  Legal values are described in the audio.h header
       file, and may be	obtained via arecord -e	xxx.  The -e flag simply
       informs the AF server of	the datatype. Some encodings may fail if they
       are not supported by the	AF server.  See	also aconvert(1).

  -g gain

       A gain in dB can	be used	to attenuate or	amplify	the sound data prior
       to recording from the audio server.  Many AF servers do not support
       client gain on record, so use with suspicion.

  -printpower

       Print input power level in dBm on stderr	every block (8 times a
       second).

  -B

       Specifies that for 16 bit data, the bytes are in	"Big Endian" byte
       order (e.g. Sparc, RIOS,	PA).

  -L

       Specifies that for 16 bit data, the bytes are in	"Little	Endian"	byte
       order (e.g. Alpha, Intel	x86, VAX).

  -t time

       time can	be used	to adjust the audio device time	at which the the
       arecord client begins to	record the sound data.	A positive value of
       time will begin recording time seconds in the future.  If time is
       negative, sound data will be returned from time seconds in the past.
       If the time offset begins earlier than the start	of the recording
       buffer, silence will be returned.  Defaults to 0.125 seconds.

  file

       arecord writes data to file in the current working directory

ENVIRONMENT

  AUDIOFILE	 specifies the host and	server to use.

BUGS
  If you encounter a reproducible bug, please submit a problem report to
  (af-bugs@crl.dec.com).

SEE ALSO
  AF(1), aplay(1)

COPYRIGHT
  Copyright 1992-1994, Digital Equipment Corporation.
  See AF(1) for	a full statement of rights and permissions.

AUTHORS
  Digital Cambridge Research Lab