From nobody Sat Feb 7 17:20:16 2026 Received: from mail-oa1-f43.google.com (mail-oa1-f43.google.com [209.85.160.43]) (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 A33AE153BE9 for ; Fri, 19 Dec 2025 05:19:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.160.43 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766121590; cv=none; b=tnXHVaYLXYDUlBacdR8xbShvvdJSsBFbp366GdsY6dTk1Sky+qpGQYQrpktiCejpPqOXZU0tHdHXaQFM6fXznQXyWB52mI5YKqoTinc0NvB+ITKojyx6itcyyHmq82KhUJyGDI2/nuduACnUW+H7CJ2TPoksMgUyIfQ/QIoMUo8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766121590; c=relaxed/simple; bh=Gv85btUjugFXTHwUwePB/9qVQ9Hx7+oyROqNjqEtnwc=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=R3GKadfMg00wn4MKVLCaYryWV8v7PA7JFjnYFTVpBfVzFbFgKy4/hLFPEGqKi1HLneoMGhIZ7PgviZm/EJH+VEgIKVbm8558gHKVsDBcw/BkhleP3BQyT1w/JZsEvz2f8mNw8FDM2DiFvHIQctC5zAizlaNZtb90VnQ3nKd65JM= 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=V2FYgr96; arc=none smtp.client-ip=209.85.160.43 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="V2FYgr96" Received: by mail-oa1-f43.google.com with SMTP id 586e51a60fabf-3ec3cdcda4eso1065894fac.1 for ; Thu, 18 Dec 2025 21:19:47 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1766121586; x=1766726386; 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=wjQdGAmN4N+e1fEd/c98w7+FBrt2fHW/7wWBacKGb2Q=; b=V2FYgr96IzAa+5/3XTOZuoccrv6tSjnqv6TSXo9NdzU3G2S2fmoqGh6RIFxwG7Rvhl pa0D8UljvUhUQpczx4iMiskjy5oRbpcF22XHSkZIFok1JiVKu510UZ9TZqnQ6p8R27+T FwHij28h6dCG9116KUX3QLPdLVD9adaS2cFHrp7zgzl9CWNdckP582+ZW5Vc4ZxURPi4 Bm7TiNRLXh+saigdAairmbApf7vSqxRPAG0jUbjasnXWlUN6hh9e4PI75uYqeM8bdZkI AR1FoLdtFuGwtDJFB7xY5wzK0XhI3q3uG9qv3geVO8gvRyROWIcoEQKjXNpn6FHrnIMo Jurw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1766121586; x=1766726386; 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=wjQdGAmN4N+e1fEd/c98w7+FBrt2fHW/7wWBacKGb2Q=; b=C3ugiVaY8NLF2DzPGGt3nojs8R3UE/AHbW29JNzTjBmPs7uZ/G+mWKpsbsUjGJXqRv Lvk4+lGgtdmcDIM8vPzuG3zj2F7KaLF87PQLeg6uJ/ZLvqsD0iX/31WkcdFWUX4gfpDl mgjx3AVNrWNE1pnCHYgvVhhnMqqwCA/oVoOm/F3+86a3r/YYZLrn98B8cOVlBivng5A1 9nZBaX33manIPPkS3UBywBRJeFmVl50IA1Z502OKxClQrm74UlTYHE5rcIwEPoWfg4UG 5zUM8Fftzm9JSnFAWf+PC3nGhAdZGeLydu2IjT0LQuqwJW+bqdQItjbVM2s7TZxTQ2vC WCtw== X-Gm-Message-State: AOJu0YzFNQzBy8ME7Es1JCuhOEYA16KCI5BE3N40cjxa/egPJWcFSwSV ky5uPtBLz4Gqn4+ZpV7sMsfSw928iB994QFpZ/f57zkgI6oIrZGbq6eN6pkXeAe8 X-Gm-Gg: AY/fxX575Cls5dXEzClNiO27tXSBfaVvNtHumPBKtT7ZJp2u5bE5Tw+jpDjWcvuGk/B Dj5kI5BKB5Nj9As6lG+UKkvst1VxSPA1h5z1fCRlmfL0QsCl0sM0NW8RqkzLxfLC1C7rG/1cQ74 aNFM1L3S1VwwNzsVad7HvbYENuX0YybAbQ3wfKDm1ZFP1lbl+Zr8NoaZkUqoIn79xZmULafM1B0 yQYMMsWkV4FjBP+9sCDldBx+Mnv1UzzG+1nkPLo3sYEf3s1Qhvlb2bEarAl6G3D1c54GBn9rp4k cBvc6mdF7HTQp9Ad6W1wAQEYSUjST8I5VFx5Cmxz/cPtf2WxwAXvgv2YlcmyKM+0hb+r+mIiKP7 v9GT7aQ+7JfCpssz3cp6F9oSIQt/f3o7hyyWWC/uoSdORF0llPLlajmi7QYbIuTNyRAKrC6pD31 AcIElY6z1aX50= X-Google-Smtp-Source: AGHT+IHTyW9c4eUV4UjKBsyVRBnECyP4QSFZiarCr76+3j0lVsYzghfGx1wTeaOuelDxS3SZVqkPrw== X-Received: by 2002:a05:6a00:a90a:b0:7e8:4587:e8d3 with SMTP id d2e1a72fcca58-7ff66a6ecd2mr1389456b3a.70.1766114222208; Thu, 18 Dec 2025 19:17:02 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7ff7e48f258sm702078b3a.47.2025.12.18.19.17.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 18 Dec 2025 19:17:01 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id 97F8B420A9C8; Fri, 19 Dec 2025 10:16:59 +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 v2] virtio: Describe @map and @vmap members in virtio_device struct Date: Fri, 19 Dec 2025 10:16:47 +0700 Message-ID: <20251219031647.25264-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=1823; i=bagasdotme@gmail.com; s=Zp7juWIhw0R1; h=from:subject; bh=Gv85btUjugFXTHwUwePB/9qVQ9Hx7+oyROqNjqEtnwc=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJkuh8033zbxzJvsYSyyUmCnb+jXRqENGfJrrTRulSs5y fLtbzXqKGVhEONikBVTZJmUyNd0epeRyIX2tY4wc1iZQIYwcHEKwEQOfmP4n37nxbojC8J1k45/ 6Do2b+4x3zzPRyqbve7uOHRizZq0ShZGhvveCrF6Cb/n+Mdtt928fvXn+dz7DPaFiypmMslu2Sp 5kxcA 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 --- This patch is split from kernel-doc fixup series [1]. Changes since v1 [2]: - Apply review trailers (Michael, Jason) [1]: https://lore.kernel.org/lkml/20251215113903.46555-1-bagasdotme@gmail.c= om/ [2]: https://lore.kernel.org/lkml/20251215113903.46555-7-bagasdotme@gmail.c= om/ 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. */ base-commit: ea1013c1539270e372fc99854bc6e4d94eaeff66 --=20 An old man doll... just what I always wanted! - Clara