From 7fe60435bce6595a9c58a9bfd8244d74b5320e96 Mon Sep 17 00:00:00 2001 From: Benjamin Franzke Date: Tue, 15 Jan 2013 08:46:13 +0100 Subject: Import DirectFB141_2k11R3_beta5 --- Source/DirectFB/lib/fusion/ref.h | 134 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 134 insertions(+) create mode 100755 Source/DirectFB/lib/fusion/ref.h (limited to 'Source/DirectFB/lib/fusion/ref.h') diff --git a/Source/DirectFB/lib/fusion/ref.h b/Source/DirectFB/lib/fusion/ref.h new file mode 100755 index 0000000..b9beda7 --- /dev/null +++ b/Source/DirectFB/lib/fusion/ref.h @@ -0,0 +1,134 @@ +/* + (c) Copyright 2001-2009 The world wide DirectFB Open Source Community (directfb.org) + (c) Copyright 2000-2004 Convergence (integrated media) GmbH + + All rights reserved. + + Written by Denis Oliver Kropp , + Andreas Hundt , + Sven Neumann , + Ville Syrjälä and + Claudio Ciccani . + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library 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 + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the + Free Software Foundation, Inc., 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA. +*/ + +#ifndef __FUSION__REF_H__ +#define __FUSION__REF_H__ + +#include + +#include +#include +#include + +typedef union { + /* multi app */ + struct { + int id; + const FusionWorldShared *shared; + FusionID creator; + /* builtin impl */ + struct { + int local; + int global; + FusionSkirmish lock; + + FusionCall *call; + int call_arg; + } builtin; + } multi; + + /* single app */ + struct { + int refs; + pthread_cond_t cond; + pthread_mutex_t lock; + bool destroyed; + int locked; + + FusionCall *call; + int call_arg; + } single; +} FusionRef; + +/* + * Initialize. + */ +DirectResult fusion_ref_init (FusionRef *ref, + const char *name, + const FusionWorld *world); + +DirectResult fusion_ref_set_name (FusionRef *ref, + const char *name); + +/* + * Lock, increase, unlock. + */ +DirectResult fusion_ref_up (FusionRef *ref, bool global); + +/* + * Lock, decrease, unlock. + */ +DirectResult fusion_ref_down (FusionRef *ref, bool global); + +/* + * Get the current reference count. Meant for debugging only. + * This value is not reliable, because no locking will be performed + * and the value may change after or even while returning it. + */ +DirectResult fusion_ref_stat (FusionRef *ref, int *refs); + +/* + * Wait for zero and lock. + */ +DirectResult fusion_ref_zero_lock (FusionRef *ref); + +/* + * Check for zero and lock if true. + */ +DirectResult fusion_ref_zero_trylock (FusionRef *ref); + +/* + * Unlock the counter. + * Only to be called after successful zero_lock or zero_trylock. + */ +DirectResult fusion_ref_unlock (FusionRef *ref); + +/* + * Have the call executed when reference counter reaches zero. + */ +DirectResult fusion_ref_watch (FusionRef *ref, + FusionCall *call, + int call_arg); + +/* + * Inherit local reference count from another reference. + * + * The local count of the other reference (and its inherited references) is added to this reference. + */ +DirectResult fusion_ref_inherit (FusionRef *ref, + FusionRef *from); + +/* + * Deinitialize. + * Can be called after successful zero_lock or zero_trylock + * so that waiting fusion_ref_up calls return with DR_DESTROYED. + */ +DirectResult fusion_ref_destroy (FusionRef *ref); + +#endif + -- cgit