-.\" $OpenBSD: audio.4,v 1.80 2018/08/05 10:31:49 ratchov Exp $
+.\" $OpenBSD: audio.4,v 1.81 2018/08/05 11:41:50 ratchov Exp $
.\" $NetBSD: audio.4,v 1.20 1998/05/28 17:27:15 augustss Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.El
.Pp
There are three types of device files available for audio operation:
-.Pa /dev/audio Ns Ar N ,
-.Pa /dev/audioctl Ns Ar N ,
-and
-.Pa /dev/mixer Ns Ar N .
+.Bl -dash -offset indent
+.It
Audio devices are used for recording or playback of digital samples.
-Mixer devices are used to manipulate volume, recording source, or other audio mixer
-functions.
-Audio control devices accept the same
-.Xr ioctl 2
-operations as audio devices,
-but no other operations.
-In contrast to audio devices,
-which have the exclusive open property,
-audioctl devices can be opened at any time and can be used to read the
-.Nm audio
-device variables while it is in use.
-.Sh SAMPLING DEVICES
+.It
+Control devices can be used to read the
+.Nm
+driver variables while it is in use.
+.It
+Mixer devices are used to manipulate volume, recording source,
+or other audio mixer functions.
+.El
+.Sh AUDIO DEVICES
When audio devices are opened,
they attempt to maintain the previous audio sample format and record/playback mode.
In addition, if one is opened read-only
If set, indicates that the device is playing and/or recording.
.El
.El
-.Sh MIXER DEVICE
+.Sh CONTROL DEVICES
+Audio control devices accept the same
+.Xr ioctl 2
+operations as audio devices,
+but no other operations.
+In contrast to audio devices,
+which have the exclusive open property,
+control devices can be opened at any time.
+.Sh MIXER DEVICES
Mixer devices support the following
.Xr ioctl 2
commands:
.Pp
.Bl -tag -width Ds -compact
.It Dv AUDIO_GETDEV Fa "audio_device_t *"
-This command is the same as described above for the sampling devices.
+This command is the same as described above for the audio devices.
.Pp
.It Dv AUDIO_MIXER_READ Fa "mixer_ctrl_t *"
.It Dv AUDIO_MIXER_WRITE Fa "mixer_ctrl_t *"
.Dv AudioC*
string values.
.Sh FILES
-.Bl -tag -width /dev/audioctl -compact
+.Bl -tag -width /dev/audioctlN -compact
.It Pa /dev/audio Ns Ar N
+Audio device.
.It Pa /dev/audioctl Ns Ar N
+Control device.
.It Pa /dev/mixer Ns Ar N
+Mixer device.
.El
.Sh SEE ALSO
.Xr aucat 1 ,