]> git.ipfire.org Git - thirdparty/gcc.git/blame - libobjc/objc/objc-sync.h
Update copyright years.
[thirdparty/gcc.git] / libobjc / objc / objc-sync.h
CommitLineData
fd312537 1/* GNU Objective C Runtime @synchronized implementation
8d9254fc 2 Copyright (C) 2010-2020 Free Software Foundation, Inc.
fd312537
NP
3 Contributed by Nicola Pero <nicola.pero@meta-innovation.com>
4
5This file is part of GCC.
6
7GCC is free software; you can redistribute it and/or modify
8it under the terms of the GNU General Public License as published by
9the Free Software Foundation; either version 3, or (at your option)
10any later version.
11
12GCC is distributed in the hope that it will be useful,
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17Under Section 7 of GPL version 3, you are granted additional
18permissions described in the GCC Runtime Library Exception, version
193.1, as published by the Free Software Foundation.
20
21You should have received a copy of the GNU General Public License and
22a copy of the GCC Runtime Library Exception along with this program;
23see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
24<http://www.gnu.org/licenses/>. */
25
26#ifndef __objc_sync_INCLUDE_GNU
27#define __objc_sync_INCLUDE_GNU
28
29#include "objc.h"
805a07f1 30#include "objc-decls.h"
fd312537
NP
31
32#ifdef __cplusplus
33extern "C" {
34#endif
35
36/* These functions are automatically called by @synchronized(). */
37
38/* 'objc_sync_enter' is automatically called when entering a
39 @synchronized() block. It locks the recursive lock associated with
40 'object'. If 'object' is nil, it does nothing. It returns
41 OBJC_SYNC_SUCCESS on success; see the enumeration below for error
42 values.
43
44 Note that you should not rely on the behaviour when 'object' is nil
805a07f1
NP
45 because it could change. */
46objc_EXPORT int objc_sync_enter (id object);
fd312537
NP
47
48/* 'objc_sync_exit' is automatically called when exiting from a
49 @synchronized() block. It unlocks the recursive lock associated
50 with 'object'. If 'object' is nil, it does nothing. It returns
51 OBJC_SYNC_SUCCESS on success; see the enumeration below for error
805a07f1
NP
52 values. */
53objc_EXPORT int objc_sync_exit (id object);
fd312537
NP
54
55/* All the possible return values for objc_sync_enter() and
56 objc_sync_exit().
57 */
58enum {
59 OBJC_SYNC_SUCCESS = 0,
60 OBJC_SYNC_NOT_OWNING_THREAD_ERROR = -1,
61 OBJC_SYNC_TIMED_OUT = -2,
62 OBJC_SYNC_NOT_INITIALIZED = -3
63};
64
65#ifdef __cplusplus
66}
67#endif
68
69#endif /* not __objc_sync_INCLUDE_GNU */