Module Name: src
Committed By: nia
Date: Mon Mar 16 08:50:06 UTC 2020
Modified Files:
src/share/man/man4: audio.4
Log Message:
audio.4: Remove reference to using O_NONBLOCK
It doesn't work properly, but this turns out to not be a problem in most
code (code where it is generally uses threads)...
Don't provide misleading information about using it, or programmers
might start wondering why their code doesn't work.
Noted by Yorick Hardy on current-users
To generate a diff of this commit:
cvs rdiff -u -r1.95 -r1.96 src/share/man/man4/audio.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/audio.4
diff -u src/share/man/man4/audio.4:1.95 src/share/man/man4/audio.4:1.96
--- src/share/man/man4/audio.4:1.95 Sun Dec 8 10:57:17 2019
+++ src/share/man/man4/audio.4 Mon Mar 16 08:50:06 2020
@@ -1,4 +1,4 @@
-.\" $NetBSD: audio.4,v 1.95 2019/12/08 10:57:17 wiz Exp $
+.\" $NetBSD: audio.4,v 1.96 2020/03/16 08:50:06 nia Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd November 12, 2019
+.Dd March 16, 2020
.Dt AUDIO 4
.Os
.Sh NAME
@@ -157,14 +157,6 @@ For historical reasons, only encodings t
.Dv AUDIO_ENCODINGFLAG_EMULATED
are able to
.Xr mmap 2 .
-.Pp
-The audio device, like most devices, can be used in
-.Xr select 2 ,
-can be set in non-blocking mode and can be set (with a
-.Dv FIOASYNC
-ioctl) to send a
-.Dv SIGIO
-when I/O is possible.
The mixer device can be set to generate a
.Dv SIGIO
whenever a mixer value is changed.
@@ -825,3 +817,7 @@ Support for virtual channels and mixing
If the device is used in
.Xr mmap 2
it is currently always mapped for writing (playing) due to VM system weirdness.
+.Sh CAVEATS
+The audio device cannot be reliably used with O_NONBLOCK or event notification
+mechanisms. Users are generally expected to only read and write a limited number
+of samples at a time, limiting the time spent in the system call.
