From aabd66686423649a956093fc54d15d94a7a786fd Mon Sep 17 00:00:00 2001 From: Julian Orth Date: Tue, 10 Sep 2024 12:31:12 +0200 Subject: [PATCH] protocol: document surface synchronization requirements This clarification, in conjunction with [egl] and [vulkan], informs clients about synchronization requirements in multi-threaded applications. [egl]: https://github.com/KhronosGroup/EGL-Registry/pull/205 [vulkan]: https://docs.vulkan.org/spec/latest/chapters/VK_KHR_surface/wsi.html#platformCreateSurface_wayland Signed-off-by: Julian Orth --- protocol/wayland.xml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/protocol/wayland.xml b/protocol/wayland.xml index 3b279a0b..aa8ec19d 100644 --- a/protocol/wayland.xml +++ b/protocol/wayland.xml @@ -1679,6 +1679,11 @@ to affect double-buffered state. Other interfaces may add further double-buffered surface state. + + Clients must ensure that the double-buffered state is consistent when + making this request. The consistency requirements are documented by + requests that manipulate the state. Therefore, clients must use external + synchronization whenever they manipulate or commit the state.