AUDIOCTL(1)

NAME
audioctl - control audio device

SYNOPSIS
audioctl [-n] [-d device] -a
audioctl [-n] [-d device] name ...
audioctl [-n] [-d device] -w name=value ...

DESCRIPTION
The audioctl command displays or sets various audio system driver variables. 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 specified 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.

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

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

HISTORY
The audioctl command first appeared in NetBSD 1.3.