2 * Copyright (c) 2007 Apple Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
29 * FILE_ID: thread_status.h
33 #ifndef _ARM_THREAD_STATUS_H_
34 #define _ARM_THREAD_STATUS_H_
36 #include <mach/machine/_structs.h>
37 #include <mach/message.h>
38 #include <mach/arm/thread_state.h>
41 * Support for determining the state of a thread
49 #define ARM_THREAD_STATE 1
50 #define ARM_UNIFIED_THREAD_STATE ARM_THREAD_STATE
51 #define ARM_VFP_STATE 2
52 #define ARM_EXCEPTION_STATE 3
53 #define ARM_DEBUG_STATE 4 /* pre-armv8 */
54 #define THREAD_STATE_NONE 5
55 #define ARM_THREAD_STATE64 6
56 #define ARM_EXCEPTION_STATE64 7
57 // ARM_THREAD_STATE_LAST (legacy) 8
58 #define ARM_THREAD_STATE32 9
61 #define ARM_DEBUG_STATE32 14
62 #define ARM_DEBUG_STATE64 15
63 #define ARM_NEON_STATE 16
64 #define ARM_NEON_STATE64 17
65 #define ARM_CPMU_STATE64 18
67 #ifdef XNU_KERNEL_PRIVATE
69 #define ARM_SAVED_STATE32 20
70 #define ARM_SAVED_STATE64 21
71 #define ARM_NEON_SAVED_STATE32 22
72 #define ARM_NEON_SAVED_STATE64 23
73 #endif /* XNU_KERNEL_PRIVATE */
75 #define VALID_THREAD_STATE_FLAVOR(x)\
76 ((x == ARM_THREAD_STATE) || \
77 (x == ARM_VFP_STATE) || \
78 (x == ARM_EXCEPTION_STATE) || \
79 (x == ARM_DEBUG_STATE) || \
80 (x == THREAD_STATE_NONE) || \
81 (x == ARM_THREAD_STATE32) || \
82 (x == ARM_THREAD_STATE64) || \
83 (x == ARM_EXCEPTION_STATE64) || \
84 (x == ARM_NEON_STATE) || \
85 (x == ARM_NEON_STATE64) || \
86 (x == ARM_DEBUG_STATE32) || \
87 (x == ARM_DEBUG_STATE64))
89 struct arm_state_hdr
{
93 typedef struct arm_state_hdr arm_state_hdr_t
;
95 typedef _STRUCT_ARM_THREAD_STATE arm_thread_state_t
;
96 typedef _STRUCT_ARM_THREAD_STATE arm_thread_state32_t
;
97 typedef _STRUCT_ARM_THREAD_STATE64 arm_thread_state64_t
;
100 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL && defined(__arm64__)
101 #define arm_thread_state64_get_pc(ts) \
102 __darwin_arm_thread_state64_get_pc(ts)
103 #define arm_thread_state64_get_pc_fptr(ts) \
104 __darwin_arm_thread_state64_get_pc_fptr(ts)
105 #define arm_thread_state64_set_pc_fptr(ts, fptr) \
106 __darwin_arm_thread_state64_set_pc_fptr(ts, fptr)
107 #define arm_thread_state64_get_lr(ts) \
108 __darwin_arm_thread_state64_get_lr(ts)
109 #define arm_thread_state64_get_lr_fptr(ts) \
110 __darwin_arm_thread_state64_get_lr_fptr(ts)
111 #define arm_thread_state64_set_lr_fptr(ts, fptr) \
112 __darwin_arm_thread_state64_set_lr_fptr(ts, fptr)
113 #define arm_thread_state64_get_sp(ts) \
114 __darwin_arm_thread_state64_get_sp(ts)
115 #define arm_thread_state64_set_sp(ts, ptr) \
116 __darwin_arm_thread_state64_set_sp(ts, ptr)
117 #define arm_thread_state64_get_fp(ts) \
118 __darwin_arm_thread_state64_get_fp(ts)
119 #define arm_thread_state64_set_fp(ts, ptr) \
120 __darwin_arm_thread_state64_set_fp(ts, ptr)
121 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL && defined(__arm64__) */
122 #endif /* !defined(KERNEL) */
124 struct arm_unified_thread_state
{
127 arm_thread_state32_t ts_32
;
128 arm_thread_state64_t ts_64
;
131 #define ts_32 uts.ts_32
132 #define ts_64 uts.ts_64
133 typedef struct arm_unified_thread_state arm_unified_thread_state_t
;
135 #define ARM_THREAD_STATE_COUNT ((mach_msg_type_number_t) \
136 (sizeof (arm_thread_state_t)/sizeof(uint32_t)))
137 #define ARM_THREAD_STATE32_COUNT ((mach_msg_type_number_t) \
138 (sizeof (arm_thread_state32_t)/sizeof(uint32_t)))
139 #define ARM_THREAD_STATE64_COUNT ((mach_msg_type_number_t) \
140 (sizeof (arm_thread_state64_t)/sizeof(uint32_t)))
141 #define ARM_UNIFIED_THREAD_STATE_COUNT ((mach_msg_type_number_t) \
142 (sizeof (arm_unified_thread_state_t)/sizeof(uint32_t)))
145 typedef _STRUCT_ARM_VFP_STATE arm_vfp_state_t
;
146 typedef _STRUCT_ARM_NEON_STATE arm_neon_state_t
;
147 typedef _STRUCT_ARM_NEON_STATE arm_neon_state32_t
;
148 typedef _STRUCT_ARM_NEON_STATE64 arm_neon_state64_t
;
150 typedef _STRUCT_ARM_EXCEPTION_STATE arm_exception_state_t
;
151 typedef _STRUCT_ARM_EXCEPTION_STATE arm_exception_state32_t
;
152 typedef _STRUCT_ARM_EXCEPTION_STATE64 arm_exception_state64_t
;
154 typedef _STRUCT_ARM_DEBUG_STATE32 arm_debug_state32_t
;
155 typedef _STRUCT_ARM_DEBUG_STATE64 arm_debug_state64_t
;
157 #if defined(XNU_KERNEL_PRIVATE) && defined(__arm64__)
158 /* See below for ARM64 kernel structure definition for arm_debug_state. */
161 * Otherwise not ARM64 kernel and we must preserve legacy ARM definitions of
162 * arm_debug_state for binary compatability of userland consumers of this file.
165 typedef _STRUCT_ARM_DEBUG_STATE arm_debug_state_t
;
166 #elif defined(__arm64__)
167 typedef _STRUCT_ARM_LEGACY_DEBUG_STATE arm_debug_state_t
;
169 #error Undefined architecture
173 #define ARM_VFP_STATE_COUNT ((mach_msg_type_number_t) \
174 (sizeof (arm_vfp_state_t)/sizeof(uint32_t)))
176 #define ARM_EXCEPTION_STATE_COUNT ((mach_msg_type_number_t) \
177 (sizeof (arm_exception_state_t)/sizeof(uint32_t)))
179 #define ARM_EXCEPTION_STATE64_COUNT ((mach_msg_type_number_t) \
180 (sizeof (arm_exception_state64_t)/sizeof(uint32_t)))
182 #define ARM_DEBUG_STATE_COUNT ((mach_msg_type_number_t) \
183 (sizeof (arm_debug_state_t)/sizeof(uint32_t)))
185 #define ARM_DEBUG_STATE32_COUNT ((mach_msg_type_number_t) \
186 (sizeof (arm_debug_state32_t)/sizeof(uint32_t)))
188 #define ARM_DEBUG_STATE64_COUNT ((mach_msg_type_number_t) \
189 (sizeof (arm_debug_state64_t)/sizeof(uint32_t)))
191 #define ARM_NEON_STATE_COUNT ((mach_msg_type_number_t) \
192 (sizeof (arm_neon_state_t)/sizeof(uint32_t)))
194 #define ARM_NEON_STATE64_COUNT ((mach_msg_type_number_t) \
195 (sizeof (arm_neon_state64_t)/sizeof(uint32_t)))
197 #define MACHINE_THREAD_STATE ARM_THREAD_STATE
198 #define MACHINE_THREAD_STATE_COUNT ARM_UNIFIED_THREAD_STATE_COUNT
201 * Largest state on this machine:
203 #define THREAD_MACHINE_STATE_MAX THREAD_STATE_MAX
205 #ifdef XNU_KERNEL_PRIVATE
207 static inline boolean_t
208 is_thread_state32(const arm_unified_thread_state_t
*its
)
210 return (its
->ash
.flavor
== ARM_THREAD_STATE32
);
213 static inline boolean_t
214 is_thread_state64(const arm_unified_thread_state_t
*its
)
216 return (its
->ash
.flavor
== ARM_THREAD_STATE64
);
219 static inline arm_thread_state32_t
*
220 thread_state32(arm_unified_thread_state_t
*its
)
225 static inline arm_thread_state64_t
*
226 thread_state64(arm_unified_thread_state_t
*its
)
231 static inline const arm_thread_state32_t
*
232 const_thread_state32(const arm_unified_thread_state_t
*its
)
237 static inline const arm_thread_state64_t
*
238 const_thread_state64(const arm_unified_thread_state_t
*its
)
244 #include <arm/proc_reg.h>
246 #define ARM_SAVED_STATE THREAD_STATE_NONE + 1
248 struct arm_saved_state
{
249 uint32_t r
[13]; /* General purpose register r0-r12 */
250 uint32_t sp
; /* Stack pointer r13 */
251 uint32_t lr
; /* Link register r14 */
252 uint32_t pc
; /* Program counter r15 */
253 uint32_t cpsr
; /* Current program status register */
254 uint32_t fsr
; /* Fault status */
255 uint32_t far
; /* Virtual Fault Address */
256 uint32_t exception
; /* exception number */
258 typedef struct arm_saved_state arm_saved_state_t
;
261 * Just for coexistence with AArch64 code.
263 typedef struct arm_saved_state arm_saved_state32_t
;
265 static inline arm_saved_state32_t
*
266 saved_state32(arm_saved_state_t
*iss
)
271 static inline boolean_t
272 is_saved_state32(const arm_saved_state_t
*iss __unused
)
278 struct arm_saved_state_tagged
{
280 struct arm_saved_state state
;
282 typedef struct arm_saved_state_tagged arm_saved_state_tagged_t
;
284 #define ARM_SAVED_STATE32_COUNT ((mach_msg_type_number_t) \
285 (sizeof (arm_saved_state_t)/sizeof(unsigned int)))
288 static inline register_t
289 get_saved_state_pc(const arm_saved_state_t
*iss
)
295 set_saved_state_pc(arm_saved_state_t
*iss
, register_t pc
)
300 static inline register_t
301 get_saved_state_sp(const arm_saved_state_t
*iss
)
307 set_saved_state_sp(arm_saved_state_t
*iss
, register_t sp
)
312 static inline register_t
313 get_saved_state_fp(const arm_saved_state_t
*iss
)
319 set_saved_state_fp(arm_saved_state_t
*iss
, register_t fp
)
324 static inline register_t
325 get_saved_state_lr(const arm_saved_state_t
*iss
)
331 set_saved_state_lr(arm_saved_state_t
*iss
, register_t lr
)
336 static inline register_t
337 get_saved_state_cpsr(const arm_saved_state_t
*iss
)
343 set_saved_state_cpsr(arm_saved_state_t
*iss
, register_t cpsr
)
348 static inline register_t
349 get_saved_state_reg(const arm_saved_state_t
*iss
, unsigned regno
)
351 return iss
->r
[regno
];
355 set_saved_state_reg(arm_saved_state_t
*iss
, unsigned regno
, register_t val
)
360 #elif defined(__arm64__)
362 #include <kern/assert.h>
363 #include <arm64/proc_reg.h>
364 #define CAST_ASSERT_SAFE(type, val) (assert((val) == ((type)(val))), (type)(val))
370 struct arm_saved_state32
{
371 uint32_t r
[13]; /* General purpose register r0-r12 */
372 uint32_t sp
; /* Stack pointer r13 */
373 uint32_t lr
; /* Link register r14 */
374 uint32_t pc
; /* Program counter r15 */
375 uint32_t cpsr
; /* Current program status register */
376 uint32_t far
; /* Virtual fault address */
377 uint32_t esr
; /* Exception syndrome register */
378 uint32_t exception
; /* Exception number */
380 typedef struct arm_saved_state32 arm_saved_state32_t
;
382 struct arm_saved_state32_tagged
{
384 struct arm_saved_state32 state
;
386 typedef struct arm_saved_state32_tagged arm_saved_state32_tagged_t
;
388 #define ARM_SAVED_STATE32_COUNT ((mach_msg_type_number_t) \
389 (sizeof (arm_saved_state32_t)/sizeof(unsigned int)))
391 struct arm_saved_state64
{
392 uint64_t x
[29]; /* General purpose registers x0-x28 */
393 uint64_t fp
; /* Frame pointer x29 */
394 uint64_t lr
; /* Link register x30 */
395 uint64_t sp
; /* Stack pointer x31 */
396 uint64_t pc
; /* Program counter */
397 uint32_t cpsr
; /* Current program status register */
398 uint32_t reserved
; /* Reserved padding */
399 uint64_t far
; /* Virtual fault address */
400 uint32_t esr
; /* Exception syndrome register */
401 uint32_t exception
; /* Exception number */
403 typedef struct arm_saved_state64 arm_saved_state64_t
;
405 #define ARM_SAVED_STATE64_COUNT ((mach_msg_type_number_t) \
406 (sizeof (arm_saved_state64_t)/sizeof(unsigned int)))
408 struct arm_saved_state64_tagged
{
410 struct arm_saved_state64 state
;
412 typedef struct arm_saved_state64_tagged arm_saved_state64_tagged_t
;
414 struct arm_saved_state
{
417 struct arm_saved_state32 ss_32
;
418 struct arm_saved_state64 ss_64
;
420 } __attribute__((aligned(16)));
421 #define ss_32 uss.ss_32
422 #define ss_64 uss.ss_64
424 typedef struct arm_saved_state arm_saved_state_t
;
427 static inline boolean_t
428 is_saved_state32(const arm_saved_state_t
*iss
)
430 return (iss
->ash
.flavor
== ARM_SAVED_STATE32
);
433 static inline boolean_t
434 is_saved_state64(const arm_saved_state_t
*iss
)
436 return (iss
->ash
.flavor
== ARM_SAVED_STATE64
);
439 static inline arm_saved_state32_t
*
440 saved_state32(arm_saved_state_t
*iss
)
445 static inline const arm_saved_state32_t
*
446 const_saved_state32(const arm_saved_state_t
*iss
)
451 static inline arm_saved_state64_t
*
452 saved_state64(arm_saved_state_t
*iss
)
457 static inline const arm_saved_state64_t
*
458 const_saved_state64(const arm_saved_state_t
*iss
)
463 static inline register_t
464 get_saved_state_pc(const arm_saved_state_t
*iss
)
466 return (is_saved_state32(iss
) ? const_saved_state32(iss
)->pc
: const_saved_state64(iss
)->pc
);
470 set_saved_state_pc(arm_saved_state_t
*iss
, register_t pc
)
472 if (is_saved_state32(iss
)) {
473 saved_state32(iss
)->pc
= CAST_ASSERT_SAFE(uint32_t, pc
);
475 saved_state64(iss
)->pc
= pc
;
479 static inline register_t
480 get_saved_state_sp(const arm_saved_state_t
*iss
)
482 return (is_saved_state32(iss
) ? const_saved_state32(iss
)->sp
: const_saved_state64(iss
)->sp
);
486 set_saved_state_sp(arm_saved_state_t
*iss
, register_t sp
)
488 if (is_saved_state32(iss
)) {
489 saved_state32(iss
)->sp
= CAST_ASSERT_SAFE(uint32_t, sp
);
491 saved_state64(iss
)->sp
= sp
;
495 static inline register_t
496 get_saved_state_lr(const arm_saved_state_t
*iss
)
498 return (is_saved_state32(iss
) ? const_saved_state32(iss
)->lr
: const_saved_state64(iss
)->lr
);
502 set_saved_state_lr(arm_saved_state_t
*iss
, register_t lr
)
504 if (is_saved_state32(iss
)) {
505 saved_state32(iss
)->lr
= CAST_ASSERT_SAFE(uint32_t, lr
);
507 saved_state64(iss
)->lr
= lr
;
511 static inline register_t
512 get_saved_state_fp(const arm_saved_state_t
*iss
)
514 return (is_saved_state32(iss
) ? const_saved_state32(iss
)->r
[7] : const_saved_state64(iss
)->fp
);
518 set_saved_state_fp(arm_saved_state_t
*iss
, register_t fp
)
520 if (is_saved_state32(iss
)) {
521 saved_state32(iss
)->r
[7] = CAST_ASSERT_SAFE(uint32_t, fp
);
523 saved_state64(iss
)->fp
= fp
;
528 check_saved_state_reglimit(const arm_saved_state_t
*iss
, unsigned reg
)
530 return (is_saved_state32(iss
) ? (reg
< ARM_SAVED_STATE32_COUNT
) : (reg
< ARM_SAVED_STATE64_COUNT
));
533 static inline register_t
534 get_saved_state_reg(const arm_saved_state_t
*iss
, unsigned reg
)
536 if (!check_saved_state_reglimit(iss
, reg
)) return 0;
538 return (is_saved_state32(iss
) ? (const_saved_state32(iss
)->r
[reg
]) : (const_saved_state64(iss
)->x
[reg
]));
542 set_saved_state_reg(arm_saved_state_t
*iss
, unsigned reg
, register_t value
)
544 if (!check_saved_state_reglimit(iss
, reg
)) return;
546 if (is_saved_state32(iss
)) {
547 saved_state32(iss
)->r
[reg
] = CAST_ASSERT_SAFE(uint32_t, value
);
549 saved_state64(iss
)->x
[reg
] = value
;
553 static inline uint32_t
554 get_saved_state_cpsr(const arm_saved_state_t
*iss
)
556 return (is_saved_state32(iss
) ? const_saved_state32(iss
)->cpsr
: const_saved_state64(iss
)->cpsr
);
560 set_saved_state_cpsr(arm_saved_state_t
*iss
, uint32_t cpsr
)
562 if (is_saved_state32(iss
)) {
563 saved_state32(iss
)->cpsr
= cpsr
;
565 saved_state64(iss
)->cpsr
= cpsr
;
569 static inline register_t
570 get_saved_state_far(const arm_saved_state_t
*iss
)
572 return (is_saved_state32(iss
) ? const_saved_state32(iss
)->far
: const_saved_state64(iss
)->far
);
576 set_saved_state_far(arm_saved_state_t
*iss
, register_t far
)
578 if (is_saved_state32(iss
)) {
579 saved_state32(iss
)->far
= CAST_ASSERT_SAFE(uint32_t, far
);
581 saved_state64(iss
)->far
= far
;
585 static inline uint32_t
586 get_saved_state_esr(const arm_saved_state_t
*iss
)
588 return (is_saved_state32(iss
) ? const_saved_state32(iss
)->esr
: const_saved_state64(iss
)->esr
);
592 set_saved_state_esr(arm_saved_state_t
*iss
, uint32_t esr
)
594 if (is_saved_state32(iss
)) {
595 saved_state32(iss
)->esr
= esr
;
597 saved_state64(iss
)->esr
= esr
;
601 static inline uint32_t
602 get_saved_state_exc(const arm_saved_state_t
*iss
)
604 return (is_saved_state32(iss
) ? const_saved_state32(iss
)->exception
: const_saved_state64(iss
)->exception
);
608 set_saved_state_exc(arm_saved_state_t
*iss
, uint32_t exc
)
610 if (is_saved_state32(iss
)) {
611 saved_state32(iss
)->exception
= exc
;
613 saved_state64(iss
)->exception
= exc
;
617 extern void panic_unimplemented(void);
620 get_saved_state_svc_number(const arm_saved_state_t
*iss
)
622 return (is_saved_state32(iss
) ? (int)const_saved_state32(iss
)->r
[12] : (int)const_saved_state64(iss
)->x
[ARM64_SYSCALL_CODE_REG_NUM
]); /* Only first word counts here */
625 typedef _STRUCT_ARM_LEGACY_DEBUG_STATE arm_legacy_debug_state_t
;
627 struct arm_debug_aggregate_state
{
630 arm_debug_state32_t ds32
;
631 arm_debug_state64_t ds64
;
633 } __attribute__((aligned(16)));
635 typedef struct arm_debug_aggregate_state arm_debug_state_t
;
637 #define ARM_LEGACY_DEBUG_STATE_COUNT ((mach_msg_type_number_t) \
638 (sizeof (arm_legacy_debug_state_t)/sizeof(uint32_t)))
643 typedef __uint128_t uint128_t
;
644 typedef uint64_t uint64x2_t
__attribute__((ext_vector_type(2)));
645 typedef uint32_t uint32x4_t
__attribute__((ext_vector_type(4)));
647 struct arm_neon_saved_state32
{
656 typedef struct arm_neon_saved_state32 arm_neon_saved_state32_t
;
658 #define ARM_NEON_SAVED_STATE32_COUNT ((mach_msg_type_number_t) \
659 (sizeof (arm_neon_saved_state32_t)/sizeof(unsigned int)))
661 struct arm_neon_saved_state64
{
670 typedef struct arm_neon_saved_state64 arm_neon_saved_state64_t
;
672 #define ARM_NEON_SAVED_STATE64_COUNT ((mach_msg_type_number_t) \
673 (sizeof (arm_neon_saved_state64_t)/sizeof(unsigned int)))
675 struct arm_neon_saved_state
{
678 struct arm_neon_saved_state32 ns_32
;
679 struct arm_neon_saved_state64 ns_64
;
682 typedef struct arm_neon_saved_state arm_neon_saved_state_t
;
683 #define ns_32 uns.ns_32
684 #define ns_64 uns.ns_64
686 static inline boolean_t
687 is_neon_saved_state32(const arm_neon_saved_state_t
*state
)
689 return (state
->nsh
.flavor
== ARM_NEON_SAVED_STATE32
);
692 static inline boolean_t
693 is_neon_saved_state64(const arm_neon_saved_state_t
*state
)
695 return (state
->nsh
.flavor
== ARM_NEON_SAVED_STATE64
);
698 static inline arm_neon_saved_state32_t
*
699 neon_state32(arm_neon_saved_state_t
*state
)
701 return &state
->ns_32
;
704 static inline arm_neon_saved_state64_t
*
705 neon_state64(arm_neon_saved_state_t
*state
)
707 return &state
->ns_64
;
716 struct arm_saved_state ss
;
717 struct arm_neon_saved_state ns
;
719 typedef struct arm_context arm_context_t
;
721 extern void saved_state_to_thread_state64(const arm_saved_state_t
*, arm_thread_state64_t
*);
722 extern void thread_state64_to_saved_state(const arm_thread_state64_t
*, arm_saved_state_t
*);
728 extern void saved_state_to_thread_state32(const arm_saved_state_t
*, arm_thread_state32_t
*);
729 extern void thread_state32_to_saved_state(const arm_thread_state32_t
*, arm_saved_state_t
*);
731 #endif /* XNU_KERNEL_PRIVATE */
733 #endif /* _ARM_THREAD_STATUS_H_ */