alsa-utils/alsactl/alsactl.1

79 lines
2 KiB
Groff
Raw Permalink Normal View History

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
\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
.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>.