pthread_mutex_setprioceiling() -- set the priority ceiling of a mutex

SYNOPSIS

#include <pthread.h>

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

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

pthread_mutex_setprioceiling()
set the priority ceiling of a mutex

Function