[Valgrind-developers] [valgrind] Doc: add item on tcmalloc >= 2.16 hangs to FAQ

[Paul F. <pa...@so...>]

https://sourceware.org/cgit/valgrind/commit/?id=b5c89ee9839a356248e7fc8f406d7ef888d76076

commit b5c89ee9839a356248e7fc8f406d7ef888d76076
Author: Paul Floyd <pj...@wa...>
Date:   Sun Sep 21 20:53:33 2025 +0200

    Doc: add item on tcmalloc >= 2.16 hangs to FAQ

Diff:
---
 docs/xml/FAQ.xml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/xml/FAQ.xml b/docs/xml/FAQ.xml
index 201b365021..f246fa6c99 100644
--- a/docs/xml/FAQ.xml
+++ b/docs/xml/FAQ.xml
@@ -541,6 +541,26 @@ int main(void)
   </answer>
 </qandaentry>
 
+<qandaentry id="faq.hangs">
+  <question id="q-hangs">
+    <para>Why does Valgrind hang when using tcmalloc?</para>
+  </question>
+  <answer id="a-hangss">
+    <para>This is because tcmalloc makes a recursive call in its initialisation code.
+      Under Valgrind that becomes either an infinite loop with optimised builds of tcmalloc
+      or a stack overflow crash with debug builds of it.</para>
+
+    <para>Your options are:
+      <itemizedlist>
+        <listitem>Do not use tcmalloc in the builds that you test with Valgrind.</listitem>
+        <listitem>Use an older version of tcmalloc. This problem started on 2024-03-24.
+          If you use gperftools 2.15 or older you should not have this problem.</listitem>
+      </para>
+
+  </answer>
+</qandaentry>
+
+
 </qandadiv>
 
 <!-- Miscellaneous -->