All Manuals > LispWorks® User Guide and Reference Manual > 37 The HCL Package

check-fragmentation Function

Summary

Provides information about the fragmentation in a generation in 32-bit LispWorks.

Package

hcl

Signature

check-fragmentation gen-num => total-free, total-small-blocks, total-large-blocks

Arguments
gen-num
An integer between 0 and 3, inclusive.
Values
total-free
An integer.
total-small-blocks
An integer.
total-large-blocks
An integer.
Description

The function check-fragmentation provides information about the fragmentation in the generation gen-num in 32-bit LispWorks.

gen-num should be 0 for the most recent generation, 1 for the most recent two generations, and so on up to a maximum (usually 3). Numbers outside this range signal an error.

total-free is the total free space in the generation.

total-small-blocks is the amount of free space in the generation which is available in blocks of 512 bytes or larger.

total-large-blocks is the amount of free space in the generation which is available in blocks of 4096 bytes or larger.

total-small-blocks and total-large-blocks give indication of the level of fragmentation in the generation. This information can be used, for example, to decide whether to call try-move-in-generation.

Notes

check-fragmentation is implemented only in 32-bit LispWorks. It is not relevant to the Memory Management API in 64-bit implementations, where gen-num-segments-fragmentation-state is available instead.

See also

try-compact-in-generation
try-move-in-generation
11.2 Guidance for control of the memory management system


LispWorks® User Guide and Reference Manual - 01 Dec 2021 19:30:35