---
 docs/spice_protocol.txt | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/docs/spice_protocol.txt b/docs/spice_protocol.txt
index fc795bb7..248bd676 100644
--- a/docs/spice_protocol.txt
+++ b/docs/spice_protocol.txt
@@ -129,6 +129,7 @@ SPICE_CHANNEL_SMARTCARD     = 8
 SPICE_CHANNEL_USBREDIR = 9
 SPICE_CHANNEL_PORT             = 10
 SPICE_CHANNEL_WEBDAV   = 11
+SPICE_CHANNEL_POWER            = 12
 ----
 +
 . Error codes UINT32
@@ -2728,3 +2729,37 @@ order to allow the client to send recorded packets in 
OPUS format.
 . SPICE_MSG_RECORD_STOP, VOID
 +
 Stop current audio capture
+
+== Power Channel definition
+
+Spice has basic support for power-control, limited to general actions.
+Spice server announce general support to clients by providing a power channel.
+Additionally Spice server announces support for each action using the 
respective
+capability. Spice clients can use the capabilities to enable the respective UI
+elements, limiting users to the supported ones. An action can be triggered by
+sending the appropriate message from the Spice client to the server, which will
+execute it; and in the case of an error respond with a SPICE_MSG_NOTIFY.
+Reset is the equivalent of pressing the "Reset" button on a normal (hardware) 
pc,
+resetting it to its initial state and booting up again. Poweroff is the 
equivalent
+of pulling the power-plug, forcing it to turn off.
+
+. Server messages
++
+None.
++
+. Client messages
++
+[source,c]
+----
+SPICE_MSGC_POWER_RESET                 = 101
+SPICE_MSGC_POWER_POWEROFF      = 102
+----
++
+. Power channel capabilities
++
+[source,c]
+----
+SPICE_POWER_CAP_RESET          = 1
+SPICE_POWER_CAP_POWEROFF       = 2
+----
++
-- 
2.52.0

Reply via email to