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

pthread_mutexattr_getprioceiling()

Get the priority ceiling of a mutex attribute object

Synopsis:

#include <pthread.h>

int pthread_mutexattr_getprioceiling( 
            const pthread_mutexattr_t* attr, 
            int* prioceiling );

Arguments:

attr

A pointer to the pthread_mutexattr_t object that you want to get the attribute from.

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_mutexattr_getprioceiling() function sets prioceiling to the current mutex attribute attr's scheduling priority ceiling. The mutex attribute object attr must have been previously created with pthread_mutexattr_init().

Returns:

EOK

Success.

EINVAL

Invalid value specified by attr or prioceiling.

EPERM

The caller doesn't have the privilege to perform the operation.

Classification:

POSIX 1003.1 THR TPP

See also:

pthread_cond_init(), pthread_create(), pthread_mutex_init(), pthread_mutexattr_getprotocol(), pthread_mutexattr_getrecursive(), pthread_mutexattr_setprioceiling(), pthread_mutexattr_setrecursive()