xref: /xnu-10063.121.3/osfmk/arm/simple_lock.h (revision 2c2f96dc2b9a4408a43d3150ae9c105355ca3daa)
1*2c2f96dcSApple OSS Distributions /*
2*2c2f96dcSApple OSS Distributions  * Copyright (c) 2019 Apple Inc. All rights reserved.
3*2c2f96dcSApple OSS Distributions  *
4*2c2f96dcSApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5*2c2f96dcSApple OSS Distributions  *
6*2c2f96dcSApple OSS Distributions  * This file contains Original Code and/or Modifications of Original Code
7*2c2f96dcSApple OSS Distributions  * as defined in and that are subject to the Apple Public Source License
8*2c2f96dcSApple OSS Distributions  * Version 2.0 (the 'License'). You may not use this file except in
9*2c2f96dcSApple OSS Distributions  * compliance with the License. The rights granted to you under the License
10*2c2f96dcSApple OSS Distributions  * may not be used to create, or enable the creation or redistribution of,
11*2c2f96dcSApple OSS Distributions  * unlawful or unlicensed copies of an Apple operating system, or to
12*2c2f96dcSApple OSS Distributions  * circumvent, violate, or enable the circumvention or violation of, any
13*2c2f96dcSApple OSS Distributions  * terms of an Apple operating system software license agreement.
14*2c2f96dcSApple OSS Distributions  *
15*2c2f96dcSApple OSS Distributions  * Please obtain a copy of the License at
16*2c2f96dcSApple OSS Distributions  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17*2c2f96dcSApple OSS Distributions  *
18*2c2f96dcSApple OSS Distributions  * The Original Code and all software distributed under the License are
19*2c2f96dcSApple OSS Distributions  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20*2c2f96dcSApple OSS Distributions  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21*2c2f96dcSApple OSS Distributions  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22*2c2f96dcSApple OSS Distributions  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23*2c2f96dcSApple OSS Distributions  * Please see the License for the specific language governing rights and
24*2c2f96dcSApple OSS Distributions  * limitations under the License.
25*2c2f96dcSApple OSS Distributions  *
26*2c2f96dcSApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27*2c2f96dcSApple OSS Distributions  */
28*2c2f96dcSApple OSS Distributions /*
29*2c2f96dcSApple OSS Distributions  * @OSF_COPYRIGHT@
30*2c2f96dcSApple OSS Distributions  */
31*2c2f96dcSApple OSS Distributions /*
32*2c2f96dcSApple OSS Distributions  * Mach Operating System
33*2c2f96dcSApple OSS Distributions  * Copyright (c) 1991,1990,1989,1988,1987 Carnegie Mellon University
34*2c2f96dcSApple OSS Distributions  * All Rights Reserved.
35*2c2f96dcSApple OSS Distributions  *
36*2c2f96dcSApple OSS Distributions  * Permission to use, copy, modify and distribute this software and its
37*2c2f96dcSApple OSS Distributions  * documentation is hereby granted, provided that both the copyright
38*2c2f96dcSApple OSS Distributions  * notice and this permission notice appear in all copies of the
39*2c2f96dcSApple OSS Distributions  * software, derivative works or modified versions, and any portions
40*2c2f96dcSApple OSS Distributions  * thereof, and that both notices appear in supporting documentation.
41*2c2f96dcSApple OSS Distributions  *
42*2c2f96dcSApple OSS Distributions  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
43*2c2f96dcSApple OSS Distributions  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
44*2c2f96dcSApple OSS Distributions  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
45*2c2f96dcSApple OSS Distributions  *
46*2c2f96dcSApple OSS Distributions  * Carnegie Mellon requests users of this software to return to
47*2c2f96dcSApple OSS Distributions  *
48*2c2f96dcSApple OSS Distributions  *  Software Distribution Coordinator  or  [email protected]
49*2c2f96dcSApple OSS Distributions  *  School of Computer Science
50*2c2f96dcSApple OSS Distributions  *  Carnegie Mellon University
51*2c2f96dcSApple OSS Distributions  *  Pittsburgh PA 15213-3890
52*2c2f96dcSApple OSS Distributions  *
53*2c2f96dcSApple OSS Distributions  * any improvements or extensions that they make and grant Carnegie Mellon
54*2c2f96dcSApple OSS Distributions  * the rights to redistribute these changes.
55*2c2f96dcSApple OSS Distributions  */
56*2c2f96dcSApple OSS Distributions 
57*2c2f96dcSApple OSS Distributions #ifdef  KERNEL_PRIVATE
58*2c2f96dcSApple OSS Distributions 
59*2c2f96dcSApple OSS Distributions #ifndef _ARM_SIMPLE_LOCK_TYPES_H_
60*2c2f96dcSApple OSS Distributions #define _ARM_SIMPLE_LOCK_TYPES_H_
61*2c2f96dcSApple OSS Distributions 
62*2c2f96dcSApple OSS Distributions #include <kern/lock_group.h>
63*2c2f96dcSApple OSS Distributions 
64*2c2f96dcSApple OSS Distributions #ifdef  KERNEL_PRIVATE
65*2c2f96dcSApple OSS Distributions #include <mach/boolean.h>
66*2c2f96dcSApple OSS Distributions #include <kern/lock_types.h>
67*2c2f96dcSApple OSS Distributions #include <sys/appleapiopts.h>
68*2c2f96dcSApple OSS Distributions #ifdef  MACH_KERNEL_PRIVATE
69*2c2f96dcSApple OSS Distributions #include <arm/locks.h>
70*2c2f96dcSApple OSS Distributions #include <mach_ldebug.h>
71*2c2f96dcSApple OSS Distributions #endif
72*2c2f96dcSApple OSS Distributions 
73*2c2f96dcSApple OSS Distributions #ifdef MACH_KERNEL_PRIVATE
74*2c2f96dcSApple OSS Distributions 
75*2c2f96dcSApple OSS Distributions extern machine_timeout_t LockTimeOut;     /* Number of hardware ticks of a lock timeout */
76*2c2f96dcSApple OSS Distributions extern machine_timeout_t LockTimeOutUsec; /* Number of microseconds for lock timeout */
77*2c2f96dcSApple OSS Distributions 
78*2c2f96dcSApple OSS Distributions typedef lck_spin_t usimple_lock_data_t, *usimple_lock_t;
79*2c2f96dcSApple OSS Distributions #else /* MACH_KERNEL_PRIVATE */
80*2c2f96dcSApple OSS Distributions 
81*2c2f96dcSApple OSS Distributions #if defined(__arm__)
82*2c2f96dcSApple OSS Distributions typedef struct slock {
83*2c2f96dcSApple OSS Distributions 	unsigned int    lock_data[10];
84*2c2f96dcSApple OSS Distributions } usimple_lock_data_t, *usimple_lock_t;
85*2c2f96dcSApple OSS Distributions #elif defined(__arm64__)
86*2c2f96dcSApple OSS Distributions /*
87*2c2f96dcSApple OSS Distributions  * ARM64_TODO: this is quite a waste of space (and a
88*2c2f96dcSApple OSS Distributions  * poorly packed data structure).  See if anyone's
89*2c2f96dcSApple OSS Distributions  * using these outside of osfmk.
90*2c2f96dcSApple OSS Distributions  * NOTE: only osfmk uses this structure in xnu-2624
91*2c2f96dcSApple OSS Distributions  */
92*2c2f96dcSApple OSS Distributions typedef struct slock {
93*2c2f96dcSApple OSS Distributions 	uint64_t lock_data[9];
94*2c2f96dcSApple OSS Distributions } usimple_lock_data_t, *usimple_lock_t;
95*2c2f96dcSApple OSS Distributions #else
96*2c2f96dcSApple OSS Distributions #error Unknown architecture.
97*2c2f96dcSApple OSS Distributions #endif
98*2c2f96dcSApple OSS Distributions 
99*2c2f96dcSApple OSS Distributions #endif  /* MACH_KERNEL_PRIVATE */
100*2c2f96dcSApple OSS Distributions 
101*2c2f96dcSApple OSS Distributions #define USIMPLE_LOCK_NULL       ((usimple_lock_t) 0)
102*2c2f96dcSApple OSS Distributions 
103*2c2f96dcSApple OSS Distributions #if !defined(decl_simple_lock_data)
104*2c2f96dcSApple OSS Distributions 
105*2c2f96dcSApple OSS Distributions typedef usimple_lock_data_t     *simple_lock_t;
106*2c2f96dcSApple OSS Distributions typedef usimple_lock_data_t     simple_lock_data_t;
107*2c2f96dcSApple OSS Distributions 
108*2c2f96dcSApple OSS Distributions #define decl_simple_lock_data(class, name) \
109*2c2f96dcSApple OSS Distributions 	class	simple_lock_data_t	name
110*2c2f96dcSApple OSS Distributions 
111*2c2f96dcSApple OSS Distributions #endif  /* !defined(decl_simple_lock_data) */
112*2c2f96dcSApple OSS Distributions 
113*2c2f96dcSApple OSS Distributions #ifdef  MACH_KERNEL_PRIVATE
114*2c2f96dcSApple OSS Distributions 
115*2c2f96dcSApple OSS Distributions #define MACHINE_SIMPLE_LOCK
116*2c2f96dcSApple OSS Distributions 
117*2c2f96dcSApple OSS Distributions extern void     arm_usimple_lock_init(simple_lock_t, __unused unsigned short);
118*2c2f96dcSApple OSS Distributions 
119*2c2f96dcSApple OSS Distributions #define simple_lock_init(l, t)   arm_usimple_lock_init(l,t)
120*2c2f96dcSApple OSS Distributions 
121*2c2f96dcSApple OSS Distributions #if LCK_GRP_USE_ARG
122*2c2f96dcSApple OSS Distributions #define simple_lock(l, grp)                  lck_spin_lock_grp(l, grp)
123*2c2f96dcSApple OSS Distributions #define simple_lock_nopreempt(l, grp)        lck_spin_lock_nopreempt_grp(l, grp)
124*2c2f96dcSApple OSS Distributions #define simple_lock_try(l, grp)              lck_spin_try_lock_grp(l, grp)
125*2c2f96dcSApple OSS Distributions #define simple_lock_try_nopreempt(l, grp)    lck_spin_try_lock_nopreempt_grp(l, grp)
126*2c2f96dcSApple OSS Distributions #else
127*2c2f96dcSApple OSS Distributions #define simple_lock(l, grp)                  lck_spin_lock(l)
128*2c2f96dcSApple OSS Distributions #define simple_lock_nopreempt(l, grp)        lck_spin_lock_nopreempt(l)
129*2c2f96dcSApple OSS Distributions #define simple_lock_try(l, grp)              lck_spin_try_lock(l)
130*2c2f96dcSApple OSS Distributions #define simple_lock_try_nopreempt(l, grp)    lck_spin_try_lock_nopreempt(l)
131*2c2f96dcSApple OSS Distributions #endif /* LCK_GRP_USE_ARG */
132*2c2f96dcSApple OSS Distributions 
133*2c2f96dcSApple OSS Distributions #define simple_unlock(l)                lck_spin_unlock(l)
134*2c2f96dcSApple OSS Distributions #define simple_unlock_nopreempt(l)      lck_spin_unlock_nopreempt(l)
135*2c2f96dcSApple OSS Distributions 
136*2c2f96dcSApple OSS Distributions #define simple_lock_try_lock_loop(l, grp)    simple_lock(l, grp)
137*2c2f96dcSApple OSS Distributions 
138*2c2f96dcSApple OSS Distributions #define simple_lock_addr(l)             (&(l))
139*2c2f96dcSApple OSS Distributions #define simple_lock_assert(l, t) lck_spin_assert(l,t)
140*2c2f96dcSApple OSS Distributions #define kdp_simple_lock_is_acquired(l) kdp_lck_spin_is_acquired(l)
141*2c2f96dcSApple OSS Distributions 
142*2c2f96dcSApple OSS Distributions #endif  /* MACH_KERNEL_PRIVATE */
143*2c2f96dcSApple OSS Distributions #endif  /* KERNEL_PRIVATE */
144*2c2f96dcSApple OSS Distributions 
145*2c2f96dcSApple OSS Distributions #endif /* !_ARM_SIMPLE_LOCK_TYPES_H_ */
146*2c2f96dcSApple OSS Distributions 
147*2c2f96dcSApple OSS Distributions #endif  /* KERNEL_PRIVATE */
148