Guardian Procedure Calls Reference Manual
Returned Value
INT(32)
Outcome of the call:
POOL64_OK0
Successful completion.
POOL64_NOINFO26
The size provided is not large enough to store any pool information.
POOL64_MOREINFO25
More information available than would fit in the pool_info_length provided.
POOL64_BAD_POOL101
Pool is uninitialized or corrupted.
These values are defined in kpool64.h for C and KPOOL64 for pTAL.
Structure Definitions for pool_info
The NSK_POOL64_INFO structure is defined in kpool64.h for C and KPOOL64 for pTAL.
The following table displays the C version of that structure:
typedef struct NSK_POOL64_INFO{
uint64 version; /* version of pool64_info struct */
uint64 strsize; /* size of this struct */
/* all sizes are in bytes */
uint64 initsize; /* size of primary pool segment */
uint64 size; /* size of pool (all segments) */
uint64 max_size; /* maximum size of pool */
uint64 alloc; /* current total allocation */
uint64 max_alloc; /* maximum allocaton */
uint64 topsize; /* top size */
uint64 ohead; /* chunk overhead size */
uint64 segs; /* number of added segs */
uint64 max_segs; /* maximum added segs */
uint64 wired; /* total bytes wired */
uint64 max_wired; /* maximum bytes wired */
} NSK_POOL64_INFO;
The alloc value is the total size of all currently allocated pool elements, including element
overhead. The max_alloc value reports the largest value alloc has achieved since the most
recent call to POOL64_RESET_MAX_ for this pool, or since the pool was defined, if there has been
no such call. The other max_... values are similar.
The topsize value describes the free area at the end the pool. If there are secondary segments,
the top area is at the end of the last segment added by POOL64_AUGMENT_, or an earlier
segment if that one has been deallocated by POOL64_DIMINISH_.
The wired value is always 0 unless the pool was defined with a wiring option, which requires
privilege.
POOL64_GETINFO_ Procedure 967