Multithreaded Programming Guide

Get Mutex's Priority Ceiling


pthread_mutex_getprioceiling(3THR) gets the priority ceiling of a mutex.

#include <pthread.h>

int pthread_mutex_getprioceiling(const pthread_mutex_t *mutex, 
											int *prioceiling);

pthread_mutex_getprioceiling() returns the priority ceiling, prioceiling of a mutex mutex.

Return Values

On successful completion, pthread_mutex_getprioceiling() returns 0. Any other return value indicates that an error occurred.

If any of the following conditions occurs, pthread_mutexatt_getprioceiling() fails and returns the corresponding value.


The option _POSIX_THREAD_PRIO_PROTECT is not defined and the implementation does not support the function.

If any of the following conditions occurs, pthread_mutex_getprioceiling() might fail and return the corresponding value.


The value specified by mutex does not refer to a currently existing mutex.


The implementation does not support the priority ceiling protocol for mutexes.


The caller does not have the privilege to perform the operation.