summaryrefslogtreecommitdiff
path: root/libobjc/objc/objc-sync.h
diff options
context:
space:
mode:
Diffstat (limited to 'libobjc/objc/objc-sync.h')
-rw-r--r--libobjc/objc/objc-sync.h69
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 */