alsactl - справочное руководство, опции, примеры команд


ИМЯ

alsactl - расширенные элементы управления для драйвера звуковой карты ALSA

СИНТАКСИС

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

ОПИСАНИЕ

alsactl используется для управления дополнительными настройками драйверов звуковой карты ALSA. Он поддерживает несколько звуковых карт. Если у вашей карты есть функции, которыми вы не можете управлять из приложения микшера, вы обратились по адресу.

КОМАНДЫ

Introduction

Аргумент <card> является необязательным. Если звуковые карты не указаны, настройки для всех карт будут сохранены, загружены или отслежены.

store <card>

Эта команда сохраняет текущее состояние драйвера для выбранной звуковой карты в файл конфигурации.

restore <card>

Эта команда загружает состояние драйвера для выбранной звуковой карты из файла конфигурации. Если восстановление не удается (возможно, частично), вызывается действие инициализации.

nrestore <card>

Эта команда похожа на restore, но она также уведомляет демон о необходимости повторного сканирования доступных звуковых карт.

init <card>

Эта команда пытается инициализировать все устройства до состояния по умолчанию. Если устройство неизвестно, возвращается код ошибки 99.

daemon

Эта команда позволяет периодически сохранять состояние звука.

rdaemon

Эта команда похожа на daemon, но сначала восстанавливает состояние звука.

kill <cmd>

Эта команда уведомляет демон о выполнении указанной операции (выход, повторное сканирование, save_and_quit).

monitor <card>

Эта команда предназначена для отслеживания событий, полученных от данного управляющего устройства.

info <card>

Эта команда показывает общую информацию в формате YAML, собранную с данного управляющего устройства (звуковой карты).

clean <card> [filter]

Эта команда очищает элементы управления, созданные приложениями.

Необязательные идентификаторы элементов принимаются в качестве фильтра. Один дополнительный аргумент анализируется как идентификатор элемента.

Пример: alsactl clean 0 "name='PCM'" "name='Mic Phantom'"

dump-state

Эта команда выводит текущее состояние (все карты) на стандартный вывод.

dump-cfg

Эта команда выводит текущую конфигурацию (все карты) на стандартный вывод. Обратите внимание, что перехватчики конфигурации оцениваются.

ПАРАМЕТРЫ

-h, --help

Справка: показать доступные флаги и команды.

-d, --debug

Используйте режим отладки: немного более подробный.

-v, --version

Вывести номер версии alsactl.

-f, --file

Выберите файл конфигурации для использования. По умолчанию это /var/lib/alsa/asound.state.

-a, --config-dir

Выберите каталог конфигурации boot/hotplug ALSA для использования. По умолчанию это /var/lib/alsa.

-l, --lock

Используйте блокировку файла, чтобы сериализовать одновременный доступ к файлу состояния (этот параметр используется по умолчанию для глобального файла состояния).

-L, --no-lock

Не используйте блокировку файла для сериализации параллельного доступа к файлу состояния (включая глобальный файл состояния).

-O, --lock-state-file

Выберите путь к файлу блокировки состояния.

-F, --force

Используется с командой восстановления. Постарайтесь максимально восстановить совпадающие элементы управления. Эта опция теперь установлена по умолчанию.

-g, --ignore

Используется с командами сохранения, восстановления и инициализации. Не показывать «Звуковые карты не найдены» и не устанавливать код выхода ошибки, если звуковые карты не установлены.

-P, --pedantic

Используется с командой восстановления. Не восстанавливайте несоответствующие элементы управления. Эта опция была старым поведением по умолчанию.

-I, --no-init-fallback

Не инициализируйте карты, если восстановление не удалось. Начиная с версии 1.0.18, alsactl пытается инициализировать карту с операцией восстановления по умолчанию. Но это может вызвать несовместимость со старой версией. Вызывающий может ожидать, что состояние не будет затронуто, если файл состояния не существует. Этот параметр возвращает поведение восстановления к более старой версии, подавляя инициализацию.

-r, --runstate

Сохраните состояние восстановления и инициализации в этот файл. Файл будет содержать только ошибки. Ошибки добавляются с идентификатором звуковой карты в конец файла.

-R, --remove

Сначала удалите файл состояния выполнения.

-E, --env #=#

Установите переменную среды (полезно для действия инициализации, или вы можете переопределить ALSA_CONFIG_PATH для чтения другой или оптимизированной конфигурации — может быть полезно для «загрузочных» сценариев).

-i, --initfile

Файл конфигурации для init. По умолчанию используется PREFIX/share/alsa/init/00main.

-p, --period

Период хранения в секундах для команды демона.

-e, --pid-file

Путь для хранения файла идентификатора процесса в формате HDB UUCP (ASCII).

-b, --background

Запустите задачу в фоновом режиме.

-s, --syslog

Используйте системный журнал для сообщений.

-n, --nice

Установить приоритет процесса (см. «человек приятный»)

-c, --sched-idle

Установите для политики планирования процессов значение ожидания (SCHED_IDLE).

-D, --ucm-defaults

Выполните также раздел «по умолчанию» из конфигурации UCM. Стандартное поведение заключается в выполнении только раздела «один раз».

-U, --no-ucm

Пропустите инициализацию UCM, даже если она доступна. Это может быть полезно для проверки устаревшей конфигурации инициализации.

ФАЙЛЫ

/var/lib/alsa/asound.state (или любой другой файл, указанный вами с помощью флага -f) используется для хранения текущих настроек ваших звуковых карт. Настройки включают в себя все обычные настройки микшера звуковой карты. Что еще более важно, alsactl может управлять другими специфическими для карты функциями, о которых приложения-микшеры обычно не знают.

Файл конфигурации создается автоматически при запуске alsactl store. Редактирование файла конфигурации вручную может быть необходимо для некоторых функций звуковой карты (например, включение/отключение автоматического усиления микрофона, цифрового выхода, джойстика/игровых портов, некоторых будущих параметров маршрутизации MIDI и т. д.).

СМОТРИТЕ ТАКЖЕ

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

ОШИБКИ

Никто не известен.

АВТОР

alsactl создан Ярославом Киселой perex@perex.cz и Абрамо Баньярой abramo@alsa-project.org. Автор этого документа Пол Винклер zarmzarm@erols.com.