Object space callbacks
Object spaces also support a number of callbacks dealing with the importing and exporting of objects.
SstAddHandlerCallback
Sent when a new handler is added to a local space. The callData is the handler that has just been added.
SstDifferentSpaceActivationCallback
Sent when an incoming marshaled representation of a space has a different activation from the local representation's activation. The callData for the callback is a three-element array containing the local representation (from which the current activation can be obtained), the incoming activation and a block. Sending value to the block will cause a marshaling error to be returned to the sender.
SstExportCallback
Sent when an object is exported for the first time (either explicitly by the developer or automatically by the SST system when messages contain objects not previously exported). The callData for the callback is a two-element array containing the key under which the object was exported and object itself.
SstFinalizeImportCallback
Sent whenever an imported remote reference object in a local image is about to be collected by the local object space's normal garbage collector. This callback is only generated if the space supports finalization (i.e., the supportFinalization option is set to true). The callData for the callback is a two-element array containing the handle under which the object was imported and the local remote reference object.
SstImportCallback
Sent when a new remote reference is imported (either the first time or the first time since it was last finalized). The callData for the callback is a three-element array containing the handle under which the object was imported, the local remote reference object, and the root of the message which contained the newly imported object (or nil if no message was involved).
SstRemoveHandlerCallback
Sent when an existing handler is removed from a local space. The callData is the handler being removed.
SstUnexportCallback
Sent when a previously exported object is removed from the export table. The callData for the callback is a two-element array containing the key under which the object was exported and the object itself.
SstUnimportCallback
Sent when a previously imported object is explicitly removed from the import table (as opposed to just being garbage collected). The callData for the callback is a two-element array containing the handle under which the object was imported and the local remote reference object.
Last modified date: 01/29/2015