From 1736ef65701d915cb5c4c7e489d35da4df47b58e Mon Sep 17 00:00:00 2001 From: Axel Davy Date: Mon, 19 Dec 2016 19:51:13 +0100 Subject: [PATCH] gallium-docs: Add documentation for threading requirements MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add documentation for the requirements related to threading for screens and contexts. Signed-off-by: Axel Davy Reviewed-by: Marek Olšák --- src/gallium/docs/source/screen.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/src/gallium/docs/source/screen.rst b/src/gallium/docs/source/screen.rst index 7ac39ffc44f..86aa2591abe 100644 --- a/src/gallium/docs/source/screen.rst +++ b/src/gallium/docs/source/screen.rst @@ -737,3 +737,13 @@ query group at the specified **index** is returned in **info**. The function returns non-zero on success. The driver-specific query group is described with the pipe_driver_query_group_info structure. + + +Thread safety +------------- + +Screen methods are required to be thread safe. While gallium rendering +contexts are not required to be thread safe, it is required to be safe to use +different contexts created with the same screen in different threads without +locks. It is also required to be safe using screen methods in a thread, while +using one of its contexts in another (without locks).