locks.h revision 5c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5
1a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten/* 2a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * Copyright (C) 2010 The Android Open Source Project 3a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * 4a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * Licensed under the Apache License, Version 2.0 (the "License"); 5a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * you may not use this file except in compliance with the License. 6a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * You may obtain a copy of the License at 7a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * 8a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * http://www.apache.org/licenses/LICENSE-2.0 9a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * 10a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * Unless required by applicable law or agreed to in writing, software 11a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * distributed under the License is distributed on an "AS IS" BASIS, 12a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * See the License for the specific language governing permissions and 14a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten * limitations under the License. 15a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten */ 16a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten 17369f3138f19f7102bf0f98b890ab84c8df633a93Glenn Kasten/** \file locks.h Mutual exclusion and condition variables */ 18369f3138f19f7102bf0f98b890ab84c8df633a93Glenn Kasten 19fe96fa06360516c60490c7a697e1148017b4c1b2Glenn Kasten#ifdef USE_DEBUG 20fe96fa06360516c60490c7a697e1148017b4c1b2Glenn Kastenextern void object_lock_exclusive_(IObject *this, const char *file, int line); 214597a7427b697df31d0bbf4c2040806d0c27b6e0Glenn Kastenextern void object_unlock_exclusive_(IObject *this, const char *file, int line); 224597a7427b697df31d0bbf4c2040806d0c27b6e0Glenn Kastenextern void object_unlock_exclusive_attributes_(IObject *this, unsigned attr, 234597a7427b697df31d0bbf4c2040806d0c27b6e0Glenn Kasten const char *file, int line); 244f064c143ef2b26347130a49788116b5d2e1252aGlenn Kastenextern void object_cond_wait_(IObject *this, const char *file, int line); 25fe96fa06360516c60490c7a697e1148017b4c1b2Glenn Kasten#else 264f064c143ef2b26347130a49788116b5d2e1252aGlenn Kastenextern void object_lock_exclusive(IObject *this); 27a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kastenextern void object_unlock_exclusive(IObject *this); 28e5bf0d2c9531a7064eb3ddcafaf93ac1b0974037Glenn Kastenextern void object_unlock_exclusive_attributes(IObject *this, unsigned attr); 294597a7427b697df31d0bbf4c2040806d0c27b6e0Glenn Kastenextern void object_cond_wait(IObject *this); 304597a7427b697df31d0bbf4c2040806d0c27b6e0Glenn Kasten#endif 31a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kastenextern void object_cond_signal(IObject *this); 32a438eb1cf1ae602afab00336528dd230bd929206Glenn Kastenextern void object_cond_broadcast(IObject *this); 33a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten 34fe96fa06360516c60490c7a697e1148017b4c1b2Glenn Kasten#ifdef USE_DEBUG 35fe96fa06360516c60490c7a697e1148017b4c1b2Glenn Kasten#define object_lock_exclusive(this) object_lock_exclusive_((this), __FILE__, __LINE__) 364597a7427b697df31d0bbf4c2040806d0c27b6e0Glenn Kasten#define object_unlock_exclusive(this) object_unlock_exclusive_((this), __FILE__, __LINE__) 374597a7427b697df31d0bbf4c2040806d0c27b6e0Glenn Kasten#define object_unlock_exclusive_attributes(this, attr) \ 384597a7427b697df31d0bbf4c2040806d0c27b6e0Glenn Kasten object_unlock_exclusive_attributes_((this), (attr), __FILE__, __LINE__) 394f064c143ef2b26347130a49788116b5d2e1252aGlenn Kasten#define object_cond_wait(this) object_cond_wait_((this), __FILE__, __LINE__) 40fe96fa06360516c60490c7a697e1148017b4c1b2Glenn Kasten#endif 41fe96fa06360516c60490c7a697e1148017b4c1b2Glenn Kasten 42a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten// Currently shared locks are implemented as exclusive, but don't count on it 43a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten 44a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten#define object_lock_shared(this) object_lock_exclusive(this) 45a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten#define object_unlock_shared(this) object_unlock_exclusive(this) 46a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten 47d07ed7df4ec9338f97f12627690d58ed9b34f25bGlenn Kasten// Currently interface locks are actually on whole object, but don't count on it. 48d07ed7df4ec9338f97f12627690d58ed9b34f25bGlenn Kasten// These operations are undefined on IObject, as it lacks an mThis. 49d07ed7df4ec9338f97f12627690d58ed9b34f25bGlenn Kasten// If you have an IObject, then use the object_ functions instead. 50a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten 51d07ed7df4ec9338f97f12627690d58ed9b34f25bGlenn Kasten#define interface_lock_exclusive(this) object_lock_exclusive(InterfaceToIObject(this)) 52d07ed7df4ec9338f97f12627690d58ed9b34f25bGlenn Kasten#define interface_unlock_exclusive(this) object_unlock_exclusive(InterfaceToIObject(this)) 53e5bf0d2c9531a7064eb3ddcafaf93ac1b0974037Glenn Kasten#define interface_unlock_exclusive_attributes(this, attr) \ 54e5bf0d2c9531a7064eb3ddcafaf93ac1b0974037Glenn Kasten object_unlock_exclusive_attributes(InterfaceToIObject(this), (attr)) 55d07ed7df4ec9338f97f12627690d58ed9b34f25bGlenn Kasten#define interface_lock_shared(this) object_lock_shared(InterfaceToIObject(this)) 56d07ed7df4ec9338f97f12627690d58ed9b34f25bGlenn Kasten#define interface_unlock_shared(this) object_unlock_shared(InterfaceToIObject(this)) 57d07ed7df4ec9338f97f12627690d58ed9b34f25bGlenn Kasten#define interface_cond_wait(this) object_cond_wait(InterfaceToIObject(this)) 58d07ed7df4ec9338f97f12627690d58ed9b34f25bGlenn Kasten#define interface_cond_signal(this) object_cond_signal(InterfaceToIObject(this)) 594b65ef9efdf5aba01bea89d8cdd64f500560a28dGlenn Kasten#define interface_cond_broadcast(this) object_cond_broadcast(InterfaceToIObject(this)) 60a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten 615c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5Glenn Kasten// Peek and poke are an optimization for small atomic fields that don't "matter". 625c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5Glenn Kasten// Don't use for struct, as struct copy might not be atomic. 635c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5Glenn Kasten// On uniprocessor they can be no-ops, on SMP they could be memory barriers but locks are easier. 64a6d984c32855a239f7f79a3d3b7f2ddfb8cb9697Glenn Kasten 655c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5Glenn Kasten#define object_lock_peek(this) object_lock_shared(this) 665c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5Glenn Kasten#define object_unlock_peek(this) object_unlock_shared(this) 675c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5Glenn Kasten#define interface_lock_poke(this) interface_lock_exclusive(this) 685c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5Glenn Kasten#define interface_unlock_poke(this) interface_unlock_exclusive(this) 695c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5Glenn Kasten#define interface_lock_peek(this) interface_lock_shared(this) 705c8bd83295b2752bb7ac34f83dfb19dcdb1be5e5Glenn Kasten#define interface_unlock_peek(this) interface_unlock_shared(this) 71