summaryrefslogtreecommitdiffstats
path: root/man/threads-aware.xml
diff options
context:
space:
mode:
Diffstat (limited to 'man/threads-aware.xml')
-rw-r--r--man/threads-aware.xml15
1 files changed, 15 insertions, 0 deletions
diff --git a/man/threads-aware.xml b/man/threads-aware.xml
new file mode 100644
index 0000000..fb38d07
--- /dev/null
+++ b/man/threads-aware.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
+
+<refsect1>
+
+<para id="strict">All functions listed here are thread-agnostic and only a single specific thread may operate on a
+given object during its entire lifetime. It's safe to allocate multiple independent objects and use each from a
+specific thread in parallel. However, it's not safe to allocate such an object in one thread, and operate or free it
+from any other, even if locking is used to ensure these threads don't operate on it at the very same time.</para>
+
+<para id="safe">All functions listed here are thread-safe and may be called in parallel from multiple threads.</para>
+
+</refsect1>