alsactl - manuale di riferimento, opzioni, esempi di comandi


NOME

alsactl - controlli avanzati per il driver della scheda audio ALSA

SINOSSI

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]]

DESCRIZIONE

alsactl viene utilizzato per controllare le impostazioni avanzate per i driver della scheda audio ALSA. Supporta più schede audio. Se la tua scheda ha caratteristiche che non riesci a controllare da un'applicazione mixer, sei nel posto giusto.

COMANDI

Introduction

L'argomento <card> è facoltativo. Se non viene specificata alcuna scheda audio, la configurazione per tutte le schede verrà salvata, caricata o monitorata.

store <card>

Questo comando salva lo stato corrente del driver per la scheda audio selezionata nel file di configurazione.

restore <card>

Questo comando carica lo stato del driver per la scheda audio selezionata dal file di configurazione. Se il ripristino fallisce (eventualmente in parte), viene richiamata l'azione init.

nrestore <card>

Questo comando è simile a restore, ma notifica anche al demone di eseguire una nuova scansione per le schede audio disponibili.

init <card>

Questo comando tenta di inizializzare tutti i dispositivi su uno stato predefinito. Se il dispositivo non è noto, viene restituito il codice di errore 99.

daemon

Questo comando riesce a salvare periodicamente lo stato del suono.

rdaemon

Questo comando è simile a daemon ma all'inizio ripristina lo stato del suono.

kill <cmd>

Questo comando notifica al demone di eseguire l'operazione specificata (quit, rescan, save_and_quit).

monitor <card>

Questo comando serve per monitorare gli eventi ricevuti dal dato dispositivo di controllo.

info <card>

Questo comando mostra le informazioni generali nel formato YAML raccolte dal dato dispositivo di controllo (scheda audio).

clean <card> [filter]

Questo comando pulisce i controlli creati dalle applicazioni.

Gli identificatori di elementi facoltativi sono accettati come filtro. Un argomento aggiuntivo viene analizzato come identificatore di elemento.

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

dump-state

Questo comando esegue il dump dello stato corrente (tutte le schede) su stdout.

dump-cfg

Questo comando esegue il dump della configurazione corrente (tutte le schede) su stdout. Si noti che vengono valutati gli hook di configurazione.

OPZIONI

-h, --help

Help: mostra flag e comandi disponibili.

-d, --debug

Usa la modalità di debug: un po' più dettagliata.

-v, --version

Stampa il numero di versione alsactl.

-f, --file

Seleziona il file di configurazione da utilizzare. L'impostazione predefinita è /var/lib/alsa/asound.state.

-a, --config-dir

Selezionare la directory di configurazione ALSA boot/hotplug da utilizzare. Il valore predefinito è /var/lib/alsa.

-l, --lock

Utilizzare il blocco del file per serializzare l'accesso simultaneo al file di stato (questa opzione è predefinita per il file di stato globale).

-L, --no-lock

Non utilizzare il blocco del file per serializzare l'accesso simultaneo al file di stato (incluso il file di stato globale).

-O, --lock-state-file

Selezionare il percorso del file di blocco dello stato.

-F, --force

Utilizzato con il comando di ripristino. Cerca di ripristinare il più possibile gli elementi di controllo corrispondenti. Questa opzione è ora impostata come predefinita.

-g, --ignore

Utilizzato con i comandi store, restore e init. Non mostrare 'Nessuna scheda audio trovata' e non impostare un codice di uscita di errore quando le schede audio non sono installate.

-P, --pedantic

Utilizzato con il comando di ripristino. Non ripristinare gli elementi di controllo non corrispondenti. Questa opzione era il vecchio comportamento predefinito.

-I, --no-init-fallback

Non inizializzare le schede se il ripristino non riesce. Dalla versione 1.0.18, alsactl tenta di inizializzare la scheda con l'operazione di ripristino predefinita. Ma questo può causare incompatibilità con la versione precedente. Il chiamante può aspettarsi che lo stato non venga toccato se non esiste alcun file di stato. Questa opzione riporta il comportamento di ripristino alla versione precedente sopprimendo l'inizializzazione.

-r, --runstate

Salva lo stato di ripristino e inizializzazione in questo file. Il file conterrà solo errori. Gli errori vengono aggiunti con l'ID della scheda audio alla fine del file.

-R, --remove

Rimuovere prima il file runstate.

-E, --env #=#

Imposta la variabile di ambiente (utile per l'azione init o puoi sovrascrivere ALSA_CONFIG_PATH per leggere una configurazione diversa o ottimizzata - può essere utile per gli script di "avvio").

-i, --initfile

Il file di configurazione per init. Per impostazione predefinita, viene utilizzato PREFIX/share/alsa/init/00main.

-p, --period

Il periodo di archiviazione in secondi per il comando daemon.

-e, --pid-file

Il percorso per memorizzare il file process-id nel formato HDB UUCP (ASCII).

-b, --background

Eseguire l'attività in background.

-s, --syslog

Usa syslog per i messaggi.

-n, --nice

Imposta la priorità del processo (vedi 'man nice')

-c, --sched-idle

Impostare il criterio di pianificazione del processo su inattivo (SCHED_IDLE).

-D, --ucm-defaults

Eseguire anche la sezione 'defaults' dalla configurazione UCM. Il comportamento standard è quello di eseguire una sola sezione 'una volta'.

-U, --no-ucm

Salta l'init UCM anche se disponibile. Può essere utile per testare la configurazione legacy di init.

FILE

/var/lib/alsa/asound.state (o qualsiasi altro file specificato con il flag -f) viene utilizzato per memorizzare le impostazioni correnti per le tue schede audio. Le impostazioni includono tutte le solite impostazioni del mixer della scheda audio. Ancora più importante, alsactl è in grado di controllare altre funzionalità specifiche della scheda che le app mixer di solito non conoscono.

Il file di configurazione viene generato automaticamente eseguendo alsactl store. La modifica manuale del file di configurazione potrebbe essere necessaria per alcune funzionalità della scheda audio (ad es. abilitazione/disabilitazione del guadagno automatico del microfono, uscita digitale, porte joystick/giochi, alcune future opzioni di routing MIDI, ecc.).

GUARDA ANCHE

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

BUG

Nessuno noto.

AUTORE

alsactl è di Jaroslav Kysela perex@perex.cz e Abramo Bagnara abramo@alsa-project.org. Questo documento è di Paul Winkler zarmzarm@erols.com.