pthread_mutex_getprioceiling()

Get a mutex's priority ceiling

Synopsis:

#include <pthread.h>

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

mutex: A pointer to the pthread_mutex_t object that you want to priority ceiling for.
prioceiling: A pointer to a location where the function can store the priority ceiling.

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

The pthread_mutex_getprioceiling() function returns the priority ceiling of mutex in prioceiling.

EOK: Success.
EINVAL: The mutex specified by mutex doesn't currently exist.
EPERM: The calling thread doesn't have permission to get the priority ceiling.