205 lines
6.7 KiB
HTML
205 lines
6.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of ALSACTL</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>ALSACTL</H1>
|
|
Section: User Commands (1)<BR>Updated: 07 May 2014<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
alsactl - advanced controls for ALSA soundcard driver
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<P>
|
|
<B>alsactl</B> [<I>options</I>] [<I>store</I>|<I>restore</I>|<I>init</I>] <card # or id or device>
|
|
<P>
|
|
<B>alsactl</B> <I>monitor</I> <card # or id>
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>alsactl</B> is used to control advanced settings for the ALSA
|
|
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.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>COMMANDS</H2>
|
|
|
|
<P>
|
|
<I>store</I> saves the current driver state for the selected soundcard
|
|
to the configuration file.
|
|
<P>
|
|
<I>restore</I> loads driver state for the selected soundcard from the
|
|
configuration file. If restoring fails (eventually partly), the init
|
|
action is called.
|
|
<P>
|
|
<I>nrestore</I> is like <I>restore</I>, but it notifies also the daemon
|
|
to do new rescan for available soundcards.
|
|
<P>
|
|
<I>init</I> tries to initialize all devices to a default state. If device
|
|
is not known, error code 99 is returned.
|
|
<P>
|
|
<I>daemon</I> manages to save periodically the sound state.
|
|
<P>
|
|
<I>rdaemon</I> like <I>daemon</I> but restore the sound state at first.
|
|
<P>
|
|
<I>kill</I> notifies the daemon to do the specified operation (quit,
|
|
rescan, save_and_quit).
|
|
<P>
|
|
<I>monitor</I> is for monitoring the events received from the given
|
|
control device.
|
|
<P>
|
|
If no soundcards are specified, setup for all cards will be saved,
|
|
loaded or monitored.
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="1"><I>-h, --help</I> <DD>
|
|
Help: show available flags and commands.
|
|
<P>
|
|
<DT id="2"><I>-d, --debug</I><DD>
|
|
Use debug mode: a bit more verbose.
|
|
<P>
|
|
<DT id="3"><I>-v, --version</I><DD>
|
|
Print alsactl version number.
|
|
<P>
|
|
<DT id="4"><I>-f, --file</I><DD>
|
|
Select the configuration file to use. The default is /var/lib/alsa/asound.state.
|
|
<P>
|
|
<DT id="5"><I>-l, --lock</I><DD>
|
|
Use the file locking to serialize the concurrent access to the state file (this
|
|
option is default for the global state file).
|
|
<P>
|
|
<DT id="6"><I>-L, --no-lock</I><DD>
|
|
Do not use the file locking to serialize the concurrent access to the state
|
|
file (including the global state file).
|
|
<P>
|
|
<DT id="7"><I>-O, --lock-state-file</I><DD>
|
|
Select the state lock file path.
|
|
<P>
|
|
<DT id="8"><I>-F, --force</I><DD>
|
|
Used with restore command. Try to restore the matching control elements
|
|
as much as possible. This option is set as default now.
|
|
<P>
|
|
<DT id="9"><I>-g, --ignore</I><DD>
|
|
Used with store and restore commands. Do not show 'No soundcards found'
|
|
and do not set an error exit code when soundcards are not installed.
|
|
<P>
|
|
<DT id="10"><I>-P, --pedantic</I><DD>
|
|
Used with restore command. Don't restore mismatching control elements.
|
|
This option was the old default behavior.
|
|
<P>
|
|
<DT id="11"><I>-I, --no-init-fallback</I><DD>
|
|
Don't initialize cards if restore fails. Since version 1.0.18,
|
|
<B>alsactl</B> tries to initialize the card with the restore operation
|
|
as default. But this can cause incompatibility with the older version.
|
|
The caller may expect that the state won't be touched if no state file
|
|
exists. This option takes the restore behavior back to the older
|
|
version by suppressing the initialization.
|
|
<P>
|
|
<DT id="12"><I>-r, --runstate</I><DD>
|
|
Save restore and init state to this file. The file will contain only errors.
|
|
Errors are appended with the soundcard id to the end of file.
|
|
<P>
|
|
<DT id="13"><I>-R, --remove</I><DD>
|
|
Remove runstate file at first.
|
|
<P>
|
|
<DT id="14"><I>-E, --env</I> #=#<DD>
|
|
Set environment variable (useful for init action or you may override
|
|
ALSA_CONFIG_PATH to read different or optimized configuration - may be
|
|
useful for "boot" scripts).
|
|
<P>
|
|
<DT id="15"><I>-i, --initfile</I><DD>
|
|
The configuration file for init. By default, PREFIX/share/alsa/init/00main
|
|
is used.
|
|
<P>
|
|
<DT id="16"><I>-p, --period</I><DD>
|
|
The store period in seconds for the daemon command.
|
|
<P>
|
|
<DT id="17"><I>-e, --pid-file</I><DD>
|
|
The pathname to store the process-id file in the HDB UUCP format (ASCII).
|
|
<P>
|
|
<DT id="18"><I>-b, --background</I><DD>
|
|
Run the task in background.
|
|
<P>
|
|
<DT id="19"><I>-s, --syslog</I><DD>
|
|
Use syslog for messages.
|
|
<P>
|
|
<DT id="20"><I>-n, --nice</I><DD>
|
|
Set the process priority (see 'man nice')
|
|
<P>
|
|
<DT id="21"><I>-c, --sched-idle</I><DD>
|
|
Set the process scheduling policy to idle (SCHED_IDLE).
|
|
<P>
|
|
<DT id="22"><I>-D, --ucm-defaults</I><DD>
|
|
Execute also the 'defaults' section from the UCM configuration. The standard
|
|
behaviour is to execute only 'once' section.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<I>/var/lib/alsa/asound.state</I> (or whatever file you specify with the
|
|
<B>-f</B> 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.
|
|
<P>
|
|
The configuration file is generated automatically by running
|
|
<B>alsactl store</B>. Editing the configuration file by hand may be
|
|
necessary for some soundcard features (e.g. enabling/disabling
|
|
automatic mic gain, digital output, joystick/game ports, some future MIDI
|
|
routing options, etc).
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B>
|
|
<A HREF="/cgi-bin/man/man2html?1+amixer">amixer</A>(1),
|
|
<A HREF="/cgi-bin/man/man2html?1+alsamixer">alsamixer</A>(1),
|
|
<A HREF="/cgi-bin/man/man2html?1+aplay">aplay</A>(1),
|
|
<A HREF="/cgi-bin/man/man2html?7+alsactl_init">alsactl_init</A>(7)
|
|
</B>
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS </H2>
|
|
|
|
None known.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<B>alsactl</B> is by Jaroslav Kysela <<A HREF="mailto:perex@perex.cz">perex@perex.cz</A>> and Abramo Bagnara
|
|
<<A HREF="mailto:abramo@alsa-project.org">abramo@alsa-project.org</A>>. This document is by Paul Winkler <<A HREF="mailto:zarmzarm@erols.com">zarmzarm@erols.com</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="23"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="24"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="25"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="26"><A HREF="#lbAE">COMMANDS</A><DD>
|
|
<DT id="27"><A HREF="#lbAF">OPTIONS</A><DD>
|
|
<DT id="28"><A HREF="#lbAG">FILES</A><DD>
|
|
<DT id="29"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="30"><A HREF="#lbAI">BUGS </A><DD>
|
|
<DT id="31"><A HREF="#lbAJ">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:06 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|