aboutsummaryrefslogtreecommitdiff
path: root/protocol
diff options
context:
space:
mode:
authorIsaac Freund <mail@isaacfreund.com>2022-06-30 14:01:46 +0200
committerSimon Ser <contact@emersion.fr>2022-08-24 14:10:23 +0000
commit4c1afb126b9a49aee367276f634f8686428d6147 (patch)
treeff7477db2a8ec16514aafe08c301fba4c173280f /protocol
parentd3cb6b73a2733d8457a8be2593a42942b36b77e2 (diff)
wlr-output-management: Implement version 3 release requests
Head/mode resources older than version 3 and lacking a release request are intentionally leaked as this is the only way to fix the race. Implements: https://gitlab.freedesktop.org/wlroots/wlr-protocols/-/merge_requests/114
Diffstat (limited to 'protocol')
-rw-r--r--protocol/wlr-output-management-unstable-v1.xml47
1 files changed, 33 insertions, 14 deletions
diff --git a/protocol/wlr-output-management-unstable-v1.xml b/protocol/wlr-output-management-unstable-v1.xml
index cadc45fb..3568e04c 100644
--- a/protocol/wlr-output-management-unstable-v1.xml
+++ b/protocol/wlr-output-management-unstable-v1.xml
@@ -39,7 +39,7 @@
interface version number is reset.
</description>
- <interface name="zwlr_output_manager_v1" version="2">
+ <interface name="zwlr_output_manager_v1" version="3">
<description summary="output device configuration manager">
This interface is a manager that allows reading and writing the current
output device configuration.
@@ -115,7 +115,7 @@
</description>
</request>
- <event name="finished">
+ <event name="finished" type="destructor">
<description summary="the compositor has finished with the manager">
This event indicates that the compositor is done sending manager events.
The compositor will destroy the object immediately after sending this
@@ -125,7 +125,7 @@
</event>
</interface>
- <interface name="zwlr_output_head_v1" version="2">
+ <interface name="zwlr_output_head_v1" version="3">
<description summary="output device">
A head is an output device. The difference between a wl_output object and
a head is that heads are advertised even if they are turned off. A head
@@ -251,14 +251,15 @@
</event>
<event name="finished">
- <description summary="the head has been destroyed">
- The compositor will destroy the object immediately after sending this
- event, so it will become invalid and the client should release any
- resources associated with it.
+ <description summary="the head has disappeared">
+ This event indicates that the head is no longer available. The head
+ object becomes inert. Clients should send a destroy request and release
+ any resources associated with it.
</description>
</event>
<!-- Version 2 additions -->
+
<event name="make" since="2">
<description summary="head manufacturer">
This event describes the manufacturer of the head.
@@ -328,9 +329,18 @@
</description>
<arg name="serial_number" type="string"/>
</event>
+
+ <!-- Version 3 additions -->
+
+ <request name="release" type="destructor" since="3">
+ <description summary="destroy the head object">
+ This request indicates that the client will no longer use this head
+ object.
+ </description>
+ </request>
</interface>
- <interface name="zwlr_output_mode_v1" version="2">
+ <interface name="zwlr_output_mode_v1" version="3">
<description summary="output mode">
This object describes an output mode.
@@ -368,15 +378,24 @@
</event>
<event name="finished">
- <description summary="the mode has been destroyed">
- The compositor will destroy the object immediately after sending this
- event, so it will become invalid and the client should release any
- resources associated with it.
+ <description summary="the mode has disappeared">
+ This event indicates that the mode is no longer available. The mode
+ object becomes inert. Clients should send a destroy request and release
+ any resources associated with it.
</description>
</event>
+
+ <!-- Version 3 additions -->
+
+ <request name="release" type="destructor" since="3">
+ <description summary="destroy the mode object">
+ This request indicates that the client will no longer use this mode
+ object.
+ </description>
+ </request>
</interface>
- <interface name="zwlr_output_configuration_v1" version="2">
+ <interface name="zwlr_output_configuration_v1" version="3">
<description summary="output configuration">
This object is used by the client to describe a full output configuration.
@@ -494,7 +513,7 @@
</request>
</interface>
- <interface name="zwlr_output_configuration_head_v1" version="2">
+ <interface name="zwlr_output_configuration_head_v1" version="3">
<description summary="head configuration">
This object is used by the client to update a single head's configuration.