From: "Michael S. Tsirkin" <mst@redhat.com>
To: Bagas Sanjaya <bagasdotme@gmail.com>
Cc: "Linux Kernel Mailing List" <linux-kernel@vger.kernel.org>,
"Linux AMDGPU" <amd-gfx@lists.freedesktop.org>,
"Linux DRI Development" <dri-devel@lists.freedesktop.org>,
"Linux Filesystems Development" <linux-fsdevel@vger.kernel.org>,
"Linux Media" <linux-media@vger.kernel.org>,
linaro-mm-sig@lists.linaro.org, kasan-dev@googlegroups.com,
"Linux Virtualization" <virtualization@lists.linux.dev>,
"Linux Memory Management List" <linux-mm@kvack.org>,
"Linux Network Bridge" <bridge@lists.linux.dev>,
"Linux Networking" <netdev@vger.kernel.org>,
"Harry Wentland" <harry.wentland@amd.com>,
"Leo Li" <sunpeng.li@amd.com>,
"Rodrigo Siqueira" <siqueira@igalia.com>,
"Alex Deucher" <alexander.deucher@amd.com>,
"Christian König" <christian.koenig@amd.com>,
"David Airlie" <airlied@gmail.com>,
"Simona Vetter" <simona@ffwll.ch>,
"Maarten Lankhorst" <maarten.lankhorst@linux.intel.com>,
"Maxime Ripard" <mripard@kernel.org>,
"Thomas Zimmermann" <tzimmermann@suse.de>,
"Matthew Brost" <matthew.brost@intel.com>,
"Danilo Krummrich" <dakr@kernel.org>,
"Philipp Stanner" <phasta@kernel.org>,
"Alexander Viro" <viro@zeniv.linux.org.uk>,
"Christian Brauner" <brauner@kernel.org>,
"Jan Kara" <jack@suse.cz>,
"Sumit Semwal" <sumit.semwal@linaro.org>,
"Alexander Potapenko" <glider@google.com>,
"Marco Elver" <elver@google.com>,
"Dmitry Vyukov" <dvyukov@google.com>,
"Jason Wang" <jasowang@redhat.com>,
"Xuan Zhuo" <xuanzhuo@linux.alibaba.com>,
"Eugenio Pérez" <eperezma@redhat.com>,
"Andrew Morton" <akpm@linux-foundation.org>,
"Uladzislau Rezki" <urezki@gmail.com>,
"Nikolay Aleksandrov" <razor@blackwall.org>,
"Ido Schimmel" <idosch@nvidia.com>,
"David S. Miller" <davem@davemloft.net>,
"Eric Dumazet" <edumazet@google.com>,
"Jakub Kicinski" <kuba@kernel.org>,
"Paolo Abeni" <pabeni@redhat.com>,
"Simon Horman" <horms@kernel.org>,
"Taimur Hassan" <Syed.Hassan@amd.com>,
"Wayne Lin" <Wayne.Lin@amd.com>, "Alex Hung" <alex.hung@amd.com>,
"Aurabindo Pillai" <aurabindo.pillai@amd.com>,
"Dillon Varone" <Dillon.Varone@amd.com>,
"George Shen" <george.shen@amd.com>,
"Aric Cyr" <aric.cyr@amd.com>,
"Cruise Hung" <Cruise.Hung@amd.com>,
"Mario Limonciello" <mario.limonciello@amd.com>,
"Sunil Khatri" <sunil.khatri@amd.com>,
"Dominik Kaszewski" <dominik.kaszewski@amd.com>,
"David Hildenbrand" <david@kernel.org>,
"Peter Zijlstra" <peterz@infradead.org>,
"Lorenzo Stoakes" <lorenzo.stoakes@oracle.com>,
"Max Kellermann" <max.kellermann@ionos.com>,
"Nysal Jan K.A." <nysal@linux.ibm.com>,
"Ryan Roberts" <ryan.roberts@arm.com>,
"Alexey Skidanov" <alexey.skidanov@intel.com>,
"Vlastimil Babka" <vbabka@suse.cz>,
"Kent Overstreet" <kent.overstreet@linux.dev>,
"Vitaly Wool" <vitaly.wool@konsulko.se>,
"Harry Yoo" <harry.yoo@oracle.com>,
"Mateusz Guzik" <mjguzik@gmail.com>, NeilBrown <neil@brown.name>,
"Amir Goldstein" <amir73il@gmail.com>,
"Jeff Layton" <jlayton@kernel.org>,
"Ivan Lipski" <ivan.lipski@amd.com>,
"Tao Zhou" <tao.zhou1@amd.com>,
"YiPeng Chai" <YiPeng.Chai@amd.com>,
"Hawking Zhang" <Hawking.Zhang@amd.com>,
"Lyude Paul" <lyude@redhat.com>,
"Daniel Almeida" <daniel.almeida@collabora.com>,
"Luben Tuikov" <luben.tuikov@amd.com>,
"Matthew Auld" <matthew.auld@intel.com>,
"Roopa Prabhu" <roopa@cumulusnetworks.com>,
"Mao Zhu" <zhumao001@208suo.com>,
"Shaomin Deng" <dengshaomin@cdjrlc.com>,
"Charles Han" <hanchunchao@inspur.com>,
"Jilin Yuan" <yuanjilin@cdjrlc.com>,
"Swaraj Gaikwad" <swarajgaikwad1925@gmail.com>,
"George Anthony Vernon" <contact@gvernon.com>
Subject: Re: [PATCH 06/14] virtio: Describe @map and @vmap members in virtio_device struct
Date: Mon, 15 Dec 2025 15:41:49 -0500 [thread overview]
Message-ID: <20251215154141-mutt-send-email-mst@kernel.org> (raw)
In-Reply-To: <20251215113903.46555-7-bagasdotme@gmail.com>
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@gmail.com>
Acked-by: Michael S. Tsirkin <mst@redhat.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
next prev parent reply other threads:[~2025-12-15 20:42 UTC|newest]
Thread overview: 24+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-12-15 11:38 [PATCH 00/14] Assorted kernel-doc fixes Bagas Sanjaya
2025-12-15 11:38 ` [PATCH 01/14] genalloc: Describe @start_addr parameter in genpool_algo_t Bagas Sanjaya
2025-12-15 11:38 ` [PATCH 02/14] mm: Describe @flags parameter in memalloc_flags_save() Bagas Sanjaya
2025-12-15 11:38 ` [PATCH 03/14] textsearch: Describe @list member in ts_ops search Bagas Sanjaya
2025-12-15 11:38 ` [PATCH 04/14] mm: vmalloc: Fix up vrealloc_node_align() kernel-doc macro name Bagas Sanjaya
2025-12-16 0:19 ` Vishal Moola (Oracle)
2025-12-15 11:38 ` [PATCH 05/14] mm, kfence: Describe @slab parameter in __kfence_obj_info() Bagas Sanjaya
2025-12-15 12:07 ` Marco Elver
2025-12-15 11:38 ` [PATCH 06/14] virtio: Describe @map and @vmap members in virtio_device struct Bagas Sanjaya
2025-12-15 20:41 ` Michael S. Tsirkin [this message]
2025-12-16 4:17 ` Jason Wang
2025-12-15 11:38 ` [PATCH 07/14] fs: Describe @isnew parameter in ilookup5_nowait() Bagas Sanjaya
2025-12-15 12:57 ` Jan Kara
2025-12-15 11:38 ` [PATCH 08/14] VFS: fix __start_dirop() kernel-doc warnings Bagas Sanjaya
2025-12-15 11:38 ` [PATCH 09/14] drm/amd/display: Don't use kernel-doc comment in dc_register_software_state struct Bagas Sanjaya
2025-12-16 15:21 ` [Linaro-mm-sig] " Alex Deucher
2025-12-15 11:38 ` [PATCH 10/14] drm/amdgpu: Describe @AMD_IP_BLOCK_TYPE_RAS in amd_ip_block_type enum Bagas Sanjaya
2025-12-16 15:20 ` Alex Deucher
2025-12-15 11:38 ` [PATCH 11/14] drm/gem/shmem: Describe @shmem and @size parameters Bagas Sanjaya
2025-12-15 11:39 ` [PATCH 12/14] drm/scheduler: Describe @result in drm_sched_job_done() Bagas Sanjaya
2025-12-15 12:24 ` Philipp Stanner
2025-12-15 11:39 ` [PATCH 13/14] drm/gpusvm: Fix drm_gpusvm_pages_valid_unlocked() kernel-doc comment Bagas Sanjaya
2025-12-15 11:39 ` [PATCH 14/14] net: bridge: Describe @tunnel_hash member in net_bridge_vlan_group struct Bagas Sanjaya
2025-12-16 8:10 ` Ido Schimmel
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20251215154141-mutt-send-email-mst@kernel.org \
--to=mst@redhat.com \
--cc=Cruise.Hung@amd.com \
--cc=Dillon.Varone@amd.com \
--cc=Hawking.Zhang@amd.com \
--cc=Syed.Hassan@amd.com \
--cc=Wayne.Lin@amd.com \
--cc=YiPeng.Chai@amd.com \
--cc=airlied@gmail.com \
--cc=akpm@linux-foundation.org \
--cc=alex.hung@amd.com \
--cc=alexander.deucher@amd.com \
--cc=alexey.skidanov@intel.com \
--cc=amd-gfx@lists.freedesktop.org \
--cc=amir73il@gmail.com \
--cc=aric.cyr@amd.com \
--cc=aurabindo.pillai@amd.com \
--cc=bagasdotme@gmail.com \
--cc=brauner@kernel.org \
--cc=bridge@lists.linux.dev \
--cc=christian.koenig@amd.com \
--cc=contact@gvernon.com \
--cc=dakr@kernel.org \
--cc=daniel.almeida@collabora.com \
--cc=davem@davemloft.net \
--cc=david@kernel.org \
--cc=dengshaomin@cdjrlc.com \
--cc=dominik.kaszewski@amd.com \
--cc=dri-devel@lists.freedesktop.org \
--cc=dvyukov@google.com \
--cc=edumazet@google.com \
--cc=elver@google.com \
--cc=eperezma@redhat.com \
--cc=george.shen@amd.com \
--cc=glider@google.com \
--cc=hanchunchao@inspur.com \
--cc=harry.wentland@amd.com \
--cc=harry.yoo@oracle.com \
--cc=horms@kernel.org \
--cc=idosch@nvidia.com \
--cc=ivan.lipski@amd.com \
--cc=jack@suse.cz \
--cc=jasowang@redhat.com \
--cc=jlayton@kernel.org \
--cc=kasan-dev@googlegroups.com \
--cc=kent.overstreet@linux.dev \
--cc=kuba@kernel.org \
--cc=linaro-mm-sig@lists.linaro.org \
--cc=linux-fsdevel@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-media@vger.kernel.org \
--cc=linux-mm@kvack.org \
--cc=lorenzo.stoakes@oracle.com \
--cc=luben.tuikov@amd.com \
--cc=lyude@redhat.com \
--cc=maarten.lankhorst@linux.intel.com \
--cc=mario.limonciello@amd.com \
--cc=matthew.auld@intel.com \
--cc=matthew.brost@intel.com \
--cc=max.kellermann@ionos.com \
--cc=mjguzik@gmail.com \
--cc=mripard@kernel.org \
--cc=neil@brown.name \
--cc=netdev@vger.kernel.org \
--cc=nysal@linux.ibm.com \
--cc=pabeni@redhat.com \
--cc=peterz@infradead.org \
--cc=phasta@kernel.org \
--cc=razor@blackwall.org \
--cc=roopa@cumulusnetworks.com \
--cc=ryan.roberts@arm.com \
--cc=simona@ffwll.ch \
--cc=siqueira@igalia.com \
--cc=sumit.semwal@linaro.org \
--cc=sunil.khatri@amd.com \
--cc=sunpeng.li@amd.com \
--cc=swarajgaikwad1925@gmail.com \
--cc=tao.zhou1@amd.com \
--cc=tzimmermann@suse.de \
--cc=urezki@gmail.com \
--cc=vbabka@suse.cz \
--cc=viro@zeniv.linux.org.uk \
--cc=virtualization@lists.linux.dev \
--cc=vitaly.wool@konsulko.se \
--cc=xuanzhuo@linux.alibaba.com \
--cc=yuanjilin@cdjrlc.com \
--cc=zhumao001@208suo.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).