pthread_mutex_setprioceiling()

set the priority ceiling of a mutex 

Function


SYNOPSIS

#include <pthread.h>

int pthread_mutex_setprioceiling(pthread_mutex_t *mutex, int ceiling, int *oldceiling);


DESCRIPTION

The pthread_mutex_setprioceiling() function either locks the mutex if it is unlocked, or blocks until it can successfully lock the mutex, then it changes the mutex's priority ceiling and releases the mutex. When the change is successful, the previous value of the priority ceiling is returned in oldceiling. The process of locking the mutex need not adhere to the priority ceiling protocol.


PARAMETERS

mutex 

Is the mutex whose priority ceiling is altered.

ceiling 

Is the new priority ceiling for the mutex.

oldceiling 

Is the location where the old priority ceiling is stored.


RETURN VALUES

The pthread_mutex_setprioceiling() function always returns ENOSYS.


CONFORMANCE

POSIX P1003.1 (1996).


MULTITHREAD SAFETY LEVEL

MT-safe.


PORTING ISSUES

This function is not supported; it always returns ENOSYS.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
pthread_mutex_getprioceiling()


PTC MKS Toolkit 10.3 Documentation Build 39.