2 * Copyright (c) 2000-2008 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@
32 * @APPLE_FREE_COPYRIGHT@
35 * (c) Copyright 1988 HEWLETT-PACKARD COMPANY
37 * To anyone who acknowledges that this file is provided "AS IS"
38 * without any express or implied warranty:
39 * permission to use, copy, modify, and distribute this file
40 * for any purpose is hereby granted without fee, provided that
41 * the above copyright notice and this notice appears in all
42 * copies, and that the name of Hewlett-Packard Company not be
43 * used in advertising or publicity pertaining to distribution
44 * of the software without specific, written prior permission.
45 * Hewlett-Packard Company makes no representations about the
46 * suitability of this software for any purpose.
49 * Copyright (c) 1990,1991,1992,1994 The University of Utah and
50 * the Computer Systems Laboratory (CSL). All rights reserved.
52 * THE UNIVERSITY OF UTAH AND CSL PROVIDE THIS SOFTWARE IN ITS "AS IS"
53 * CONDITION, AND DISCLAIM ANY LIABILITY OF ANY KIND FOR ANY DAMAGES
54 * WHATSOEVER RESULTING FROM ITS USE.
56 * CSL requests users of this software to return to csl-dist@cs.utah.edu any
57 * improvements that they make and grant CSL redistribution rights.
59 * Utah $Hdr: model_dep.c 1.34 94/12/14$
62 * NOTICE: This file was modified by McAfee Research in 2004 to introduce
63 * support for mandatory and extensible security protections. This notice
64 * is included in support of clause 2.2 (b) of the Apple Public License,
71 #include <db_machine_commands.h>
73 #include <kern/thread.h>
74 #include <machine/pmap.h>
75 #include <device/device_types.h>
77 #include <libkern/OSKextLibPrivate.h>
79 #include <mach/vm_param.h>
80 #include <mach/clock_types.h>
81 #include <mach/machine.h>
82 #include <mach/kmod.h>
85 #include <kern/misc_protos.h>
86 #include <kern/startup.h>
87 #include <ppc/misc_protos.h>
88 #include <ppc/proc_reg.h>
89 #include <ppc/thread.h>
92 #include <ppc/Firmware.h>
93 #include <ppc/low_trace.h>
94 #include <ppc/mappings.h>
95 #include <ppc/FirmwareCalls.h>
96 #include <ppc/cpu_internal.h>
97 #include <ppc/exception.h>
98 #include <ppc/hw_perfmon.h>
99 #include <ppc/lowglobals.h>
100 #include <ppc/machine_cpu.h>
101 #include <ppc/db_machdep.h>
103 #include <kern/clock.h>
104 #include <kern/debug.h>
105 #include <machine/trap.h>
106 #include <kern/spl.h>
107 #include <pexpert/pexpert.h>
108 #include <kern/sched.h>
109 #include <kern/task.h>
110 #include <kern/machine.h>
111 #include <vm/vm_map.h>
113 #include <IOKit/IOPlatformExpert.h>
115 #include <mach/vm_prot.h>
117 #include <mach/time_value.h>
118 #include <mach/mach_types.h>
119 #include <mach/mach_vm.h>
120 #include <machine/machparam.h> /* for btop */
123 #include <ddb/db_aout.h>
124 #include <ddb/db_output.h>
125 #include <ddb/db_command.h>
126 #include <machine/db_machdep.h>
128 extern struct db_command ppc_db_commands
[];
129 #endif /* MACH_KDB */
131 char kernel_args_buf
[256] = "/mach_kernel";
132 char boot_args_buf
[256] = "/mach_servers/bootstrap";
135 #define TRAP_DEBUGGER __asm__ volatile("tw 4,r3,r3");
136 #define TRAP_DEBUGGER_INST 0x7c831808
137 #define TRAP_DIRECT __asm__ volatile("tw 4,r4,r4");
138 #define TRAP_DIRECT_INST 0x7c842008
139 #define TRAP_INST_SIZE 4
140 #define BREAK_TO_KDP0 0x7fe00008
141 #define BREAK_TO_KDP1 0x7c800008
142 #define BREAK_TO_KDB0 0x7c810808
145 * Code used to synchronize debuggers among all cpus, one active at a time, switch
146 * from on to another using kdb_on! #cpu or cpu #cpu
149 hw_lock_data_t debugger_lock
; /* debugger lock */
150 hw_lock_data_t pbtlock
; /* backtrace print lock */
152 unsigned int debugger_cpu
= (unsigned)-1; /* current cpu running debugger */
153 int debugger_debug
= 0; /* Debug debugger */
154 int db_run_mode
; /* Debugger run mode */
155 unsigned int debugger_sync
= 0; /* Cross processor debugger entry sync */
156 extern unsigned int NMIss
; /* NMI debounce switch */
158 extern volatile int panicwait
;
159 volatile unsigned int pbtcnt
= 0;
160 volatile unsigned int pbtcpu
= -1;
162 unsigned int lastTrace
; /* Value of low-level exception trace controls */
165 volatile unsigned int cpus_holding_bkpts
; /* counter for number of cpus holding
166 breakpoints (ie: cpus that did not
167 insert back breakpoints) */
168 void unlock_debugger(void);
169 void lock_debugger(void);
170 void dump_backtrace(struct savearea
*sv
,
171 unsigned int stackptr
,
173 void dump_savearea(struct savearea
*sv
,
177 boolean_t db_breakpoints_inserted
= TRUE
;
178 jmp_buf_t
*db_recover
;
182 #include <ddb/db_run.h>
184 extern boolean_t db_breakpoints_inserted
;
185 extern jmp_buf_t
*db_recover
;
186 #define KDB_READY 0x1
191 #define KDP_READY 0x1
194 unsigned int db_im_stepping
= 0xFFFFFFFF; /* Remember if we were stepping */
197 const char *failNames
[] = {
198 "Debugging trap", /* failDebug */
199 "Corrupt stack", /* failStack */
200 "Corrupt mapping tables", /* failMapping */
201 "Corrupt context", /* failContext */
202 "No saveareas", /* failNoSavearea */
203 "Savearea corruption", /* failSaveareaCorr */
204 "Invalid live context", /* failBadLiveContext */
205 "Corrupt skip lists", /* failSkipLists */
206 "Unaligned stack", /* failUnalignedStk */
207 "Invalid pmap", /* failPmap */
208 "Lock timeout", /* failTimeout */
209 "Unknown failure code" /* Unknown failure code - must always be last */
212 const char *invxcption
= "Unknown code";
214 static unsigned commit_paniclog_to_nvram
;
217 void kdb_trap(__unused
int type
, __unused
struct savearea
*regs
) {}
218 #endif /* !MACH_KDB */
221 void kdp_trap(__unused
int type
, __unused
struct savearea
*regs
) {}
222 #endif /* !MACH_KDP */
224 extern int default_preemption_rate
;
225 extern int max_unsafe_quanta
;
226 extern int max_poll_quanta
;
229 machine_startup(void)
234 if (PE_parse_boot_argn("cpus", &wncpu
, sizeof (wncpu
))) {
235 if ((wncpu
> 0) && (wncpu
< MAX_CPUS
))
239 if( PE_get_hotkey( kPEControlKey
))
240 halt_in_debugger
= halt_in_debugger
? 0 : 1;
242 if (PE_parse_boot_argn("debug", &boot_arg
, sizeof (boot_arg
))) {
243 if (boot_arg
& DB_HALT
) halt_in_debugger
=1;
244 if (boot_arg
& DB_PRT
) disable_debug_output
=FALSE
;
245 if (boot_arg
& DB_SLOG
) systemLogDiags
=TRUE
;
246 if (boot_arg
& DB_NMI
) panicDebugging
=TRUE
;
247 if (boot_arg
& DB_LOG_PI_SCRN
) logPanicDataToScreen
=TRUE
;
250 if (!PE_parse_boot_argn("nvram_paniclog", &commit_paniclog_to_nvram
, sizeof (commit_paniclog_to_nvram
)))
251 commit_paniclog_to_nvram
= 1;
253 PE_parse_boot_argn("vmmforce", &lowGlo
.lgVMMforcedFeats
, sizeof (lowGlo
.lgVMMforcedFeats
));
255 hw_lock_init(&debugger_lock
); /* initialize debugger lock */
256 hw_lock_init(&pbtlock
); /* initialize print backtrace lock */
262 #if DB_MACHINE_COMMANDS
263 db_machine_commands_install(ppc_db_commands
);
264 #endif /* DB_MACHINE_COMMANDS */
267 if (boot_arg
& DB_KDB
)
268 current_debugger
= KDB_CUR_DB
;
271 * Cause a breakpoint trap to the debugger before proceeding
272 * any further if the proper option bit was specified in
275 if (halt_in_debugger
&& (current_debugger
== KDB_CUR_DB
)) {
276 Debugger("inline call to debugger(machine_startup)");
277 halt_in_debugger
= 0;
280 #endif /* MACH_KDB */
281 if (PE_parse_boot_argn("preempt", &boot_arg
, sizeof (boot_arg
))) {
282 default_preemption_rate
= boot_arg
;
284 if (PE_parse_boot_argn("unsafe", &boot_arg
, sizeof (boot_arg
))) {
285 max_unsafe_quanta
= boot_arg
;
287 if (PE_parse_boot_argn("poll", &boot_arg
, sizeof (boot_arg
))) {
288 max_poll_quanta
= boot_arg
;
290 if (PE_parse_boot_argn("yield", &boot_arg
, sizeof (boot_arg
))) {
291 sched_poll_yield_shift
= boot_arg
;
297 * Kick off the kernel bootstrap.
304 machine_boot_info(__unused
char *buf
, __unused vm_size_t size
)
306 return(PE_boot_args());
312 machine_info
.memory_size
= mem_size
; /* Note that this will be 2 GB for >= 2 GB machines */
320 /* Note that we must initialize the stepper tables AFTER the clock is configured!!!!! */
321 if(pmsExperimental
& 1) pmsCPUConf(); /* (EXPERIMENTAL) Initialize the stepper tables */
328 slave_machine_init(__unused
void *param
)
330 cpu_machine_init(); /* Initialize the processor */
331 clock_init(); /* Init the clock */
335 halt_all_cpus(boolean_t reboot
)
339 printf("MACH Reboot\n");
340 PEHaltRestart(kPERestartCPU
);
344 printf("CPU halted\n");
345 PEHaltRestart(kPEHaltCPU
);
353 halt_all_cpus(FALSE
);
358 * Machine-dependent routine to fill in an array with up to callstack_max
359 * levels of return pc information.
362 machine_callstack(__unused natural_t
*buf
, __unused vm_size_t callstack_max
)
365 #endif /* MACH_ASSERT */
368 print_backtrace(struct savearea
*ssp
)
370 unsigned int stackptr
, fence
;
371 struct savearea
*sv
, *svssp
, *psv
;
375 * We need this lock to make sure we don't hang up when we double panic on an MP.
378 cpu
= cpu_number(); /* Just who are we anyways? */
379 if(pbtcpu
!= cpu
) { /* Allow recursion */
380 (void)hw_atomic_add(&pbtcnt
, 1); /* Remember we are trying */
381 while(!hw_lock_try(&pbtlock
)); /* Spin here until we can get in. If we never do, well, we're crashing anyhow... */
382 pbtcpu
= cpu
; /* Mark it as us */
385 svssp
= (struct savearea
*)ssp
; /* Make this easier */
388 sv
= (struct savearea
*)current_thread()->machine
.pcb
; /* Find most current savearea if system has started */
390 fence
= 0xFFFFFFFF; /* Show we go all the way */
391 if(sv
) fence
= (unsigned int)sv
->save_r1
; /* Stop at previous exception point */
393 if(!svssp
) { /* Should we start from stack? */
394 kdb_printf("Latest stack backtrace for cpu %d:\n", cpu_number());
395 __asm__
volatile("mr %0,r1" : "=r" (stackptr
)); /* Get current stack */
396 dump_backtrace((struct savearea
*)0,stackptr
, fence
); /* Dump the backtrace */
397 if(!sv
) { /* Leave if no saveareas */
398 hw_lock_unlock(&pbtlock
); /* Allow another back trace to happen */
402 else { /* Were we passed an exception? */
403 fence
= 0xFFFFFFFF; /* Show we go all the way */
404 if(svssp
->save_hdr
.save_prev
) {
405 if((svssp
->save_hdr
.save_prev
<= vm_last_addr
) && ((unsigned int)pmap_find_phys(kernel_pmap
, (addr64_t
)svssp
->save_hdr
.save_prev
))) { /* Valid address? */
406 psv
= (struct savearea
*)((unsigned int)svssp
->save_hdr
.save_prev
); /* Get the 64-bit back chain converted to a regualr pointer */
407 fence
= (unsigned int)psv
->save_r1
; /* Stop at previous exception point */
411 kdb_printf("Latest crash info for cpu %d:\n", cpu_number());
412 kdb_printf(" Exception state (sv=%p)\n", svssp
);
413 dump_savearea(svssp
, fence
); /* Dump this savearea */
416 if(!sv
) { /* Leave if no saveareas */
417 hw_lock_unlock(&pbtlock
); /* Allow another back trace to happen */
421 kdb_printf("Proceeding back via exception chain:\n");
423 while(sv
) { /* Do them all... */
424 if(!(((addr64_t
)((uintptr_t)sv
) <= vm_last_addr
) &&
425 (unsigned int)pmap_find_phys(kernel_pmap
, (addr64_t
)((uintptr_t)sv
)))) { /* Valid address? */
426 kdb_printf(" Exception state (sv=%p) Not mapped or invalid. stopping...\n", sv
);
430 kdb_printf(" Exception state (sv=%p)\n", sv
);
431 if(sv
== svssp
) { /* Did we dump it already? */
432 kdb_printf(" previously dumped as \"Latest\" state. skipping...\n");
435 fence
= 0xFFFFFFFF; /* Show we go all the way */
436 if(sv
->save_hdr
.save_prev
) {
437 if((sv
->save_hdr
.save_prev
<= vm_last_addr
) && ((unsigned int)pmap_find_phys(kernel_pmap
, (addr64_t
)sv
->save_hdr
.save_prev
))) { /* Valid address? */
438 psv
= (struct savearea
*)((unsigned int)sv
->save_hdr
.save_prev
); /* Get the 64-bit back chain converted to a regualr pointer */
439 fence
= (unsigned int)psv
->save_r1
; /* Stop at previous exception point */
442 dump_savearea(sv
, fence
); /* Dump this savearea */
445 sv
= CAST_DOWN(struct savearea
*, sv
->save_hdr
.save_prev
); /* Back chain */
449 pbtcpu
= -1; /* Mark as unowned */
450 hw_lock_unlock(&pbtlock
); /* Allow another back trace to happen */
451 (void)hw_atomic_sub(&pbtcnt
, 1); /* Show we are done */
453 while(pbtcnt
); /* Wait for completion */
455 panic_display_system_configuration();
460 dump_savearea(struct savearea
*sv
, unsigned int fence
)
464 if(sv
->save_exception
> T_MAX
)
465 xcode
= invxcption
; /* Too big for table */
467 xcode
= trap_type
[sv
->save_exception
/ 4]; /* Point to the type */
469 kdb_printf(" PC=0x%08X; MSR=0x%08X; DAR=0x%08X; DSISR=0x%08X; LR=0x%08X; R1=0x%08X; XCP=0x%08X (%s)\n",
470 (unsigned int)sv
->save_srr0
, (unsigned int)sv
->save_srr1
, (unsigned int)sv
->save_dar
, sv
->save_dsisr
,
471 (unsigned int)sv
->save_lr
, (unsigned int)sv
->save_r1
, sv
->save_exception
, xcode
);
473 if(!(sv
->save_srr1
& MASK(MSR_PR
))) { /* Are we in the kernel? */
474 dump_backtrace(sv
, (unsigned int)sv
->save_r1
, fence
); /* Dump the stack back trace from here if not user state */
480 #define DUMPFRAMES 34
483 void dump_backtrace(struct savearea
*sv
, unsigned int stackptr
, unsigned int fence
) {
485 unsigned int bframes
[DUMPFRAMES
];
486 unsigned int sframe
[8], raddr
, dumbo
;
490 kdb_printf(" Backtrace:\n");
491 if (sv
!= (struct savearea
*)0) {
492 bframes
[0] = (unsigned int)sv
->save_srr0
;
493 bframes
[1] = (unsigned int)sv
->save_lr
;
496 for(i
= index
; i
< DUMPFRAMES
; i
++) { /* Dump up to max frames */
498 if(!stackptr
|| (stackptr
== fence
)) break; /* Hit stop point or end... */
500 if(stackptr
& 0x0000000F) { /* Is stack pointer valid? */
501 kdb_printf("\n backtrace terminated - unaligned frame address: 0x%08X\n", stackptr
); /* No, tell 'em */
505 raddr
= (unsigned int)pmap_find_phys(kernel_pmap
, (addr64_t
)stackptr
); /* Get physical frame address */
506 if(!raddr
|| (stackptr
> vm_last_addr
)) { /* Is it mapped? */
507 kdb_printf("\n backtrace terminated - frame not mapped or invalid: 0x%08X\n", stackptr
); /* No, tell 'em */
511 if(!mapping_phys_lookup(raddr
, &dumbo
)) { /* Is it within physical RAM? */
512 kdb_printf("\n backtrace terminated - frame outside of RAM: v=0x%08X, p=%08X\n", stackptr
, raddr
); /* No, tell 'em */
516 ReadReal((addr64_t
)((raddr
<< 12) | (stackptr
& 4095)), &sframe
[0]); /* Fetch the stack frame */
518 bframes
[i
] = sframe
[LRindex
]; /* Save the link register */
520 // syms_formataddr((vm_offset_t)bframes[i], syminfo, sizeof (syminfo));
521 // kdb_printf(" %s\n", syminfo);
522 if(!i
) kdb_printf(" "); /* Indent first time */
523 else if(!(i
& 7)) kdb_printf("\n "); /* Skip to new line every 8 */
524 kdb_printf("0x%08X ", bframes
[i
]); /* Dump the link register */
526 stackptr
= sframe
[0]; /* Chain back */
529 if(i
>= DUMPFRAMES
) kdb_printf(" backtrace continues...\n"); /* Say we terminated early */
530 if(i
) kmod_panic_dump((vm_offset_t
*)&bframes
[0], i
); /* Show what kmods are in trace */
534 void commit_paniclog(void) {
535 unsigned long pi_size
= 0;
537 if (debug_buf_size
> 0) {
538 if (commit_paniclog_to_nvram
) {
541 /* XXX Consider using the WKdm compressor in the
542 * future, rather than just packing - would need to
543 * be co-ordinated with crashreporter, which decodes
544 * this post-restart. The compressor should be
545 * capable of in-place compression.
547 bufpos
= packA(debug_buf
, (unsigned) (debug_buf_ptr
- debug_buf
), debug_buf_size
);
548 /* If compression was successful,
549 * use the compressed length
551 pi_size
= bufpos
? bufpos
: (unsigned) (debug_buf_ptr
- debug_buf
);
553 /* Truncate if the buffer is larger than a
554 * certain magic size - this really ought to
555 * be some appropriate fraction of the NVRAM
556 * image buffer, and is best done in the
557 * savePanicInfo() or PESavePanicInfo() calls
558 * This call must save data synchronously,
559 * since we can subsequently halt the system.
561 kprintf("Attempting to commit panic log to NVRAM\n");
562 /* N.B.: This routine (currently an IOKit wrapper that
563 * calls through to the appropriate platform NVRAM
564 * driver, must be panic context safe, i.e.
565 * acquire no locks or require kernel services.
566 * This does not appear to be the case currently
567 * on some platforms, unfortunately (the driver
568 * on command gate serialization).
570 pi_size
= PESavePanicInfo((unsigned char *)debug_buf
,
571 ((pi_size
> 2040) ? 2040 : pi_size
));
572 /* Uncompress in-place, to allow debuggers to examine
576 unpackA(debug_buf
, bufpos
);
582 Debugger(const char *message
) {
586 spl
= splhigh(); /* No interruptions from here on */
589 * backtrace for Debugger() call from panic() if no current debugger
590 * backtrace and return for double panic() call
592 if ((panicstr
!= (char *)0) &&
593 (((nestedpanic
!= 0) && (current_debugger
== 1)) || (active_debugger
== 0))) {
594 print_backtrace(NULL
);
595 if (nestedpanic
!= 0) {
597 return; /* Yeah, don't enter again... */
601 if (debug_mode
&& getPerProc()->debugger_active
) { /* Are we already on debugger on this processor? */
603 return; /* Yeah, don't do it again... */
608 * The above stuff catches the double panic case so we shouldn't have to worry about that here.
610 if ( panicstr
!= (char *)0 )
612 disable_preemption();
613 /* Commit the panic log buffer to NVRAM, unless otherwise
614 * specified via a boot-arg.
617 if(!panicDebugging
) {
618 unsigned int my_cpu
, tcpu
;
620 my_cpu
= cpu_number();
621 debugger_cpu
= my_cpu
;
623 (void)hw_atomic_add(&debug_mode
, 1);
624 PerProcTable
[my_cpu
].ppe_vaddr
->debugger_active
++;
627 for(tcpu
= 0; tcpu
< real_ncpus
; tcpu
++) {
628 if(tcpu
== my_cpu
) continue;
629 (void)hw_atomic_add(&debugger_sync
, 1);
630 (void)cpu_signal(tcpu
, SIGPdebug
, 0 ,0);
632 (void)hw_cpu_sync(&debugger_sync
, LockTimeOut
);
638 if(!panicDebugging
) {
640 PEHaltRestart(kPEPanicRestartCPU
);
642 PEHaltRestart( kPEHangCPU
);
649 if ((current_debugger
!= NO_CUR_DB
)) { /* If there is a debugger configured, enter it */
650 printf("Debugger(%s)\n", message
);
653 return; /* Done debugging for a while */
656 printf("\nNo debugger configured - dumping debug information\n");
657 printf("MSR=%08X\n",mfmsr());
658 print_backtrace(NULL
);
664 * Here's where we attempt to get some diagnostic information dumped out
665 * when the system is really confused. We will try to get into the
668 * We are here with interrupts disabled and on the debug stack. The savearea
669 * that was passed in is NOT chained to the activation.
671 * save_r3 contains the failure reason code.
675 SysChoked(unsigned int type
, struct savearea
*sv
)
677 unsigned int failcode
;
678 const char * const pmsg
= "System Failure: cpu=%d; code=%08X (%s)\n";
679 mp_disable_preemption();
680 disable_debug_output
= FALSE
;
683 failcode
= (unsigned int)sv
->save_r3
; /* Get the failure code */
684 if(failcode
> failUnknown
) failcode
= failUnknown
; /* Set unknown code code */
686 kprintf(pmsg
, cpu_number(), (unsigned int)sv
->save_r3
, failNames
[failcode
]);
687 kdb_printf(pmsg
, cpu_number(), (unsigned int)sv
->save_r3
, failNames
[failcode
]);
689 print_backtrace(sv
); /* Attempt to print backtrace */
691 /* Commit the panic log buffer to NVRAM, unless otherwise
692 * specified via a boot-arg. For certain types of panics
693 * which result in a "choke" exception, this may well
694 * be inadvisable, and setting the nvram_paniclog=0
695 * boot-arg may be useful.
701 Call_DebuggerC(type
, sv
); /* Attempt to get into debugger */
703 if ((current_debugger
!= NO_CUR_DB
))
704 Call_DebuggerC(type
, sv
); /* Attempt to get into debugger */
705 panic_plain(pmsg
, cpu_number(), (unsigned int)sv
->save_r3
, failNames
[failcode
]);
711 * When we get here, interruptions are disabled and we are on the debugger stack
712 * Never, ever, ever, ever enable interruptions from here on
716 Call_DebuggerC(unsigned int type
, struct savearea
*saved_state
)
718 int directcall
, wait
;
719 addr64_t instr_ptr
= 0ULL;
721 unsigned int instr
, tcpu
, my_cpu
;
724 my_cpu
= cpu_number(); /* Get our CPU */
727 if((debugger_cpu
== my_cpu
) && /* Do we already own debugger? */
728 PerProcTable
[my_cpu
].ppe_vaddr
->debugger_active
&& /* and are we really active? */
729 db_recover
&& /* and have we set up recovery? */
730 (current_debugger
== KDB_CUR_DB
)) { /* and are we in KDB (only it handles recovery) */
731 kdb_trap(type
, saved_state
); /* Then reenter it... */
735 (void)hw_atomic_add(&debug_mode
, 1); /* Indicate we are in debugger */
736 PerProcTable
[my_cpu
].ppe_vaddr
->debugger_active
++; /* Show active on our CPU */
738 lock_debugger(); /* Insure that only one CPU is in debugger */
740 if(db_im_stepping
== my_cpu
) { /* Are we just back from a step? */
741 enable_preemption_no_check(); /* Enable preemption now */
742 db_im_stepping
= 0xFFFFFFFF; /* Nobody stepping right now */
745 if (debugger_debug
) {
747 kprintf("Call_DebuggerC(%d): %08X %08X, debact = %d\n", my_cpu
, type
, (uint32_t)saved_state
, debug_mode
); /* (TEST/DEBUG) */
749 printf("Call_Debugger: enter - cpu %d, is_slave %d, debugger_cpu %d, pc %08llX\n",
750 my_cpu
, PerProcTable
[my_cpu
].ppe_vaddr
->debugger_is_slave
, debugger_cpu
, saved_state
->save_srr0
);
753 instr_pp
= (vm_offset_t
)pmap_find_phys(kernel_pmap
, (addr64_t
)(saved_state
->save_srr0
));
756 instr_ptr
= (addr64_t
)(((addr64_t
)instr_pp
<< 12) | (saved_state
->save_srr0
& 0xFFF)); /* Make physical address */
757 instr
= ml_phys_read_64(instr_ptr
); /* Get the trap that caused entry */
762 if (debugger_debug
) kprintf("Call_DebuggerC(%d): instr_pp = %08X, instr_ptr = %016llX, instr = %08X\n", my_cpu
, instr_pp
, instr_ptr
, instr
); /* (TEST/DEBUG) */
765 if (db_breakpoints_inserted
) cpus_holding_bkpts
++; /* Bump up the holding count */
766 if ((debugger_cpu
== (unsigned)-1) &&
767 !PerProcTable
[my_cpu
].ppe_vaddr
->debugger_is_slave
) {
769 if (debugger_debug
) kprintf("Call_DebuggerC(%d): lasttrace = %08X\n", my_cpu
, lastTrace
); /* (TEST/DEBUG) */
771 debugger_cpu
= my_cpu
; /* Show that we are debugger */
774 lastTrace
= LLTraceSet(0); /* Disable low-level tracing */
776 for(tcpu
= 0; tcpu
< real_ncpus
; tcpu
++) { /* Stop all the other guys */
777 if(tcpu
== my_cpu
) continue; /* Don't diddle ourselves */
778 (void)hw_atomic_add(&debugger_sync
, 1); /* Count signal sent */
779 (void)cpu_signal(tcpu
, SIGPdebug
, 0 ,0); /* Tell 'em to enter debugger */
781 (void)hw_cpu_sync(&debugger_sync
, LockTimeOut
); /* Wait for the other processors to enter debug */
782 debugger_sync
= 0; /* We're done with it */
784 else if (debugger_cpu
!= my_cpu
) goto debugger_exit
; /* We are not debugger, don't continue... */
787 if (instr
== TRAP_DIRECT_INST
) {
788 disable_debug_output
= FALSE
;
789 print_backtrace(saved_state
);
792 switch_debugger
= 0; /* Make sure switch request is off */
793 directcall
= 1; /* Assume direct call */
795 if (saved_state
->save_srr1
& MASK(SRR1_PRG_TRAP
)) { /* Trap instruction? */
797 directcall
= 0; /* We had a trap not a direct call */
799 switch (instr
) { /* Select trap type */
802 case BREAK_TO_KDP0
: /* Breakpoint into KDP? */
803 case BREAK_TO_KDP1
: /* Breakpoint into KDP? */
804 current_debugger
= KDP_CUR_DB
; /* Yes, set KDP */
805 kdp_trap(type
, saved_state
); /* Enter it */
810 case BREAK_TO_KDB0
: /* Breakpoint to KDB (the "good" debugger)? */
811 current_debugger
= KDB_CUR_DB
; /* Yes, set it */
812 kdb_trap(type
, saved_state
); /* Enter it */
816 case TRAP_DEBUGGER_INST
: /* Should we enter the current debugger? */
817 case TRAP_DIRECT_INST
: /* Should we enter the current debugger? */
818 if (current_debugger
== KDP_CUR_DB
) /* Is current KDP? */
819 kdp_trap(type
, saved_state
); /* Yes, enter it */
820 else if (current_debugger
== KDB_CUR_DB
) /* Is this KDB? */
821 kdb_trap(type
, saved_state
); /* Yes, go ahead and enter */
822 else goto debugger_error
; /* No debugger active */
825 default: /* Unknown/bogus trap type */
830 while(1) { /* We are here to handle debugger switches */
832 if(!directcall
) { /* Was this a direct call? */
833 if(!switch_debugger
) break; /* No, then leave if no switch requested... */
836 * Note: we can only switch to a debugger we have. Ignore bogus switch requests.
839 if (debugger_debug
) kprintf("Call_DebuggerC(%d): switching debuggers\n", my_cpu
); /* (TEST/DEBUG) */
842 if(current_debugger
== KDP_CUR_DB
) current_debugger
= KDB_CUR_DB
; /* Switch to KDB */
848 if(current_debugger
== KDB_CUR_DB
) current_debugger
= KDP_CUR_DB
; /* Switch to KDP */
852 switch_debugger
= 0; /* Clear request */
853 directcall
= 0; /* Clear first-time direct call indication */
855 switch (current_debugger
) { /* Enter correct debugger */
857 case KDP_CUR_DB
: /* Enter KDP */
858 kdp_trap(type
, saved_state
);
861 case KDB_CUR_DB
: /* Enter KDB */
862 kdb_trap(type
, saved_state
);
865 default: /* No debugger installed */
873 if (debugger_debug
) kprintf("Call_DebuggerC(%d): exit - inst = %08X, cpu=%d(%d), run=%d\n", my_cpu
,
874 instr
, my_cpu
, debugger_cpu
, db_run_mode
); /* (TEST/DEBUG) */
876 if ((instr
== TRAP_DEBUGGER_INST
) || /* Did we trap to enter debugger? */
877 (instr
== TRAP_DIRECT_INST
)) saved_state
->save_srr0
+= TRAP_INST_SIZE
; /* Yes, point past trap */
879 wasdebugger
= 0; /* Assume not debugger */
880 if(debugger_cpu
== my_cpu
) { /* Are the debugger processor? */
881 wasdebugger
= 1; /* Remember that we were the debugger */
882 LLTraceSet(lastTrace
); /* Enable tracing on the way out if we are debugger */
885 wait
= FALSE
; /* Assume we are not going to wait */
886 if (db_run_mode
== STEP_CONTINUE
) { /* Are we going to run? */
887 wait
= TRUE
; /* Yeah, remember to wait for breakpoints to clear */
888 debugger_cpu
= -1; /* Release other processor's debuggers */
889 for(tcpu
= 0; tcpu
< real_ncpus
; tcpu
++)
890 PerProcTable
[tcpu
].ppe_vaddr
->debugger_pending
= 0; /* Release request (this is a HACK) */
891 NMIss
= 0; /* Let NMI bounce */
894 if(db_run_mode
== STEP_ONCE
) { /* Are we about to step? */
895 disable_preemption(); /* Disable preemption for the step */
896 db_im_stepping
= my_cpu
; /* Remember that I am about to step */
899 if (db_breakpoints_inserted
) cpus_holding_bkpts
--; /* If any breakpoints, back off count */
900 if (PerProcTable
[my_cpu
].ppe_vaddr
->debugger_is_slave
) PerProcTable
[my_cpu
].ppe_vaddr
->debugger_is_slave
--; /* If we were a slove, uncount us */
902 printf("Call_Debugger: exit - cpu %d, debugger_cpu %d, run_mode %d holds %d\n",
903 my_cpu
, debugger_cpu
, db_run_mode
,
906 unlock_debugger(); /* Release the lock */
907 PerProcTable
[my_cpu
].ppe_vaddr
->debugger_active
--; /* Say we aren't active anymore */
909 if (wait
) while(cpus_holding_bkpts
); /* Wait for breakpoints to clear */
912 (void)hw_atomic_sub(&debug_mode
, 1); /* Set out of debug now */
914 return(1); /* Exit debugger normally */
917 if(db_run_mode
!= STEP_ONCE
) enable_preemption_no_check(); /* Enable preemption, but don't preempt here */
918 (void)hw_atomic_sub(&debug_mode
, 1); /* Set out of debug now */
919 return(0); /* Return in shame... */
928 my_cpu
= cpu_number(); /* Get our CPU number */
930 while(1) { /* Check until we get it */
931 if (debugger_cpu
!= (unsigned)-1 && debugger_cpu
!= my_cpu
)
932 continue; /* Someone, not us, is debugger... */
933 if (hw_lock_try(&debugger_lock
)) { /* Get the debug lock */
934 if (debugger_cpu
== (unsigned)-1 || debugger_cpu
== my_cpu
)
935 break; /* Is it us? */
936 hw_lock_unlock(&debugger_lock
); /* Not us, release lock */
941 void unlock_debugger(void) {
943 hw_lock_unlock(&debugger_lock
);
947 int patchInst(task_t task
, addr64_t vaddr
, uint32_t inst
);
948 int patchInst(task_t task
, addr64_t vaddr
, uint32_t inst
)
952 uint32_t instr
, nestingDepth
;
954 vm_region_submap_short_info_data_64_t info
;
955 mach_msg_type_number_t count
;
956 mach_vm_address_t address
;
957 mach_vm_size_t sizeOfRegion
;
960 if(task
== TASK_NULL
) return -1; /* Leave if task is bogus... */
962 task_lock(task
); /* Make sure the task doesn't go anywhaere */
963 if (!task
->active
) { /* Is is alive? */
964 task_unlock(task
); /* Nope, unlock */
965 return -1; /* Not a active task, fail... */
967 map
= task
->map
; /* Get his map */
968 vm_map_reference_swap(map
); /* Don't let it go away */
969 task_unlock(task
); /* Unleash the task */
971 /* Find the memory permissions. */
972 nestingDepth
=999999; /* Limit recursion */
974 count
= VM_REGION_SUBMAP_SHORT_INFO_COUNT_64
;
975 address
= (mach_vm_address_t
)vaddr
;
976 sizeOfRegion
= (mach_vm_size_t
)4;
978 ret
= mach_vm_region_recurse(map
, &address
, &sizeOfRegion
, &nestingDepth
, (vm_region_recurse_info_t
)&info
, &count
);
979 if (ret
!= KERN_SUCCESS
) { /* Leave if it didn't work */
980 vm_map_deallocate(map
); /* Drop reference on map */
985 * We need to check if there could be a problem if the dtrace probes are being removed and the code is being
986 * executed at the same time. This sequence may leave us with no-execute turned on temporarily when we execute
990 if (!(info
.protection
& VM_PROT_WRITE
)) {
991 /* Save the original protection values for restoration later */
992 reprotect
= info
.protection
;
994 if (info
.max_protection
& VM_PROT_WRITE
) {
995 /* The memory is not currently writable, but can be made writable. */
996 ret
= mach_vm_protect(map
, (mach_vm_offset_t
)vaddr
, (mach_vm_size_t
)4, 0, reprotect
| VM_PROT_WRITE
);
1000 * The memory is not currently writable, and cannot be made writable. We need to COW this memory.
1002 * Strange, we can't just say "reprotect | VM_PROT_COPY", that fails.
1004 ret
= mach_vm_protect(map
, (mach_vm_offset_t
)vaddr
, (mach_vm_size_t
)4, 0, VM_PROT_COPY
| VM_PROT_READ
| VM_PROT_WRITE
);
1007 if (ret
!= KERN_SUCCESS
) {
1008 vm_map_deallocate(map
); /* Drop reference on map */
1014 /* The memory was already writable. */
1015 reprotect
= VM_PROT_NONE
;
1018 instr
= inst
; /* Place instruction in local memory */
1019 ret
= vm_map_write_user(map
, &inst
, (vm_map_address_t
)vaddr
, (vm_size_t
)4); /* Write the instruction */
1020 if (ret
!= KERN_SUCCESS
) { /* Leave if it didn't work */
1022 if (reprotect
!= VM_PROT_NONE
) {
1023 ret
= mach_vm_protect (map
, (mach_vm_offset_t
)vaddr
, (mach_vm_size_t
)4, 0, reprotect
);
1026 vm_map_deallocate(map
); /* Drop reference on map */
1030 paddr
= (addr64_t
)pmap_find_phys(map
->pmap
, vaddr
) << 12; /* Find the physical address of the patched address */
1031 if(!paddr
) { /* Is address mapped now? */
1032 vm_map_deallocate(map
); /* Drop reference on map */
1033 return 0; /* Leave... */
1035 paddr
= paddr
| (vaddr
& 4095); /* Construct physical address */
1036 invalidate_icache64(paddr
, 4, 1); /* Flush out the instruction cache here */
1038 if (reprotect
!= VM_PROT_NONE
) {
1039 ret
= mach_vm_protect(map
, (mach_vm_offset_t
)vaddr
, (mach_vm_size_t
)4, 0, reprotect
);
1042 vm_map_deallocate(map
);