From nobody Mon May 25 04:34:29 2026 Received: from mail-vk1-f182.google.com (mail-vk1-f182.google.com [209.85.221.182]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C8CC11A262A for ; Tue, 19 May 2026 01:35:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779154521; cv=none; b=h8jisq137j4Dl7Kef+/ZGfv4Lav1thXlqP9eZ4Zvb46t40XiL2Ri+UaNHdPIEjp/JJMf7esNhuqbpgARnW7tGdPuOXO72iM1fN5Fo8bKWbp2uITT0pSo28hQLIPsXT/Hmm0bAw9pEcuJfVRFcnUAGPqcTfakEDKNsEtZeFtbUsY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779154521; c=relaxed/simple; bh=KjMvZFjC6y4OcwTWkFYR1YeAONR7NN9MwUQVQd+2+tQ=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=FXtoVcvzKRYmKRlzlbVYu55wi3T7BWFgKaHnOB2E0QB6cVvuB51ub1Tl86owFcEqMsTv4Ub8dSXCcZ1ccl3WxbeZj8pIAdZx3v9bCujZ03C7cGEvLml0oBwWuQujxW2eHKs2tiC1lBnkObVZIzH0MPzl/2DZ+l6M0/dfesZjcbs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=ZMPbLx69; arc=none smtp.client-ip=209.85.221.182 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="ZMPbLx69" Received: by mail-vk1-f182.google.com with SMTP id 71dfb90a1353d-57754ec3462so1732280e0c.0 for ; Mon, 18 May 2026 18:35:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1779154519; x=1779759319; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=q1Fp7K7PG/nlHH3CiiWwzeRxFndoQ3kUzPeEfziqQvg=; b=ZMPbLx69HUTY2BHXA5wg0ffLVyLWSxVezKvdnMu2lenXGoe2RRifGnHSSu2v90h/yV +HZzYGKR+ZMmqETBfS8vhuxYhRtI8rTVlsVifH/+f85psvrIS+WNvjIZb+yhfvkNWlvH k8X7gOJHqxuxAuekchPLA2V+2ZpTPFvsFxVG/BVirDQ3B2SuvL0uGjepCIZc6rtvkCGu 1HopB4cmTPa3BcBBO4hTQRPIe4pgDE7CpVGHqVn5Vd7qC5v0VZO78tpHMxekOHtNtOVu wXLZAUtSAPcwpOwBnFIBxf9W4Azcw4E8pIJzRm/v3F8bo1gyX+kI64FG6xXkd4qqTfyG WM/w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1779154519; x=1779759319; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=q1Fp7K7PG/nlHH3CiiWwzeRxFndoQ3kUzPeEfziqQvg=; b=pFlbXql8+pIGf69ASWGIZlktC9o0rChle+j881SFlxuCy6GWGLzVTw3GRLYaM7lM1V HyBfIgTbsNCQHOkxRKIPkiVzosNtykNcsH0sDMZwBKSFxsC17SOtuFnuxNXgrlrOd00J mMn/2BJ6Q/zi8rIhfTZG5YA77IaYh3DmuvIVOM2LOTWSsJmA/8jQHPbFgb0W7LlVrFOv sopRgt8fYygJpgP2lVu+Wytavhsk1OrcHIdgiwSOgD3NtdSgRdu8UxrjPkDh3L1cgUc4 Q85hJJHhVEEQbcpMVRbl92oWux+pYVYtW+BjlH1PpvLgfZKPMd+QLVyodklkLrogBXPT G1jw== X-Forwarded-Encrypted: i=1; AFNElJ+2W4X+9svo+UxUL5tIFUeD0+mKIaSu3o7++Xai24fDvSol58u2NG7ZZM+wA872A0fL4cQYdKjGTiK2Cds=@vger.kernel.org X-Gm-Message-State: AOJu0YziOHqqIP0cuDW3MV1CQRbznl1gDlgbx/vTZhtIz6IAUUOtMG8j 6Lqwh97aM+QCwmH42dYl97Gt5nQndz5Yb8sWUCd3a4XIGVlJRiLwiakF X-Gm-Gg: Acq92OG5OhSGkBL8nsr+np/wEUCzZ7PUXI1Us4Mk8uoLYvOCQYVw0lisEdvmtncNoJ3 ZorqixAsOihEsXGKagQPoV7+xtusubMQdF1TL31cBYPDw4nVu3qTZbpaOnvFc6HFY3R8dl3R7xu ben2L/LCWBICPA9NARujL9We9csqNE4sWx/45aSQkhUPjTLxhVL/6N3dakBi9dOeuG5kaUt6f7m p9v/+nw5GIeMAYvJGSR4eRt14OmYSoOck5k7wf+SOUkSBpB4x/8fk2EI608N9hRNNFkI9FTNPVw K4D3ln354Hsa7ZtH72yzR35CM29ZJw/KNoNv7x0KvLjszKbfTtAL0j7RM0Iai8DuXK1UP4LWj4P ZBeswni8DOisoTu0XGipvxtTnIgzeQ39M2TeOv0n4ULyTzRp8FiNEs46oad1bF2FQfKnpEboegZ C2FIVQ+eU/ujz05vEUyZF+FUuKxBzu10EMdE0= X-Received: by 2002:a05:6122:2407:b0:56b:7d4d:4d11 with SMTP id 71dfb90a1353d-5760be39b7bmr9653912e0c.1.1779154518848; Mon, 18 May 2026 18:35:18 -0700 (PDT) Received: from fedora ([107.145.254.161]) by smtp.gmail.com with ESMTPSA id 71dfb90a1353d-5760fadc1dasm7151886e0c.16.2026.05.18.18.35.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 18 May 2026 18:35:17 -0700 (PDT) From: Christian Fontanez To: "Michael S. Tsirkin" , Jason Wang , Xuan Zhuo , =?UTF-8?q?Eugenio=20P=C3=A9rez?= Cc: skhan@linuxfoundation.org, luis.hernandez093@gmail.com, rbm@suse.com, Christian Fontanez , virtualization@lists.linux.dev, linux-kernel@vger.kernel.org Subject: [PATCH] virtio: add missing kernel-doc for map and vmap members Date: Mon, 18 May 2026 21:33:20 -0400 Message-ID: <20260519013321.32511-1-christfontanez@gmail.com> X-Mailer: git-send-email 2.54.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Commit bee8c7c24b73 ("virtio: introduce map ops in virtio core") and commit b16060c5c7d5 ("virtio: introduce virtio_map container union") added 'map' and 'vmap' members to struct virtio_device but did not update the kernel-doc comment block. This caused 'make htmldocs' to emit warnings: ./include/linux/virtio.h:188 struct member 'map' not described in 'virtio= _device' ./include/linux/virtio.h:188 struct member 'vmap' not described in 'virti= o_device' Add the missing entries in struct-declaration order to match the existing convention in the file. After this patch, 'make htmldocs' no longer emits these warnings. Fixes: bee8c7c24b73 ("virtio: introduce map ops in virtio core") Fixes: b16060c5c7d5 ("virtio: introduce virtio_map container union") Reported-by: Luis Felipe Hernandez Signed-off-by: Christian Fontanez --- Notes for reviewers: - Tested with 'make htmldocs' on linux-next (next-20260518); the two warnings on include/linux/virtio.h:188 are gone, with no new warnings introduced. - Based on linux-next/master at commit 80dd246accce ("Add linux-next specific files for 20260518"). include/linux/virtio.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/include/linux/virtio.h b/include/linux/virtio.h index 3bbc4cb6a672..bf089e51970e 100644 --- a/include/linux/virtio.h +++ b/include/linux/virtio.h @@ -157,11 +157,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: the map operations for mapping virtio device memory. * @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: the map container with transport- or device-specific metadata. * @debugfs_dir: debugfs directory entry. * @debugfs_filter_features: features to be filtered set by debugfs. */ -- 2.54.0