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

[Randy Dunlap <rdunlap@infradead.org>]

Hi,

On 11/2/26 4:04 PM, Joonho Lee wrote:
> Document the five opt-in capture module parameters introduced by this
> series. All default to false. Describe the startup-empty, short-payload,
> packed-status and pause-restart compatibility behavior alongside staging,
> and require validation with the target device.
> 
> Assisted-by: LLM
> Signed-off-by: Joonho Lee <mynameisjune111@gmail.com>
> 
> ---

Please include a diffstat for each patch (here, below the "---" line).

> 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
> @@ -8328,6 +8328,36 @@
>  			brightness level.
>  			default: 1
>  
> +	virtio_snd.capture_allow_empty= [HW,SOUND]
> +			Retry a bounded number of empty startup capture replies.
> +			Format: <bool>
> +			Default: false. Compatibility option for devices that
> +			require staged capture; validate with the target device.
> +
> +	virtio_snd.capture_allow_short= [HW,SOUND]
> +			Accept non-empty, frame-aligned short capture replies.
> +			Format: <bool>
> +			Default: false. Compatibility option for devices that
> +			require staged capture; validate with the target device.
> +
> +	virtio_snd.capture_packed_status= [HW,SOUND]
> +			Read status immediately after the returned capture data.
> +			Format: <bool>
> +			Default: false. Compatibility option for devices that
> +			require staged capture; validate with the target device.
> +
> +	virtio_snd.capture_pause_restart= [HW,SOUND]
> +			Release and reprepare capture streams across pause.
> +			Format: <bool>
> +			Default: false. Compatibility option for devices that
> +			require staged capture; validate with the target device.
> +
> +	virtio_snd.capture_staging= [HW,SOUND]
> +			Use request-owned buffers for capture data.
> +			Format: <bool>
> +			Default: false. Compatibility option for devices that
> +			require staged capture; validate with the target device.
> +

All virtio_snd entries should be *after* virtio_mmio (alphabetical order).

>  	virtio_mmio.device=
>  			[VMMIO] Memory mapped virtio (platform) device.
>  

-- 
~Randy