Changeset ae6d3b8

Timestamp:

03/09/2017 08:18:01 PM (7 years ago)

Author:

Pierre Labastie <pieere@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

331a2b7

Parents:

a0418e7

Message:

Improve explanations for valgrind tests

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18468 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• general/prog/valgrind.xml (modified) (3 diffs)

general/prog/valgrind.xml

@@ -78 +78 @@
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
+      <xref linkend="bind"/> or <xref linkend="bind-utils"/> (for tests), 
       <xref linkend="boost"/>,
-      <xref linkend="llvm"/> (with Clang),
       <xref linkend="gdb"/> (for tests), 
-      <xref linkend="which"/> (for tests), 
-      <xref linkend="bind"/> or <xref linkend="bind-utils"/> (for tests), 
-      and
-      <ulink url="http://www.openmp.org">OpenMP</ulink>
-    </para>
-
+      <xref linkend="llvm"/> (with Clang), and
+      <xref linkend="which"/> (for tests)
+    </para>
+
+<!-- See "maintainer note", below
     <bridgehead renderas="sect4">Optional for regenerating the documentation</bridgehead>
     <para role="optional">
@@ -92 +91 @@
       <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
     </para>
-
+-->
     <para condition="html" role="usernotes">User Notes:
       <ulink url="&blfs-wiki;/valgrind"/>
@@ -135 +134 @@
     </note>
 
-
     <para>
       To test the results, issue: <command>make regtest</command>. The tests
-      may hang forever if <xref linkend="gdb"/> is not installed.
-    </para>
-<!--  Note to maintainer: Recheck when next texlive (2015) is released.
-    <para>
-      If you wish to regenerate the documentation, run:
-    </para>
-
-<screen><userinput>make -C docs download-docs</userinput></screen>
--->
+      may hang forever if <xref linkend="gdb"/> is not installed. Some tests
+      are known to hang also, depending on the version of glibc. Problematic
+      tests can be disabled by changing the <userinput>prereq:</userinput> line
+      in the correponding <filename>.vgtest</filename> file to
+      <userinput>prereq: false</userinput>. For example:
+    </para>
+
+<!-- For valgrind-3.12.0, the pth_cond_destroy_busy test hangs forever because
+     of some change in glibc-2.25. Should be fixed in next versions of
+     valgrind.-->
+<screen><userinput>sed -e 's@prereq:.*@prereq: false@' \
+    -i {helgrind,drd}/tests/pth_cond_destroy_busy.vgtest</userinput></screen>
+
+    <note>
+      <para>
+        The <application>OpenMP</application> tests are skipped if libgomp
+        has been compiled with <option>--enable-linux-futex</option> (the
+        default). If needed, just recompile the libgomp library from
+        the gcc build tree, passing <option>--disable-linux-futex</option>
+        to configure, storing the library to some place and changing the link
+        from <filename>/usr/lib/libgomp.so.1</filename> to point to the new
+        library.
+      </para>
+    </note>
+
+<!--  Note to maintainer: there is a long thread in ticket #5882 explaining
+      why we do not provide instructions to rebuild the documentation.
+      (still broken with TeXLive 2016) -->
+
     <para>
       Now, as the <systemitem class="username">root</systemitem> user: