[PATCH] balloon: fix PAGE_POISON feature bit description

"Michael S. Tsirkin" <[email protected]> Wed, 22 Apr 2026 12:12:32 -0400
Newsgroups dev.linux.lists.virtio-comment
Message-ID <e7c84a6828472d383984ccc26af1119f4a94a0f0.1776874350.git.mst@redhat.com>
The short description only mentions deflation, but poison_val
also governs page reporting. It also calls itself a "hint"
despite the driver normative having MUST statements. Fix both.

Fixes: https://github.com/oasis-tcs/virtio-spec/issues/240
Signed-off-by: Michael S. Tsirkin <[email protected]>
---
 device-types/balloon/description.tex | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/device-types/balloon/description.tex b/device-types/balloon/description.tex
index a1d9603..e7b957c 100644
--- a/device-types/balloon/description.tex
+++ b/device-types/balloon/description.tex
@@ -43,8 +43,8 @@ \subsection{Feature bits}\label{sec:Device Types / Memory Balloon Device / Featu
     page hinting. A virtqueue for providing hints as to what memory is
     currently free is present. Configuration field \field{free_page_hint_cmd_id}
     is valid.
-\item[ VIRTIO_BALLOON_F_PAGE_POISON(4) ] A hint to the device, that the driver
-    will immediately write \field{poison_val} to pages after deflating them.
+\item[ VIRTIO_BALLOON_F_PAGE_POISON(4) ] The driver initializes
+    deflated and reported pages with \field{poison_val}.
     Configuration field \field{poison_val} is valid.
 \item[ VIRTIO_BALLOON_F_PAGE_REPORTING(5) ] The device has support for free
     page reporting. A virtqueue for reporting free guest memory is present.
-- 
MST