X-Git-Url: https://git.liburcu.org/?p=urcu.git;a=blobdiff_plain;f=urcu%2Ftls-compat.h;fp=urcu%2Ftls-compat.h;h=2f4023258c2cf658da196090a68d5757cc617753;hp=192a53609fb5f6bc445f98fdd6bc26918126687e;hb=fa320ad0278a5e2ab4bfa837ffccfadcdaac4166;hpb=88ecbe6daa6da4850ea975b635cd1af8e4ca9bfe

diff --git a/urcu/tls-compat.h b/urcu/tls-compat.h
index 192a536..2f40232 100644
--- a/urcu/tls-compat.h
+++ b/urcu/tls-compat.h
@@ -47,6 +47,18 @@ extern "C" {
  * Another exmaple:
  * 	typedef void (*call_rcu_flavor)(struct rcu_head *, XXXX);
  * 	DECLARE_URCU_TLS(call_rcu_flavor, p_call_rcu);
+ *
+ * NOTE: URCU_TLS() is NOT async-signal-safe, you can't use it
+ * inside any function which can be called from signal handler.
+ *
+ * But if pthread_getspecific() is async-signal-safe in your
+ * platform, you can make URCU_TLS() async-signal-safe via:
+ * ensuring the first call to URCU_TLS() of a given TLS variable of
+ * all threads is called earliest from a non-signal handler function.
+ *
+ * Example: In any thread, the first call of URCU_TLS(rcu_reader)
+ * is called from rcu_register_thread(), so we can ensure all later
+ * URCU_TLS(rcu_reader) in any thread is async-signal-safe.
  */
 
 # define DECLARE_URCU_TLS(type, name)	\