MA_VERIFY_ALLOCATOR_STUFF
NAME
MA_verify_allocator_stuff - sanity check the internal state
of MA
C SYNOPSIS
#include "macdecls.h"
Boolean MA_verify_allocator_stuff()
FORTRAN SYNOPSIS
#include "mafdecls.h"
logical function MA_verify_allocator_stuff()
DESCRIPTION
MA_verify_allocator_stuff() checks each block currently
allocated on the heap or the stack for checksum and guard
errors. For each error found, a message is printed on the
standard output (stdout). If any errors are found, a summary
message is printed on the standard error (stderr), else
nothing is printed.
DIAGNOSTICS
unavailable; recompile MA with -DVERIFY
To use this routine, MA must be compiled with cpp
option -DVERIFY.
%s block '%s', handle %d, address 0x%lx:
The following diagnostics are each prefixed by this
information, which identifies the corrupted block.
current checksum %lu != stored checksum %lu
This indicates that the block has been corrupted by
having its internal state overwritten.
current left signature %u != proper left signature %u
This indicates that the block has been corrupted by
being overwritten at the left end. The likely cause of
this is an application indexing bug.
current right signature %u != proper right signature %u
This indicates that the block has been corrupted by
being overwritten at the right end. The likely cause of
this is an application indexing bug.
RETURN VALUE
C: MA_TRUE upon success (no errors), MA_FALSE upon failure
(errors).
FORTRAN: .true. upon success (no errors), .false. upon
failure (errors).
SEE ALSO
MA(3), MA_set_auto_verify(3)
AUTHOR
Gregory S. Thomas, Pacific Northwest Laboratory