PetscIsRegionPoisoned#
Query whether a particular memory region is poisoned
Synopsis#
static inline PetscErrorCode PetscIsRegionPoisoned(const void *ptr, size_t size, PetscBool3 *poisoned)
Input Parameters#
ptr - The pointer to the start of the region
size - The size (in bytes) of the region to query
Output Parameter#
poisoned - Whether the region is known to be poisoned
Notes#
Sets poisoned to PETSC_BOOL3_TRUE if at least 1 byte in the range [ptr, ptr + size) is
poisoned. Therefore a region must be entirely unpoisoned for poisoned to be PETSC_BOOL3_FALSE.
If ptr is NULL or size is 0 then poisoned is set to PETSC_BOOL3_FALSE.
If it is not possible to query the poisoned status of a region, then poisoned is set to
PETSC_BOOL3_UNKNOWN.
See Also#
Level#
developer
Location#
include/petsc/private/mempoison.h
Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages