From 370ec54e2168a6fe61a500461a3eb95274531e18 Mon Sep 17 00:00:00 2001
From: Panu Matilainen <pmatilai@redhat.com>
Date: Mon, 25 Jan 2021 16:39:51 +0200
Subject: [PATCH] Document rpm API thread (un-)safety

Fixes: #1483
---
 doc/librpm/Doxyheader.h | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/librpm/Doxyheader.h b/doc/librpm/Doxyheader.h
index f26227eecd..ef8a03e77e 100644
--- a/doc/librpm/Doxyheader.h
+++ b/doc/librpm/Doxyheader.h
@@ -8,6 +8,14 @@
     - \link rpmtd	querying \endlink,
     - or \link rpmts	(un)installing \endlink RPM packages.
 
+    Thread-safety: in general, data and object-like elements in the rpm
+    API are only safe to be accessed and disposed of from the originating
+    thread. Some central resources have rudimentary protection to support
+    concurrent access though:
+    - rpm configuration and macros
+    - rpmlog subsystem
+    - rpm string pool objects
+    - rpm keyring and public keys
  */
 /** \defgroup buildsign Building & signing packages:
  *