summaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
authormartin <martin@NetBSD.org>2020-04-30 15:40:50 +0000
committermartin <martin@NetBSD.org>2020-04-30 15:40:50 +0000
commit5feb5adf334c59e7a55c1553f9983ebe46b13a14 (patch)
tree141e990f4ecbc00976e68b2cec1be4b739a9ed9c /share
parent6333909388a3101626605dbf908f5e82a22365f1 (diff)
Pull up following revision(s) (requested by isaki in ticket #875):
sys/dev/audio/audio.c: revision 1.59 share/man/man4/audio.4: revision 1.102 share/man/man4/audio.4: revision 1.103 sys/dev/audio/audio.c: revision 1.43 Limit the number of channels that userland apps can set (by AUDIO_SETINFO) to the number of channels supported by the hardware or less, if the hardware supports multi channels. - On monaural or stereo hardware, userland apps can always set 1ch or 2ch. The kernel (audio layer) can convert mono-stereo each other. - On 3ch (2.1ch) hardware, for example, userland apps can set 1, 2, or 3ch, but not 4ch or more. This allows userland apps to know actual number of channels supported by the hardware in the same way as before. PR kern/54973. Reinitialize the sticky parameters whenever the hardware format is changed. When the number of the hardware channels becomes less than the number of channels that sticky parameters remember, subsequent open("/dev/sound") will fail without this treatment. This is for rev 1.43. Add description about channel limitation introduced in audio.c 1.43. PR kern/54973. Remove trailing whitespace.
Diffstat (limited to 'share')
-rw-r--r--share/man/man4/audio.419
1 files changed, 13 insertions, 6 deletions
diff --git a/share/man/man4/audio.4 b/share/man/man4/audio.4
index d2e4da6b011..7483131ffbf 100644
--- a/share/man/man4/audio.4
+++ b/share/man/man4/audio.4
@@ -1,4 +1,4 @@
-.\" $NetBSD: audio.4,v 1.90 2019/05/09 09:35:29 wiz Exp $
+.\" $NetBSD: audio.4,v 1.90.2.1 2020/04/30 15:40:50 martin Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -402,18 +402,25 @@ unsigned linear encoding with big endian byte order
Dolby Digital AC3
.El
.Pp
-Regardless of formats supported by underlying driver, the
+The
.Nm
driver accepts the following formats.
.Va encoding
and
.Va precision
are one of the values obtained by
-.Dv AUDIO_GETENC .
-.Va channels
-ranges from 1 to 12.
+.Dv AUDIO_GETENC ,
+regardless of formats supported by underlying driver.
.Va frequency
-ranges from 1000Hz to 192000Hz.
+ranges from 1000Hz to 192000Hz,
+regardless of frequency (ranges) supported by underlying driver.
+.Va channels
+depends your underlying driver.
+If the underlying driver only supports monaural (1channel)
+or stereo (2channels), you can specify 1 or 2 regardless of
+number of channels supported by underlying driver.
+If the underlying driver supports three or more channels, you can specify
+the number of channels supported by the underlying driver or less.
.Pp
The
.Va gain ,