[Return to Bookshelf] [Contents] [Previous Section] [Next Section] [Index] [Help]


cma_unlock_global

Unlocks a global mutex.

Syntax

cma_unlock_global();

C Binding

#include 

void cma_unlock_global(void);

Arguments

None

Description

This service unlocks the global mutex when each call to cma_ lock_global has been matched by a call to this routine. For example, if you called cma_lock_global three times, cma_unlock_global unlocks the global mutex when you call it the third time.

If no threads are waiting for the global mutex, it becomes unlocked with no current owner. If one or more threads are waiting to lock the global mutex, one thread is unblocked and tries to acquire the global lock again. The scheduling policy is used to determine which thread acquires the global mutex.

The results of calling this routine are unpredictable if the global mutex is already unlocked. The results of calling this service are also unpredictable if the global mutex is owned by a thread other than the calling thread.

Do not call this routine from any software interrupt handler.

Exceptions

cma_e_existence
cma_e_use_error



[Return to Bookshelf] [Contents] [Previous Section] [Next Section] [Index] [Help]