summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorjakemsr <jakemsr@openbsd.org>2008-05-26 00:36:08 +0000
committerjakemsr <jakemsr@openbsd.org>2008-05-26 00:36:08 +0000
commitf20336e6f7728a11f27734ef4142df66921c107b (patch)
treea38230db9798863e8c3515fd9467568ca4b6cb99
parentuse ac97 default parameters for auich(4), auixp(4) and auvia(4). (diff)
downloadwireguard-openbsd-f20336e6f7728a11f27734ef4142df66921c107b.tar.xz
wireguard-openbsd-f20336e6f7728a11f27734ef4142df66921c107b.zip
explain why, even though we support "sticky" block sizes, setting block
sizes before other parameters can cause problems. ok ratchov@
-rw-r--r--share/man/man4/audio.418
1 files changed, 16 insertions, 2 deletions
diff --git a/share/man/man4/audio.4 b/share/man/man4/audio.4
index 0c54211e815..53dcbcace0d 100644
--- a/share/man/man4/audio.4
+++ b/share/man/man4/audio.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: audio.4,v 1.52 2008/04/21 00:32:42 jakemsr Exp $
+.\" $OpenBSD: audio.4,v 1.53 2008/05/26 00:36:08 jakemsr Exp $
.\" $NetBSD: audio.4,v 1.20 1998/05/28 17:27:15 augustss Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -35,7 +35,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: April 21 2008 $
+.Dd $Mdocdate: May 26 2008 $
.Dt AUDIO 4
.Os
.Sh NAME
@@ -519,6 +519,20 @@ even when the encoding is changed.
The stickiness can be cleared by reopening the device or setting the
.Va block_size
to 0.
+Care should be taken when setting the
+.Va block_size
+before other parameters.
+If the device does not natively support the audio parameters, then the
+internal block size may be scaled to a larger size to accomodate
+conversion to a native format.
+If the
+.Va block_size
+has been set, the internal block size will not be rescaled when the
+parameters, and thus possibly the scaling factor, change.
+This can result in a block size much larger than was orginally requested.
+It is recommended to set
+.Va block_size
+at the same time as, or after all other parameters have been set.
.Pp
The
.Va seek