linux-kernel - Re: [PATCH 06/14] virtio: Describe @map and @vmap members in virtio

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20251215154141-mutt-send-email-mst@kernel.org>
Date: Mon, 15 Dec 2025 15:41:49 -0500
From: "Michael S. Tsirkin" <mst@...hat.com>
To: Bagas Sanjaya <bagasdotme@...il.com>
Cc: Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
	Linux AMDGPU <amd-gfx@...ts.freedesktop.org>,
	Linux DRI Development <dri-devel@...ts.freedesktop.org>,
	Linux Filesystems Development <linux-fsdevel@...r.kernel.org>,
	Linux Media <linux-media@...r.kernel.org>,
	linaro-mm-sig@...ts.linaro.org, kasan-dev@...glegroups.com,
	Linux Virtualization <virtualization@...ts.linux.dev>,
	Linux Memory Management List <linux-mm@...ck.org>,
	Linux Network Bridge <bridge@...ts.linux.dev>,
	Linux Networking <netdev@...r.kernel.org>,
	Harry Wentland <harry.wentland@....com>,
	Leo Li <sunpeng.li@....com>, Rodrigo Siqueira <siqueira@...lia.com>,
	Alex Deucher <alexander.deucher@....com>,
	Christian König <christian.koenig@....com>,
	David Airlie <airlied@...il.com>, Simona Vetter <simona@...ll.ch>,
	Maarten Lankhorst <maarten.lankhorst@...ux.intel.com>,
	Maxime Ripard <mripard@...nel.org>,
	Thomas Zimmermann <tzimmermann@...e.de>,
	Matthew Brost <matthew.brost@...el.com>,
	Danilo Krummrich <dakr@...nel.org>,
	Philipp Stanner <phasta@...nel.org>,
	Alexander Viro <viro@...iv.linux.org.uk>,
	Christian Brauner <brauner@...nel.org>, Jan Kara <jack@...e.cz>,
	Sumit Semwal <sumit.semwal@...aro.org>,
	Alexander Potapenko <glider@...gle.com>,
	Marco Elver <elver@...gle.com>, Dmitry Vyukov <dvyukov@...gle.com>,
	Jason Wang <jasowang@...hat.com>,
	Xuan Zhuo <xuanzhuo@...ux.alibaba.com>,
	Eugenio Pérez <eperezma@...hat.com>,
	Andrew Morton <akpm@...ux-foundation.org>,
	Uladzislau Rezki <urezki@...il.com>,
	Nikolay Aleksandrov <razor@...ckwall.org>,
	Ido Schimmel <idosch@...dia.com>,
	"David S. Miller" <davem@...emloft.net>,
	Eric Dumazet <edumazet@...gle.com>,
	Jakub Kicinski <kuba@...nel.org>, Paolo Abeni <pabeni@...hat.com>,
	Simon Horman <horms@...nel.org>,
	Taimur Hassan <Syed.Hassan@....com>, Wayne Lin <Wayne.Lin@....com>,
	Alex Hung <alex.hung@....com>,
	Aurabindo Pillai <aurabindo.pillai@....com>,
	Dillon Varone <Dillon.Varone@....com>,
	George Shen <george.shen@....com>, Aric Cyr <aric.cyr@....com>,
	Cruise Hung <Cruise.Hung@....com>,
	Mario Limonciello <mario.limonciello@....com>,
	Sunil Khatri <sunil.khatri@....com>,
	Dominik Kaszewski <dominik.kaszewski@....com>,
	David Hildenbrand <david@...nel.org>,
	Peter Zijlstra <peterz@...radead.org>,
	Lorenzo Stoakes <lorenzo.stoakes@...cle.com>,
	Max Kellermann <max.kellermann@...os.com>,
	"Nysal Jan K.A." <nysal@...ux.ibm.com>,
	Ryan Roberts <ryan.roberts@....com>,
	Alexey Skidanov <alexey.skidanov@...el.com>,
	Vlastimil Babka <vbabka@...e.cz>,
	Kent Overstreet <kent.overstreet@...ux.dev>,
	Vitaly Wool <vitaly.wool@...sulko.se>,
	Harry Yoo <harry.yoo@...cle.com>, Mateusz Guzik <mjguzik@...il.com>,
	NeilBrown <neil@...wn.name>, Amir Goldstein <amir73il@...il.com>,
	Jeff Layton <jlayton@...nel.org>, Ivan Lipski <ivan.lipski@....com>,
	Tao Zhou <tao.zhou1@....com>, YiPeng Chai <YiPeng.Chai@....com>,
	Hawking Zhang <Hawking.Zhang@....com>,
	Lyude Paul <lyude@...hat.com>,
	Daniel Almeida <daniel.almeida@...labora.com>,
	Luben Tuikov <luben.tuikov@....com>,
	Matthew Auld <matthew.auld@...el.com>,
	Roopa Prabhu <roopa@...ulusnetworks.com>,
	Mao Zhu <zhumao001@...suo.com>,
	Shaomin Deng <dengshaomin@...rlc.com>,
	Charles Han <hanchunchao@...pur.com>,
	Jilin Yuan <yuanjilin@...rlc.com>,
	Swaraj Gaikwad <swarajgaikwad1925@...il.com>,
	George Anthony Vernon <contact@...rnon.com>
Subject: Re: [PATCH 06/14] virtio: Describe @map and @vmap members in
 virtio_device struct

On Mon, Dec 15, 2025 at 06:38:54PM +0700, Bagas Sanjaya wrote:
> Sphinx reports kernel-doc warnings:
> 
> WARNING: ./include/linux/virtio.h:181 struct member 'map' not described in 'virtio_device'
> WARNING: ./include/linux/virtio.h:181 struct member 'vmap' not described in 'virtio_device'
> 
> Describe these members.
> 
> Fixes: bee8c7c24b7373 ("virtio: introduce map ops in virtio core")
> Signed-off-by: Bagas Sanjaya <bagasdotme@...il.com>

Acked-by: Michael S. Tsirkin <mst@...hat.com>

> ---
>  include/linux/virtio.h | 2 ++
>  1 file changed, 2 insertions(+)
> 
> diff --git a/include/linux/virtio.h b/include/linux/virtio.h
> index 132a474e59140a..68ead8fda9c921 100644
> --- a/include/linux/virtio.h
> +++ b/include/linux/virtio.h
> @@ -150,11 +150,13 @@ struct virtio_admin_cmd {
>   * @id: the device type identification (used to match it with a driver).
>   * @config: the configuration ops for this device.
>   * @vringh_config: configuration ops for host vrings.
> + * @map: configuration ops for device's mapping buffer
>   * @vqs: the list of virtqueues for this device.
>   * @features: the 64 lower features supported by both driver and device.
>   * @features_array: the full features space supported by both driver and
>   *		    device.
>   * @priv: private pointer for the driver's use.
> + * @vmap: device virtual map
>   * @debugfs_dir: debugfs directory entry.
>   * @debugfs_filter_features: features to be filtered set by debugfs.
>   */
> -- 
> An old man doll... just what I always wanted! - Clara