astobj2_global.c

Go to the documentation of this file.

/*
 * astobj2_global - global containers for AO2 objects.
 *
 * Copyright (C) 2006 Marta Carbone, Luigi Rizzo - Univ. di Pisa, Italy
 *
 * See http://www.asterisk.org for more information about
 * the Asterisk project. Please do not directly contact
 * any of the maintainers of this project for assistance;
 * the project provides a web site, mailing lists and IRC
 * channels for your use.
 *
 * This program is free software, distributed under the terms of
 * the GNU General Public License Version 2. See the LICENSE file
 * at the top of the source tree.
 */

/*! \file
 *
 * \brief Functions implementing ao2_global_obj routines.
 *
 * \author Richard Mudgett <[email protected]>
 */

/*** MODULEINFO
   <support_level>core</support_level>
 ***/

#include "asterisk.h"

#include "asterisk/astobj2.h"
#include "asterisk/utils.h"

void *__ao2_global_obj_replace(struct ao2_global_obj *holder, void *obj, const char *tag, const char *file, int line, const char *func, const char *name)
{
   void *obj_old;

   if (!holder) {
      /* For sanity */
      ast_log(LOG_ERROR, "Must be called with a global object!\n");
      ast_assert(0);
      return NULL;
   }
   if (__ast_rwlock_wrlock(file, line, func, &holder->lock, name)) {
      /* Could not get the write lock. */
      ast_assert(0);
      return NULL;
   }

   if (obj) {
      __ao2_ref(obj, +1, tag, file, line, func);
   }
   obj_old = holder->obj;
   holder->obj = obj;

   __ast_rwlock_unlock(file, line, func, &holder->lock, name);

   return obj_old;
}

int __ao2_global_obj_replace_unref(struct ao2_global_obj *holder, void *obj, const char *tag, const char *file, int line, const char *func, const char *name)
{
   void *obj_old;

   obj_old = __ao2_global_obj_replace(holder, obj, tag, file, line, func, name);
   if (obj_old) {
      __ao2_ref(obj_old, -1, tag, file, line, func);
      return 1;
   }
   return 0;
}

void *__ao2_global_obj_ref(struct ao2_global_obj *holder, const char *tag, const char *file, int line, const char *func, const char *name)
{
   void *obj;

   if (!holder) {
      /* For sanity */
      ast_log(LOG_ERROR, "Must be called with a global object!\n");
      ast_assert(0);
      return NULL;
   }

   if (__ast_rwlock_rdlock(file, line, func, &holder->lock, name)) {
      /* Could not get the read lock. */
      ast_assert(0);
      return NULL;
   }

   obj = holder->obj;
   if (obj) {
      __ao2_ref(obj, +1, tag, file, line, func);
   }

   __ast_rwlock_unlock(file, line, func, &holder->lock, name);

   return obj;
}