1This directory contains a universal DEBUG kernel, built for 32-bit and
264-bit Intel. It includes a dSYM bundle for remote kernel debugging
3and live kernel debugging.
4
5INSTALLATION
6
7!!!WARNING!!! These steps will overwrite the default kernel and
8System.kext. Backup all files before attempting these steps.
9
10To install the DEBUG kernel, do:
11bash-3.2$ sudo -s
12bash-3.2# cd /
13bash-3.2# ditto /AppleInternal/Developer/Extras/Kernel\ Debugging/System.kext /System/Library/Extensions/System.kext
14bash-3.2# cp -r /AppleInternal/Developer/Extras/Kernel\ Debugging/mach_kernel* /
15bash-3.2# chown -R root:wheel /System/Library/Extensions/System.kext /mach_kernel*
16bash-3.2# chmod -R g-w /System/Library/Extensions/System.kext /mach_kernel*
17bash-3.2# touch /System/Library/Extensions
18bash-3.2# shutdown -r now
19
20REMOTE KERNEL DEBUGGING
21
22See the documentation that accompanies the Kernel Debug Kit
23
24LIVE KERNEL DEBUGGING
25
26With the DEBUG kernel installed, set "kmem=1" in your "boot-args"
27NVRAM variable, reboot, and do:
28
29bash-3.2$ sudo gdb -a <arch> --quiet /mach_kernel
30(gdb) target darwin-kernel
31(gdb) source /AppleInternal/Developer/Extras/Kernel\ Debugging/kgmacros
32Loading Kernel GDB Macros package.  Type "help kgm" for more info.
33(gdb) attach
34Connected.
35
36<arch> should reflect the currently booted kernel architecture, either
37"i386" or "x86_64"
38
39
40