pthread_mutex_getprioceiling SubroutinePurposeReturns the current value of the prioceiling attribute of a mutex.LibraryThreads Library (libpthreads.a)Syntax#include <pthread.h>int pthread_mutex_getprioceiling (mutex, prioceiling)pthread_mutex_t *mutex;int *prioceiling;DescriptionThe pthread_mutex_getprioceiling subroutine returns the current valueof the prioceiling attribute of the mutex mutex. This attribute specifiesthe priority ceiling of the mutex, used in the priority protectionprotocol to prevent priority inversions. It has no meaning if themutex uses another protocol.Note:	The pthread.h header file must be the first included file ofeach source file using the threads library.Parametersmutex	Specifies the target mutex.prioceiling	Points to where the prioceiling attribute value will bestored.Return ValuesUpon successful completion, the current value of the prioceiling attributeis returned via the prioceiling parameter, and 0 is returned. Otherwise,an error code is returned.Error CodesThe pthread_mutex_getprioceiling subroutine is unsuccessful if thefollowing is true:EINVAL	The mutex parameter is not valid.ENOSYS	The priority protection POSIX option is not implemented.EPERM	The calling thread does not have the privilege to perform theoperation.ESRCH	The mutex mutex does not exist.Implementation SpecificsThis subroutine is part of the Base Operating System (BOS) Runtime.The implementation of this subroutine is dependent on the priorityprotection POSIX option. The priority protection POSIX option is notimplemented in the current version of AIX.Related InformationThe pthread_mutex_setprioceiling subroutine, pthread_mutexattr_getprioceilingsubroutine.Synchronization Scheduling.Threads Library Options.Threads Library Quick Reference.