must be used in the scope of a call into LispWorks by a foreign callable on a thread that was not created by LispWorks. It informs LispWorks that there are unlikely to be more callbacks into Lisp on the current thread. As a result, LispWorks can cleanup its side.
For each thread that was not created by Lisp and on which there was a call into Lisp, LispWorks keeps data on the Lisp side which it uses to make the entry faster. If the thread goes away, this data is not needed and so LispWorks can free it.
If another callback occurs on the same thread after a callback that called
, LispWorks will have to recreate its side, which takes a little more time, but otherwise it works in the same way. Thus it is possible to call
even when it is not guaranteed that there will not be further callbacks on the same thread.
LispWorks User Guide and Reference Manual - 21 Dec 2011