Writing Monitors for the Event Monitoring Service (December 1999)

Chapter 2 37
The EMS Application Programming Interface (API)
Function Descriptions
rm_destroy
Used by resource monitors and target applications to destroyobjects that
are no longer needed.
Function Prototype
void rm_destroy (rm_object_addr obj);
Parameters
obj The object to be destroyed.
Usage Notes
This function deallocates memory using free(3C). Any references to
fields inside the object are invalid once the object has been destroyed.
Note that since rm_get() returns pointers to fields inside objects, those
references are invalid once rm_destroy() has been called.
If obj contains other objects, those objects will also be destroyed. For
example, a Subclass Reply object may contain Resource State objects. If a
Subclass Reply object is destroyed, the Resource State objects will
automatically be destroyed as well.
If obj is NULL, rm_destroy() has no effect.