AUDIOCTL(1)             NetBSD General Commands Manual             AUDIOCTL(1)

NAME
     audioctl -- control audio device

SYNOPSIS
     audioctl [-d device] [-n] -a
     audioctl [-d device] [-n] name ...
     audioctl [-d device] [-n] -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, then
     audioctl prints the current value of those variables for the specified
     device.  If the -a flag is specified, all variables for the device are
     printed.  If the -w flag is specified audioctl attempts to set the speci-
     fied variables to the given values.

     The -d flag can be used to give an alternative audio control device, the
     default is /dev/audioctl0.

     The -n flag suppresses printing of the variable name.

ENVIRONMENT
     AUDIOCTLDEVICE  the audio control device to use.

FILES
     /dev/audio0     audio I/O device (resets on open)
     /dev/audioctl0  audio control device
     /dev/sound0     audio I/O device (does not reset on open)

EXAMPLES
     To set the playing sampling rate to 11025, you can use
           audioctl -w play.sample_rate=11025
     To set all of the play parameters for CD-quality audio, you can use
           audioctl -w play=44100,2,16,slinear_le
     Note that many of the variables that can be inspected and changed with
     audioctl are reset when /dev/audio0 is opened.  This can be circumvented
     by using /dev/sound0 instead.

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

HISTORY
     The audioctl command first appeared in NetBSD 1.3.

COMPATIBILITY
     The old -f flag is still supported.  This support will be removed eventu-
     ally.

NetBSD 5.0_STABLE              January 27, 2002              NetBSD 5.0_STABLE
