alsactl - manuel de référence, options, exemples de commandes


NOM

alsactl - contrôles avancés pour le pilote de carte son ALSA

SYNOPSIS

alsactl [options] [store|restore|init] <card # or id or device>

alsactl monitor <card # or id>

alsactl info <card # or id>

alsactl [clean] <card # or id or device> [[control identifiers]]

DESCRIPTION

alsactl est utilisé pour contrôler les paramètres avancés des pilotes de carte son ALSA. Il prend en charge plusieurs cartes son. Si votre carte possède des fonctionnalités que vous ne semblez pas pouvoir contrôler à partir d'une application de mixage, vous êtes au bon endroit.

COMMANDES

Introduction

L'argument <card> est facultatif. Si aucune carte son n'est spécifiée, la configuration de toutes les cartes sera enregistrée, chargée ou surveillée.

store <card>

Cette commande enregistre l'état actuel du pilote pour la carte son sélectionnée dans le fichier de configuration.

restore <card>

Cette commande charge l'état du pilote pour la carte son sélectionnée à partir du fichier de configuration. Si la restauration échoue (éventuellement en partie), l'action init est appelée.

nrestore <card>

Cette commande est comme restore, mais elle demande aussi au démon de faire une nouvelle analyse des cartes son disponibles.

init <card>

Cette commande tente d'initialiser tous les périphériques à un état par défaut. Si le périphérique n'est pas connu, le code d'erreur 99 est renvoyé.

daemon

Cette commande parvient à sauvegarder périodiquement l'état du son.

rdaemon

Cette commande est comme daemon mais restaure d'abord l'état du son.

kill <cmd>

Cette commande demande au démon d'effectuer l'opération spécifiée (quit, rescan, save_and_quit).

monitor <card>

Cette commande sert à surveiller les événements reçus du dispositif de contrôle donné.

info <card>

Cette commande affiche les informations générales au format YAML collectées à partir du périphérique de contrôle donné (carte son).

clean <card> [filter]

Cette commande nettoie les champs créés par les applications.

Les identificateurs d'éléments facultatifs sont acceptés comme filtre. Un argument supplémentaire est analysé comme un identifiant d'élément.

Exemple : alsactl clean 0 "name='PCM'" "name='Mic Phantom'"

dump-state

Cette commande vide l'état actuel (toutes les cartes) sur stdout.

dump-cfg

Cette commande vide la configuration actuelle (toutes les cartes) sur stdout. Notez que les crochets de configuration sont évalués.

OPTIONS

-h, --help

Aide : affiche les drapeaux et les commandes disponibles.

-d, --debug

Utiliser le mode débogage : un peu plus verbeux.

-v, --version

Afficher le numéro de version d'alsactl.

-f, --file

Sélectionnez le fichier de configuration à utiliser. La valeur par défaut est /var/lib/alsa/asound.state.

-a, --config-dir

Sélectionnez le répertoire de configuration boot/hotplug ALSA à utiliser. La valeur par défaut est /var/lib/alsa.

-l, --lock

Utilisez le verrouillage de fichier pour sérialiser l'accès simultané au fichier d'état (cette option est par défaut pour le fichier d'état global).

-L, --no-lock

N'utilisez pas le verrouillage de fichier pour sérialiser l'accès simultané au fichier d'état (y compris le fichier d'état global).

-O, --lock-state-file

Sélectionnez le chemin du fichier de verrouillage d'état.

-F, --force

Utilisé avec la commande de restauration. Essayez de restaurer autant que possible les éléments de contrôle correspondants. Cette option est maintenant définie par défaut.

-g, --ignore

Utilisé avec les commandes store, restore et init. N'affiche pas "Aucune carte son trouvée" et ne définit pas de code de sortie d'erreur lorsque les cartes son ne sont pas installées.

-P, --pedantic

Utilisé avec la commande de restauration. Ne restaurez pas les éléments de contrôle incompatibles. Cette option était l'ancien comportement par défaut.

-I, --no-init-fallback

N'initialisez pas les cartes si la restauration échoue. Depuis la version 1.0.18, alsactl essaie d'initialiser la carte avec l'opération de restauration par défaut. Mais cela peut entraîner une incompatibilité avec l'ancienne version. L'appelant peut s'attendre à ce que l'état ne soit pas touché si aucun fichier d'état n'existe. Cette option ramène le comportement de restauration à l'ancienne version en supprimant l'initialisation.

-r, --runstate

Enregistrez l'état de restauration et d'initialisation dans ce fichier. Le fichier ne contiendra que des erreurs. Les erreurs sont ajoutées avec l'identifiant de la carte son à la fin du fichier.

-R, --remove

Supprimez d'abord le fichier d'état d'exécution.

-E, --env #=#

Définir la variable d'environnement (utile pour l'action init ou vous pouvez remplacer ALSA_CONFIG_PATH pour lire une configuration différente ou optimisée - peut être utile pour les scripts "boot").

-i, --initfile

Le fichier de configuration pour init. Par défaut, PREFIX/share/alsa/init/00main est utilisé.

-p, --period

La période de stockage en secondes pour la commande démon.

-e, --pid-file

Le chemin d'accès pour stocker le fichier d'ID de processus au format HDB UUCP (ASCII).

-b, --background

Exécutez la tâche en arrière-plan.

-s, --syslog

Utilisez syslog pour les messages.

-n, --nice

Définir la priorité du processus (voir 'man nice')

-c, --sched-idle

Définissez la stratégie de planification de processus sur inactif (SCHED_IDLE).

-D, --ucm-defaults

Exécutez également la section 'defaults' de la configuration UCM. Le comportement standard consiste à n'exécuter qu'une seule fois la section.

-U, --no-ucm

Ignorez l'initialisation UCM même si elle est disponible. Cela peut être utile pour tester la configuration d'initialisation héritée.

DES DOSSIERS

/var/lib/alsa/asound.state (ou tout autre fichier que vous spécifiez avec le drapeau -f) est utilisé pour stocker les paramètres actuels de vos cartes son. Les paramètres incluent tous les paramètres habituels du mélangeur de carte son. Plus important encore, alsactl est capable de contrôler d'autres fonctionnalités spécifiques à la carte que les applications de mixage ne connaissent généralement pas.

Le fichier de configuration est généré automatiquement en exécutant alsactl store. L'édition manuelle du fichier de configuration peut être nécessaire pour certaines fonctionnalités de la carte son (par exemple, activer/désactiver le gain automatique du micro, la sortie numérique, les ports joystick/jeu, certaines futures options de routage MIDI, etc.).

VOIR ÉGALEMENT

amixer(1), alsamixer(1), aplay(1), alsactl_init(7)

INSECTES

Aucun connu.

AUTEUR

alsactl est de Jaroslav Kysela perex@perex.cz et Abramo Bagnara abramo@alsa-project.org. Ce document est de Paul Winkler zarmzarm@erols.com.