2001-05-15 14:11:08 +02:00
|
|
|
.TH ALSACTL 1 "15 May 2001"
|
1998-12-01 11:26:49 +01:00
|
|
|
.SH NAME
|
1998-12-08 12:49:21 +01:00
|
|
|
alsactl \- advanced controls for ALSA soundcard driver
|
1998-12-01 11:26:49 +01:00
|
|
|
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
|
2001-05-15 14:11:08 +02:00
|
|
|
\fBalsactl\fP [\fIoptions\fP] [\fIstore\fP|\fIrestore\fP] <card # or id>
|
1998-12-01 11:26:49 +01:00
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
\fBalsactl\fP is used to control advanced settings for the ALSA
|
1998-12-10 10:12:59 +01:00
|
|
|
soundcard drivers. It supports multiple soundcards. If your card has
|
|
|
|
|
features that you can't seem to control from a mixer application,
|
|
|
|
|
you have come to the right place.
|
1998-12-01 11:26:49 +01:00
|
|
|
|
|
|
|
|
.SH INVOKING
|
|
|
|
|
|
2001-05-15 14:11:08 +02:00
|
|
|
\fBalsactl\fP [\fIoptions\fP] [\fIstore\fP|\fIrestore\fP] <card # or id>
|
1998-12-01 11:26:49 +01:00
|
|
|
|
|
|
|
|
.SS Commands
|
|
|
|
|
|
2001-05-15 14:11:08 +02:00
|
|
|
\fIstore\fP saves the current driver state for the selected soundcard
|
1998-12-01 11:26:49 +01:00
|
|
|
to the configuration file.
|
|
|
|
|
|
2001-05-15 14:11:08 +02:00
|
|
|
\fIrestore\fP loads driver state for the selected soundcard from the configuration file.
|
1998-12-01 11:26:49 +01:00
|
|
|
|
|
|
|
|
If no soundcards are specified, setup for all cards will be saved or
|
|
|
|
|
loaded.
|
|
|
|
|
|
|
|
|
|
.SS Options
|
|
|
|
|
|
|
|
|
|
.TP
|
|
|
|
|
\fI-h, --help\fP
|
|
|
|
|
Help: show available flags and commands.
|
|
|
|
|
|
|
|
|
|
.TP
|
2002-09-06 17:21:01 +02:00
|
|
|
\fI-f, --file\fP
|
2001-05-15 14:11:08 +02:00
|
|
|
Select the configuration file to use. The default is /etc/asound.state
|
1998-12-01 11:26:49 +01:00
|
|
|
|
2002-09-06 17:21:01 +02:00
|
|
|
.TP
|
|
|
|
|
\fI-F, --force\fP
|
|
|
|
|
Used with restore command. Try to restore the matching control elements
|
|
|
|
|
as much as possible.
|
|
|
|
|
|
1998-12-01 11:26:49 +01:00
|
|
|
.TP
|
|
|
|
|
\fI-d, --debug\fP
|
|
|
|
|
Use debug mode: a bit more verbose.
|
|
|
|
|
|
|
|
|
|
.TP
|
|
|
|
|
\fI-v, --version\fP
|
|
|
|
|
Print alsactl version number.
|
|
|
|
|
|
|
|
|
|
.SH FILES
|
2001-05-15 14:11:08 +02:00
|
|
|
\fI/etc/asound.state\fP (or whatever file you specify with the
|
1998-12-08 12:49:21 +01:00
|
|
|
\fB-f\fP flag) is used to store current settings for your
|
|
|
|
|
soundcards. The settings include all the usual soundcard mixer
|
|
|
|
|
settings. More importantly, alsactl is
|
|
|
|
|
capable of controlling other card-specific features that mixer apps
|
|
|
|
|
usually don't know about.
|
1998-12-01 11:26:49 +01:00
|
|
|
|
|
|
|
|
The configuration file is generated automatically by running
|
1998-12-08 12:49:21 +01:00
|
|
|
\fBalsactl store\fP. Editing the configuration file by hand may be
|
|
|
|
|
necessary for some soundcard features (e.g. enabling/disabling
|
1998-12-10 10:12:59 +01:00
|
|
|
automatic mic gain, digital output, joystick/game ports, some future MIDI
|
|
|
|
|
routing options, etc).
|
1998-12-08 12:49:21 +01:00
|
|
|
|
1998-12-01 11:26:49 +01:00
|
|
|
.SH SEE ALSO
|
|
|
|
|
\fB
|
|
|
|
|
amixer(1),
|
|
|
|
|
alsamixer(1),
|
|
|
|
|
aplay(1)
|
|
|
|
|
\fP
|
|
|
|
|
|
|
|
|
|
.SH BUGS
|
|
|
|
|
None known.
|
|
|
|
|
|
|
|
|
|
.SH AUTHOR
|
2001-05-15 14:11:08 +02:00
|
|
|
\fBalsactl\fP is by Jaroslav Kysela <perex@suse.cz> and Abramo Bagnara
|
|
|
|
|
<abramo@alsa-project.org>. This document is by Paul Winkler <zarmzarm@erols.com>.
|
