| | 1 | /* |
| | 2 | * Copyright (c) 2000-2010 Apple Inc. All rights reserved. |
| | 3 | * |
| | 4 | * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ |
| | 5 | * |
| | 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. |
| | 14 | * |
| | 15 | * Please obtain a copy of the License at |
| | 16 | * http://www.opensource.apple.com/apsl/ and read it before using this file. |
| | 17 | * |
| | 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. |
| | 25 | * |
| | 26 | * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ |
| | 27 | */ |
| | 28 | |
| | 29 | /* Copyright (c) 1997 Apple Computer, Inc. All rights reserved. |
| | 30 | * |
| | 31 | * kdebug.h - kernel_debug definitions |
| | 32 | * |
| | 33 | */ |
| | 34 | |
| | 35 | #ifndef BSD_SYS_KDEBUG_H |
| | 36 | #define BSD_SYS_KDEBUG_H |
| | 37 | |
| | 38 | #include <sys/appleapiopts.h> |
| | 39 | #include <sys/cdefs.h> |
| | 40 | __BEGIN_DECLS |
| | 41 | |
| | 42 | #ifdef __APPLE_API_UNSTABLE |
| | 43 | |
| | 44 | #include <mach/clock_types.h> |
| | 45 | #include <stdint.h> |
| | 46 | #if defined(KERNEL_BUILD) |
| | 47 | #include <kdebug.h> |
| | 48 | #endif /* KERNEL_BUILD */ |
| | 49 | |
| | 50 | #ifdef XNU_KERNEL_PRIVATE |
| | 51 | #include <stdint.h> |
| | 52 | #include <mach/branch_predicates.h> |
| | 53 | #endif |
| | 54 | |
| | 55 | /* |
| | 56 | * types of faults that vm_fault handles |
| | 57 | * and creates trace entries for |
| | 58 | */ |
| | 59 | #define DBG_ZERO_FILL_FAULT 1 |
| | 60 | #define DBG_PAGEIN_FAULT 2 |
| | 61 | #define DBG_COW_FAULT 3 |
| | 62 | #define DBG_CACHE_HIT_FAULT 4 |
| | 63 | #define DBG_NZF_PAGE_FAULT 5 |
| | 64 | #define DBG_GUARD_FAULT 6 |
| | 65 | #define DBG_PAGEINV_FAULT 7 |
| | 66 | #define DBG_PAGEIND_FAULT 8 |
| | 67 | |
| | 68 | |
| | 69 | /* The debug code consists of the following |
| | 70 | * |
| | 71 | * ---------------------------------------------------------------------- |
| | 72 | *| | | |Func | |
| | 73 | *| Class (8) | SubClass (8) | Code (14) |Qual(2)| |
| | 74 | * ---------------------------------------------------------------------- |
| | 75 | * The class specifies the higher level |
| | 76 | */ |
| | 77 | |
| | 78 | /* The Function qualifiers */ |
| | 79 | #define DBG_FUNC_START 1 |
| | 80 | #define DBG_FUNC_END 2 |
| | 81 | #define DBG_FUNC_NONE 0 |
| | 82 | |
| | 83 | |
| | 84 | /* The Kernel Debug Classes */ |
| | 85 | #define DBG_MACH 1 |
| | 86 | #define DBG_NETWORK 2 |
| | 87 | #define DBG_FSYSTEM 3 |
| | 88 | #define DBG_BSD 4 |
| | 89 | #define DBG_IOKIT 5 |
| | 90 | #define DBG_DRIVERS 6 |
| | 91 | #define DBG_TRACE 7 |
| | 92 | #define DBG_DLIL 8 |
| | 93 | #define DBG_SECURITY 9 |
| | 94 | #define DBG_CORESTORAGE 10 |
| | 95 | #define DBG_MISC 20 |
| | 96 | #define DBG_DYLD 31 |
| | 97 | #define DBG_QT 32 |
| | 98 | #define DBG_APPS 33 |
| | 99 | #define DBG_LAUNCHD 34 |
| | 100 | #define DBG_MIG 255 |
| | 101 | |
| | 102 | /* **** The Kernel Debug Sub Classes for Mach (DBG_MACH) **** */ |
| | 103 | #define DBG_MACH_EXCP_KTRAP_x86 0x02 /* Kernel Traps on x86 */ |
| | 104 | #define DBG_MACH_EXCP_DFLT 0x03 /* Data Translation Fault */ |
| | 105 | #define DBG_MACH_EXCP_IFLT 0x04 /* Inst Translation Fault */ |
| | 106 | #define DBG_MACH_EXCP_INTR 0x05 /* Interrupts */ |
| | 107 | #define DBG_MACH_EXCP_ALNG 0x06 /* Alignment Exception */ |
| | 108 | #define DBG_MACH_EXCP_UTRAP_x86 0x07 /* User Traps on x86 */ |
| | 109 | #define DBG_MACH_EXCP_FP 0x08 /* FP Unavail */ |
| | 110 | #define DBG_MACH_EXCP_DECI 0x09 /* Decrementer Interrupt */ |
| | 111 | #define DBG_MACH_CHUD 0x0A /* CHUD */ |
| | 112 | #define DBG_MACH_EXCP_SC 0x0C /* System Calls */ |
| | 113 | #define DBG_MACH_EXCP_TRACE 0x0D /* Trace exception */ |
| | 114 | #define DBG_MACH_EXCP_EMUL 0x0E /* Instruction emulated */ |
| | 115 | #define DBG_MACH_IHDLR 0x10 /* Interrupt Handlers */ |
| | 116 | #define DBG_MACH_IPC 0x20 /* Inter Process Comm */ |
| | 117 | #define DBG_MACH_VM 0x30 /* Virtual Memory */ |
| | 118 | #define DBG_MACH_LEAKS 0x31 /* alloc/free */ |
| | 119 | #define DBG_MACH_SCHED 0x40 /* Scheduler */ |
| | 120 | #define DBG_MACH_MSGID_INVALID 0x50 /* Messages - invalid */ |
| | 121 | #define DBG_MACH_LOCKS 0x60 /* new lock APIs */ |
| | 122 | #define DBG_MACH_PMAP 0x70 /* pmap */ |
| | 123 | #define DBG_MACH_MP 0x90 /* MP related */ |
| | 124 | |
| | 125 | /* Codes for Scheduler (DBG_MACH_SCHED) */ |
| | 126 | #define MACH_SCHED 0x0 /* Scheduler */ |
| | 127 | #define MACH_STACK_ATTACH 0x1 /* stack_attach() */ |
| | 128 | #define MACH_STACK_HANDOFF 0x2 /* stack_handoff() */ |
| | 129 | #define MACH_CALL_CONT 0x3 /* call_continuation() */ |
| | 130 | #define MACH_CALLOUT 0x4 /* callouts */ |
| | 131 | #define MACH_STACK_DETACH 0x5 |
| | 132 | #define MACH_MAKE_RUNNABLE 0x6 /* make thread runnable */ |
| | 133 | #define MACH_PROMOTE 0x7 /* promoted due to resource */ |
| | 134 | #define MACH_DEMOTE 0x8 /* promotion undone */ |
| | 135 | #define MACH_IDLE 0x9 /* processor idling */ |
| | 136 | #define MACH_STACK_DEPTH 0xa /* stack depth at switch */ |
| | 137 | #define MACH_MOVED 0xb /* did not use original scheduling decision */ |
| | 138 | #define MACH_FAIRSHARE_ENTER 0xc /* move to fairshare band */ |
| | 139 | #define MACH_FAIRSHARE_EXIT 0xd /* exit fairshare band */ |
| | 140 | #define MACH_FAILSAFE 0xe /* tripped fixed-pri/RT failsafe */ |
| | 141 | #define MACH_GET_URGENCY 0x14 /* Urgency queried by platform */ |
| | 142 | #define MACH_URGENCY 0x15 /* Urgency (RT/BG/NORMAL) communicated |
| | 143 | * to platform */ |
| | 144 | #define MACH_REDISPATCH 0x16 /* "next thread" thread redispatched */ |
| | 145 | #define MACH_REMOTE_AST 0x17 /* AST signal issued to remote processor */ |
| | 146 | #define MACH_SCHED_LPA_BROKEN 0x18 /* last_processor affinity broken in choose_processor */ |
| | 147 | |
| | 148 | /* Codes for pmap (DBG_MACH_PMAP) */ |
| | 149 | #define PMAP__CREATE 0x0 |
| | 150 | #define PMAP__DESTROY 0x1 |
| | 151 | #define PMAP__PROTECT 0x2 |
| | 152 | #define PMAP__PAGE_PROTECT 0x3 |
| | 153 | #define PMAP__ENTER 0x4 |
| | 154 | #define PMAP__REMOVE 0x5 |
| | 155 | #define PMAP__NEST 0x6 |
| | 156 | #define PMAP__UNNEST 0x7 |
| | 157 | #define PMAP__FLUSH_TLBS 0x8 |
| | 158 | #define PMAP__UPDATE_INTERRUPT 0x9 |
| | 159 | #define PMAP__ATTRIBUTE_CLEAR 0xa |
| | 160 | |
| | 161 | /* **** The Kernel Debug Sub Classes for Network (DBG_NETWORK) **** */ |
| | 162 | #define DBG_NETIP 1 /* Internet Protocol */ |
| | 163 | #define DBG_NETARP 2 /* Address Resolution Protocol */ |
| | 164 | #define DBG_NETUDP 3 /* User Datagram Protocol */ |
| | 165 | #define DBG_NETTCP 4 /* Transmission Control Protocol */ |
| | 166 | #define DBG_NETICMP 5 /* Internet Control Message Protocol */ |
| | 167 | #define DBG_NETIGMP 6 /* Internet Group Management Protocol */ |
| | 168 | #define DBG_NETRIP 7 /* Routing Information Protocol */ |
| | 169 | #define DBG_NETOSPF 8 /* Open Shortest Path First */ |
| | 170 | #define DBG_NETISIS 9 /* Intermediate System to Intermediate System */ |
| | 171 | #define DBG_NETSNMP 10 /* Simple Network Management Protocol */ |
| | 172 | #define DBG_NETSOCK 11 /* Socket Layer */ |
| | 173 | |
| | 174 | /* For Apple talk */ |
| | 175 | #define DBG_NETAARP 100 /* Apple ARP */ |
| | 176 | #define DBG_NETDDP 101 /* Datagram Delivery Protocol */ |
| | 177 | #define DBG_NETNBP 102 /* Name Binding Protocol */ |
| | 178 | #define DBG_NETZIP 103 /* Zone Information Protocol */ |
| | 179 | #define DBG_NETADSP 104 /* Name Binding Protocol */ |
| | 180 | #define DBG_NETATP 105 /* Apple Transaction Protocol */ |
| | 181 | #define DBG_NETASP 106 /* Apple Session Protocol */ |
| | 182 | #define DBG_NETAFP 107 /* Apple Filing Protocol */ |
| | 183 | #define DBG_NETRTMP 108 /* Routing Table Maintenance Protocol */ |
| | 184 | #define DBG_NETAURP 109 /* Apple Update Routing Protocol */ |
| | 185 | #define DBG_NETIPSEC 128 /* IPsec Protocol */ |
| | 186 | |
| | 187 | /* **** The Kernel Debug Sub Classes for IOKIT (DBG_IOKIT) **** */ |
| | 188 | #define DBG_IOINTC 0 /* Interrupt controller */ |
| | 189 | #define DBG_IOWORKLOOP 1 /* Work from work loop */ |
| | 190 | #define DBG_IOINTES 2 /* Interrupt event source */ |
| | 191 | #define DBG_IOCLKES 3 /* Clock event source */ |
| | 192 | #define DBG_IOCMDQ 4 /* Command queue latencies */ |
| | 193 | #define DBG_IOMCURS 5 /* Memory Cursor */ |
| | 194 | #define DBG_IOMDESC 6 /* Memory Descriptors */ |
| | 195 | #define DBG_IOPOWER 7 /* Power Managerment */ |
| | 196 | #define DBG_IOSERVICE 8 /* Matching etc. */ |
| | 197 | |
| | 198 | /* **** 9-32 reserved for internal IOKit usage **** */ |
| | 199 | |
| | 200 | #define DBG_IOSTORAGE 32 /* Storage layers */ |
| | 201 | #define DBG_IONETWORK 33 /* Network layers */ |
| | 202 | #define DBG_IOKEYBOARD 34 /* Keyboard */ |
| | 203 | #define DBG_IOHID 35 /* HID Devices */ |
| | 204 | #define DBG_IOAUDIO 36 /* Audio */ |
| | 205 | #define DBG_IOSERIAL 37 /* Serial */ |
| | 206 | #define DBG_IOTTY 38 /* TTY layers */ |
| | 207 | #define DBG_IOSAM 39 /* SCSI Architecture Model layers */ |
| | 208 | #define DBG_IOPARALLELATA 40 /* Parallel ATA */ |
| | 209 | #define DBG_IOPARALLELSCSI 41 /* Parallel SCSI */ |
| | 210 | #define DBG_IOSATA 42 /* Serial-ATA */ |
| | 211 | #define DBG_IOSAS 43 /* SAS */ |
| | 212 | #define DBG_IOFIBRECHANNEL 44 /* FiberChannel */ |
| | 213 | #define DBG_IOUSB 45 /* USB */ |
| | 214 | #define DBG_IOBLUETOOTH 46 /* Bluetooth */ |
| | 215 | #define DBG_IOFIREWIRE 47 /* FireWire */ |
| | 216 | #define DBG_IOINFINIBAND 48 /* Infiniband */ |
| | 217 | #define DBG_IOCPUPM 49 /* CPU Power Management */ |
| | 218 | #define DBG_IOGRAPHICS 50 /* Graphics */ |
| | 219 | #define DBG_HIBERNATE 51 /* hibernation related events */ |
| | 220 | |
| | 221 | |
| | 222 | /* Backwards compatibility */ |
| | 223 | #define DBG_IOPOINTING DBG_IOHID /* OBSOLETE: Use DBG_IOHID instead */ |
| | 224 | #define DBG_IODISK DBG_IOSTORAGE /* OBSOLETE: Use DBG_IOSTORAGE instead */ |
| | 225 | |
| | 226 | /* **** The Kernel Debug Sub Classes for Device Drivers (DBG_DRIVERS) **** */ |
| | 227 | #define DBG_DRVSTORAGE 1 /* Storage layers */ |
| | 228 | #define DBG_DRVNETWORK 2 /* Network layers */ |
| | 229 | #define DBG_DRVKEYBOARD 3 /* Keyboard */ |
| | 230 | #define DBG_DRVHID 4 /* HID Devices */ |
| | 231 | #define DBG_DRVAUDIO 5 /* Audio */ |
| | 232 | #define DBG_DRVSERIAL 7 /* Serial */ |
| | 233 | #define DBG_DRVSAM 8 /* SCSI Architecture Model layers */ |
| | 234 | #define DBG_DRVPARALLELATA 9 /* Parallel ATA */ |
| | 235 | #define DBG_DRVPARALLELSCSI 10 /* Parallel SCSI */ |
| | 236 | #define DBG_DRVSATA 11 /* Serial ATA */ |
| | 237 | #define DBG_DRVSAS 12 /* SAS */ |
| | 238 | #define DBG_DRVFIBRECHANNEL 13 /* FiberChannel */ |
| | 239 | #define DBG_DRVUSB 14 /* USB */ |
| | 240 | #define DBG_DRVBLUETOOTH 15 /* Bluetooth */ |
| | 241 | #define DBG_DRVFIREWIRE 16 /* FireWire */ |
| | 242 | #define DBG_DRVINFINIBAND 17 /* Infiniband */ |
| | 243 | #define DBG_DRVGRAPHICS 18 /* Graphics */ |
| | 244 | #define DBG_DRVSD 19 /* Secure Digital */ |
| | 245 | |
| | 246 | /* Backwards compatibility */ |
| | 247 | #define DBG_DRVPOINTING DBG_DRVHID /* OBSOLETE: Use DBG_DRVHID instead */ |
| | 248 | #define DBG_DRVDISK DBG_DRVSTORAGE /* OBSOLETE: Use DBG_DRVSTORAGE instead */ |
| | 249 | |
| | 250 | /* **** The Kernel Debug Sub Classes for the DLIL Layer (DBG_DLIL) **** */ |
| | 251 | #define DBG_DLIL_STATIC 1 /* Static DLIL code */ |
| | 252 | #define DBG_DLIL_PR_MOD 2 /* DLIL Protocol Module */ |
| | 253 | #define DBG_DLIL_IF_MOD 3 /* DLIL Interface Module */ |
| | 254 | #define DBG_DLIL_PR_FLT 4 /* DLIL Protocol Filter */ |
| | 255 | #define DBG_DLIL_IF_FLT 5 /* DLIL Interface FIlter */ |
| | 256 | |
| | 257 | /* The Kernel Debug Sub Classes for File System (DBG_FSYSTEM) */ |
| | 258 | #define DBG_FSRW 1 /* reads and writes to the filesystem */ |
| | 259 | #define DBG_DKRW 2 /* reads and writes to the disk */ |
| | 260 | #define DBG_FSVN 3 /* vnode operations (inc. locking/unlocking) */ |
| | 261 | #define DBG_FSLOOOKUP 4 /* namei and other lookup-related operations */ |
| | 262 | #define DBG_JOURNAL 5 /* journaling operations */ |
| | 263 | #define DBG_IOCTL 6 /* ioctl to the disk */ |
| | 264 | #define DBG_BOOTCACHE 7 /* bootcache operations */ |
| | 265 | #define DBG_HFS 8 /* HFS-specific events; see bsd/hfs/hfs_kdebug.h */ |
| | 266 | |
| | 267 | /* The Kernel Debug Sub Classes for BSD */ |
| | 268 | #define DBG_BSD_PROC 0x01 /* process/signals related */ |
| | 269 | #define DBG_BSD_EXCP_SC 0x0C /* System Calls */ |
| | 270 | #define DBG_BSD_AIO 0x0D /* aio (POSIX async IO) */ |
| | 271 | #define DBG_BSD_SC_EXTENDED_INFO 0x0E /* System Calls, extended info */ |
| | 272 | #define DBG_BSD_SC_EXTENDED_INFO2 0x0F /* System Calls, extended info */ |
| | 273 | |
| | 274 | |
| | 275 | /* The Codes for BSD subcode class DBG_BSD_PROC */ |
| | 276 | #define BSD_PROC_EXIT 1 /* process exit */ |
| | 277 | #define BSD_PROC_FRCEXIT 2 /* Kernel force termination */ |
| | 278 | |
| | 279 | /* The Kernel Debug Sub Classes for DBG_TRACE */ |
| | 280 | #define DBG_TRACE_DATA 0 |
| | 281 | #define DBG_TRACE_STRING 1 |
| | 282 | #define DBG_TRACE_INFO 2 |
| | 283 | |
| | 284 | /* The Kernel Debug Sub Classes for DBG_CORESTORAGE */ |
| | 285 | #define DBG_CS_IO 0 |
| | 286 | |
| | 287 | /* The Kernel Debug Sub Classes for DBG_MISC */ |
| | 288 | #define DBG_EVENT 0x10 |
| | 289 | #define DBG_BUFFER 0x20 |
| | 290 | |
| | 291 | /* The Kernel Debug Sub Classes for DBG_DYLD */ |
| | 292 | #define DBG_DYLD_STRING 5 |
| | 293 | |
| | 294 | /* The Kernel Debug modifiers for the DBG_DKRW sub class */ |
| | 295 | #define DKIO_DONE 0x01 |
| | 296 | #define DKIO_READ 0x02 |
| | 297 | #define DKIO_ASYNC 0x04 |
| | 298 | #define DKIO_META 0x08 |
| | 299 | #define DKIO_PAGING 0x10 |
| | 300 | #define DKIO_THROTTLE 0x20 |
| | 301 | #define DKIO_PASSIVE 0x40 |
| | 302 | |
| | 303 | /* Codes for Application Sub Classes */ |
| | 304 | #define DBG_APP_SAMBA 128 |
| | 305 | |
| | 306 | /**********************************************************************/ |
| | 307 | |
| | 308 | #define KDBG_CODE(Class, SubClass, code) (((Class & 0xff) << 24) | ((SubClass & 0xff) << 16) | ((code & 0x3fff) << 2)) |
| | 309 | |
| | 310 | #define KDBG_MIGCODE(msgid) ((DBG_MIG << 24) | (((msgid) & 0x3fffff) << 2)) |
| | 311 | |
| | 312 | #define MACHDBG_CODE(SubClass, code) KDBG_CODE(DBG_MACH, SubClass, code) |
| | 313 | #define NETDBG_CODE(SubClass, code) KDBG_CODE(DBG_NETWORK, SubClass, code) |
| | 314 | #define FSDBG_CODE(SubClass, code) KDBG_CODE(DBG_FSYSTEM, SubClass, code) |
| | 315 | #define BSDDBG_CODE(SubClass, code) KDBG_CODE(DBG_BSD, SubClass, code) |
| | 316 | #define IOKDBG_CODE(SubClass, code) KDBG_CODE(DBG_IOKIT, SubClass, code) |
| | 317 | #define DRVDBG_CODE(SubClass, code) KDBG_CODE(DBG_DRIVERS, SubClass, code) |
| | 318 | #define TRACEDBG_CODE(SubClass,code) KDBG_CODE(DBG_TRACE, SubClass, code) |
| | 319 | #define MISCDBG_CODE(SubClass,code) KDBG_CODE(DBG_MISC, SubClass, code) |
| | 320 | #define DLILDBG_CODE(SubClass,code) KDBG_CODE(DBG_DLIL, SubClass, code) |
| | 321 | #define SECURITYDBG_CODE(SubClass,code) KDBG_CODE(DBG_SECURITY, SubClass, code) |
| | 322 | #define DYLDDBG_CODE(SubClass,code) KDBG_CODE(DBG_DYLD, SubClass, code) |
| | 323 | #define QTDBG_CODE(SubClass,code) KDBG_CODE(DBG_QT, SubClass, code) |
| | 324 | #define APPSDBG_CODE(SubClass,code) KDBG_CODE(DBG_APPS, SubClass, code) |
| | 325 | #define CPUPM_CODE(code) IOKDBG_CODE(DBG_IOCPUPM, code) |
| | 326 | |
| | 327 | #define KMEM_ALLOC_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 0) |
| | 328 | #define KMEM_ALLOC_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 1) |
| | 329 | #define KMEM_FREE_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 2) |
| | 330 | #define KMEM_FREE_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 3) |
| | 331 | #define ZALLOC_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 4) |
| | 332 | #define ZALLOC_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 5) |
| | 333 | #define ZFREE_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 6) |
| | 334 | #define ZFREE_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 7) |
| | 335 | |
| | 336 | #define PMAP_CODE(code) MACHDBG_CODE(DBG_MACH_PMAP, code) |
| | 337 | |
| | 338 | /* Usage: |
| | 339 | * kernel_debug((KDBG_CODE(DBG_NETWORK, DNET_PROTOCOL, 51) | DBG_FUNC_START), |
| | 340 | * offset, 0, 0, 0,0) |
| | 341 | * |
| | 342 | * For ex, |
| | 343 | * |
| | 344 | * #include <sys/kdebug.h> |
| | 345 | * |
| | 346 | * #define DBG_NETIPINIT NETDBG_CODE(DBG_NETIP,1) |
| | 347 | * |
| | 348 | * |
| | 349 | * void |
| | 350 | * ip_init() |
| | 351 | * { |
| | 352 | * register struct protosw *pr; |
| | 353 | * register int i; |
| | 354 | * |
| | 355 | * KERNEL_DEBUG(DBG_NETIPINIT | DBG_FUNC_START, 0,0,0,0,0) |
| | 356 | * -------- |
| | 357 | * KERNEL_DEBUG(DBG_NETIPINIT, 0,0,0,0,0) |
| | 358 | * -------- |
| | 359 | * KERNEL_DEBUG(DBG_NETIPINIT | DBG_FUNC_END, 0,0,0,0,0) |
| | 360 | * } |
| | 361 | * |
| | 362 | |
| | 363 | */ |
| | 364 | |
| | 365 | extern unsigned int kdebug_enable; |
| | 366 | #define KDEBUG_ENABLE_TRACE 0x1 |
| | 367 | #define KDEBUG_ENABLE_ENTROPY 0x2 |
| | 368 | #define KDEBUG_ENABLE_CHUD 0x4 |
| | 369 | |
| | 370 | #if (!defined(NO_KDEBUG)) |
| | 371 | #ifdef XNU_KERNEL_PRIVATE |
| | 372 | #define KERNEL_DEBUG_CONSTANT(x,a,b,c,d,e) \ |
| | 373 | do { \ |
| | 374 | if (__improbable(kdebug_enable)) \ |
| | 375 | kernel_debug(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \ |
| | 376 | (uintptr_t)d,(uintptr_t)e); \ |
| | 377 | } while(0) |
| | 378 | |
| | 379 | #define KERNEL_DEBUG_CONSTANT1(x,a,b,c,d,e) \ |
| | 380 | do { \ |
| | 381 | if (__improbable(kdebug_enable)) \ |
| | 382 | kernel_debug1(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \ |
| | 383 | (uintptr_t)d,(uintptr_t)e); \ |
| | 384 | } while(0) |
| | 385 | #else /* XNU_KERNEL_PRIVATE */ |
| | 386 | #define KERNEL_DEBUG_CONSTANT(x,a,b,c,d,e) \ |
| | 387 | do { \ |
| | 388 | if (kdebug_enable) \ |
| | 389 | kernel_debug(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \ |
| | 390 | (uintptr_t)d,(uintptr_t)e); \ |
| | 391 | } while(0) |
| | 392 | |
| | 393 | #define KERNEL_DEBUG_CONSTANT1(x,a,b,c,d,e) \ |
| | 394 | do { \ |
| | 395 | if (kdebug_enable) \ |
| | 396 | kernel_debug1(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \ |
| | 397 | (uintptr_t)d,(uintptr_t)e); \ |
| | 398 | } while(0) |
| | 399 | #endif /* XNU_KERNEL_PRIVATE */ |
| | 400 | #else /*!NO_KDEBUG */ |
| | 401 | #define KERNEL_DEBUG_CONSTANT(x,a,b,c,d,e) do { } while(0) |
| | 402 | #define KERNEL_DEBUG_CONSTANT1(x,a,b,c,d,e) do { } while(0) |
| | 403 | |
| | 404 | #define __kdebug_constant_only __unused |
| | 405 | #endif |
| | 406 | |
| | 407 | extern void kernel_debug( |
| | 408 | uint32_t debugid, |
| | 409 | uintptr_t arg1, |
| | 410 | uintptr_t arg2, |
| | 411 | uintptr_t arg3, |
| | 412 | uintptr_t arg4, |
| | 413 | uintptr_t arg5); |
| | 414 | |
| | 415 | extern void kernel_debug1( |
| | 416 | uint32_t debugid, |
| | 417 | uintptr_t arg1, |
| | 418 | uintptr_t arg2, |
| | 419 | uintptr_t arg3, |
| | 420 | uintptr_t arg4, |
| | 421 | uintptr_t arg5); |
| | 422 | |
| | 423 | |
| | 424 | #if (KDEBUG && (!defined(NO_KDEBUG))) |
| | 425 | #ifdef XNU_KERNEL_PRIVATE |
| | 426 | #define KERNEL_DEBUG(x,a,b,c,d,e) \ |
| | 427 | do { \ |
| | 428 | if (__improbable(kdebug_enable)) \ |
| | 429 | kernel_debug((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \ |
| | 430 | (uintptr_t)c, (uintptr_t)d, (uintptr_t)e); \ |
| | 431 | } while(0) |
| | 432 | |
| | 433 | #define KERNEL_DEBUG1(x,a,b,c,d,e) \ |
| | 434 | do { \ |
| | 435 | if (__improbable(kdebug_enable)) \ |
| | 436 | kernel_debug1((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \ |
| | 437 | (uintptr_t)c, (uintptr_t)d, (uintptr_t)e); \ |
| | 438 | } while(0) |
| | 439 | |
| | 440 | #define __kdebug_only |
| | 441 | #else /* !XNU_KERNEL_PRIVATE */ |
| | 442 | #define KERNEL_DEBUG(x,a,b,c,d,e) \ |
| | 443 | do { \ |
| | 444 | if (kdebug_enable) \ |
| | 445 | kernel_debug((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \ |
| | 446 | (uintptr_t)c, (uintptr_t)d, (uintptr_t)e); \ |
| | 447 | } while(0) |
| | 448 | |
| | 449 | #define KERNEL_DEBUG1(x,a,b,c,d,e) \ |
| | 450 | do { \ |
| | 451 | if (kdebug_enable) \ |
| | 452 | kernel_debug1((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \ |
| | 453 | (uintptr_t)c, (uintptr_t)d, (uintptr_t)e); \ |
| | 454 | } while(0) |
| | 455 | #endif /* XNU_KERNEL_PRIVATE */ |
| | 456 | #else |
| | 457 | |
| | 458 | #define KERNEL_DEBUG(x,a,b,c,d,e) do {} while (0) |
| | 459 | #define KERNEL_DEBUG1(x,a,b,c,d,e) do {} while (0) |
| | 460 | |
| | 461 | #define __kdebug_only __unused |
| | 462 | #endif |
| | 463 | |
| | 464 | #ifdef KERNEL_PRIVATE |
| | 465 | #include <mach/boolean.h> |
| | 466 | struct proc; |
| | 467 | extern void kdbg_trace_data(struct proc *proc, long *arg_pid); |
| | 468 | |
| | 469 | extern void kdbg_trace_string(struct proc *proc, long *arg1, long *arg2, long *arg3, long *arg4); |
| | 470 | |
| | 471 | extern void kdbg_dump_trace_to_file(const char *); |
| | 472 | void start_kern_tracing(unsigned int); |
| | 473 | struct task; |
| | 474 | extern void kdbg_get_task_name(char*, int, struct task *task); |
| | 475 | void disable_wrap(uint32_t *old_slowcheck, uint32_t *old_flags); |
| | 476 | void enable_wrap(uint32_t old_slowcheck, boolean_t lostevents); |
| | 477 | void release_storage_unit(int cpu, uint32_t storage_unit); |
| | 478 | int allocate_storage_unit(int cpu); |
| | 479 | |
| | 480 | void trace_handler_map_ctrl_page(uintptr_t addr, unsigned long ctrl_page_size, unsigned long storage_size, unsigned long kds_ptr_size); |
| | 481 | void trace_handler_map_bufinfo(uintptr_t addr, unsigned long size); |
| | 482 | void trace_handler_unmap_bufinfo(void); |
| | 483 | void trace_handler_map_buffer(int index, uintptr_t addr, unsigned long size); |
| | 484 | void trace_handler_unmap_buffer(int index); |
| | 485 | void trace_set_timebases(uint64_t tsc, uint64_t ns); |
| | 486 | #endif /* KERNEL_PRIVATE */ |
| | 487 | |
| | 488 | |
| | 489 | #endif /* __APPLE_API_UNSTABLE */ |
| | 490 | __END_DECLS |
| | 491 | |
| | 492 | |
| | 493 | #ifdef PRIVATE |
| | 494 | #ifdef __APPLE_API_PRIVATE |
| | 495 | /* |
| | 496 | * private kernel_debug definitions |
| | 497 | */ |
| | 498 | |
| | 499 | typedef struct { |
| | 500 | uint64_t timestamp; |
| | 501 | uintptr_t arg1; |
| | 502 | uintptr_t arg2; |
| | 503 | uintptr_t arg3; |
| | 504 | uintptr_t arg4; |
| | 505 | uintptr_t arg5; /* will hold current thread */ |
| | 506 | uint32_t debugid; |
| | 507 | #if defined(__LP64__) |
| | 508 | uint32_t cpuid; |
| | 509 | uintptr_t unused; |
| | 510 | #endif |
| | 511 | } kd_buf; |
| | 512 | |
| | 513 | #if !defined(__LP64__) |
| | 514 | #define KDBG_TIMESTAMP_MASK 0x00ffffffffffffffULL |
| | 515 | #define KDBG_CPU_MASK 0xff00000000000000ULL |
| | 516 | #define KDBG_CPU_SHIFT 56 |
| | 517 | static inline void |
| | 518 | kdbg_set_cpu(kd_buf *kp, int cpu) |
| | 519 | { |
| | 520 | kp->timestamp = (kp->timestamp & KDBG_TIMESTAMP_MASK) | |
| | 521 | (((uint64_t) cpu) << KDBG_CPU_SHIFT); |
| | 522 | } |
| | 523 | static inline int |
| | 524 | kdbg_get_cpu(kd_buf *kp) |
| | 525 | { |
| | 526 | return (int) (((kp)->timestamp & KDBG_CPU_MASK) >> KDBG_CPU_SHIFT); |
| | 527 | } |
| | 528 | static inline void |
| | 529 | kdbg_set_timestamp(kd_buf *kp, uint64_t thetime) |
| | 530 | { |
| | 531 | kp->timestamp = thetime & KDBG_TIMESTAMP_MASK; |
| | 532 | } |
| | 533 | static inline uint64_t |
| | 534 | kdbg_get_timestamp(kd_buf *kp) |
| | 535 | { |
| | 536 | return kp->timestamp & KDBG_TIMESTAMP_MASK; |
| | 537 | } |
| | 538 | static inline void |
| | 539 | kdbg_set_timestamp_and_cpu(kd_buf *kp, uint64_t thetime, int cpu) |
| | 540 | { |
| | 541 | kp->timestamp = (thetime & KDBG_TIMESTAMP_MASK) | |
| | 542 | (((uint64_t) cpu) << KDBG_CPU_SHIFT); |
| | 543 | } |
| | 544 | #else |
| | 545 | #define KDBG_TIMESTAMP_MASK 0xffffffffffffffffULL |
| | 546 | static inline void |
| | 547 | kdbg_set_cpu(kd_buf *kp, int cpu) |
| | 548 | { |
| | 549 | kp->cpuid = cpu; |
| | 550 | } |
| | 551 | static inline int |
| | 552 | kdbg_get_cpu(kd_buf *kp) |
| | 553 | { |
| | 554 | return kp->cpuid; |
| | 555 | } |
| | 556 | static inline void |
| | 557 | kdbg_set_timestamp(kd_buf *kp, uint64_t thetime) |
| | 558 | { |
| | 559 | kp->timestamp = thetime; |
| | 560 | } |
| | 561 | static inline uint64_t |
| | 562 | kdbg_get_timestamp(kd_buf *kp) |
| | 563 | { |
| | 564 | return kp->timestamp; |
| | 565 | } |
| | 566 | static inline void |
| | 567 | kdbg_set_timestamp_and_cpu(kd_buf *kp, uint64_t thetime, int cpu) |
| | 568 | { |
| | 569 | kdbg_set_timestamp(kp, thetime); |
| | 570 | kdbg_set_cpu(kp, cpu); |
| | 571 | } |
| | 572 | #endif |
| | 573 | |
| | 574 | /* Debug Flags */ |
| | 575 | #define KDBG_INIT 0x001 |
| | 576 | #define KDBG_NOWRAP 0x002 |
| | 577 | #define KDBG_FREERUN 0x004 |
| | 578 | #define KDBG_WRAPPED 0x008 |
| | 579 | #define KDBG_USERFLAGS (KDBG_FREERUN|KDBG_NOWRAP|KDBG_INIT) |
| | 580 | #define KDBG_PIDCHECK 0x010 |
| | 581 | #define KDBG_MAPINIT 0x020 |
| | 582 | #define KDBG_PIDEXCLUDE 0x040 |
| | 583 | #define KDBG_LOCKINIT 0x080 |
| | 584 | #define KDBG_LP64 0x100 |
| | 585 | |
| | 586 | typedef struct { |
| | 587 | unsigned int type; |
| | 588 | unsigned int value1; |
| | 589 | unsigned int value2; |
| | 590 | unsigned int value3; |
| | 591 | unsigned int value4; |
| | 592 | |
| | 593 | } kd_regtype; |
| | 594 | |
| | 595 | typedef struct |
| | 596 | { |
| | 597 | int nkdbufs; |
| | 598 | int nolog; |
| | 599 | int flags; |
| | 600 | int nkdthreads; |
| | 601 | int bufid; |
| | 602 | } kbufinfo_t; |
| | 603 | |
| | 604 | typedef struct { |
| | 605 | uintptr_t thread; |
| | 606 | int valid; |
| | 607 | char command[20]; |
| | 608 | } kd_threadmap; |
| | 609 | |
| | 610 | |
| | 611 | typedef struct { |
| | 612 | int version_no; |
| | 613 | int thread_count; |
| | 614 | uint64_t TOD_secs; |
| | 615 | uint32_t TOD_usecs; |
| | 616 | } RAW_header; |
| | 617 | |
| | 618 | #define RAW_VERSION0 0x55aa0000 |
| | 619 | #define RAW_VERSION1 0x55aa0101 |
| | 620 | |
| | 621 | |
| | 622 | #define KDBG_CLASSTYPE 0x10000 |
| | 623 | #define KDBG_SUBCLSTYPE 0x20000 |
| | 624 | #define KDBG_RANGETYPE 0x40000 |
| | 625 | #define KDBG_TYPENONE 0x80000 |
| | 626 | #define KDBG_CKTYPES 0xF0000 |
| | 627 | |
| | 628 | #define KDBG_RANGECHECK 0x100000 |
| | 629 | #define KDBG_VALCHECK 0x200000 /* Check up to 4 individual values */ |
| | 630 | |
| | 631 | #define KDBG_BUFINIT 0x80000000 |
| | 632 | |
| | 633 | /* Control operations */ |
| | 634 | #define KDBG_EFLAGS 1 |
| | 635 | #define KDBG_DFLAGS 2 |
| | 636 | #define KDBG_ENABLE 3 |
| | 637 | #define KDBG_SETNUMBUF 4 |
| | 638 | #define KDBG_GETNUMBUF 5 |
| | 639 | #define KDBG_SETUP 6 |
| | 640 | #define KDBG_REMOVE 7 |
| | 641 | #define KDBG_SETREGCODE 8 |
| | 642 | #define KDBG_GETREGCODE 9 |
| | 643 | #define KDBG_READTRACE 10 |
| | 644 | #define KDBG_PIDTR 11 |
| | 645 | #define KDBG_THRMAP 12 |
| | 646 | #define KDBG_PIDEX 14 |
| | 647 | #define KDBG_SETRTCDEC 15 |
| | 648 | #define KDBG_KDGETENTROPY 16 |
| | 649 | |
| | 650 | /* Minimum value allowed when setting decrementer ticks */ |
| | 651 | #define KDBG_MINRTCDEC 2500 |
| | 652 | |
| | 653 | #endif /* __APPLE_API_PRIVATE */ |
| | 654 | #endif /* PRIVATE */ |
| | 655 | |
| | 656 | #endif /* !BSD_SYS_KDEBUG_H */ |
projects / apple / xnu.git / blame_incremental