server_heap_unit_ref()

void server_heap_unit_ref(void *_unit)

This function increments the reference count on the unit, you must do this when you add another reference to the unit.

For example, lets say you have a unit you allocated from a ServerKit heap with server_heap_unit_allocate().

You have populated this unit with data representing a message, the message is to be sent to a number of threads via seperate ServerKit queues. For every queue you place the unit on, you must increase the reference count. When you are finished with placing the message on queues, you must decrement the reference count because hwen you allocated it, it was set to 1.

These details are important to understand, if you don't get it you will have some serious problems with multithreaded programming.