Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

heap_check_always32(3) OSS Library Calls Reference Manual
NAME
heap_check_always32 - Controls whether the run-time heap consistency is checked automati-
cally
LIBRARY
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll
SYNOPSIS
#include <stdlib.h>
void heap_check_always32(
int switch);
PARAMETERS
switch Specifies whether to enable or disable automatic consistency checking of the
run-time heap. A value of 0 (zero) for switch disables automatic checking. A
value of 1 for switch enables automatic checking. The native CRE
heap_check_always32( ) function also accepts a value of 2 for the switch vari-
able and treats it as if it were a value of 1.
DESCRIPTION
The heap_check_always32( ) function controls whether the memory-management functions
calloc32( ), free32( ), malloc32( ), and realloc32( ) automatically check the consistency of the
run-time heap they manipulate.
When automatic consistency checking is enabled, the memory-management functions listed ear-
lier perform the consistency check by calling the heap_check32( ) function. Consequently, an
inconsistency discovered by automatic checking has the same impact as one discovered by cal-
ling heap_check32( ). Enabling automatic consistency checking degrades the performance of
heap operations significantly. Thus, you should disable automatic checking after developing and
debugging your application.
RELATED INFORMATION
Functions: heap_check32(3).
STANDARDS CONFORMANCE
The heap_check_always32( ) function is an HP extension to the XPG4 Version 2 specification.
3−196 Hewlett-Packard Company 527187-017