alsaconf(8) [suse man page]
ALSACONF(8) System Manager's Manual ALSACONF(8) NAME
alsaconf - configuration tool for the Advanced Linux Sound Architecture SYNOPSIS
alsaconf [options] DESCRIPTION
This manual page documents briefly the alsaconf command. This manual page was written for the Debian distribution because the original program does not have a manual page. Alsaconf is a simple shell script which tries to detect the sound cards on your system and writes a suitable configuration file for ALSA. It will try to guess what GNU/Linux distribution you're running, and will act accordingly to the standards of that distribution, if spe- cific support is available. Alsaconf will write a module-init-tools (or modutils) snippet which can be then used by module-init-tools (or modutils) to load the correct parameters for your sound card. OPTIONS
Alsaconf accepts the following options: -c, --config file Specify the module config file. As default, alsaconf probes the available config file automatically. -d, --devmode mode Set the device mode for the ALSA devices (default = 0666). This option is obsolete in the recent ALSA version. -g, --gid gid Set the gid for the ALSA devices (default = 0). This option is obsolete in the recent ALSA version. -h, --help Displays this help text. -L, --log file Logging on the given file. The log is appended to the file. This option is for debugging purpose only. -l, --legacy Check only for legacy non-isapnp cards. -m, --modinfo Read module descriptions instead of reading a card database. -P, --listprobe List the supported legacy card modules. -p, --probe card-name Probe a legacy non-isapnp card and print module options. -r, --strict Set strict device mode (equiv. with -g 17 -d 0660). This option is obsolete in the recent ALSA version. -s, --sound-wav-file Use the specified wav file as a test sound. -u, --uid uid Set the uid for the ALSA devices (default = 0). This option is obsolete in the recent ALSA version. DEBIAN SPECIFIC
In Debian, the default gid of the device files is 29 (corresponding to the audio group) and the default device mode is 0660. For the ALSA base package, see also /usr/share/doc/alsa-base/ SEE ALSO
alsamixer(1), amixer(1), aplay(1), arecord(1) HOMEPAGE
http://www.alsa-project.org/ AUTHOR
The alsaconf script was written by Takashi Iwai <tiwai@suse.de>, Bernd Kaindl <bk@suse.de> and Jan Ondrej (SAL) <ondrejj@salstar.sk> This manual page was written by Jordi Mallach <jordi@debian.org>, for the Debian system (but may be used by others). February 23, 2003 ALSACONF(8)
Check Out this Related Man Page
ALSACTL(1) General Commands Manual ALSACTL(1) NAME
alsactl - advanced controls for ALSA soundcard driver SYNOPSIS
alsactl [options] [store|restore|init] <card # or id or device> DESCRIPTION
alsactl 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. COMMANDS
store saves the current driver state for the selected soundcard to the configuration file. restore loads driver state for the selected soundcard from the configuration file. If restoring fails (eventually partly), the init action is called. init tries to initialize all devices to a default state. If device is not known, error code 99 is returned. If no soundcards are specified, setup for all cards will be saved or loaded. OPTIONS
-h, --help Help: show available flags and commands. -d, --debug Use debug mode: a bit more verbose. -v, --version Print alsactl version number. -f, --file Select the configuration file to use. The default is /var/lib/alsa/asound.state. -F, --force Used with restore command. Try to restore the matching control elements as much as possible. This option is set as default now. -g, --ignore 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, --pedantic Used with restore command. Don't restore mismatching control elements. This option was the old default behavior. -I, --no-init-fallback Don't initialize cards if restore fails. Since version 1.0.18, alsactl 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. -r, --runstate 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. -R, --remove Remove runstate file at first. -E, --env #=# 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). -i, --initfile #=# The configuration file for init. By default, PREFIX/share/alsa/init/00main is used. FILES
/var/lib/alsa/asound.state (or whatever file you specify with the -f flag) is used to store current settings for your soundcards. The set- tings 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. The configuration file is generated automatically by running alsactl store. 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). SEE ALSO
amixer(1), alsamixer(1), aplay(1) BUGS
None known. AUTHOR
alsactl is by Jaroslav Kysela <perex@perex.cz> and Abramo Bagnara <abramo@alsa-project.org>. This document is by Paul Winkler <zarmzarm@erols.com>. 15 May 2001 ALSACTL(1)