Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 536 / 612

Functions for Managing Locks and Synchronization
536 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
Parameters
This function takes the following parameters:
Returns
This function returns one of the following values:
• A non-zero value if the thread (or threads) are successfully notified.
• 0 if an error occurs (for example, if the condition variable is NULL or if the
mutex associated with the condition variable is not locked).
Description
This function notifies one or all threads that are waiting on the condition variable
(see the
slapi_wait_condvar()
function). Before calling this function, the calling
thread must lock the mutex associated with this condition variable.
slapi_unlock_mutex()
Unlocks the specified mutex.
Syntax
#include “slapi-plugin.h”
int slapi_unlock_mutex( Slapi_Mutex *mutex );
Parameters
This function takes the following parameters:
Returns
This function returns one of the following values:
• A non-zero value if the mutex was successfully unlocked.
cvar
Pointer to an
Slapi_CondVar
structure representing the condition
variable.
notify_all
If 1, notifies all threads that are waiting on the condition variable.
mutex
Pointer to an
Slapi_Mutex
structure representing the mutex
that you want to unlock.