[PATCH] docs/specs/pvpanic: document shutdown event

[Thomas Weißschuh]

Shutdown requests are normally hardware dependent.
By extending pvpanic to also handle shutdown requests, guests can
submit such requests with an easily implementable and cross-platform
mechanism.

Signed-off-by: Thomas Weißschuh <thomas@t-8ch.de>
---
This patch was split out from my earlier pvpanic-shutdown series [0].
The original series dropped the usage of the linux/pvpanic.h UAPI
header.
As we decided to keep the linux header [1] this first commit only adds
the spec definition.
Then a patch to Linux will add the new events to linux/pvpanic.h.
After this the rest of the changes to QEMU will be submitted again.

[0] 
https://lore.kernel.org/qemu-devel/20240208-pvpanic-shutdown-v6-0-965580ac057b@t-8ch.de/
[1] https://lore.kernel.org/lkml/20240213053953-mutt-send-email-mst@kernel.org/
---
 docs/specs/pvpanic.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/specs/pvpanic.rst b/docs/specs/pvpanic.rst
index f894bc19555f..61a80480edb8 100644
--- a/docs/specs/pvpanic.rst
+++ b/docs/specs/pvpanic.rst
@@ -29,6 +29,8 @@ bit 1
   a guest panic has happened and will be handled by the guest;
   the host should record it or report it, but should not affect
   the execution of the guest.
+bit 2
+  a regular guest shutdown has happened and should be processed by the host
 
 PCI Interface
 -------------

---
base-commit: f901bf11b3ddf852e591593b09b8aa7a177f9a0b
change-id: 20240310-pvpanic-shutdown-spec-4ea2172529e8

Best regards,
-- 
Thomas Weißschuh <thomas@t-8ch.de>