alsactl - manual de referência, opções, exemplos de comandos


NOME

alsactl - controles avançados para driver de placa de som ALSA

SINOPSE

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

DESCRIÇÃO

alsactl é usado para controlar as configurações avançadas dos drivers da placa de som ALSA. Ele suporta várias placas de som. Se a sua placa possui recursos que você não consegue controlar a partir de um aplicativo de mixer, você veio ao lugar certo.

COMANDOS

Introduction

O argumento <card> é opcional. Se nenhuma placa de som for especificada, a configuração de todas as placas será salva, carregada ou monitorada.

store <card>

Este comando salva o estado atual do driver da placa de som selecionada no arquivo de configuração.

restore <card>

Este comando carrega o estado do driver para a placa de som selecionada no arquivo de configuração. Se a restauração falhar (eventualmente parcialmente), a ação init será chamada.

nrestore <card>

Este comando é como restaurar, mas também notifica o daemon para fazer uma nova busca por placas de som disponíveis.

init <card>

Este comando tenta inicializar todos os dispositivos para um estado padrão. Se o dispositivo não for conhecido, o código de erro 99 será retornado.

daemon

Este comando consegue salvar periodicamente o estado do som.

rdaemon

Este comando é como daemon, mas primeiro restaura o estado do som.

kill <cmd>

Este comando notifica o daemon para fazer a operação especificada (sair, rescan, save_and_quit).

monitor <card>

Este comando é para monitorar os eventos recebidos do dispositivo de controle fornecido.

info <card>

Este comando mostra as informações gerais no formato YAML coletadas do dispositivo de controle fornecido (placa de som).

clean <card> [filter]

Este comando limpa os controles criados pelos aplicativos.

Os identificadores de elementos opcionais são aceitos como um filtro. Um argumento extra é analisado como um identificador de elemento.

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

dump-state

Este comando despeja o estado atual (todos os cartões) para stdout.

dump-cfg

Este comando despeja a configuração atual (todas as placas) para stdout. Observe que os ganchos de configuração são avaliados.

OPÇÕES

-h, --help

Ajuda: mostra sinalizadores e comandos disponíveis.

-d, --debug

Use o modo de depuração: um pouco mais detalhado.

-v, --version

Imprima o número da versão alsactl.

-f, --file

Selecione o arquivo de configuração a ser usado. O padrão é /var/lib/alsa/asound.state.

-a, --config-dir

Selecione o diretório de configuração ALSA boot/hotplug a ser usado. O padrão é /var/lib/alsa.

-l, --lock

Use o bloqueio de arquivo para serializar o acesso simultâneo ao arquivo de estado (essa opção é padrão para o arquivo de estado global).

-L, --no-lock

Não use o bloqueio de arquivo para serializar o acesso simultâneo ao arquivo de estado (incluindo o arquivo de estado global).

-O, --lock-state-file

Selecione o caminho do arquivo de bloqueio de estado.

-F, --force

Usado com comando de restauração. Tente restaurar os elementos de controle correspondentes o máximo possível. Esta opção está definida como padrão agora.

-g, --ignore

Usado com os comandos store, restore e init. Não mostre 'Nenhuma placa de som encontrada' e não defina um código de saída de erro quando as placas de som não estiverem instaladas.

-P, --pedantic

Usado com comando de restauração. Não restaure elementos de controle incompatíveis. Essa opção era o antigo comportamento padrão.

-I, --no-init-fallback

Não inicialize os cartões se a restauração falhar. Desde a versão 1.0.18, alsactl tenta inicializar o cartão com a operação de restauração como padrão. Mas isso pode causar incompatibilidade com a versão mais antiga. O chamador pode esperar que o estado não seja alterado se nenhum arquivo de estado existir. Esta opção leva o comportamento de restauração de volta para a versão mais antiga suprimindo a inicialização.

-r, --runstate

Salve a restauração e o estado de inicialização neste arquivo. O arquivo conterá apenas erros. Os erros são anexados com o ID da placa de som ao final do arquivo.

-R, --remove

Remova o arquivo runstate primeiro.

-E, --env #=#

Defina a variável de ambiente (útil para ação de inicialização ou você pode substituir ALSA_CONFIG_PATH para ler configurações diferentes ou otimizadas - pode ser útil para scripts de "inicialização").

-i, --initfile

O arquivo de configuração do init. Por padrão, PREFIX/share/alsa/init/00main é usado.

-p, --period

O período de armazenamento em segundos para o comando daemon.

-e, --pid-file

O nome do caminho para armazenar o arquivo de id do processo no formato HDB UUCP (ASCII).

-b, --background

Execute a tarefa em segundo plano.

-s, --syslog

Use syslog para mensagens.

-n, --nice

Defina a prioridade do processo (consulte 'man nice')

-c, --sched-idle

Defina a política de agendamento do processo como ociosa (SCHED_IDLE).

-D, --ucm-defaults

Execute também a seção 'padrão' da configuração do UCM. O comportamento padrão é executar apenas a seção 'uma vez'.

-U, --no-ucm

Ignore o init do UCM, mesmo que disponível. Pode ser útil para testar a configuração legada do init.

ARQUIVOS

/var/lib/alsa/asound.state (ou qualquer arquivo que você especificar com o sinalizador -f) é usado para armazenar as configurações atuais de suas placas de som. As configurações incluem todas as configurações usuais do mixer da placa de som. Mais importante, o alsactl é capaz de controlar outros recursos específicos do cartão que os aplicativos de mixagem geralmente não conhecem.

O arquivo de configuração é gerado automaticamente executando alsactl store. A edição manual do arquivo de configuração pode ser necessária para alguns recursos da placa de som (por exemplo, habilitar/desabilitar o ganho automático de microfone, saída digital, portas de joystick/jogo, algumas opções futuras de roteamento MIDI, etc.).

VEJA TAMBÉM

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

INSETOS

Nenhum conhecido.

AUTOR

alsactl é de Jaroslav Kysela perex@perex.cz e Abramo Bagnara abramo@alsa-project.org. Este documento é de Paul Winkler zarmzarm@erols.com.