pthread_mutex_setprioceiling()

Set a mutex's priority ceiling

Synopsis:

#include <pthread.h>

int pthread_mutex_setprioceiling( 
                     pthread_mutex_t* mutex, 
                     int prioceiling, 
                     int* old_ceiling );

Library:

libc

Description:

The pthread_mutex_setprioceiling() function locks mutex (or blocks until it can lock it), changes its priority ceiling to prioceiling, and releases it. When the change is successful, the previous priority ceiling is returned in old_ceiling.

Returns:

EOK

Success.

EINVAL

The mutex specified by mutex doesn't currently exist or the priority requested by prioceiling is out of range.

EPERM

The calling thread doesn't have permission to get the priority ceiling.

Classification:

POSIX 1003.1 (Threads)

See also:

pthread_mutex_getprioceiling()