diff options
Diffstat (limited to 'libobjc/objc/objc-sync.h')
-rw-r--r-- | libobjc/objc/objc-sync.h | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/libobjc/objc/objc-sync.h b/libobjc/objc/objc-sync.h new file mode 100644 index 000000000..04d1db653 --- /dev/null +++ b/libobjc/objc/objc-sync.h @@ -0,0 +1,69 @@ +/* GNU Objective C Runtime @synchronized implementation + Copyright (C) 2010 Free Software Foundation, Inc. + Contributed by Nicola Pero <nicola.pero@meta-innovation.com> + +This file is part of GCC. + +GCC 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 3, or (at your option) +any later version. + +GCC 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. + +Under Section 7 of GPL version 3, you are granted additional +permissions described in the GCC Runtime Library Exception, version +3.1, as published by the Free Software Foundation. + +You should have received a copy of the GNU General Public License and +a copy of the GCC Runtime Library Exception along with this program; +see the files COPYING3 and COPYING.RUNTIME respectively. If not, see +<http://www.gnu.org/licenses/>. */ + +#ifndef __objc_sync_INCLUDE_GNU +#define __objc_sync_INCLUDE_GNU + +#include "objc.h" +#include "objc-decls.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* These functions are automatically called by @synchronized(). */ + +/* 'objc_sync_enter' is automatically called when entering a + @synchronized() block. It locks the recursive lock associated with + 'object'. If 'object' is nil, it does nothing. It returns + OBJC_SYNC_SUCCESS on success; see the enumeration below for error + values. + + Note that you should not rely on the behaviour when 'object' is nil + because it could change. */ +objc_EXPORT int objc_sync_enter (id object); + +/* 'objc_sync_exit' is automatically called when exiting from a + @synchronized() block. It unlocks the recursive lock associated + with 'object'. If 'object' is nil, it does nothing. It returns + OBJC_SYNC_SUCCESS on success; see the enumeration below for error + values. */ +objc_EXPORT int objc_sync_exit (id object); + +/* All the possible return values for objc_sync_enter() and + objc_sync_exit(). + */ +enum { + OBJC_SYNC_SUCCESS = 0, + OBJC_SYNC_NOT_OWNING_THREAD_ERROR = -1, + OBJC_SYNC_TIMED_OUT = -2, + OBJC_SYNC_NOT_INITIALIZED = -3 +}; + +#ifdef __cplusplus +} +#endif + +#endif /* not __objc_sync_INCLUDE_GNU */ |