NAME
audioctl —
control audio device
SYNOPSIS
audioctl |
[-d
device]
[-p
channel]
[-n] -a |
audioctl |
[-d
device]
[-p
channel]
[-n] name
... |
audioctl |
[-d
device]
[-p
channel]
[-n] -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
-p flag can be used to give a virtual channel to control,
the default is a new channel.
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, for the channel 3 you can use
audioctl -p 3 -w
play.sample_rate=11025
To set all of the play parameters for CD-quality audio, you can use
audioctl -p 3 -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.