pthread_mutex_getprioceiling(3p) - phpMan

PTHREAD_MUTEX_GETPRIOCEILING(P)                PTHREAD_MUTEX_GETPRIOCEILING(P)



NAME
       pthread_mutex_getprioceiling, pthread_mutex_setprioceiling - get and set the prior-
       ity ceiling of a mutex (REALTIME THREADS)

SYNOPSIS
       #include <pthread.h>

       int pthread_mutex_getprioceiling(const pthread_mutex_t *restrict mutex,
              int *restrict prioceiling);
       int pthread_mutex_setprioceiling(pthread_mutex_t *restrict mutex,
              int prioceiling, int *restrict old_ceiling);


DESCRIPTION
       The pthread_mutex_getprioceiling() function shall return the current priority ceil-
       ing of the mutex.

       The  pthread_mutex_setprioceiling()  function  shall either lock the mutex if it is
       unlocked, or block until it can successfully lock the mutex, then it  shall  change
       the  mutex’s priority ceiling and release the mutex. When the change is successful,
       the previous value of the priority ceiling shall be returned  in  old_ceiling.  The
       process of locking the mutex need not adhere to the priority protect protocol.

       If  the  pthread_mutex_setprioceiling()  function fails, the mutex priority ceiling
       shall not be changed.

RETURN VALUE
       If successful, the  pthread_mutex_getprioceiling()  and  pthread_mutex_setprioceil-
       ing()  functions shall return zero; otherwise, an error number shall be returned to
       indicate the error.

ERRORS
       The pthread_mutex_getprioceiling() and pthread_mutex_setprioceiling() functions may
       fail if:

       EINVAL The priority requested by prioceiling is out of range.

       EINVAL The value specified by mutex does not refer to a currently existing mutex.

       EPERM  The caller does not have the privilege to perform the operation.


       These functions shall not return an error code of [EINTR].

       The following sections are informative.

EXAMPLES
       None.

APPLICATION USAGE
       None.

RATIONALE
       None.

FUTURE DIRECTIONS
       None.

SEE ALSO
       pthread_mutex_destroy()  ,  pthread_mutex_lock()  , pthread_mutex_timedlock() , the
       Base Definitions volume of IEEE Std 1003.1-2001, <pthread.h>

COPYRIGHT
       Portions of this text are reprinted and reproduced in electronic form from IEEE Std
       1003.1,  2003  Edition,  Standard  for Information Technology -- Portable Operating
       System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C)
       2001-2003  by  the  Institute  of Electrical and Electronics Engineers, Inc and The
       Open Group. In the event of any discrepancy between this version and  the  original
       IEEE  and The Open Group Standard, the original IEEE and The Open Group Standard is
       the  referee  document.  The  original  Standard  can   be   obtained   online   at
       http://www.opengroup.org/unix/online.html .



POSIX                                2003      PTHREAD_MUTEX_GETPRIOCEILING(P)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-10 11:12 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)