MA_VERIFY_ALLOCATOR_STUFF(3)

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.fh"
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).

FILES
Include files: /msrc/proj/hpctools/ma/release/current/include
Library:       /msrc/proj/hpctools/ma/release/current/lib/platform/libma.a
Man pages:     /msrc/proj/hpctools/ma/release/current/man/man3
Source code:   /msrc/proj/hpctools/ma/release/current/tar/marelease.tar

SEE ALSO
MA(3), MA_set_auto_verify(3)

AUTHOR
Gregory S. Thomas, Pacific Northwest National Laboratory