lib/libthr/thread/thr_mutex_prioceiling.c

   1 /*
   2  * Copyright (c) 1998 Daniel Eischen <eischen@vigrid.com>.
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  * 3. All advertising materials mentioning features or use of this software
  14  *    must display the following acknowledgement:
  15  *      This product includes software developed by Daniel Eischen.
  16  * 4. Neither the name of the author nor the names of any co-contributors
  17  *    may be used to endorse or promote products derived from this software
  18  *    without specific prior written permission.
  19  *
  20  * THIS SOFTWARE IS PROVIDED BY DANIEL EISCHEN AND CONTRIBUTORS ``AS IS'' AND
  21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30  * SUCH DAMAGE.
  31  *
  32  * $FreeBSD$
  33  */
  34 #include <string.h>
  35 #include <stdlib.h>
  36 #include <errno.h>
  37 #include <pthread.h>
  38 #include "thr_private.h"
  39
  40 __weak_reference(_pthread_mutexattr_getprioceiling, pthread_mutexattr_getprioceiling);
  41 __weak_reference(_pthread_mutexattr_setprioceiling, pthread_mutexattr_setprioceiling);
  42 __weak_reference(_pthread_mutex_getprioceiling, pthread_mutex_getprioceiling);
  43 __weak_reference(_pthread_mutex_setprioceiling, pthread_mutex_setprioceiling);
  44
  45 int
  46 _pthread_mutexattr_getprioceiling(pthread_mutexattr_t *mattr, int *prioceiling)
  47 {
  48         int ret = 0;
  49
  50         if (*mattr == NULL)
  51                 ret = EINVAL;
  52         else
  53                 *prioceiling = (*mattr)->m_ceiling;
  54
  55         return(ret);
  56 }
  57
  58 int
  59 _pthread_mutexattr_setprioceiling(pthread_mutexattr_t *mattr, int prioceiling)
  60 {
  61         int ret = 0;
  62
  63         if (*mattr == NULL)
  64                 ret = EINVAL;
  65         else if (prioceiling <= PTHREAD_MAX_PRIORITY &&
  66             prioceiling >= PTHREAD_MIN_PRIORITY)
  67                 (*mattr)->m_ceiling = prioceiling;
  68         else
  69                 ret = EINVAL;
  70
  71         return (ret);
  72 }
  73
  74 int
  75 _pthread_mutex_getprioceiling(pthread_mutex_t *mutex,
  76                               int *prioceiling)
  77 {
  78         if (*mutex == NULL)
  79                 return (EINVAL);
  80         else
  81                 *prioceiling = (*mutex)->m_prio;
  82         return (0);
  83 }
  84
  85 int
  86 _pthread_mutex_setprioceiling(pthread_mutex_t *mutex,
  87                               int prioceiling, int *old_ceiling)
  88 {
  89         int ret = 0;
  90
  91         if (*mutex == NULL)
  92                 return (EINVAL);
  93         else if (prioceiling > PTHREAD_MAX_PRIORITY ||
  94             prioceiling < PTHREAD_MIN_PRIORITY)
  95                 return (EINVAL);
  96
  97         /*
  98          * Because of the use of pthread_mutex_unlock(), the
  99          * priority ceiling of a mutex cannot be changed
 100          * while the mutex is held by another thread. It also,
 101          * means that the the thread trying to change the
 102          * priority ceiling must adhere to prio protection rules.
 103          */
 104         if ((ret = pthread_mutex_lock(mutex)) == 0) {
 105                 /* Return the old ceiling and set the new ceiling: */
 106                 *old_ceiling = (*mutex)->m_prio;
 107                 (*mutex)->m_prio = prioceiling;
 108
 109                 /* Unlock the mutex: */
 110                 ret = pthread_mutex_unlock(mutex);
 111         }
 112         return(ret);
 113 }