]> git.saurik.com Git - apple/xnu.git/blame - libkern/os/object_private.h
xnu-6153.61.1.tar.gz
[apple/xnu.git] / libkern / os / object_private.h
CommitLineData
39037602
A
1/*
2 * Copyright (c) 2011-2012 Apple Inc. All rights reserved.
3 *
4 * @APPLE_APACHE_LICENSE_HEADER_START@
5 *
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
9 *
10 * http://www.apache.org/licenses/LICENSE-2.0
11 *
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
17 *
18 * @APPLE_APACHE_LICENSE_HEADER_END@
19 */
20
21/*
22 * IMPORTANT: This header file describes INTERNAL interfaces to libdispatch
23 * which are subject to change in future releases of Mac OS X. Any applications
24 * relying on these interfaces WILL break.
25 */
26
27#ifndef __OS_OBJECT_PRIVATE__
28#define __OS_OBJECT_PRIVATE__
29
30#include <sys/cdefs.h>
31#include <stddef.h>
32#include <os/object.h>
33
34#ifndef __OSX_AVAILABLE_STARTING
35#define __OSX_AVAILABLE_STARTING(x, y)
36#endif
37
38#if __GNUC__
39#define OS_OBJECT_NOTHROW __attribute__((__nothrow__))
40#define OS_OBJECT_NONNULL __attribute__((__nonnull__))
41#define OS_OBJECT_WARN_RESULT __attribute__((__warn_unused_result__))
42#define OS_OBJECT_MALLOC __attribute__((__malloc__))
43#define OS_OBJECT_EXPORT extern __attribute__((visibility("default")))
44#else
45/*! @parseOnly */
46#define OS_OBJECT_NOTHROW
47/*! @parseOnly */
48#define OS_OBJECT_NONNULL
49/*! @parseOnly */
50#define OS_OBJECT_WARN_RESULT
51/*! @parseOnly */
52#define OS_OBJECT_MALLOC
53#define OS_OBJECT_EXPORT extern
54#endif
55
56#if OS_OBJECT_USE_OBJC && defined(__has_feature)
57#if __has_feature(objc_arc)
58#define _OS_OBJECT_OBJC_ARC 1
59#else
60#define _OS_OBJECT_OBJC_ARC 0
61#endif
62#else
63#define _OS_OBJECT_OBJC_ARC 0
64#endif
65
66#define _OS_OBJECT_GLOBAL_REFCNT INT_MAX
67
68#define _OS_OBJECT_HEADER(isa, ref_cnt, xref_cnt) \
0a7de745
A
69 isa; /* must be pointer-sized */ \
70 int volatile ref_cnt; \
71 int volatile xref_cnt
39037602
A
72
73#if OS_OBJECT_HAVE_OBJC_SUPPORT
74// Must match size of compiler-generated OBJC_CLASS structure rdar://10640168
75#define _OS_OBJECT_CLASS_HEADER() \
0a7de745 76 void *_os_obj_objc_class_t[5]
39037602
A
77#else
78#define _OS_OBJECT_CLASS_HEADER() \
0a7de745
A
79 void (*_os_obj_xref_dispose)(_os_object_t); \
80 void (*_os_obj_dispose)(_os_object_t)
39037602
A
81#endif
82
83#define OS_OBJECT_CLASS(name) OS_##name
84
85#if OS_OBJECT_USE_OBJC
0a7de745 86__OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0)
39037602
A
87OS_OBJECT_EXPORT
88@interface OS_OBJECT_CLASS(object) : NSObject
89- (void)_xref_dispose;
90- (void)_dispose;
91@end
92typedef OS_OBJECT_CLASS(object) *_os_object_t;
93#define _OS_OBJECT_DECL_SUBCLASS_INTERFACE(name, super) \
0a7de745
A
94 @interface OS_OBJECT_CLASS(name) : OS_OBJECT_CLASS(super) \
95 <OS_OBJECT_CLASS(name)> \
96 @end
39037602
A
97#else
98typedef struct _os_object_s *_os_object_t;
99#endif
100
101__BEGIN_DECLS
102
103#if !_OS_OBJECT_OBJC_ARC
104
0a7de745 105 __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0)
39037602
A
106OS_OBJECT_EXPORT OS_OBJECT_MALLOC OS_OBJECT_WARN_RESULT OS_OBJECT_NOTHROW
107_os_object_t
108_os_object_alloc(const void *cls, size_t size);
109
0a7de745 110__OSX_AVAILABLE_STARTING(__MAC_10_9, __IPHONE_7_0)
39037602
A
111OS_OBJECT_EXPORT OS_OBJECT_MALLOC OS_OBJECT_WARN_RESULT OS_OBJECT_NOTHROW
112_os_object_t
113_os_object_alloc_realized(const void *cls, size_t size);
114
0a7de745 115__OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0)
39037602
A
116OS_OBJECT_EXPORT OS_OBJECT_NONNULL OS_OBJECT_NOTHROW
117void _os_object_dealloc(_os_object_t object);
118
0a7de745 119__OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0)
39037602
A
120OS_OBJECT_EXPORT OS_OBJECT_NONNULL OS_OBJECT_NOTHROW
121_os_object_t
122_os_object_retain(_os_object_t object);
123
0a7de745 124__OSX_AVAILABLE_STARTING(__MAC_10_11, __IPHONE_9_0)
39037602
A
125OS_OBJECT_EXPORT OS_OBJECT_NONNULL OS_OBJECT_NOTHROW
126_os_object_t
127_os_object_retain_with_resurrect(_os_object_t obj);
128
0a7de745 129__OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0)
39037602
A
130OS_OBJECT_EXPORT OS_OBJECT_NONNULL OS_OBJECT_NOTHROW
131void
132_os_object_release(_os_object_t object);
133
0a7de745 134__OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0)
39037602
A
135OS_OBJECT_EXPORT OS_OBJECT_NONNULL OS_OBJECT_NOTHROW
136_os_object_t
137_os_object_retain_internal(_os_object_t object);
138
0a7de745 139__OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0)
39037602
A
140OS_OBJECT_EXPORT OS_OBJECT_NONNULL OS_OBJECT_NOTHROW
141void
142_os_object_release_internal(_os_object_t object);
143
144#endif // !_OS_OBJECT_OBJC_ARC
145
146__END_DECLS
147
148#endif