dri-devel.lists.freedesktop.org archive mirror
 help / color / mirror / Atom feed
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


  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).