Multithreaded Programming Guide

Get Mutex's Priority Ceiling


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

#include <pthread.h>

int pthread_mutex_getprioceiling(const pthread_mutexatt_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 returned 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.