From nobody Sat Feb 7 17:41:53 2026 Received: from mail-pl1-f169.google.com (mail-pl1-f169.google.com [209.85.214.169]) (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 6BEFA23645D for ; Mon, 29 Dec 2025 01:55:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.169 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766973310; cv=none; b=aCrcmetujKAF240lmaPCAGuzxVeQXpW76afGt/7uOYA4QPfIeyVukP39QHAJMQVKg5gISXSL0le6gMstO2GxddM07UhhCkO1tQAw0Z6VF+7d55qiYDxm4ftO+XhdsRXdS4P9I9tta4nNhHRjRoxy9X5QDgR4xhxxNuEnU3w0FGw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766973310; c=relaxed/simple; bh=vyEgeMf2uqW5VB4nieLxhnduvrdLalTDDvg+5iSNH2M=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=G+HxauYQVFCQdj3+o2RKY0GF01vnqoveNw57H34qcul01AXmSp4AK0dd5RswK/k/p1jSxhPIYZfzFwdSdCF0K40jrGCXPsIxCakqc6I9uiAW5tzc7AduteLtCL7T0cCWb8ISGo9iy86ET72lVpqGg32urn3Ssg+O2jSe5D247Vg= 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=bsnl609L; arc=none smtp.client-ip=209.85.214.169 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="bsnl609L" Received: by mail-pl1-f169.google.com with SMTP id d9443c01a7336-2a1022dda33so70079955ad.2 for ; Sun, 28 Dec 2025 17:55:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1766973306; x=1767578106; 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=tNbndnUAKE4QFtio3tegbJFEwnl00q7Bud+tWf5WcZY=; b=bsnl609LPtbXCdzUJC/i9svrKxQluKiPrSEUQt76qRXLCTmECShNwUuExH1EmAFSU7 wiTnVVx3t6t2LEWW0+TGFlSxr3bJWbHSptbVfhg5763jq69MHKq56Yh01kjHpfpMkLSz 7HEgAMUe/nj8fmTb1lCl9f8T8gr35vCsnTuXAbxcb00SuEKwMrS2ujtE+8ltmOYgyr79 lrvXaw2hBhfNFW4G73RY7+zjtvaInoHrHXp2T0LTC7Jjj/nxOO2GXIfJKKVa4IxeD3gF 83IuItbAqyQ/DhCx+5xDkEGhG6H2iPxJwUugK0ezUmbbeYSIbbntpYq+0csa20AdERZv Kehw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1766973306; x=1767578106; 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=tNbndnUAKE4QFtio3tegbJFEwnl00q7Bud+tWf5WcZY=; b=nmmE6rXavnrWQwLxKGbzlS36vmwAex9GSTzRywNTWuheNsE65glAmOpEdiZa5jCgwN imozrrmzEtgydbD6LyngiotDtYPv5sAPT2ECzXHjhZOiewTLYi2Kz06GuWHu+ahvzG5d TlftpzD4wNMx1rlfGcDhUDW4f2JD0V+9aiK465DhhgTE7hg/LdzqNMYQJApk6YNheUgM EOEgxMQMZhlhx/osW4B2qN9WqZQF17n72i2mFdVEkGh9tkIGZVx/Bs/T726O/8K4cG5j muc7cU7lvyVvu2i68Tgnvn39Q/GT1M7es1RvusdLPs46jHLQMRW+asG+29ferIwWyDmA VDoA== X-Gm-Message-State: AOJu0YwDt12r93QWJmpUR1sehM9GyJj/4rOuD7BMTSTC0pX0whMfw4KV C5cPRsYecXfLuh6V3W0cROngg33lfhJDfBfjPDEFSrqwd+AUe0L5uKtZ X-Gm-Gg: AY/fxX6L9vB0XC4qD0sMRjVCE+hp6xVJYQOoevaKpX8Bm3f2FSloKylaTHjpS5r8zZj r2CKGFnK2xla85vYveeAbihX9r+3RUT6qnIXsZ/Kg7Bb4fXRGM+DYH6A0214g+wnWEANvGZ3dkz GrYTZRzKKB2oMixnxOTnBbNotigTTyoWgjHF9mlwfMJtSHUdvqwREwYaibRGLEfKpkkt40PrGGG Ilq/evPWIHFe7j5dFjNEI+mAVuc8rohoAPr81soIhPuIYDJHWcvNqcBjwyrq4IAAZILWRJmU7OY JV2KCZDUHaIbP3ayD4OFlo4McG2LRzWX+eJ7s8I30LgnBq8RkymPq4lIi22qUU6tCmBsqMvmq20 7o9KggAyLKCNI7UYtzz6mit8NlHYfNPTDoHEI/XDsvTTbKRjoQLE5L1fd6P9A3eX5AwwrxZBTfR ZryBb7dlDeVzUp6y1mQrYuUQ== X-Google-Smtp-Source: AGHT+IFAqNAOcyp8GZerwdObBMUWzzrN3MMt05y3VVk/QtXfyYzfKPsqF5Z6S83WeUvHVLk6oiTyww== X-Received: by 2002:a17:903:2cd:b0:2a0:e532:242e with SMTP id d9443c01a7336-2a2f220dd7bmr273277345ad.11.1766973306503; Sun, 28 Dec 2025 17:55:06 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2a2f3c667cesm261043605ad.18.2025.12.28.17.55.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 28 Dec 2025 17:55:05 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id B27EA42A31AA; Mon, 29 Dec 2025 08:54:45 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Virtualization Cc: "Michael S. Tsirkin" , Jason Wang , Xuan Zhuo , =?UTF-8?q?Eugenio=20P=C3=A9rez?= , Bagas Sanjaya Subject: [PATCH v3] virtio: Describe @map and @vmap members in virtio_device struct Date: Mon, 29 Dec 2025 08:54:24 +0700 Message-ID: <20251229015424.16060-1-bagasdotme@gmail.com> X-Mailer: git-send-email 2.52.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1718; i=bagasdotme@gmail.com; s=Zp7juWIhw0R1; h=from:subject; bh=vyEgeMf2uqW5VB4nieLxhnduvrdLalTDDvg+5iSNH2M=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJmBd0891tU71zT1aOSXwH/yryYxa/W1tX1h3Heq9pJus oVwjYRnRykLgxgXg6yYIsukRL6m07uMRC60r3WEmcPKBDKEgYtTACbi0cnwv2bT7SfPT2scj89y uXjJmfUv/4pqpSr71n2q+2Q85TscAxj+B/+P2XpqexNb9DX9K5xLRaYYxNwz1T/dc7w2987Mlx8 U2QE= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" 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") Acked-by: Michael S. Tsirkin Acked-by: Jason Wang Signed-off-by: Bagas Sanjaya --- Changes since v2 [1]: - Apply wording suggestions (Michael) [1]: https://lore.kernel.org/virtualization/20251219031647.25264-1-bagasdot= me@gmail.com/ include/linux/virtio.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/include/linux/virtio.h b/include/linux/virtio.h index 3626eb6947282a..48b88c149eca43 100644 --- a/include/linux/virtio.h +++ b/include/linux/virtio.h @@ -152,11 +152,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: operations for mapping buffer for a virtio device. * @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/domain used for mapping memory. * @debugfs_dir: debugfs directory entry. * @debugfs_filter_features: features to be filtered set by debugfs. */ base-commit: f8f9c1f4d0c7a64600e2ca312dec824a0bc2f1da --=20 An old man doll... just what I always wanted! - Clara