blob: a3e129658bb4c027f2c4c2b016f1c1f44b7cf89d [file] [log] [blame]
.\" Hey, EMACS: -*- nroff -*-
.\" alsaconf.8 is copyright 2003 by Jordi Mallach <jordi@debian.org>
.\"
.\" This is free documentation, see the latest version of the GNU
.\" General Public License for copying conditions. There is NO warranty.
.TH ALSACONF 8 "February 23, 2003"
.SH NAME
alsaconf \- configuration tool for the Advanced Linux Sound Architecture
.SH SYNOPSIS
.B alsaconf
.RI [ options ]
.SH DESCRIPTION
This manual page documents briefly the
.B alsaconf
command.
This manual page was written for the Debian distribution because the
original program does not have a manual page.
.PP
\fBAlsaconf\fP 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 specific support is available.
.PP
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.
.SH OPTIONS
Alsaconf accepts the following options:
.TP
.B \-c, \-\-config file
Specify the module config file.
As default,
.B alsaconf
probes the available config file automatically.
.TP
.B \-d, \-\-devmode mode
Set the device mode for the ALSA devices (default = 0666).
This option is obsolete in the recent ALSA version.
.TP
.B \-g, \-\-gid gid
Set the gid for the ALSA devices (default = 0).
This option is obsolete in the recent ALSA version.
.TP
.B \-h, \-\-help
Displays this help text.
.TP
.B \-L, \-\-log file
Logging on the given file. The log is appended to the file.
This option is for debugging purpose only.
.TP
.B \-l, \-\-legacy
Check only for legacy non-isapnp cards.
.TP
.B \-m, \-\-modinfo
Read module descriptions instead of reading a card database.
.TP
.B \-P, \-\-listprobe
List the supported legacy card modules.
.TP
.B \-p, \-\-probe card-name
Probe a legacy non-isapnp card and print module options.
.TP
.B \-r, \-\-strict
Set strict device mode (equiv. with \-g 17 \-d 0660).
This option is obsolete in the recent ALSA version.
.TP
.B \-s, \-\-sound\-wav\-file
Use the specified wav file as a test sound.
.TP
.B \-u, \-\-uid uid
Set the uid for the ALSA devices (default = 0).
This option is obsolete in the recent ALSA version.
.SH 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
.I /usr/share/doc/alsa\-base/
.SH SEE ALSO
\fB
alsamixer(1),
amixer(1),
aplay(1),
arecord(1)
\fP
.SH HOMEPAGE
http://www.alsa\-project.org/
.SH 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).