Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-18
POOL_GETINFO_ Procedure
fail-block-size output
INT(32) .EXT:ref:1
is the size in bytes of the block that the POOL_GETSPACE_ procedure failed to
allocate when it returned an
error value of 10 (unable to allocate space). Note
that the value of the
block-size parameter specified in the POOL_GETSPACE_
procedure is smaller than
fail-block-size because it is not rounded up. See
“Considerations” for the POOL_DEFINE_ procedure for a description of the
differences between the requested block size and the allocated block size.
curfrag output
INT .EXT:ref:1
is the number of free fragments in the pool.
maxfrag output
INT .EXT:ref:1
is the maximum number of free fragments that the pool has ever had since it was
originally allocated with the POOL_DEFINE_ procedure.
alignment output
INT .EXT:ref:1
is the pool alignment selected when the pool was originally allocated with the
POOL_DEFINE_ procedure.
tag-size output
INT .EXT:ref:1
is the size in bytes of one of the tags used to mark the free or allocated blocks.
Considerations
See “Considerations” for the POOL_DEFINE_ procedure.
Example
error :=
POOL_GETINFO_ ( pool, error^detail, avail^pool^size );
! determine the available pool size
Related Programming Manual
For programming information about the POOL_GETINFO_ memory-management
procedure, refer to the
Guardian Programmer’s Guide.
Note. There are additional considerations for privileged callers.