Changeset ae6d3b8


Ignore:
Timestamp:
03/09/2017 08:18:01 PM (5 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, lazarus, perl-modules, qt5new, trunk, upgradedb, xry111/intltool, xry111/test-20220226
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:
1 edited

Legend:

Unmodified
Added
Removed
  • general/prog/valgrind.xml

    ra0418e7 rae6d3b8  
    7878    <bridgehead renderas="sect4">Optional</bridgehead>
    7979    <para role="optional">
     80      <xref linkend="bind"/> or <xref linkend="bind-utils"/> (for tests),
    8081      <xref linkend="boost"/>,
    81       <xref linkend="llvm"/> (with Clang),
    8282      <xref linkend="gdb"/> (for tests),
    83       <xref linkend="which"/> (for tests),
    84       <xref linkend="bind"/> or <xref linkend="bind-utils"/> (for tests),
    85       and
    86       <ulink url="http://www.openmp.org">OpenMP</ulink>
    87     </para>
    88 
     83      <xref linkend="llvm"/> (with Clang), and
     84      <xref linkend="which"/> (for tests)
     85    </para>
     86
     87<!-- See "maintainer note", below
    8988    <bridgehead renderas="sect4">Optional for regenerating the documentation</bridgehead>
    9089    <para role="optional">
     
    9291      <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
    9392    </para>
    94 
     93-->
    9594    <para condition="html" role="usernotes">User Notes:
    9695      <ulink url="&blfs-wiki;/valgrind"/>
     
    135134    </note>
    136135
    137 
    138136    <para>
    139137      To test the results, issue: <command>make regtest</command>. The tests
    140       may hang forever if <xref linkend="gdb"/> is not installed.
    141     </para>
    142 <!--  Note to maintainer: Recheck when next texlive (2015) is released.
    143     <para>
    144       If you wish to regenerate the documentation, run:
    145     </para>
    146 
    147 <screen><userinput>make -C docs download-docs</userinput></screen>
    148 -->
     138      may hang forever if <xref linkend="gdb"/> is not installed. Some tests
     139      are known to hang also, depending on the version of glibc. Problematic
     140      tests can be disabled by changing the <userinput>prereq:</userinput> line
     141      in the correponding <filename>.vgtest</filename> file to
     142      <userinput>prereq: false</userinput>. For example:
     143    </para>
     144
     145<!-- For valgrind-3.12.0, the pth_cond_destroy_busy test hangs forever because
     146     of some change in glibc-2.25. Should be fixed in next versions of
     147     valgrind.-->
     148<screen><userinput>sed -e 's@prereq:.*@prereq: false@' \
     149    -i {helgrind,drd}/tests/pth_cond_destroy_busy.vgtest</userinput></screen>
     150
     151    <note>
     152      <para>
     153        The <application>OpenMP</application> tests are skipped if libgomp
     154        has been compiled with <option>--enable-linux-futex</option> (the
     155        default). If needed, just recompile the libgomp library from
     156        the gcc build tree, passing <option>--disable-linux-futex</option>
     157        to configure, storing the library to some place and changing the link
     158        from <filename>/usr/lib/libgomp.so.1</filename> to point to the new
     159        library.
     160      </para>
     161    </note>
     162
     163<!--  Note to maintainer: there is a long thread in ticket #5882 explaining
     164      why we do not provide instructions to rebuild the documentation.
     165      (still broken with TeXLive 2016) -->
     166
    149167    <para>
    150168      Now, as the <systemitem class="username">root</systemitem> user:
Note: See TracChangeset for help on using the changeset viewer.