code.delx.au - pulseaudio/blob - src/pulsecore/once.c

   1 /* $Id$ */
   2
   3 /***
   4   This file is part of PulseAudio.
   5
   6   Copyright 2006 Lennart Poettering
   7
   8   PulseAudio is free software; you can redistribute it and/or modify
   9   it under the terms of the GNU Lesser General Public License as published
  10   by the Free Software Foundation; either version 2 of the License,
  11   or (at your option) any later version.
  12
  13   PulseAudio is distributed in the hope that it will be useful, but
  14   WITHOUT ANY WARRANTY; without even the implied warranty of
  15   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  16   General Public License for more details.
  17
  18   You should have received a copy of the GNU Lesser General Public License
  19   along with PulseAudio; if not, write to the Free Software
  20   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  21   USA.
  22 ***/
  23
  24 #ifdef HAVE_CONFIG_H
  25 #include <config.h>
  26 #endif
  27
  28 #include <pulsecore/macro.h>
  29 #include <pulsecore/mutex.h>
  30
  31 #include "once.h"
  32
  33 int pa_once_begin(pa_once *control) {
  34     pa_mutex *m;
  35
  36     pa_assert(control);
  37
  38     if (pa_atomic_load(&control->done))
  39         return 0;
  40
  41     pa_atomic_inc(&control->ref);
  42
  43     /* Caveat: We have to make sure that the once func has completed
  44      * before returning, even if the once func is not actually
  45      * executed by us. Hence the awkward locking. */
  46
  47     for (;;) {
  48
  49         if ((m = pa_atomic_ptr_load(&control->mutex))) {
  50
  51             /* The mutex is stored in locked state, hence let's just
  52              * wait until it is unlocked */
  53             pa_mutex_lock(m);
  54
  55             pa_once_end(control);
  56             return 0;
  57         }
  58
  59         pa_assert_se(m = pa_mutex_new(FALSE, FALSE));
  60         pa_mutex_lock(m);
  61
  62         if (pa_atomic_ptr_cmpxchg(&control->mutex, NULL, m))
  63             return 1;
  64
  65         pa_mutex_unlock(m);
  66         pa_mutex_free(m);
  67     }
  68 }
  69
  70 void pa_once_end(pa_once *control) {
  71     pa_mutex *m;
  72
  73     pa_assert(control);
  74
  75     pa_atomic_store(&control->done, 1);
  76
  77     pa_assert_se(m = pa_atomic_ptr_load(&control->mutex));
  78     pa_mutex_unlock(m);
  79
  80     if (pa_atomic_dec(&control->ref) <= 1) {
  81         pa_assert_se(pa_atomic_ptr_cmpxchg(&control->mutex, m, NULL));
  82         pa_mutex_free(m);
  83     }
  84 }
  85
  86 /* Not reentrant -- how could it be? */
  87 void pa_run_once(pa_once *control, pa_once_func_t func) {
  88     pa_assert(control);
  89     pa_assert(func);
  90
  91     if (pa_once_begin(control)) {
  92         func();
  93         pa_once_end(control);
  94     }
  95 }
  96