From 8dfea0ce50d6097b1198bc50538e19beee53d762 Mon Sep 17 00:00:00 2001
From: Andrew Johnson <anj@aps.anl.gov>
Date: Fri, 26 Jan 2007 19:03:56 +0000
Subject: [PATCH] Added description of the NPTL Abort issue.

---
 documentation/KnownProblems.html | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/documentation/KnownProblems.html b/documentation/KnownProblems.html
index d76468d17..af5e39de7 100644
--- a/documentation/KnownProblems.html
+++ b/documentation/KnownProblems.html
@@ -14,6 +14,16 @@
 <ul>
   <li>It is not possible to build this version of base on HP-UX due to C++
     issues which appear to be bugs in the HP-UX compiler.</li>
+  <li>When shutting down any CA client or IOC on a recent version of GNU/Linux
+    (one that includes the NPTL threading library) the following message may
+    appear, possibly preceeded by a message about a thread terminating due to a
+    C++ exception:
+    <blockquote><pre>FATAL: exception not rethrown</pre></blockquote>
+    An <tt>Abort</tt> message and a core-dump may also be generated if the
+    user's settings allow this. The error is caused by the implementation of the
+    pthread_cancel() mechanism in NPTL, which uses the C++ exception mechanism
+    without providing any means to distinguish the cancel exception to regular
+    C++ exception handlers.</li>
 </ul>
 
 </body>