2 * Copyright (c) 2000-2006 Apple Computer, 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@
30 #include <mach/mach_types.h>
31 #include <mach/machine.h>
32 #include <mach/exception_types.h>
33 #include <kern/cpu_data.h>
34 #include <i386/trap.h>
36 #include <kdp/kdp_internal.h>
37 #include <mach-o/loader.h>
38 #include <mach-o/nlist.h>
39 #include <IOKit/IOPlatformExpert.h> /* for PE_halt_restart */
40 #include <kern/machine.h> /* for halt_all_cpus */
41 #include <libkern/OSAtomic.h>
43 #include <kern/thread.h>
44 #include <i386/thread.h>
45 #include <vm/vm_map.h>
46 #include <i386/pmap.h>
47 #include <kern/kalloc.h>
49 #define KDP_TEST_HARNESS 0
51 #define dprintf(x) printf x
56 extern cpu_type_t
cpuid_cputype(void);
57 extern cpu_subtype_t
cpuid_cpusubtype(void);
59 extern vm_offset_t
machine_trace_thread_get_kva(vm_offset_t cur_target_addr
, vm_map_t map
, uint32_t *thread_trace_flags
);
60 extern void machine_trace_thread_clear_validation_cache(void);
61 extern vm_map_t kernel_map
;
63 void print_saved_state(void *);
66 void kdp_getstate(x86_thread_state64_t
*);
67 void kdp_setstate(x86_thread_state64_t
*);
68 void kdp_print_phys(int);
69 unsigned machine_read64(addr64_t srcaddr
, caddr_t dstaddr
, uint32_t len
);
75 unsigned short *remote_port
,
76 unsigned int exception
,
81 kdp_exception_t
*rq
= (kdp_exception_t
*)pkt
;
83 rq
->hdr
.request
= KDP_EXCEPTION
;
85 rq
->hdr
.seq
= kdp
.exception_seq
;
87 rq
->hdr
.len
= sizeof (*rq
);
90 rq
->exc_info
[0].cpu
= 0;
91 rq
->exc_info
[0].exception
= exception
;
92 rq
->exc_info
[0].code
= code
;
93 rq
->exc_info
[0].subcode
= subcode
;
95 rq
->hdr
.len
+= rq
->n_exc_info
* sizeof (kdp_exc_info_t
);
97 bcopy((char *)rq
, (char *)pkt
, rq
->hdr
.len
);
99 kdp
.exception_ack_needed
= TRUE
;
101 *remote_port
= kdp
.exception_port
;
111 kdp_exception_ack_t
*rq
= (kdp_exception_ack_t
*)pkt
;
113 if (((unsigned int) len
) < sizeof (*rq
))
116 if (!rq
->hdr
.is_reply
|| rq
->hdr
.request
!= KDP_EXCEPTION
)
119 dprintf(("kdp_exception_ack seq %x %x\n", rq
->hdr
.seq
, kdp
.exception_seq
));
121 if (rq
->hdr
.seq
== kdp
.exception_seq
) {
122 kdp
.exception_ack_needed
= FALSE
;
130 x86_thread_state64_t
*state
133 x86_saved_state64_t
*saved_state
;
135 saved_state
= (x86_saved_state64_t
*)kdp
.saved_state
;
137 state
->rax
= saved_state
->rax
;
138 state
->rbx
= saved_state
->rbx
;
139 state
->rcx
= saved_state
->rcx
;
140 state
->rdx
= saved_state
->rdx
;
141 state
->rdi
= saved_state
->rdi
;
142 state
->rsi
= saved_state
->rsi
;
143 state
->rbp
= saved_state
->rbp
;
145 state
->r8
= saved_state
->r8
;
146 state
->r9
= saved_state
->r9
;
147 state
->r10
= saved_state
->r10
;
148 state
->r11
= saved_state
->r11
;
149 state
->r12
= saved_state
->r12
;
150 state
->r13
= saved_state
->r13
;
151 state
->r14
= saved_state
->r14
;
152 state
->r15
= saved_state
->r15
;
154 state
->rsp
= saved_state
->isf
.rsp
;
155 state
->rflags
= saved_state
->isf
.rflags
;
156 state
->rip
= saved_state
->isf
.rip
;
158 state
->cs
= saved_state
->isf
.cs
;
159 state
->fs
= saved_state
->fs
;
160 state
->gs
= saved_state
->gs
;
166 x86_thread_state64_t
*state
169 x86_saved_state64_t
*saved_state
;
171 saved_state
= (x86_saved_state64_t
*)kdp
.saved_state
;
172 saved_state
->rax
= state
->rax
;
173 saved_state
->rbx
= state
->rbx
;
174 saved_state
->rcx
= state
->rcx
;
175 saved_state
->rdx
= state
->rdx
;
176 saved_state
->rdi
= state
->rdi
;
177 saved_state
->rsi
= state
->rsi
;
178 saved_state
->rbp
= state
->rbp
;
179 saved_state
->r8
= state
->r8
;
180 saved_state
->r9
= state
->r9
;
181 saved_state
->r10
= state
->r10
;
182 saved_state
->r11
= state
->r11
;
183 saved_state
->r12
= state
->r12
;
184 saved_state
->r13
= state
->r13
;
185 saved_state
->r14
= state
->r14
;
186 saved_state
->r15
= state
->r15
;
188 saved_state
->isf
.rflags
= state
->rflags
;
189 saved_state
->isf
.rsp
= state
->rsp
;
190 saved_state
->isf
.rip
= state
->rip
;
192 saved_state
->fs
= (uint32_t)state
->fs
;
193 saved_state
->gs
= (uint32_t)state
->gs
;
198 kdp_machine_read_regs(
199 __unused
unsigned int cpu
,
205 static x86_float_state64_t null_fpstate
;
209 case x86_THREAD_STATE64
:
210 dprintf(("kdp_readregs THREAD_STATE64\n"));
211 kdp_getstate((x86_thread_state64_t
*)data
);
212 *size
= sizeof (x86_thread_state64_t
);
213 return KDPERR_NO_ERROR
;
215 case x86_FLOAT_STATE64
:
216 dprintf(("kdp_readregs THREAD_FPSTATE64\n"));
217 *(x86_float_state64_t
*)data
= null_fpstate
;
218 *size
= sizeof (x86_float_state64_t
);
219 return KDPERR_NO_ERROR
;
222 dprintf(("kdp_readregs bad flavor %d\n", flavor
));
224 return KDPERR_BADFLAVOR
;
229 kdp_machine_write_regs(
230 __unused
unsigned int cpu
,
238 case x86_THREAD_STATE64
:
239 dprintf(("kdp_writeregs THREAD_STATE64\n"));
240 kdp_setstate((x86_thread_state64_t
*)data
);
241 return KDPERR_NO_ERROR
;
243 case x86_FLOAT_STATE64
:
244 dprintf(("kdp_writeregs THREAD_FPSTATE64\n"));
245 return KDPERR_NO_ERROR
;
248 dprintf(("kdp_writeregs bad flavor %d\n", flavor
));
249 return KDPERR_BADFLAVOR
;
256 kdp_machine_hostinfo(
257 kdp_hostinfo_t
*hostinfo
262 hostinfo
->cpus_mask
= 0;
264 for (i
= 0; i
< machine_info
.max_cpus
; i
++) {
265 if (cpu_data_ptr
[i
] == NULL
)
268 hostinfo
->cpus_mask
|= (1 << i
);
271 hostinfo
->cpu_type
= cpuid_cputype() | CPU_ARCH_ABI64
;
272 hostinfo
->cpu_subtype
= cpuid_cpusubtype();
280 kprintf("kdp panic: %s\n", msg
);
281 __asm__
volatile("hlt");
303 kdp_us_spin(int usec
)
308 void print_saved_state(void *state
)
310 x86_saved_state64_t
*saved_state
;
314 kprintf("pc = 0x%llx\n", saved_state
->isf
.rip
);
315 kprintf("cr2= 0x%llx\n", saved_state
->cr2
);
316 kprintf("rp = TODO FIXME\n");
317 kprintf("sp = %p\n", saved_state
);
324 return; /* No op here. */
330 __asm__
volatile ("int $3"); /* Let the processor do the work */
334 typedef struct _cframe_t
{
335 struct _cframe_t
*prev
;
340 extern pt_entry_t
*DMAP2
;
341 extern caddr_t DADDR2
;
344 kdp_print_phys(int src
)
349 *(int *) DMAP2
= 0x63 | (src
& 0xfffff000);
350 invlpg((uintptr_t) DADDR2
);
351 iptr
= (unsigned int *) DADDR2
;
352 for (i
= 0; i
< 100; i
++) {
353 kprintf("0x%x ", *iptr
++);
365 x86_saved_state64_t
*saved_state
,
366 kern_return_t result
,
370 unsigned int exception
, code
, subcode
= 0;
371 boolean_t prev_interrupts_state
;
373 if (trapno
!= T_INT3
&& trapno
!= T_DEBUG
) {
374 kprintf("Debugger: Unexpected kernel trap number: "
375 "0x%x, RIP: 0x%llx, CR2: 0x%llx\n",
376 trapno
, saved_state
->isf
.rip
, saved_state
->cr2
);
381 prev_interrupts_state
= ml_set_interrupts_enabled(FALSE
);
382 disable_preemption();
384 if (saved_state
->isf
.rflags
& EFL_TF
) {
385 enable_preemption_no_check();
391 exception
= EXC_ARITHMETIC
;
392 code
= EXC_I386_DIVERR
;
396 exception
= EXC_SOFTWARE
;
397 code
= EXC_I386_INTOFLT
;
400 case T_OUT_OF_BOUNDS
:
401 exception
= EXC_ARITHMETIC
;
402 code
= EXC_I386_BOUNDFLT
;
405 case T_INVALID_OPCODE
:
406 exception
= EXC_BAD_INSTRUCTION
;
407 code
= EXC_I386_INVOPFLT
;
410 case T_SEGMENT_NOT_PRESENT
:
411 exception
= EXC_BAD_INSTRUCTION
;
412 code
= EXC_I386_SEGNPFLT
;
413 subcode
= (unsigned int)saved_state
->isf
.err
;
417 exception
= EXC_BAD_INSTRUCTION
;
418 code
= EXC_I386_STKFLT
;
419 subcode
= (unsigned int)saved_state
->isf
.err
;
422 case T_GENERAL_PROTECTION
:
423 exception
= EXC_BAD_INSTRUCTION
;
424 code
= EXC_I386_GPFLT
;
425 subcode
= (unsigned int)saved_state
->isf
.err
;
429 exception
= EXC_BAD_ACCESS
;
431 subcode
= (unsigned int)va
;
435 exception
= EXC_SOFTWARE
;
436 code
= EXC_I386_ALIGNFLT
;
441 exception
= EXC_BREAKPOINT
;
442 code
= EXC_I386_BPTFLT
;
446 exception
= EXC_BAD_INSTRUCTION
;
451 if (current_cpu_datap()->cpu_fatal_trap_state
) {
452 current_cpu_datap()->cpu_post_fatal_trap_state
= saved_state
;
453 saved_state
= current_cpu_datap()->cpu_fatal_trap_state
;
456 handle_debugger_trap(exception
, code
, subcode
, saved_state
);
459 ml_set_interrupts_enabled(prev_interrupts_state
);
461 /* If the instruction single step bit is set, disable kernel preemption
463 if (saved_state
->isf
.rflags
& EFL_TF
) {
464 disable_preemption();
471 kdp_machine_get_breakinsn(
480 #define RETURN_OFFSET 4
483 machine_trace_thread(thread_t thread
,
489 uint32_t * thread_trace_flags
)
491 uint32_t * tracebuf
= (uint32_t *)tracepos
;
492 uint32_t framesize
= (trace_fp
? 2 : 1) * sizeof(uint32_t);
495 uint32_t stackptr
= 0;
496 uint32_t stacklimit
= 0xfc000000;
498 uint32_t prev_eip
= 0;
500 vm_offset_t kern_virt_addr
= 0;
501 vm_map_t bt_vm_map
= VM_MAP_NULL
;
503 nframes
= (tracebound
> tracepos
) ? MIN(nframes
, (int)((tracebound
- tracepos
) / framesize
)) : 0;
506 x86_saved_state32_t
*iss32
;
508 iss32
= USER_REGS32(thread
);
509 prev_eip
= iss32
->eip
;
510 stackptr
= iss32
->ebp
;
512 stacklimit
= 0xffffffff;
513 bt_vm_map
= thread
->task
->map
;
516 panic("32-bit trace attempted on 64-bit kernel");
518 for (framecount
= 0; framecount
< nframes
; framecount
++) {
520 *tracebuf
++ = prev_eip
;
522 *tracebuf
++ = stackptr
;
525 /* Invalid frame, or hit fence */
526 if (!stackptr
|| (stackptr
== fence
)) {
530 /* Unaligned frame */
531 if (stackptr
& 0x0000003) {
535 if (stackptr
<= prevsp
) {
539 if (stackptr
> stacklimit
) {
543 kern_virt_addr
= machine_trace_thread_get_kva(stackptr
+ RETURN_OFFSET
, bt_vm_map
, thread_trace_flags
);
545 if (!kern_virt_addr
) {
546 if (thread_trace_flags
) {
547 *thread_trace_flags
|= kThreadTruncatedBT
;
552 prev_eip
= *(uint32_t *)kern_virt_addr
;
556 kern_virt_addr
= machine_trace_thread_get_kva(stackptr
, bt_vm_map
, thread_trace_flags
);
558 if (kern_virt_addr
) {
559 stackptr
= *(uint32_t *)kern_virt_addr
;
562 if (thread_trace_flags
) {
563 *thread_trace_flags
|= kThreadTruncatedBT
;
568 machine_trace_thread_clear_validation_cache();
570 return (uint32_t) (((char *) tracebuf
) - tracepos
);
574 #define RETURN_OFFSET64 8
575 /* Routine to encapsulate the 64-bit address read hack*/
577 machine_read64(addr64_t srcaddr
, caddr_t dstaddr
, uint32_t len
)
579 return (unsigned)kdp_machine_vm_read(srcaddr
, dstaddr
, len
);
583 machine_trace_thread64(thread_t thread
,
589 uint32_t * thread_trace_flags
)
591 uint64_t * tracebuf
= (uint64_t *)tracepos
;
592 unsigned framesize
= (trace_fp
? 2 : 1) * sizeof(addr64_t
);
595 addr64_t stackptr
= 0;
597 addr64_t prev_rip
= 0;
599 vm_offset_t kern_virt_addr
= 0;
600 vm_map_t bt_vm_map
= VM_MAP_NULL
;
602 nframes
= (tracebound
> tracepos
) ? MIN(nframes
, (int)((tracebound
- tracepos
) / framesize
)) : 0;
605 x86_saved_state64_t
*iss64
;
606 iss64
= USER_REGS64(thread
);
607 prev_rip
= iss64
->isf
.rip
;
608 stackptr
= iss64
->rbp
;
609 bt_vm_map
= thread
->task
->map
;
612 stackptr
= STACK_IKS(thread
->kernel_stack
)->k_rbp
;
613 prev_rip
= STACK_IKS(thread
->kernel_stack
)->k_rip
;
614 prev_rip
= VM_KERNEL_UNSLIDE(prev_rip
);
615 bt_vm_map
= kernel_map
;
618 for (framecount
= 0; framecount
< nframes
; framecount
++) {
620 *tracebuf
++ = prev_rip
;
622 *tracebuf
++ = stackptr
;
625 if (!stackptr
|| (stackptr
== fence
)) {
628 if (stackptr
& 0x0000007) {
631 if (stackptr
<= prevsp
) {
635 kern_virt_addr
= machine_trace_thread_get_kva(stackptr
+ RETURN_OFFSET64
, bt_vm_map
, thread_trace_flags
);
636 if (!kern_virt_addr
) {
637 if (thread_trace_flags
) {
638 *thread_trace_flags
|= kThreadTruncatedBT
;
643 prev_rip
= *(uint64_t *)kern_virt_addr
;
645 prev_rip
= VM_KERNEL_UNSLIDE(prev_rip
);
650 kern_virt_addr
= machine_trace_thread_get_kva(stackptr
, bt_vm_map
, thread_trace_flags
);
652 if (kern_virt_addr
) {
653 stackptr
= *(uint64_t *)kern_virt_addr
;
656 if (thread_trace_flags
) {
657 *thread_trace_flags
|= kThreadTruncatedBT
;
662 machine_trace_thread_clear_validation_cache();
664 return (uint32_t) (((char *) tracebuf
) - tracepos
);
668 kdp_ml_enter_debugger(void)
670 __asm__
__volatile__("int3");