src/pulsecore/mutex.h

   1 #ifndef foopulsemutexhfoo
   2 #define foopulsemutexhfoo
   3
   4 /***
   5   This file is part of PulseAudio.
   6
   7   Copyright 2006 Lennart Poettering
   8
   9   PulseAudio is free software; you can redistribute it and/or modify
  10   it under the terms of the GNU Lesser General Public License as
  11   published by the Free Software Foundation; either version 2.1 of the
  12   License, or (at your option) any later version.
  13
  14   PulseAudio is distributed in the hope that it will be useful, but
  15   WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17   General Public License for more details.
  18
  19   You should have received a copy of the GNU Lesser General Public
  20   License along with PulseAudio; if not, see <http://www.gnu.org/licenses/>.
  21 ***/
  22
  23 #include <pulsecore/macro.h>
  24 #include <pulsecore/atomic.h>
  25
  26 typedef struct pa_mutex pa_mutex;
  27
  28 /* Please think twice before enabling priority inheritance. This is no
  29  * magic wand! Use it only when the potentially prioritized threads are
  30  * good candidates for it. Don't use this blindly! Also, note that
  31  * only very few operating systems actually implement this, hence this
  32  * is merely a hint. */
  33 pa_mutex* pa_mutex_new(bool recursive, bool inherit_priority);
  34
  35 void pa_mutex_free(pa_mutex *m);
  36 void pa_mutex_lock(pa_mutex *m);
  37 bool pa_mutex_try_lock(pa_mutex *m);
  38 void pa_mutex_unlock(pa_mutex *m);
  39
  40 typedef struct pa_cond pa_cond;
  41
  42 pa_cond *pa_cond_new(void);
  43 void pa_cond_free(pa_cond *c);
  44 void pa_cond_signal(pa_cond *c, int broadcast);
  45 int pa_cond_wait(pa_cond *c, pa_mutex *m);
  46 #ifdef __TIZEN__
  47 int pa_cond_timedwait(pa_cond *c, pa_mutex *m, int ms_to_wait);
  48 #endif
  49
  50 /* Static mutexes are basically just atomically updated pointers to pa_mutex objects */
  51
  52 typedef struct pa_static_mutex {
  53     pa_atomic_ptr_t ptr;
  54 } pa_static_mutex;
  55
  56 #define PA_STATIC_MUTEX_INIT { PA_ATOMIC_PTR_INIT(NULL) }
  57
  58 pa_mutex* pa_static_mutex_get(pa_static_mutex *m, bool recursive, bool inherit_priority);
  59
  60 #endif