Re: [PATCH] virtio: document the map API in the driver writing guide
From: Jason Wang
Date: Fri Mar 13 2026 - 02:41:57 EST
On Fri, Mar 13, 2026 at 5:58 AM John S <xaum.io@xxxxxxxxx> wrote:
>
> Add a new "Buffer mapping" section to the virtio driver writing guide
> documenting the virtio map API (struct virtio_map_ops). This API was
> introduced in commit bee8c7c24b73 ("virtio: introduce map ops in virtio
> core") to allow transports and devices that do not perform DMA (such
> as VDUSE) to provide their own buffer mapping logic instead of abusing
> the DMA API.
>
> The new section explains when and why custom map ops are used, documents
> the virtio_map_ops structure and the union virtio_map token, and
> references the driver-facing mapping helpers with their kernel-doc.
>
> Signed-off-by: Kit Dallege <xaum.io@xxxxxxxxx>
> ---
Acked-by: Jason Wang <jasowang@xxxxxxxxxx>
Thanks