lumiera_/src/lib/rwlock.c

/*
  rwlock.c  -  read/write locks

  Copyright (C)         Lumiera.org
    2008,               Christian Thaeter <ct@pipapo.org>

  This program is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License as
  published by the Free Software Foundation; either version 2 of the
  License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#define _GNU_SOURCE

#include <errno.h>
#include "lib/rwlock.h"

LUMIERA_ERROR_DEFINE(RWLOCK_AGAIN, "maximum number of readlocks exceed");
LUMIERA_ERROR_DEFINE(RWLOCK_DEADLOCK, "deadlock detected");

/**
 * @file Read/write locks.
 */


/**
 * Initialize a rwlock
 * @param self is a pointer to the rwlock to be initialized
 * @return self as given
 */
LumieraRWLock
lumiera_rwlock_init (LumieraRWLock self)
{
  if (self)
    {
      pthread_rwlock_init (&self->rwlock, NULL);
    }
  return self;
}

/**
 * destroy a rwlock
 * @param self is a pointer to the rwlock to be initialized
 * @return self on success or NULL at error
 */
LumieraRWLock
lumiera_rwlock_destroy (LumieraRWLock self)
{
  if (self)
    {
      if (pthread_rwlock_destroy (&self->rwlock))
        LUMIERA_DIE;
    }
  return self;
}




/**
 * initialize a rwlockacquirer state
 * @param self rwlockacquirer to be initialized, must be an automatic variable
 * @param rwlock associated rwlock
 * @param state initial state of the mutex, either LUMIERA_RDLOCKED, LUMIERA_WRLOCKED or LUMIERA_UNLOCKED
 * @return self as given or NULL on error
 */
LumieraRWLockacquirer
lumiera_rwlockacquirer_init (LumieraRWLockacquirer self, LumieraRWLock rwlock, enum lumiera_lockstate state)
{
  REQUIRE (self);
  REQUIRE (rwlock);
  REQUIRE (state != LUMIERA_LOCKED, "illegal state for rwlock");
  self->rwlock = rwlock;
  self->state = state;

  switch (state)
    {
    case LUMIERA_RDLOCKED:
      switch (pthread_rwlock_rdlock (&rwlock->rwlock))
        {
        case 0:
          break;
        case EAGAIN:
          lumiera_error_set (LUMIERA_ERROR_RWLOCK_AGAIN);
          return NULL;
        case EDEADLK:
          lumiera_error_set (LUMIERA_ERROR_RWLOCK_DEADLOCK);
          return NULL;
        default:
          LUMIERA_DIE;
        }
    case LUMIERA_WRLOCKED:
      switch (pthread_rwlock_wrlock (&rwlock->rwlock))
        {
        case 0:
          break;
        case EDEADLK:
          lumiera_error_set (LUMIERA_ERROR_RWLOCK_DEADLOCK);
          return NULL;
        default:
          LUMIERA_DIE;
        }
    default:
      break;
    }
  return self;
}


/**
 * readlock the rwlock.
 * must not already be locked
 * @param self rwlockacquirer associated with a rwlock
 * @return self as given or NULL on error
 */
LumieraRWLockacquirer
lumiera_rwlockacquirer_rdlock (LumieraRWLockacquirer self)
{
  REQUIRE (self);
  REQUIRE (self->state == LUMIERA_UNLOCKED, "rwlock already locked");

  switch (pthread_rwlock_rdlock (&self->rwlock->rwlock))
    {
    case 0:
      break;
    case EAGAIN:
      lumiera_error_set (LUMIERA_ERROR_RWLOCK_AGAIN);
      return NULL;
    case EDEADLK:
      lumiera_error_set (LUMIERA_ERROR_RWLOCK_DEADLOCK);
      return NULL;
    default:
      LUMIERA_DIE;
    }

  self->state = LUMIERA_RDLOCKED;
  return self;
}


/**
 * writelock the rwlock.
 * must not already be locked
 * @param self rwlockacquirer associated with a rwlock
 * @return self as given or NULL on error
 */
LumieraRWLockacquirer
lumiera_rwlockacquirer_wrlock (LumieraRWLockacquirer self)
{
  REQUIRE (self);
  REQUIRE (self->state == LUMIERA_UNLOCKED, "rwlock already locked");

  switch (pthread_rwlock_wrlock (&self->rwlock->rwlock))
    {
    case 0:
      break;
    case EDEADLK:
      lumiera_error_set (LUMIERA_ERROR_RWLOCK_DEADLOCK);
      return NULL;
    default:
      LUMIERA_DIE;
    }

  self->state = LUMIERA_WRLOCKED;
  return self;
}