petsc-3.14.5 2021-03-03
Report Typos and Errors

# PetscMallocValidate

Test the memory for corruption. This can be called at any time between PetscInitialize() and PetscFinalize()

### Synopsis

    #include "petscsys.h"
    PetscErrorCode  PetscMallocValidate(int line,const char function[],const char file[])

### Input Parameters

| line | - line number where call originated.
| function | - name of function calling
| file | - file where function is

### Return value

The number of errors detected.

Options Database:.

| -malloc_test | - turns this feature on when PETSc was not configured with --with-debugging=0
| -malloc_debug | - turns this feature on anytime

### Output Effect

Error messages are written to stdout.

### Notes

This is only run if PetscMallocSetDebug() has been called which is set by -malloc_test (if debugging is turned on) or -malloc_debug (any time)

You should generally use CHKMEMQ as a short cut for calling this routine.

The Fortran calling sequence is simply PetscMallocValidate(ierr)

No output is generated if there are no problems detected.

### Developers Note

Uses the flg TRdebugLevel (set as the first argument to PetscMallocSetDebug()) to determine if it should run

### See Also

CHKMEMQ

### Level

advanced

### Location

src/sys/memory/mtr.c
Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages