audioctl show-device [-v] [-d device]
audioctl show-control [-v] [-d device] [control ...]
audioctl set-control [-v] [-d device] control value
audioctl save-controls [-d device] [-f] file
audioctl load-controls [-d device] file
The audioctl command is used to control various features of the audio mixer and to get information about the audio mixer and the audio device. The audioctl command operates on the following data types:
An audio device, such as audiohd#0. The subcommands that accept this do so as an argument to an option –d. If not supplied, the default audio device is assumed. Any device node associated with an audio device works as well, such as /dev/sound/0 , /dev/dsp1, or /dev/audio.
A mixer control name, such as volume.
The value of a control. The specific format depends on the type of control. Monophonic values usually use a single whole number between 0 and 100, inclusive. Stereo values use a pair of such numbers, representing the right and left channels. Boolean values indicate either on or off. Enumerations take a single value of one or more names.
An ASCII text file of control settings.
Each subcommand has its own set of options that it takes. However, some subcommands support the special flag -v, which indicates a request for more verbose output.
The following subcommands are supported:
List all the audio devices on the system.
Display general information about a device.
Display the control setting values for the device. The named controls are displayed. If no control names are provided, then all control values are displayed.
Changes the value of a control to the supplied value.
Saves the current state of all mixer control values to the named file. The command aborts safely if the file already exists, unless –f is specified.
Restores previously saved state in the named file for all mixer controls.
If the –d and –a options are not specified, the AUDIODEV environment variable is consulted. If set, AUDIODEV contains the full path name of the user's default audio device.
See attributes(5) for descriptions of the following attributes:
The audioctl command and its subcommands are Committed. The human readable output is Not An Interface. The device names, control names, and values are Uncommitted. The format of the state files used by the save-controls and load-controls subcommands is Committed Private.