RTEMS 4.8.0 On-Line Library

Mutex Manager pthread_mutexattr_setprioceiling - Set the Priority Ceiling

RTEMS POSIX API User's Guide

10.4.5: pthread_mutexattr_setprioceiling - Set the Priority Ceiling

CALLING SEQUENCE:

#include <pthread.h>

int pthread_mutexattr_setprioceiling(
  pthread_mutexattr_t *attr,
  int                  prioceiling
);

STATUS CODES:

EINVAL: The attribute pointer argument is invalid.
EINVAL: The attribute set is not initialized.
EINVAL: The prioceiling argument is invalid.

DESCRIPTION:

The pthread_mutexattr_setprioceiling routine is used to set value of the prioceiling attribute. This attribute specifies the priority that is the ceiling for threads obtaining this mutex. Any task obtaining this mutex may not be of greater priority that the ceiling. If it is of lower priority, then its priority will be elevated to prioceiling.

NOTES:

NONE

RTEMS POSIX API User's Guide