--- alsactl.1 2024-11-27 01:36:34.387486580 +0000 +++ alsactl.1.new 2024-11-27 01:53:30.810769721 +0000 @@ -4,7 +4,8 @@ alsactl \- advanced controls for ALSA so .SH SYNOPSIS -\fBalsactl\fP [\fIoptions\fP] [\fIstore\fP|\fIrestore\fP|\fIinit\fP] +\fBalsactl\fP [\fIoptions\fP] [\fIstore\fP|\fIrestore\fP|\fIinit\fP] \fBalsactl\fP \fImonitor\fP @@ -14,8 +15,10 @@ alsactl \- advanced controls for ALSA so .SH DESCRIPTION \fBalsactl\fP 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, +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. .SH COMMANDS @@ -38,13 +41,13 @@ action is called. .SS nrestore -This command is like \fIrestore\fP, but it notifies also the daemon -to do new rescan for available soundcards. +This command is like \fIrestore\fP, +but it notifies also the daemon to do new rescan for available soundcards. .SS init -This command tries to initialize all devices to a default state. If device -is not known, error code 99 is returned. +This command tries to initialize all devices to a default state. +If device is not known, error code 99 is returned. .SS daemon @@ -56,8 +59,8 @@ This command is like \fIdaemon\fP but re .SS kill -This command notifies the daemon to do the specified operation (quit, -rescan, save_and_quit). +This command notifies the daemon to do the specified operation +(quit, rescan, save_and_quit). .SS monitor @@ -73,8 +76,8 @@ collected from the given control device This command cleans the controls created by applications. -The optional element identifiers are accepted as a filter. One extra -argument is parsed as an element identifiers. +The optional element identifiers are accepted as a filter. +One extra argument is parsed as an element identifiers. \fIExample:\fP alsactl clean 0 "name='PCM'" "name='Mic Phantom'" @@ -90,7 +93,7 @@ Note that the configuration hooks are ev .SH OPTIONS .TP -\fI\-h, \-\-help\fP +\fI\-h, \-\-help\fP Help: show available flags and commands. .TP @@ -103,21 +106,24 @@ Print alsactl version number. .TP \fI\-f, \-\-file\fP -Select the configuration file to use. The default is /var/lib/alsa/asound.state. +Select the configuration file to use. +The default is /var/lib/alsa/asound.state. .TP \fI\-a, \-\-config-dir\fP -Select the boot / hotplug ALSA configuration directory to use. The default is /var/lib/alsa. +Select the boot / hotplug ALSA configuration directory to use. +The default is /var/lib/alsa. .TP \fI\-l, \-\-lock\fP -Use the file locking to serialize the concurrent access to the state file (this -option is default for the global state file). +Use the file locking to serialize the concurrent access to the state file +(this option is default for the global state file). .TP \fI\-L, \-\-no-lock\fP Do not use the file locking to serialize the concurrent access to the state -file (including the global state file). +file +(including the global state file). .TP \fI\-O, \-\-lock-state-file\fP @@ -130,21 +136,27 @@ as much as possible. This option is set .TP \fI\-g, \-\-ignore\fP -Used with store, restore and init commands. Do not show 'No soundcards found' -and do not set an error exit code when soundcards are not installed. +Used with store, restore and init commands. +Do not show 'No soundcards found' +and do not set an error exit code +when soundcards are not installed. .TP \fI\-P, \-\-pedantic\fP -Used with restore command. Don't restore mismatching control elements. +Used with restore command. +Don't restore mismatching control elements. This option was the old default behavior. .TP \fI\-I, \-\-no\-init\-fallback\fP -Don't initialize cards if restore fails. Since version 1.0.18, +Don't initialize cards if restore fails. +Since version 1.0.18, \fBalsactl\fP 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 +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. .TP @@ -158,9 +170,10 @@ Remove runstate file at first. .TP \fI\-E, \-\-env\fP #=# -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). +Set environment variable +(useful for init action +or you may override ALSA_CONFIG_PATH to read different +or optimized configuration \(en may be useful for "boot" scripts). .TP \fI\-i, \-\-initfile\fP @@ -193,39 +206,40 @@ Set the process scheduling policy to idl .TP \fI\-D, \-\-ucm-defaults\fP -Execute also the 'defaults' section from the UCM configuration. The standard -behaviour is to execute only 'once' section. +Execute also the 'defaults' section from the UCM configuration. +The standard behaviour is to execute only 'once' section. .TP \fI\-U, \-\-no-ucm\fP -Skip the UCM init even if available. It may be useful for the test the -legacy init configuration. +Skip the UCM init even if available. +It may be useful for the test the legacy init configuration. .SH FILES -\fI/var/lib/alsa/asound.state\fP (or whatever file you specify with the -\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. +\fI/var/lib/alsa/asound.state\fP +(or whatever file you specify with the \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. The configuration file is generated automatically by running \fBalsactl store\fP. Editing the configuration file by hand may be -necessary for some soundcard features (e.g. enabling/disabling +necessary for some soundcard features (e.g., enabling/disabling automatic mic gain, digital output, joystick/game ports, some future MIDI routing options, etc). .SH SEE ALSO -\fB -amixer(1), -alsamixer(1), -aplay(1), -alsactl_init(7) -\fP +.BR \ +amixer "(1), "\ +alsamixer "(1), "\ +aplay "(1), "\ +alsactl_init (7) -.SH BUGS +.SH BUGS None known. .SH AUTHOR -\fBalsactl\fP is by Jaroslav Kysela and Abramo Bagnara -. This document is by Paul Winkler . +\fBalsactl\fP is by Jaroslav Kysela +and Abramo Bagnara . +This document is by Paul Winkler .