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

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

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

SEE ALSO

Functions:: pthread_mutex_getprioceiling()

MKS Toolkit 9.3 Documentation Build 6.