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>

此命令从配置文件加载所选声卡的驱动程序状态。如果恢复失败(最终部分失败),则会调用 init 操作。

nrestore <card>

此命令类似于“恢复”,但它还通知守护进程对可用声卡进行新的重新扫描。

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

将恢复和初始化状态保存到此文件。该文件将仅包含错误。错误与声卡 ID 一起附加到文件末尾。

-R, --remove

首先删除运行状态文件。

-E, --env #=#

设置环境变量(对于 init 操作有用,或者您可以覆盖 ALSA_CONFIG_PATH 以读取不同或优化的配置 - 可能对“启动”脚本有用)。

-i, --initfile

init 的配置文件。默认情况下,使用 PREFIX/share/alsa/init/00main。

-p, --period

守护程序命令的存储周期(以秒为单位)。

-e, --pid-file

以 HDB UUCP 格式 (ASCII) 存储进程 ID 文件的路径名。

-b, --background

在后台运行任务。

-s, --syslog

使用系统日志来记录消息。

-n, --nice

设置进程优先级(参见“man 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 由 Jaroslav Kysela 和 Abramo Bagnara 编写。本文档由 Paul Winkler 撰写。