pthread_mutex_getprioceiling()

Updated: April 19, 2023

Get a mutex's priority ceiling

Synopsis:

#include <pthread.h>

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

Arguments:

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.

Library:

libc

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

Description:

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

Returns:

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.

Classification:

POSIX 1003.1 RPP|TPP

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes