[PATCH v15 12/12] docs: describe virtio-sound capture options

From: Joonho Lee

Date: Wed Nov 04 2026 - 19:17:24 EST


Document the five opt-in virtio_snd capture module parameters. State that
capture_allow_empty, capture_allow_short, capture_packed_status and
capture_pause_restart require capture_staging, and use the ALSA kernel
parameter restriction tag for each entry.

Assisted-by: LLM
Signed-off-by: Joonho Lee <mynameisjune111@xxxxxxxxx>

---
Documentation/admin-guide/kernel-parameters.txt | 29 +++++++++++++++++++++++
1 file changed, 29 insertions(+)

diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt
--- a/Documentation/admin-guide/kernel-parameters.txt
+++ b/Documentation/admin-guide/kernel-parameters.txt
@@ -8344,6 +8344,35 @@

Can be used multiple times for multiple devices.

+ virtio_snd.capture_allow_empty= [HW,ALSA]
+ Retry a bounded number of empty startup capture replies
+ when virtio_snd.capture_staging=1.
+ Format: <bool>
+ Default: false. Validate with the target device.
+
+ virtio_snd.capture_allow_short= [HW,ALSA]
+ Accept non-empty, frame-aligned short capture replies
+ when virtio_snd.capture_staging=1.
+ Format: <bool>
+ Default: false. Validate with the target device.
+
+ virtio_snd.capture_packed_status= [HW,ALSA]
+ Read status immediately after the returned capture data
+ when virtio_snd.capture_staging=1.
+ Format: <bool>
+ Default: false. Validate with the target device.
+
+ virtio_snd.capture_pause_restart= [HW,ALSA]
+ Release and reprepare capture streams across pause when
+ virtio_snd.capture_staging=1.
+ Format: <bool>
+ Default: false. Validate with the target device.
+
+ virtio_snd.capture_staging= [HW,ALSA]
+ Enable staged capture using request-owned buffers.
+ Format: <bool>
+ Default: false. Validate with the target device.
+
vga= [BOOT,X86-32] Select a particular video mode
See Documentation/arch/x86/boot.rst and
Documentation/admin-guide/svga.rst.