Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 535 / 612

Functions for Managing Locks and Synchronization
Chapter 15 Function Reference 535
Description
This function creates a new condition variable and returns a pointer to the
Slapi_CondVar
structure. You can create the
Slapi_Mutex
structure by calling
the
slapi_new_mutex()
function.
To wait on the condition variable, call the slapi_wait_condvar() function. To notify
waiting threads, call the
slapi_notify_condvar()
function.
When you are done working with this
Slapi_CondVar
structure, call the
slapi_destroy_condvar()
function to free the structure from memory.
slapi_new_mutex()
Creates a new mutex and returns a pointer to the corresponding
Slapi_Mutex
structure.
Syntax
#include “slapi-plugin.h”
Slapi_Mutex *slapi_new_mutex();
Returns
This function returns one of the following values:
• A pointer to the new
Slapi_Mutex
structure.
•
NULL
if memory cannot be allocated.
Description
This function creates a new mutex and returns a pointer to the
Slapi_Mutex
structure. You can lock this mutex by calling the
slapi_pblock_destroy()
function and unlock the mutex by calling the
slapi_unlock_mutex()
function.
When you are done working with the mutex, you can free the
Slapi_Mutex
structure by calling the
slapi_destroy_mutex()
function.
slapi_notify_condvar()
Notifies a thread that is waiting on the specified condition variable.
Syntax
#include “slapi-plugin.h”
int slapi_notify_condvar( Slapi_CondVar *cvar, int notify_all );