au-utils/audev.1

.Dd May 16, 2017
.Dt AUDEV 1
.Os
.Sh NAME
.Nm audev ,
.Nm au2dev ,
.Nm dev2au
.Nd plays/records an Au formatted audio streams
.Sh SYNOPSIS
.Nm audev
.Op Fl R
.Op Fl b Ar buffer-size
.Op Fl d Ar device
.Nm au2dev
.Op Fl R
.Op Fl b Ar buffer-size
.Op Fl d Ar device
.Nm dev2au
.Fl R
.Op Fl b Ar buffer-size
.Op Fl d Ar device
.Nm audev
.Op Fl W
.Op Fl b Ar buffer-size
.Op Fl d Ar device
.Op Fl e Ar encoding
.Op Fl c Ar channels
.Op Fl r Ar rate
.Op Fl s Ar string
.Op Fl t Ar time
.Nm au2dev
.Fl W
.Op Fl b Ar buffer-size
.Op Fl d Ar device
.Op Fl e Ar encoding
.Op Fl c Ar channels
.Op Fl r Ar rate
.Op Fl s Ar string
.Op Fl t Ar time
.Nm dev2au
.Op Fl W
.Op Fl b Ar buffer-size
.Op Fl d Ar device
.Op Fl e Ar encoding
.Op Fl c Ar channels
.Op Fl r Ar rate
.Op Fl s Ar string
.Op Fl t Ar time
.Sh DESCRIPTION
.Nm
plays or records an Au formatted stream to an audio device.
.Pp
The
.Fl R
and
.Fl W
flags force the utility to read (play) or write (record) an Au
formatted audio stream, respectively
.Pp
The options for playing an Au formatted stream are follows:
.Bl -tag -width Ds
.It Fl b Ar buffer-size
Override the default buffer size.
.It Fl d Ar device
Override the default audio device.
.El
.Pp
The options for recording an Au formatted stream are as follows:
.Bl -tag -width Ds
.It Fl b Ar buffer-size
Override the default buffer size.
.It Fl c Ar channels
Override the default channel count (normally 2).
.It Fl d Ar device
Override the default audio device.
.It Fl e Ar encoding
Override the default encoding (normally 16-bit PCM).
.It Fl r Ar rate
Override the default sample-rate (normally 48000).
.It Fl s Ar string
Write
.Ar string
to the audio file before the audio data.  All occurrences of this option
are concatenated together.
.It Fl t Ar time
Record for
.Ar time
seconds (normally indefinite).
.El
.Sh EXAMPLES
Record ten seconds of 8kHz uLaw audio:
.Dl dev2au -eulaw -r8000 -t10 > recording.au
.Pp
Playback redorded audio:
.Dl au2dev < recording.au
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO
.Xr au 7
.Xr auconv 1
.Xr auopen 1
.Xr au2file 1
.Xr file2au 1
.Xr audioplay 1
.Xr audiorecord 1
.Xr audio 4
.Xr sound 4
.Xr sndio 7