This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pthread_mutex_getprioceiling()

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 THR TPP

See also:

pthread_mutex_setprioceiling()