summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorratchov <ratchov@openbsd.org>2016-01-29 10:45:38 +0000
committerratchov <ratchov@openbsd.org>2016-01-29 10:45:38 +0000
commitd02a72b577047d6667fadb4e937bad68c4d7cbd5 (patch)
tree603ac6c20637c9ec60ec3287c127274b6b5a3e6b
parentDisplay play and record parameters that are not independent (diff)
downloadwireguard-openbsd-d02a72b577047d6667fadb4e937bad68c4d7cbd5.tar.xz
wireguard-openbsd-d02a72b577047d6667fadb4e937bad68c4d7cbd5.zip
We're not allowed to change audio parameters while the device is
in use by another program. Explain that and remove wrong example.
-rw-r--r--usr.bin/audioctl/audioctl.120
1 files changed, 5 insertions, 15 deletions
diff --git a/usr.bin/audioctl/audioctl.1 b/usr.bin/audioctl/audioctl.1
index 93abcf25998..e53c7c4a72d 100644
--- a/usr.bin/audioctl/audioctl.1
+++ b/usr.bin/audioctl/audioctl.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: audioctl.1,v 1.27 2009/11/10 07:42:22 ratchov Exp $
+.\" $OpenBSD: audioctl.1,v 1.28 2016/01/29 10:45:38 ratchov Exp $
.\" $NetBSD: audioctl.1,v 1.7 1998/04/27 16:55:23 augustss Exp $
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 10 2009 $
+.Dd $Mdocdate: January 29 2016 $
.Dt AUDIOCTL 1
.Os
.Sh NAME
@@ -73,6 +73,9 @@ Attempt to set the specified variable
to
.Ar value .
.El
+.Pp
+Variables may only be changed if the device is not opened for
+playback or recording by another process.
.Sh ENVIRONMENT
.Bl -tag -width AUDIOCTLDEVICE
.It Ev AUDIOCTLDEVICE
@@ -87,19 +90,6 @@ default audio control device
To set the playing sampling rate to 11025 you can enter:
.Pp
.Dl $ audioctl play.rate=11025
-.Pp
-Note that many of the variables that can be inspected and changed
-are reset when the
-.Pa /dev/audio
-device is opened.
-This can be circumvented like so:
-.Pp
-.Dl $ (cat file.au; audioctl -f /dev/audioctl) \*(Gt /dev/audio
-or
-.Bd -literal -offset indent -compact
-$ (audioctl -f /dev/audioctl play.block_size=1024; cat file.au) \e
- \*(Gt /dev/audio
-.Ed
.Sh SEE ALSO
.Xr aucat 1 ,
.Xr cdio 1 ,