CHKMEMQ#

Checks the memory for corruption, calls error handler if any is detected

Synopsis#

#include <petscsys.h>
CHKMEMQ;

Not Collective

Notes#

We highly recommend using Valgrind https://petsc.org/release/faq/#valgrind or for NVIDIA CUDA systems https://docs.nvidia.com/cuda/cuda-memcheck/index.html for finding memory problems. The CHKMEMQ macro is useful on systems that do not have valgrind, but is not as good as valgrind or cuda-memcheck.

Must run with the option -malloc_debug (-malloc_test in debug mode; or if PetscMallocSetDebug() called) to enable this option

Once the error handler is called the calling function is then returned from with the given error code.

By defaults prints location where memory that is corrupted was allocated.

Use CHKMEMA for functions that return void

See Also#

PetscTraceBackErrorHandler(), PetscPushErrorHandler(), PetscError(), SETERRQ(), PetscMallocValidate()

Level#

beginner

Location#

include/petscerror.h

Examples#

src/dm/field/tutorials/ex1.c
src/dm/tutorials/ex11f90.F90


Edit on GitLab

Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages