Author: sewardj
Date: 2007-12-02 02:01:09 +0000 (Sun, 02 Dec 2007)
New Revision: 7262
Log:
* document gcc code generation shenanigans on ppc32-linux
* add docs for --malloc-fill and --free-fill
Modified:
trunk/memcheck/docs/mc-manual.xml
Modified: trunk/memcheck/docs/mc-manual.xml
===================================================================
--- trunk/memcheck/docs/mc-manual.xml 2007-12-01 02:09:50 UTC (rev 7261)
+++ trunk/memcheck/docs/mc-manual.xml 2007-12-02 02:01:09 UTC (rev 7262)
@@ -152,11 +152,19 @@
<para>When enabled, assume that reads and writes some small
distance below the stack pointer are due to bugs in gcc 2.96, and
does not report them. The "small distance" is 256 bytes by
- default. Note that gcc 2.96 is the default compiler on some older
+ default. Note that gcc 2.96 is the default compiler on some ancient
Linux distributions (RedHat 7.X) and so you may need to use this
flag. Do not use it if you do not have to, as it can cause real
errors to be overlooked. A better alternative is to use a more
recent gcc/g++ in which this bug is fixed.</para>
+
+ <para>You may also need to use this flag when working with
+ gcc/g++ 3.X or 4.X on 32-bit PowerPC Linux. This is because
+ gcc/g++ generates code which occasionally accesses below the
+ stack pointer, particularly for floating-point to/from integer
+ conversions. This is in violation of the 32-bit PowerPC ELF
+ specification, which makes no provision for locations below the
+ stack pointer to be accessible.</para>
</listitem>
</varlistentry>
@@ -199,6 +207,39 @@
</listitem>
</varlistentry>
+ <varlistentry id="opt.malloc-fill" xreflabel="--malloc-fill">
+ <term>
+ <option><![CDATA[--malloc-fill=<hexnumber> ]]></option>
+ </term>
+ <listitem>
+ <para>Fills blocks allocated
+ by <computeroutput>malloc</computeroutput>,
+ <computeroutput>new</computeroutput>, etc, but not
+ by <computeroutput>calloc</computeroutput>, with the specified
+ byte. This can be useful when trying to shake out obscure
+ memory corruption problems. The allocated area is still
+ regarded by Memcheck as undefined -- this flag only affects its
+ contents.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="opt.free-fill" xreflabel="--free-fill">
+ <term>
+ <option><![CDATA[--free-fill=<hexnumber> ]]></option>
+ </term>
+ <listitem>
+ <para>Fills blocks freed
+ by <computeroutput>free</computeroutput>,
+ <computeroutput>delete</computeroutput>, etc, with the
+ specified byte. This can be useful when trying to shake out
+ obscure memory corruption problems. The freed area is still
+ regarded by Memcheck as not valid for access -- this flag only
+ affects its contents.
+ </para>
+ </listitem>
+ </varlistentry>
+
</variablelist>
<!-- end of xi:include in the manpage -->
-------------------------------------------------------------------------
SF.Net email is sponsored by: The Future of Linux Business White Paper
from Novell. From the desktop to the data center, Linux is going
mainstream. Let it simplify your IT future.
http://altfarm.mediaplex.com/ad/ck/8857-50307-18918-4
_______________________________________________
Valgrind-developers mailing list
Valgrind-developers@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/valgrind-developers
