pthread_unlock_global_np()--Unlock Global Mutex

Syntax:

 #include <pthread.h>
 int pthread_unlock_global_np(void);

  Service Program Name: QP0WTCBH

  Default Public Authority: *USE

  Threadsafe: Yes

  Signal Safe: Yes

The pthread_unlock_global_np() function unlocks a global mutex provided by the pthreads run-time. The global mutex is a recursive mutex with a name of "QP0W_GLOBAL_MTX". The global mutex is not currently used by the pthreads run-time to serialize access to any system resources, and is provided for application use only.

Note: This function is not portable

Authorities and Locks

For successful completion, the global mutex lock must be held prior to calling pthread_unlock_global_np().

Parameters

None.

Return Value

0: pthread_unlock_global_np() was successful.
value: pthread_unlock_global_np() was not successful. value is set to indicate the error condition.

Error Conditions

If pthread_unlock_global_np() was not successful, the error condition returned usually indicates one of the following errors. Under some conditions, the value returned could indicate an error other than those listed here.

[EINVAL]: The value specified for the argument is not correct.
[EPERM]: The mutex is not currently held by the caller.

Related Information

The <pthread.h> header file. See Header files for Pthread functions.
pthread_lock_global_np()--Lock Global Mutex

Example

See the pthread_lock_global_np() example.

API introduced: V4R3

[ Back to top | Pthread APIs | APIs by category ]