AUDIOCTL(1)                OpenBSD Reference Manual                AUDIOCTL(1)

NAME
     audioctl - control audio device

SYNOPSIS
     audioctl [-n] [-f file] -a
     audioctl [-n] [-f file] name [...]
     audioctl [-n] [-f file] -w name=value [...]

DESCRIPTION
     The audioctl command displays or sets various audio system driver vari-
     ables.  If a list of variables is present on the command line, audioctl
     prints the current value of those variables for the specified device.  By
     default, audioctl operates on the /dev/audioctl device.

     The options are as follows:

     -a      Print all device variables and their current values.

     -w name=value
             Attempt to set the specified variable name to value.

     -f file
             Specify an alternative audio control device.

     -n      Suppress printing of the variable name.

EXAMPLES
     To set the playing sampling rate to 11025 you can enter

           audioctl -w play.sample_rate=11025

     Note that many of the variables that can be inspected and changed are re-
     set when the device is opened.  This can be circumvented like so:

           (cat file.au; audioctl -f /dev/stdout -a) > /dev/audio

     or

           (audioctl -f /dev/stdout -w blocksize=1024; cat file.au) >
           /dev/audio

ENVIRONMENT
     AUDIOCTLDEVICE  Audio control device to use.

FILES
     /dev/audioctl  default audio control device

SEE ALSO
     mixerctl(1), audio(4), sysctl(8)

HISTORY
     The audioctl command first appeared in NetBSD 1.3.

OpenBSD 2.9                       May 4, 1997                                1
