From 7c3f7c7676c78aa3131615222f1943d26a3da519 Mon Sep 17 00:00:00 2001
From: hselasky <hselasky@ccf9f872-aa2e-dd11-9fc8-001c23d0bc1f>
Date: Thu, 26 Mar 2015 10:26:25 +0000
Subject: [PATCH] MFC r280262 and r280263: Add more known bugs to the USB audio
 manual page.

git-svn-id: svn://svn.freebsd.org/base/stable/9@280682 ccf9f872-aa2e-dd11-9fc8-001c23d0bc1f
---
 share/man/man4/snd_uaudio.4 | 33 ++++++++++++++++++++++++---------
 1 file changed, 24 insertions(+), 9 deletions(-)

diff --git a/share/man/man4/snd_uaudio.4 b/share/man/man4/snd_uaudio.4
index b04585169..ccc3865b0 100644
--- a/share/man/man4/snd_uaudio.4
+++ b/share/man/man4/snd_uaudio.4
@@ -29,7 +29,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 24, 2011
+.Dd March 19, 2015
 .Dt SND_UAUDIO 4
 .Os
 .Sh NAME
@@ -91,12 +91,27 @@ by
 The
 .Tn PCM
 framework in
-.Fx ,
-as of this writing, does not handle device un-registrations in a properly
-abstracted manner, i.e., a detach request is refused by the
-.Tn PCM
-framework if the device is in use.
-It is necessary to allow the device un-registration to complete
-successfully, otherwise the
+.Fx
+only supports synchronous device detach.
+That means all mixer and DSP character devices belonging to a given
+USB audio device must be closed when receiving an error on a DSP read,
+a DSP write or a DSP IOCTL request.
+Else the USB audio driver will wait for this to happen, preventing
+enumeration of new devices on the parenting USB controller.
+.Pp
+Some USB audio devices might refuse to work properly unless the sample
+rate is configured the same for both recording and playback, even if
+only simplex is used.
+See the
+.Va dev.pcm.%d.[play|rec].vchanrate
+sysctls.
+.Pp
+The
 .Tn PCM
-layer will panic.
+framework in
+.Fx
+currently doesn't support the full set of USB audio mixer
+controls.
+Some mixer controls are only available as
+.Va dev.pcm.%d.mixer
+sysctls.
-- 
2.45.0