set-approaching-memory-limit-callback Function

Summary

Sets a callback that it is called when 32-bit LispWorks approaches its memory limit.

Package

system

Signature

set-approaching-memory-limit-callback callback

Arguments

callback⇩

A function designator.

Description

The function set-approaching-memory-limit-callback sets a callback that it is called when 32-bit LispWorks approaches its limit of memory.

The function callback must take two arguments: the size of the image and the margin of growth:

callback size margin

Normally callback should do something to prevent further growth of the image, or at least minimize the damage if LispWorks crashes when it actually reaches its limit (for example by saving data to disk).

callback can prevent an error being signaled by calling cl:continue.

If there is no callback (the default) or callback returns, LispWorks signals an error.

Notes

set-approaching-memory-limit-callback is not relevant to 64-bit LispWorks.

set-approaching-memory-limit-callback does not return a useful value.

See also

11.3.6 Approaching the memory limit
approaching-memory-limit