summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDemi Marie Obenour <demiobenour@gmail.com>2022-10-15 15:56:32 -0400
committerJonas Ådahl <jadahl@gmail.com>2022-11-04 15:22:22 +0000
commit9238fd2224d8c1d595e02fbd6b77b98ed1c3a19d (patch)
treea64edf338a67a910f5c7179d474126ed600f6599
parentcec292a65371d20fe52e7dcd1d4a5dec2bc7032d (diff)
downloadwayland-protocols-9238fd2224d8c1d595e02fbd6b77b98ed1c3a19d.tar.gz
Add xdg-shell.unresponsive error
This allows compositors to disconnect clients that have been deemed unresponsive. Signed-off-by: Demi Marie Obenour <demiobenour@gmail.com>
-rw-r--r--stable/xdg-shell/xdg-shell.xml9
1 files changed, 7 insertions, 2 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index f815b9a..d01175d 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -50,6 +50,8 @@
summary="the client provided an invalid surface state"/>
<entry name="invalid_positioner" value="5"
summary="the client provided an invalid positioner"/>
+ <entry name="unresponsive" value="6"
+ summary="the client didn’t respond to a ping event in time"/>
</enum>
<request name="destroy" type="destructor">
@@ -94,7 +96,8 @@
<request name="pong">
<description summary="respond to a ping event">
A client must respond to a ping event with a pong request or
- the client may be deemed unresponsive. See xdg_wm_base.ping.
+ the client may be deemed unresponsive. See xdg_wm_base.ping
+ and xdg_wm_base.error.unresponsive.
</description>
<arg name="serial" type="uint" summary="serial of the ping event"/>
</request>
@@ -108,7 +111,9 @@
Compositors can use this to determine if the client is still
alive. It's unspecified what will happen if the client doesn't
respond to the ping request, or in what timeframe. Clients should
- try to respond in a reasonable amount of time.
+ try to respond in a reasonable amount of time. The “unresponsive”
+ error is provided for compositors that wish to disconnect unresponsive
+ clients.
A compositor is free to ping in any way it wants, but a client must
always respond to any xdg_wm_base object it created.