kdebug.h
1 /* 2 * Copyright (c) 2000-2019 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 #ifndef BSD_SYS_KDEBUG_H 30 #define BSD_SYS_KDEBUG_H 31 32 #include <sys/appleapiopts.h> 33 #include <sys/cdefs.h> 34 35 __BEGIN_DECLS 36 37 #ifdef __APPLE_API_UNSTABLE 38 39 /* 40 * Kdebug is a kernel facility for tracing events occurring on a system. User 41 * space processes should prefer os_signpost, instead. 42 * 43 * This header defines reserved debugids, which are 32-bit values that describe 44 * each event: 45 * 46 * +----------------+----------------+----------------------------+----+ 47 * | Class (8) | Subclass (8) | Code (14) |Func| 48 * | | | |(2) | 49 * +----------------+----------------+----------------------------+----+ 50 * \_________________________________/ 51 * ClassSubclass (CSC) 52 * \________________________________________________________________00_/ 53 * Eventid 54 * \___________________________________________________________________/ 55 * Debugid 56 * 57 * The eventid is a hierarchical ID, indicating which components an event is 58 * referring to. The debugid includes an eventid and two function qualifier 59 * bits, to determine the structural significance of an event (whether it 60 * starts or ends an interval). 61 */ 62 63 #define KDBG_CLASS_MASK (0xff000000) 64 #define KDBG_CLASS_OFFSET (24) 65 #define KDBG_CLASS_MAX (0xff) 66 67 #define KDBG_SUBCLASS_MASK (0x00ff0000) 68 #define KDBG_SUBCLASS_OFFSET (16) 69 #define KDBG_SUBCLASS_MAX (0xff) 70 71 /* class and subclass mask */ 72 #define KDBG_CSC_MASK (0xffff0000) 73 #define KDBG_CSC_OFFSET (KDBG_SUBCLASS_OFFSET) 74 #define KDBG_CSC_MAX (0xffff) 75 76 #define KDBG_CODE_MASK (0x0000fffc) 77 #define KDBG_CODE_OFFSET (2) 78 #define KDBG_CODE_MAX (0x3fff) 79 80 #define KDBG_EVENTID_MASK (0xfffffffc) 81 #define KDBG_FUNC_MASK (0x00000003) 82 83 /* Generate an eventid corresponding to Class, SubClass, and Code. */ 84 #define KDBG_EVENTID(Class, SubClass, Code) \ 85 (((unsigned)((Class) & 0xff) << KDBG_CLASS_OFFSET) | \ 86 ((unsigned)((SubClass) & 0xff) << KDBG_SUBCLASS_OFFSET) | \ 87 ((unsigned)((Code) & 0x3fff) << KDBG_CODE_OFFSET)) 88 /* Deprecated macro using old naming convention. */ 89 #define KDBG_CODE(Class, SubClass, Code) \ 90 KDBG_EVENTID(Class, SubClass, Code) 91 92 /* Extract pieces of the debug code. */ 93 #define KDBG_EXTRACT_CLASS(Debugid) \ 94 ((uint8_t)(((Debugid) & KDBG_CLASS_MASK) >> KDBG_CLASS_OFFSET)) 95 #define KDBG_EXTRACT_SUBCLASS(Debugid) \ 96 ((uint8_t)(((Debugid) & KDBG_SUBCLASS_MASK) >> KDBG_SUBCLASS_OFFSET)) 97 #define KDBG_EXTRACT_CSC(Debugid) \ 98 ((uint16_t)(((Debugid) & KDBG_CSC_MASK) >> KDBG_CSC_OFFSET)) 99 #define KDBG_EXTRACT_CODE(Debugid) \ 100 ((uint16_t)(((Debugid) & KDBG_CODE_MASK) >> KDBG_CODE_OFFSET)) 101 #define KDBG_CLASS_ENCODE(Class, SubClass) KDBG_EVENTID(Class, SubClass, 0) 102 #define KDBG_CLASS_DECODE(Debugid) (Debugid & KDBG_CSC_MASK) 103 104 /* function qualifiers */ 105 #define DBG_FUNC_START 1U 106 #define DBG_FUNC_END 2U 107 #define DBG_FUNC_NONE 0U 108 109 /* The Kernel Debug Classes */ 110 111 #define DBG_MACH 1 112 #define DBG_NETWORK 2 113 #define DBG_FSYSTEM 3 114 #define DBG_BSD 4 115 #define DBG_IOKIT 5 116 #define DBG_DRIVERS 6 117 #define DBG_TRACE 7 118 #define DBG_DLIL 8 119 #define DBG_PTHREAD 9 120 #define DBG_CORESTORAGE 10 121 #define DBG_CG 11 122 #define DBG_MONOTONIC 12 123 #define DBG_MISC 20 124 #define DBG_SECURITY 30 125 #define DBG_DYLD 31 126 #define DBG_QT 32 127 #define DBG_APPS 33 128 #define DBG_LAUNCHD 34 129 #define DBG_SILICON 35 130 #define DBG_PERF 37 131 #define DBG_IMPORTANCE 38 132 #define DBG_BANK 40 133 #define DBG_XPC 41 134 #define DBG_ATM 42 135 #define DBG_ARIADNE 43 136 #define DBG_DAEMON 44 137 #define DBG_ENERGYTRACE 45 138 #define DBG_DISPATCH 46 139 #define DBG_IMG 49 140 #define DBG_UMALLOC 51 141 #define DBG_TURNSTILE 53 142 143 #define DBG_MIG 255 144 145 /* **** The Kernel Debug Sub Classes for Mach (DBG_MACH) **** */ 146 #define DBG_MACH_EXCP_KTRAP_x86 0x02 /* Kernel Traps on x86 */ 147 #define DBG_MACH_EXCP_DFLT 0x03 /* deprecated name */ 148 #define DBG_MACH_EXCP_SYNC_ARM 0x03 /* arm/arm64 synchronous exception */ 149 #define DBG_MACH_EXCP_IFLT 0x04 /* deprecated name */ 150 #define DBG_MACH_EXCP_SERR_ARM 0x04 /* arm/arm64 SError (async) exception */ 151 #define DBG_MACH_EXCP_INTR 0x05 /* Interrupts */ 152 #define DBG_MACH_EXCP_ALNG 0x06 /* Alignment Exception */ 153 #define DBG_MACH_EXCP_UTRAP_x86 0x07 /* User Traps on x86 */ 154 #define DBG_MACH_EXCP_FP 0x08 /* FP Unavail */ 155 #define DBG_MACH_EXCP_DECI 0x09 /* Decrementer Interrupt */ 156 #define DBG_MACH_CHUD 0x0A /* deprecated name */ 157 #define DBG_MACH_SIGNPOST 0x0A /* kernel signposts */ 158 #define DBG_MACH_EXCP_SC 0x0C /* System Calls */ 159 #define DBG_MACH_EXCP_TRACE 0x0D /* Trace exception */ 160 #define DBG_MACH_EXCP_EMUL 0x0E /* Instruction emulated */ 161 #define DBG_MACH_IHDLR 0x10 /* Interrupt Handlers */ 162 #define DBG_MACH_IPC 0x20 /* Inter Process Comm */ 163 #define DBG_MACH_RESOURCE 0x25 /* tracing limits, etc */ 164 #define DBG_MACH_VM 0x30 /* Virtual Memory */ 165 #define DBG_MACH_LEAKS 0x31 /* alloc/free */ 166 #define DBG_MACH_WORKINGSET 0x32 /* private subclass for working set related debugging */ 167 #define DBG_MACH_SCHED 0x40 /* Scheduler */ 168 #define DBG_MACH_MSGID_INVALID 0x50 /* Messages - invalid */ 169 #define DBG_MACH_LOCKS 0x60 /* new lock APIs */ 170 #define DBG_MACH_PMAP 0x70 /* pmap */ 171 #define DBG_MACH_CLOCK 0x80 /* clock */ 172 #define DBG_MACH_MP 0x90 /* MP related */ 173 #define DBG_MACH_VM_PRESSURE 0xA0 /* Memory Pressure Events */ 174 #define DBG_MACH_STACKSHOT 0xA1 /* Stackshot/Microstackshot subsystem */ 175 #define DBG_MACH_SFI 0xA2 /* Selective Forced Idle (SFI) */ 176 #define DBG_MACH_ENERGY_PERF 0xA3 /* Energy/performance resource stats */ 177 #define DBG_MACH_SYSDIAGNOSE 0xA4 /* sysdiagnose */ 178 #define DBG_MACH_ZALLOC 0xA5 /* Zone allocator */ 179 #define DBG_MACH_THREAD_GROUP 0xA6 /* Thread groups */ 180 #define DBG_MACH_COALITION 0xA7 /* Coalitions */ 181 #define DBG_MACH_SHAREDREGION 0xA8 /* Shared region */ 182 #define DBG_MACH_SCHED_CLUTCH 0xA9 /* Clutch scheduler */ 183 #define DBG_MACH_IO 0xAA /* I/O */ 184 #define DBG_MACH_WORKGROUP 0xAB /* Workgroup subsystem */ 185 #define DBG_MACH_HV 0xAC /* Hypervisor subsystem */ 186 187 /* Codes for DBG_MACH_IO */ 188 #define DBC_MACH_IO_MMIO_READ 0x1 189 #define DBC_MACH_IO_MMIO_WRITE 0x2 190 #define DBC_MACH_IO_PHYS_READ 0x3 191 #define DBC_MACH_IO_PHYS_WRITE 0x4 192 #define DBC_MACH_IO_PORTIO_READ 0x5 193 #define DBC_MACH_IO_PORTIO_WRITE 0x6 194 195 /* Interrupt type bits for DBG_MACH_EXCP_INTR */ 196 #define DBG_INTR_TYPE_UNKNOWN 0x0 /* default/unknown interrupt */ 197 #define DBG_INTR_TYPE_IPI 0x1 /* interprocessor interrupt */ 198 #define DBG_INTR_TYPE_TIMER 0x2 /* timer interrupt */ 199 #define DBG_INTR_TYPE_OTHER 0x3 /* other (usually external) interrupt */ 200 #define DBG_INTR_TYPE_PMI 0x4 /* performance monitor interrupt */ 201 202 /* Codes for Scheduler (DBG_MACH_SCHED) */ 203 #define MACH_SCHED 0x0 /* Scheduler */ 204 #define MACH_STACK_ATTACH 0x1 /* stack_attach() */ 205 #define MACH_STACK_HANDOFF 0x2 /* stack_handoff() */ 206 #define MACH_CALL_CONT 0x3 /* call_continuation() */ 207 #define MACH_CALLOUT 0x4 /* callouts */ 208 #define MACH_STACK_DETACH 0x5 209 #define MACH_MAKE_RUNNABLE 0x6 /* make thread runnable */ 210 #define MACH_PROMOTE 0x7 /* promoted due to resource (replaced by MACH_PROMOTED) */ 211 #define MACH_DEMOTE 0x8 /* promotion undone (replaced by MACH_UNPROMOTED) */ 212 #define MACH_IDLE 0x9 /* processor idling */ 213 #define MACH_STACK_DEPTH 0xa /* stack depth at switch */ 214 #define MACH_MOVED 0xb /* did not use original scheduling decision */ 215 #define MACH_PSET_LOAD_AVERAGE 0xc 216 #define MACH_AMP_DEBUG 0xd 217 #define MACH_FAILSAFE 0xe /* tripped fixed-pri/RT failsafe */ 218 #define MACH_BLOCK 0xf /* thread block */ 219 #define MACH_WAIT 0x10 /* thread wait assertion */ 220 #define MACH_GET_URGENCY 0x14 /* Urgency queried by platform */ 221 #define MACH_URGENCY 0x15 /* Urgency (RT/BG/NORMAL) communicated 222 * to platform 223 */ 224 #define MACH_REDISPATCH 0x16 /* "next thread" thread redispatched */ 225 #define MACH_REMOTE_AST 0x17 /* AST signal issued to remote processor */ 226 #define MACH_SCHED_CHOOSE_PROCESSOR 0x18 /* Result of choose_processor */ 227 #define MACH_DEEP_IDLE 0x19 /* deep idle on master processor */ 228 /* unused 0x1a was MACH_SCHED_DECAY_PRIORITY */ 229 #define MACH_CPU_THROTTLE_DISABLE 0x1b /* Global CPU Throttle Disable */ 230 #define MACH_RW_PROMOTE 0x1c /* promoted due to RW lock promotion */ 231 #define MACH_RW_DEMOTE 0x1d /* promotion due to RW lock undone */ 232 #define MACH_SCHED_MAINTENANCE 0x1f /* periodic maintenance thread */ 233 #define MACH_DISPATCH 0x20 /* context switch completed */ 234 #define MACH_QUANTUM_HANDOFF 0x21 /* quantum handoff occurred */ 235 #define MACH_MULTIQ_DEQUEUE 0x22 /* Result of multiq dequeue */ 236 #define MACH_SCHED_THREAD_SWITCH 0x23 /* attempt direct context switch to hinted thread */ 237 #define MACH_SCHED_SMT_BALANCE 0x24 /* SMT load balancing ASTs */ 238 #define MACH_REMOTE_DEFERRED_AST 0x25 /* Deferred AST started against remote processor */ 239 #define MACH_REMOTE_CANCEL_AST 0x26 /* Canceled deferred AST for remote processor */ 240 #define MACH_SCHED_CHANGE_PRIORITY 0x27 /* thread sched priority changed */ 241 #define MACH_SCHED_UPDATE_REC_CORES 0x28 /* Change to recommended processor bitmask */ 242 #define MACH_STACK_WAIT 0x29 /* Thread could not be switched-to because of kernel stack shortage */ 243 #define MACH_THREAD_BIND 0x2a /* Thread was bound (or unbound) to a processor */ 244 #define MACH_WAITQ_PROMOTE 0x2b /* Thread promoted by waitq boost */ 245 #define MACH_WAITQ_DEMOTE 0x2c /* Thread demoted from waitq boost */ 246 #define MACH_SCHED_LOAD 0x2d /* load update */ 247 #define MACH_REC_CORES_FAILSAFE 0x2e /* recommended processor failsafe kicked in */ 248 #define MACH_SCHED_QUANTUM_EXPIRED 0x2f /* thread quantum expired */ 249 #define MACH_EXEC_PROMOTE 0x30 /* Thread promoted by exec boost */ 250 #define MACH_EXEC_DEMOTE 0x31 /* Thread demoted from exec boost */ 251 #define MACH_AMP_SIGNAL_SPILL 0x32 /* AMP spill signal sent to cpuid */ 252 #define MACH_AMP_STEAL 0x33 /* AMP thread stolen or spilled */ 253 #define MACH_SCHED_LOAD_EFFECTIVE 0x34 /* Effective scheduler load */ 254 /* unused MACH_PROMOTED 0x35 was: thread promoted due to mutex priority promotion */ 255 /* unused MACH_UNPROMOTED 0x36 was: thread unpromoted due to mutex priority promotion */ 256 /* unused MACH_PROMOTED_UPDATE 0x37 was: thread already promoted, but promotion priority changed */ 257 #define MACH_QUIESCENT_COUNTER 0x38 /* quiescent counter tick */ 258 #define MACH_TURNSTILE_USER_CHANGE 0x39 /* base priority change because of turnstile */ 259 #define MACH_AMP_RECOMMENDATION_CHANGE 0x3a /* Thread group recommendation change */ 260 #define MACH_AMP_PERFCTL_POLICY_CHANGE 0x3b /* AMP policy for perfctl cluster recommendation */ 261 #define MACH_TURNSTILE_KERNEL_CHANGE 0x40 /* sched priority change because of turnstile */ 262 #define MACH_SCHED_WI_AUTO_JOIN 0x41 /* work interval auto join events */ 263 #define MACH_SCHED_WI_DEFERRED_FINISH 0x42 /* work interval pending finish events for auto-join thread groups */ 264 #define MACH_SET_RT_DEADLINE 0x43 /* set thread->realtime.deadline */ 265 #define MACH_CANCEL_RT_DEADLINE 0x44 /* cancel thread->realtime.deadline */ 266 #define MACH_PSET_AVG_EXEC_TIME 0x50 267 268 /* Codes for Clutch/Edge Scheduler (DBG_MACH_SCHED_CLUTCH) */ 269 #define MACH_SCHED_CLUTCH_ROOT_BUCKET_STATE 0x0 /* __unused */ 270 #define MACH_SCHED_CLUTCH_TG_BUCKET_STATE 0x1 /* __unused */ 271 #define MACH_SCHED_CLUTCH_THREAD_SELECT 0x2 /* Thread selection events for Clutch scheduler */ 272 #define MACH_SCHED_CLUTCH_THREAD_STATE 0x3 /* __unused */ 273 #define MACH_SCHED_CLUTCH_TG_BUCKET_PRI 0x4 /* Clutch bucket priority update event */ 274 /* Edge Scheduler Tracepoints */ 275 #define MACH_SCHED_EDGE_CLUSTER_OVERLOAD 0x5 /* Cluster experienced overload; migrating threads to other clusters */ 276 #define MACH_SCHED_EDGE_STEAL 0x6 /* Per-cluster avg. thread execution time */ 277 #define MACH_SCHED_EDGE_REBAL_RUNNABLE 0x7 /* Rebalance runnable threads on a foreign cluster */ 278 #define MACH_SCHED_EDGE_REBAL_RUNNING 0x8 /* Rebalance running threads on a foreign cluster */ 279 #define MACH_SCHED_EDGE_SHOULD_YIELD 0x9 /* Edge decisions for thread yield */ 280 #define MACH_SCHED_CLUTCH_THR_COUNT 0xa /* Clutch scheduler runnable thread counts */ 281 #define MACH_SCHED_EDGE_LOAD_AVG 0xb /* Per-cluster load average */ 282 283 /* Codes for workgroup interval subsystem (DBG_MACH_WORKGROUP) */ 284 #define WORKGROUP_INTERVAL_CREATE 0x0 /* work interval creation */ 285 #define WORKGROUP_INTERVAL_DESTROY 0x1 /* work interval destruction */ 286 #define WORKGROUP_INTERVAL_CHANGE 0x2 /* thread work interval change */ 287 #define WORKGROUP_INTERVAL_START 0x3 /* work interval start call */ 288 #define WORKGROUP_INTERVAL_UPDATE 0x4 /* work interval update call */ 289 #define WORKGROUP_INTERVAL_FINISH 0x5 /* work interval finish call */ 290 291 /* Variants for MACH_MULTIQ_DEQUEUE */ 292 #define MACH_MULTIQ_BOUND 1 293 #define MACH_MULTIQ_GROUP 2 294 #define MACH_MULTIQ_GLOBAL 3 295 296 /* Arguments for vm_fault (DBG_MACH_VM) */ 297 #define DBG_ZERO_FILL_FAULT 1 298 #define DBG_PAGEIN_FAULT 2 299 #define DBG_COW_FAULT 3 300 #define DBG_CACHE_HIT_FAULT 4 301 #define DBG_NZF_PAGE_FAULT 5 302 #define DBG_GUARD_FAULT 6 303 #define DBG_PAGEINV_FAULT 7 304 #define DBG_PAGEIND_FAULT 8 305 #define DBG_COMPRESSOR_FAULT 9 306 #define DBG_COMPRESSOR_SWAPIN_FAULT 10 307 #define DBG_COR_FAULT 11 308 309 /* Codes for IPC (DBG_MACH_IPC) */ 310 #define MACH_TASK_SUSPEND 0x0 /* Suspended a task */ 311 #define MACH_TASK_RESUME 0x1 /* Resumed a task */ 312 #define MACH_THREAD_SET_VOUCHER 0x2 313 #define MACH_IPC_MSG_SEND 0x3 /* mach msg send, uniq msg info */ 314 #define MACH_IPC_MSG_RECV 0x4 /* mach_msg receive */ 315 #define MACH_IPC_MSG_RECV_VOUCHER_REFUSED 0x5 /* mach_msg receive, voucher refused */ 316 #define MACH_IPC_KMSG_FREE 0x6 /* kernel free of kmsg data */ 317 #define MACH_IPC_VOUCHER_CREATE 0x7 /* Voucher added to global voucher hashtable */ 318 #define MACH_IPC_VOUCHER_CREATE_ATTR_DATA 0x8 /* Attr data for newly created voucher */ 319 #define MACH_IPC_VOUCHER_DESTROY 0x9 /* Voucher removed from global voucher hashtable */ 320 #define MACH_IPC_KMSG_INFO 0xa /* Send/Receive info for a kmsg */ 321 #define MACH_IPC_KMSG_LINK 0xb /* link a kernel kmsg pointer to user mach_msg_header_t */ 322 #define MACH_IPC_PORT_ENTRY_MODIFY 0xc /* A port space gained or lost a port right (reference) */ 323 #define MACH_IPC_DESTROY_GUARDED_DESC 0xd /* Unable to receive a guarded descriptor */ 324 325 /* Codes for thread groups (DBG_MACH_THREAD_GROUP) */ 326 #define MACH_THREAD_GROUP_NEW 0x0 327 #define MACH_THREAD_GROUP_FREE 0x1 328 #define MACH_THREAD_GROUP_SET 0x2 329 #define MACH_THREAD_GROUP_NAME 0x3 330 #define MACH_THREAD_GROUP_NAME_FREE 0x4 331 #define MACH_THREAD_GROUP_FLAGS 0x5 332 #define MACH_THREAD_GROUP_BLOCK 0x6 333 334 /* Codes for coalitions (DBG_MACH_COALITION) */ 335 #define MACH_COALITION_NEW 0x0 336 #define MACH_COALITION_FREE 0x1 337 #define MACH_COALITION_ADOPT 0x2 338 #define MACH_COALITION_REMOVE 0x3 339 #define MACH_COALITION_THREAD_GROUP_SET 0x4 340 341 /* Codes for pmap (DBG_MACH_PMAP) */ 342 #define PMAP__CREATE 0x0 343 #define PMAP__DESTROY 0x1 344 #define PMAP__PROTECT 0x2 345 #define PMAP__PAGE_PROTECT 0x3 346 #define PMAP__ENTER 0x4 347 #define PMAP__REMOVE 0x5 348 #define PMAP__NEST 0x6 349 #define PMAP__UNNEST 0x7 350 #define PMAP__FLUSH_TLBS 0x8 351 #define PMAP__UPDATE_INTERRUPT 0x9 352 #define PMAP__ATTRIBUTE_CLEAR 0xa 353 #define PMAP__REUSABLE 0xb /* This appears to be unused */ 354 #define PMAP__QUERY_RESIDENT 0xc 355 #define PMAP__FLUSH_KERN_TLBS 0xd 356 #define PMAP__FLUSH_DELAYED_TLBS 0xe 357 #define PMAP__FLUSH_TLBS_TO 0xf 358 #define PMAP__FLUSH_EPT 0x10 359 #define PMAP__FAST_FAULT 0x11 360 #define PMAP__SWITCH 0x12 361 #define PMAP__TTE 0x13 362 #define PMAP__SWITCH_USER_TTB 0x14 363 #define PMAP__UPDATE_CACHING 0x15 364 #define PMAP__ATTRIBUTE_CLEAR_RANGE 0x16 365 #define PMAP__CLEAR_USER_TTB 0x17 366 #define PMAP__IOMMU_INIT 0x18 367 #define PMAP__IOMMU_IOVMALLOC 0x19 368 #define PMAP__IOMMU_IOVMFREE 0x1a 369 #define PMAP__IOMMU_MAP 0x1b 370 #define PMAP__IOMMU_UNMAP 0x1c 371 #define PMAP__IOMMU_IOCTL 0x1d 372 #define PMAP__IOMMU_GRANT_PAGE 0x1e 373 374 /* Codes for clock (DBG_MACH_CLOCK) */ 375 #define MACH_EPOCH_CHANGE 0x0 /* wake epoch change */ 376 #define MACH_BRIDGE_RCV_TS 0x1 /* receive timestamp pair from interrupt handler */ 377 #define MACH_BRIDGE_REMOTE_TIME 0x2 /* calculate remote timestamp */ 378 #define MACH_BRIDGE_RESET_TS 0x3 /* reset timestamp conversion parameters */ 379 #define MACH_BRIDGE_TS_PARAMS 0x4 /* recompute timestamp conversion parameters */ 380 #define MACH_BRIDGE_SKIP_TS 0x5 /* skip timestamp */ 381 #define MACH_BRIDGE_TS_MISMATCH 0x6 /* mismatch between predicted and received remote timestamp */ 382 #define MACH_BRIDGE_OBSV_RATE 0x7 /* out of range observed rates */ 383 384 /* Codes for Stackshot/Microstackshot (DBG_MACH_STACKSHOT) */ 385 #define MICROSTACKSHOT_RECORD 0x0 386 #define MICROSTACKSHOT_GATHER 0x1 387 388 /* Codes for sysdiagnose (DBG_MACH_SYSDIAGNOSE) */ 389 #define SYSDIAGNOSE_NOTIFY_USER 0x0 390 #define SYSDIAGNOSE_FULL 0x1 391 #define SYSDIAGNOSE_STACKSHOT 0x2 392 #define SYSDIAGNOSE_TAILSPIN 0x3 393 394 /* Codes for Selective Forced Idle (DBG_MACH_SFI) */ 395 #define SFI_SET_WINDOW 0x0 396 #define SFI_CANCEL_WINDOW 0x1 397 #define SFI_SET_CLASS_OFFTIME 0x2 398 #define SFI_CANCEL_CLASS_OFFTIME 0x3 399 #define SFI_THREAD_DEFER 0x4 400 #define SFI_OFF_TIMER 0x5 401 #define SFI_ON_TIMER 0x6 402 #define SFI_WAIT_CANCELED 0x7 403 #define SFI_PID_SET_MANAGED 0x8 404 #define SFI_PID_CLEAR_MANAGED 0x9 405 #define SFI_GLOBAL_DEFER 0xa 406 407 /* Codes for Zone Allocator (DBG_MACH_ZALLOC) */ 408 #define ZALLOC_ZCRAM 0x0 409 410 /* Codes for Mach resource management (DBG_MACH_RESOURCE) */ 411 /* _K32A/B codes start at double the low nibble */ 412 #define RMON_ENABLE_CPUUSAGE_MONITOR 0x001 413 #define RMON_CPUUSAGE_VIOLATED 0x002 414 #define RMON_CPUUSAGE_SUSPENDED 0x003 415 #define RMON_CPUUSAGE_VIOLATED_K32A 0x004 416 #define RMON_CPUUSAGE_VIOLATED_K32B 0x005 417 #define RMON_CPUUSAGE_RESUMED 0x006 418 #define RMON_DISABLE_CPUUSAGE_MONITOR 0x00f 419 420 #define RMON_ENABLE_CPUWAKES_MONITOR 0x011 421 #define RMON_CPUWAKES_VIOLATED 0x012 422 #define RMON_CPUWAKES_VIOLATED_K32A 0x014 423 #define RMON_CPUWAKES_VIOLATED_K32B 0x015 424 #define RMON_DISABLE_CPUWAKES_MONITOR 0x01f 425 426 #define RMON_ENABLE_IO_MONITOR 0x021 427 #define RMON_LOGWRITES_VIOLATED 0x022 428 #define RMON_PHYSWRITES_VIOLATED 0x023 429 #define RMON_LOGWRITES_VIOLATED_K32A 0x024 430 #define RMON_LOGWRITES_VIOLATED_K32B 0x025 431 #define RMON_DISABLE_IO_MONITOR 0x02f 432 433 /* Codes for Hypervisor (DBG_MACH_HV) */ 434 #define HV_GUEST_ENTER 0x000 435 #define HV_GUEST_ERROR 0x001 436 437 /* **** The Kernel Debug Sub Classes for Network (DBG_NETWORK) **** */ 438 #define DBG_NETIP 1 /* Internet Protocol */ 439 #define DBG_NETARP 2 /* Address Resolution Protocol */ 440 #define DBG_NETUDP 3 /* User Datagram Protocol */ 441 #define DBG_NETTCP 4 /* Transmission Control Protocol */ 442 #define DBG_NETICMP 5 /* Internet Control Message Protocol */ 443 #define DBG_NETIGMP 6 /* Internet Group Management Protocol */ 444 #define DBG_NETRIP 7 /* Routing Information Protocol */ 445 #define DBG_NETOSPF 8 /* Open Shortest Path First */ 446 #define DBG_NETISIS 9 /* Intermediate System to Intermediate System */ 447 #define DBG_NETSNMP 10 /* Simple Network Management Protocol */ 448 #define DBG_NETSOCK 11 /* Socket Layer */ 449 450 /* For Apple talk */ 451 #define DBG_NETAARP 100 /* Apple ARP */ 452 #define DBG_NETDDP 101 /* Datagram Delivery Protocol */ 453 #define DBG_NETNBP 102 /* Name Binding Protocol */ 454 #define DBG_NETZIP 103 /* Zone Information Protocol */ 455 #define DBG_NETADSP 104 /* Name Binding Protocol */ 456 #define DBG_NETATP 105 /* Apple Transaction Protocol */ 457 #define DBG_NETASP 106 /* Apple Session Protocol */ 458 #define DBG_NETAFP 107 /* Apple Filing Protocol */ 459 #define DBG_NETRTMP 108 /* Routing Table Maintenance Protocol */ 460 #define DBG_NETAURP 109 /* Apple Update Routing Protocol */ 461 462 #define DBG_NETIPSEC 128 /* IPsec Protocol */ 463 #define DBG_NETVMNET 129 /* VMNet */ 464 465 /* **** The Kernel Debug Sub Classes for IOKIT (DBG_IOKIT) **** */ 466 #define DBG_IOINTC 0 /* Interrupt controller */ 467 #define DBG_IOWORKLOOP 1 /* Work from work loop */ 468 #define DBG_IOINTES 2 /* Interrupt event source */ 469 #define DBG_IOCLKES 3 /* Clock event source */ 470 #define DBG_IOCMDQ 4 /* Command queue latencies */ 471 #define DBG_IOMCURS 5 /* Memory Cursor */ 472 #define DBG_IOMDESC 6 /* Memory Descriptors */ 473 #define DBG_IOPOWER 7 /* Power Managerment */ 474 #define DBG_IOSERVICE 8 /* Matching etc. */ 475 #define DBG_IOREGISTRY 9 /* Registry */ 476 477 /* **** 9-32 reserved for internal IOKit usage **** */ 478 479 #define DBG_IOSTORAGE 32 /* Storage layers */ 480 #define DBG_IONETWORK 33 /* Network layers */ 481 #define DBG_IOKEYBOARD 34 /* Keyboard */ 482 #define DBG_IOHID 35 /* HID Devices */ 483 #define DBG_IOAUDIO 36 /* Audio */ 484 #define DBG_IOSERIAL 37 /* Serial */ 485 #define DBG_IOTTY 38 /* TTY layers */ 486 #define DBG_IOSAM 39 /* SCSI Architecture Model layers */ 487 #define DBG_IOPARALLELATA 40 /* Parallel ATA */ 488 #define DBG_IOPARALLELSCSI 41 /* Parallel SCSI */ 489 #define DBG_IOSATA 42 /* Serial-ATA */ 490 #define DBG_IOSAS 43 /* SAS */ 491 #define DBG_IOFIBRECHANNEL 44 /* FiberChannel */ 492 #define DBG_IOUSB 45 /* USB */ 493 #define DBG_IOBLUETOOTH 46 /* Bluetooth */ 494 #define DBG_IOFIREWIRE 47 /* FireWire */ 495 #define DBG_IOINFINIBAND 48 /* Infiniband */ 496 #define DBG_IOCPUPM 49 /* CPU Power Management */ 497 #define DBG_IOGRAPHICS 50 /* Graphics */ 498 #define DBG_HIBERNATE 51 /* hibernation related events */ 499 #define DBG_IOTHUNDERBOLT 52 /* Thunderbolt */ 500 #define DBG_BOOTER 53 /* booter related events */ 501 #define DBG_IOAUDIO2 54 /* Audio (extended) */ 502 503 #define DBG_IOSURFACEPA 64 /* IOSurface page mappings */ 504 #define DBG_IOMDPA 65 /* IOMemoryDescriptor page mappings */ 505 #define DBG_IODARTPA 66 /* DART page mappings */ 506 /* **** 67-79 reserved for physical address mapping information **** */ 507 508 /* Backwards compatibility */ 509 #define DBG_IOPOINTING DBG_IOHID /* OBSOLETE: Use DBG_IOHID instead */ 510 #define DBG_IODISK DBG_IOSTORAGE /* OBSOLETE: Use DBG_IOSTORAGE instead */ 511 512 /* **** The Kernel Debug Sub Classes for Device Drivers (DBG_DRIVERS) **** */ 513 #define DBG_DRVSTORAGE 1 /* Storage layers */ 514 #define DBG_DRVNETWORK 2 /* Network layers */ 515 #define DBG_DRVKEYBOARD 3 /* Keyboard */ 516 #define DBG_DRVHID 4 /* HID Devices */ 517 #define DBG_DRVAUDIO 5 /* Audio */ 518 #define DBG_DRVSERIAL 7 /* Serial */ 519 #define DBG_DRVSAM 8 /* SCSI Architecture Model layers */ 520 #define DBG_DRVPARALLELATA 9 /* Parallel ATA */ 521 #define DBG_DRVPARALLELSCSI 10 /* Parallel SCSI */ 522 #define DBG_DRVSATA 11 /* Serial ATA */ 523 #define DBG_DRVSAS 12 /* SAS */ 524 #define DBG_DRVFIBRECHANNEL 13 /* FiberChannel */ 525 #define DBG_DRVUSB 14 /* USB */ 526 #define DBG_DRVBLUETOOTH 15 /* Bluetooth */ 527 #define DBG_DRVFIREWIRE 16 /* FireWire */ 528 #define DBG_DRVINFINIBAND 17 /* Infiniband */ 529 #define DBG_DRVGRAPHICS 18 /* Graphics */ 530 #define DBG_DRVSD 19 /* Secure Digital */ 531 #define DBG_DRVNAND 20 /* NAND drivers and layers */ 532 #define DBG_SSD 21 /* SSD */ 533 #define DBG_DRVSPI 22 /* SPI */ 534 #define DBG_DRVWLAN_802_11 23 /* WLAN 802.11 */ 535 #define DBG_DRVSSM 24 /* System State Manager(AppleSSM) */ 536 #define DBG_DRVSMC 25 /* System Management Controller */ 537 #define DBG_DRVMACEFIMANAGER 26 /* Mac EFI Manager */ 538 #define DBG_DRVANE 27 /* ANE */ 539 #define DBG_DRVETHERNET 28 /* Ethernet */ 540 #define DBG_DRVMCC 29 /* Memory Cache Controller */ 541 #define DBG_DRVACCESSORY 30 /* Accessories */ 542 543 /* Backwards compatibility */ 544 #define DBG_DRVPOINTING DBG_DRVHID /* OBSOLETE: Use DBG_DRVHID instead */ 545 #define DBG_DRVDISK DBG_DRVSTORAGE /* OBSOLETE: Use DBG_DRVSTORAGE instead */ 546 547 /* **** The Kernel Debug Sub Classes for the DLIL Layer (DBG_DLIL) **** */ 548 #define DBG_DLIL_STATIC 1 /* Static DLIL code */ 549 #define DBG_DLIL_PR_MOD 2 /* DLIL Protocol Module */ 550 #define DBG_DLIL_IF_MOD 3 /* DLIL Interface Module */ 551 #define DBG_DLIL_PR_FLT 4 /* DLIL Protocol Filter */ 552 #define DBG_DLIL_IF_FLT 5 /* DLIL Interface FIlter */ 553 554 /* The Kernel Debug Sub Classes for File System (DBG_FSYSTEM) */ 555 #define DBG_FSRW 0x1 /* reads and writes to the filesystem */ 556 #define DBG_DKRW 0x2 /* reads and writes to the disk */ 557 #define DBG_FSVN 0x3 /* vnode operations (inc. locking/unlocking) */ 558 #define DBG_FSLOOOKUP 0x4 /* namei and other lookup-related operations */ 559 #define DBG_JOURNAL 0x5 /* journaling operations */ 560 #define DBG_IOCTL 0x6 /* ioctl to the disk */ 561 #define DBG_BOOTCACHE 0x7 /* bootcache operations */ 562 #define DBG_HFS 0x8 /* HFS-specific events; see the hfs project */ 563 #define DBG_APFS 0x9 /* APFS-specific events; see the apfs project */ 564 #define DBG_SMB 0xA /* SMB-specific events; see the smb project */ 565 #define DBG_MOUNT 0xB /* Mounting/unmounting operations */ 566 #define DBG_EXFAT 0xE /* ExFAT-specific events; see the exfat project */ 567 #define DBG_MSDOS 0xF /* FAT-specific events; see the msdosfs project */ 568 #define DBG_ACFS 0x10 /* Xsan-specific events; see the XsanFS project */ 569 #define DBG_THROTTLE 0x11 /* I/O Throttling events */ 570 #define DBG_DECMP 0x12 /* Decmpfs-specific events */ 571 #define DBG_VFS 0x13 /* VFS layer events */ 572 #define DBG_LIVEFS 0x14 /* LiveFS events; see the UserFS project */ 573 #define DBG_CONTENT_PROT 0xCF /* Content Protection Events: see bsd/sys/cprotect.h */ 574 575 /* 576 * For Kernel Debug Sub Class DBG_HFS, state bits for hfs_update event 577 */ 578 #define DBG_HFS_UPDATE_ACCTIME 0x01 579 #define DBG_HFS_UPDATE_MODTIME 0x02 580 #define DBG_HFS_UPDATE_CHGTIME 0x04 581 #define DBG_HFS_UPDATE_MODIFIED 0x08 582 #define DBG_HFS_UPDATE_FORCE 0x10 583 #define DBG_HFS_UPDATE_DATEADDED 0x20 584 #define DBG_HFS_UPDATE_MINOR 0x40 585 #define DBG_HFS_UPDATE_SKIPPED 0x80 586 587 /* 588 * Codes for Kernel Debug Sub Class DBG_VFS 589 */ 590 #define DBG_VFS_IO_COMPRESSION_STATS 0x1000 591 592 /* The Kernel Debug Sub Classes for BSD */ 593 #define DBG_BSD_PROC 0x01 /* process/signals related */ 594 #define DBG_BSD_MEMSTAT 0x02 /* memorystatus / jetsam operations */ 595 #define DBG_BSD_KEVENT 0x03 /* kqueue / kevent related */ 596 #define DBG_BSD_EXCP_SC 0x0C /* System Calls */ 597 #define DBG_BSD_AIO 0x0D /* aio (POSIX async IO) */ 598 #define DBG_BSD_SC_EXTENDED_INFO 0x0E /* System Calls, extended info */ 599 #define DBG_BSD_SC_EXTENDED_INFO2 0x0F /* System Calls, extended info */ 600 #define DBG_BSD_KDEBUG_TEST 0xFF /* for testing kdebug */ 601 602 /* The Codes for BSD subcode class DBG_BSD_PROC */ 603 #define BSD_PROC_EXIT 1 /* process exit */ 604 #define BSD_PROC_FRCEXIT 2 /* Kernel force termination */ 605 #define BSD_PROC_EXEC 3 /* process spawn / exec */ 606 #define BSD_PROC_EXITREASON_CREATE 4 /* exit reason creation */ 607 #define BSD_PROC_EXITREASON_COMMIT 5 /* exit reason commited to a proc */ 608 609 /* Codes for BSD subcode class DBG_BSD_MEMSTAT */ 610 #define BSD_MEMSTAT_SCAN 1 /* memorystatus thread awake */ 611 #define BSD_MEMSTAT_JETSAM 2 /* LRU jetsam */ 612 #define BSD_MEMSTAT_JETSAM_HIWAT 3 /* highwater jetsam */ 613 #define BSD_MEMSTAT_FREEZE 4 /* freeze process */ 614 #define BSD_MEMSTAT_FREEZE_SCAN 5 /* select a process to freeze and freeze it */ 615 #define BSD_MEMSTAT_UPDATE 6 /* priority update */ 616 #define BSD_MEMSTAT_IDLE_DEMOTE 7 /* idle demotion fired */ 617 #define BSD_MEMSTAT_CLEAR_ERRORS 8 /* reset termination error state */ 618 #define BSD_MEMSTAT_DIRTY_TRACK 9 /* track the process state */ 619 #define BSD_MEMSTAT_DIRTY_SET 10 /* set the process state */ 620 #define BSD_MEMSTAT_DIRTY_CLEAR 11 /* clear the process state */ 621 #ifdef PRIVATE 622 #define BSD_MEMSTAT_GRP_SET_PROP 12 /* set group properties */ 623 #define BSD_MEMSTAT_DO_KILL 13 /* memorystatus kills */ 624 #define BSD_MEMSTAT_CHANGE_PRIORITY 14 /* priority changed */ 625 #endif /* PRIVATE */ 626 #define BSD_MEMSTAT_FAST_JETSAM 15 /* Aggressive jetsam ("clear-the-deck") */ 627 #define BSD_MEMSTAT_COMPACTOR_RUN 16 /* run VM compactor after process kill */ 628 #define BSD_MEMSTAT_FREEZE_DISABLE 17 /* disable freeze and kill frozen processes */ 629 #define BSD_MEMSTAT_RELAUNCH_FLAGS 18 /* flags representing jetsam behavior; based on launchd data */ 630 631 /* Codes for BSD subcode class DBG_BSD_KEVENT */ 632 #define BSD_KEVENT_KQ_PROCESS_BEGIN 1 633 #define BSD_KEVENT_KQ_PROCESS_END 2 634 #define BSD_KEVENT_KQWQ_PROCESS_BEGIN 3 635 #define BSD_KEVENT_KQWQ_PROCESS_END 4 636 #define BSD_KEVENT_KQWQ_BIND 5 637 #define BSD_KEVENT_KQWQ_UNBIND 6 638 #define BSD_KEVENT_KQWQ_THREQUEST 7 639 #define BSD_KEVENT_KQWL_PROCESS_BEGIN 8 640 #define BSD_KEVENT_KQWL_PROCESS_END 9 641 #define BSD_KEVENT_KQWL_THREQUEST 10 642 #define BSD_KEVENT_KQWL_THADJUST 11 643 #define BSD_KEVENT_KQ_REGISTER 12 644 #define BSD_KEVENT_KQWQ_REGISTER 13 645 #define BSD_KEVENT_KQWL_REGISTER 14 646 #define BSD_KEVENT_KNOTE_ACTIVATE 15 647 #define BSD_KEVENT_KQ_PROCESS 16 648 #define BSD_KEVENT_KQWQ_PROCESS 17 649 #define BSD_KEVENT_KQWL_PROCESS 18 650 #define BSD_KEVENT_KQWL_BIND 19 651 #define BSD_KEVENT_KQWL_UNBIND 20 652 #define BSD_KEVENT_KNOTE_ENABLE 21 653 #define BSD_KEVENT_KNOTE_VANISHED 22 654 655 /* The Kernel Debug Sub Classes for DBG_TRACE */ 656 #define DBG_TRACE_DATA 0 657 #define DBG_TRACE_STRING 1 658 #define DBG_TRACE_INFO 2 659 660 /* The Kernel Debug events: */ 661 #define TRACE_DATA_NEWTHREAD (TRACEDBG_CODE(DBG_TRACE_DATA, 1)) 662 #define TRACE_DATA_EXEC (TRACEDBG_CODE(DBG_TRACE_DATA, 2)) 663 #define TRACE_DATA_THREAD_TERMINATE (TRACEDBG_CODE(DBG_TRACE_DATA, 3)) 664 #define TRACE_DATA_THREAD_TERMINATE_PID (TRACEDBG_CODE(DBG_TRACE_DATA, 4)) 665 #define TRACE_STRING_GLOBAL (TRACEDBG_CODE(DBG_TRACE_STRING, 0)) 666 #define TRACE_STRING_NEWTHREAD (TRACEDBG_CODE(DBG_TRACE_STRING, 1)) 667 #define TRACE_STRING_EXEC (TRACEDBG_CODE(DBG_TRACE_STRING, 2)) 668 #define TRACE_STRING_PROC_EXIT (TRACEDBG_CODE(DBG_TRACE_STRING, 3)) 669 #define TRACE_STRING_THREADNAME (TRACEDBG_CODE(DBG_TRACE_STRING, 4)) 670 #define TRACE_STRING_THREADNAME_PREV (TRACEDBG_CODE(DBG_TRACE_STRING, 5)) 671 #define TRACE_PANIC (TRACEDBG_CODE(DBG_TRACE_INFO, 0)) 672 #define TRACE_TIMESTAMPS (TRACEDBG_CODE(DBG_TRACE_INFO, 1)) 673 #define TRACE_LOST_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 2)) 674 #define TRACE_WRITING_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 3)) 675 #define TRACE_INFO_STRING (TRACEDBG_CODE(DBG_TRACE_INFO, 4)) 676 #define TRACE_RETROGRADE_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 5)) 677 678 /* The Kernel Debug Sub Classes for DBG_CORESTORAGE */ 679 #define DBG_CS_IO 0 680 681 /* The Kernel Debug Sub Classes for DBG_SECURITY */ 682 #define DBG_SEC_KERNEL 0 /* raw entropy collected by the kernel */ 683 #define DBG_SEC_SANDBOX 1 684 685 /* Sub-class codes for CoreGraphics (DBG_CG) are defined in its component. */ 686 687 /* The Kernel Debug Sub Classes for DBG_MONOTONIC */ 688 #define DBG_MT_INSTRS_CYCLES 1 689 #define DBG_MT_DEBUG 2 690 #define DBG_MT_RESOURCES_PROC_EXIT 3 691 #define DBG_MT_RESOURCES_THR_EXIT 4 692 #define DBG_MT_TMPTH 0xfe 693 #define DBG_MT_TMPCPU 0xff 694 695 /* Kernel Debug events for the DBG_MT_RESOURCES_PROC_EXIT subclass */ 696 #define DBG_MT_INSTRS_CYCLES_PROC_EXIT MTDBG_RESOURCES_ON_PROC_EXIT(0) 697 698 /* Kernel Debug events for the DBG_MT_RESOURCES_THR_EXIT subclass */ 699 #define DBG_MT_INSTRS_CYCLES_THR_EXIT MTDBG_RESOURCES_ON_THR_EXIT(0) 700 701 /* The Kernel Debug Sub Classes for DBG_MISC */ 702 #define DBG_MISC_COREBRIGHTNESS 0x01 703 #define DBG_MISC_VIDEOENG 0x02 704 #define DBG_EVENT 0x10 705 #define DBG_MISC_INSTRUMENTS 0x11 706 #define DBG_MISC_INSTRUMENTSBT 0x12 707 #define DBG_MISC_LAYOUT 0x1a 708 #define DBG_BUFFER 0x20 709 710 /* The Kernel Debug Sub Classes for DBG_DYLD */ 711 #define DBG_DYLD_UUID (5) 712 713 /* Kernel Debug codes for the DBG_DYLD_UUID subclass */ 714 #define DBG_DYLD_UUID_MAP_A (0) 715 #define DBG_DYLD_UUID_MAP_B (1) 716 #define DBG_DYLD_UUID_MAP_32_A (2) 717 #define DBG_DYLD_UUID_MAP_32_B (3) 718 #define DBG_DYLD_UUID_MAP_32_C (4) 719 #define DBG_DYLD_UUID_UNMAP_A (5) 720 #define DBG_DYLD_UUID_UNMAP_B (6) 721 #define DBG_DYLD_UUID_UNMAP_32_A (7) 722 #define DBG_DYLD_UUID_UNMAP_32_B (8) 723 #define DBG_DYLD_UUID_UNMAP_32_C (9) 724 #define DBG_DYLD_UUID_SHARED_CACHE_A (10) 725 #define DBG_DYLD_UUID_SHARED_CACHE_B (11) 726 #define DBG_DYLD_UUID_SHARED_CACHE_32_A (12) 727 #define DBG_DYLD_UUID_SHARED_CACHE_32_B (13) 728 #define DBG_DYLD_UUID_SHARED_CACHE_32_C (14) 729 #define DBG_DYLD_AOT_UUID_MAP_A (15) 730 #define DBG_DYLD_AOT_UUID_MAP_B (16) 731 732 /* The Kernel Debug modifiers for the DBG_DKRW sub class */ 733 #define DKIO_DONE 0x01 734 #define DKIO_READ 0x02 735 #define DKIO_ASYNC 0x04 736 #define DKIO_META 0x08 737 #define DKIO_PAGING 0x10 738 #define DKIO_THROTTLE 0x20 /* Deprecated, still provided so fs_usage doesn't break */ 739 #define DKIO_PASSIVE 0x40 740 #define DKIO_NOCACHE 0x80 741 #define DKIO_TIER_MASK 0xF00 742 #define DKIO_TIER_SHIFT 8 743 #define DKIO_TIER_UPGRADE 0x1000 744 745 /* Kernel Debug Sub Classes for Applications (DBG_APPS) */ 746 #define DBG_APP_LOGINWINDOW 0x03 747 #define DBG_APP_AUDIO 0x04 748 #define DBG_APP_SYSTEMUI 0x05 749 #define DBG_APP_SIGNPOST 0x0A 750 #define DBG_APP_APPKIT 0x0C 751 #define DBG_APP_UIKIT 0x0D 752 #define DBG_APP_DFR 0x0E 753 #define DBG_APP_LAYOUT 0x0F 754 #define DBG_APP_COREDATA 0x10 755 #define DBG_APP_SAMBA 0x80 756 #define DBG_APP_EOSSUPPORT 0x81 757 #define DBG_APP_MACEFIMANAGER 0x82 758 759 /* Kernel Debug codes for Throttling (DBG_THROTTLE) */ 760 #define OPEN_THROTTLE_WINDOW 0x1 761 #define PROCESS_THROTTLED 0x2 762 #define IO_THROTTLE_DISABLE 0x3 763 #define IO_TIER_UPL_MISMATCH 0x4 764 765 /* Subclasses for MACH Importance Policies (DBG_IMPORTANCE) */ 766 /* TODO: Split up boost and task policy? */ 767 #define IMP_ASSERTION 0x10 /* Task takes/drops a boost assertion */ 768 #define IMP_BOOST 0x11 /* Task boost level changed */ 769 #define IMP_MSG 0x12 /* boosting message sent by donating task on donating port */ 770 #define IMP_WATCHPORT 0x13 /* port marked as watchport, and boost was transferred to the watched task */ 771 #define IMP_TASK_SUPPRESSION 0x17 /* Task changed suppression behaviors */ 772 #define IMP_TASK_APPTYPE 0x18 /* Task launched with apptype */ 773 #define IMP_UPDATE 0x19 /* Requested -> effective calculation */ 774 #define IMP_USYNCH_QOS_OVERRIDE 0x1A /* Userspace synchronization applied QoS override to resource owning thread */ 775 #define IMP_DONOR_CHANGE 0x1B /* The iit_donor bit changed */ 776 #define IMP_MAIN_THREAD_QOS 0x1C /* The task's main thread QoS was set */ 777 #define IMP_SYNC_IPC_QOS 0x1D /* Sync IPC QOS override */ 778 /* DBG_IMPORTANCE subclasses 0x20 - 0x3F are reserved for task policy flavors */ 779 780 /* thread and task attributes */ 781 #define IMP_TASK_POLICY_DARWIN_BG 0x21 782 #define IMP_TASK_POLICY_IOPOL 0x22 783 #define IMP_TASK_POLICY_IO 0x23 784 #define IMP_TASK_POLICY_PASSIVE_IO 0x24 785 786 /* task only attributes */ 787 #define IMP_TASK_POLICY_DARWIN_BG_IOPOL 0x27 788 /* unused, was IMP_TASK_POLICY_TAL 0x28 */ 789 #define IMP_TASK_POLICY_BOOST 0x29 790 #define IMP_TASK_POLICY_ROLE 0x2A 791 /* unused 0x2B */ 792 #define IMP_TASK_POLICY_TERMINATED 0x2C 793 #define IMP_TASK_POLICY_NEW_SOCKETS_BG 0x2D 794 #define IMP_TASK_POLICY_SUP_ACTIVE 0x2E 795 #define IMP_TASK_POLICY_LATENCY_QOS 0x2F 796 #define IMP_TASK_POLICY_THROUGH_QOS 0x30 797 #define IMP_TASK_POLICY_WATCHERS_BG 0x31 798 799 #define IMP_TASK_POLICY_SFI_MANAGED 0x34 800 #define IMP_TASK_POLICY_ALL_SOCKETS_BG 0x37 801 802 #define IMP_TASK_POLICY_BASE_LATENCY_AND_THROUGHPUT_QOS 0x39 /* latency as value1, throughput as value2 */ 803 #define IMP_TASK_POLICY_OVERRIDE_LATENCY_AND_THROUGHPUT_QOS 0x3A /* latency as value1, throughput as value2 */ 804 805 /* thread only attributes */ 806 #define IMP_TASK_POLICY_PIDBIND_BG 0x32 807 /* unused 0x33 */ 808 /* reserved 0x35 */ 809 #define IMP_TASK_POLICY_QOS_OVERRIDE 0x36 810 #define IMP_TASK_POLICY_QOS_AND_RELPRIO 0x38 /* QoS as value1, relative priority as value2 */ 811 #define IMP_TASK_POLICY_QOS_WORKQ_OVERRIDE 0x3B 812 #define IMP_TASK_POLICY_QOS_PROMOTE 0x3C 813 #define IMP_TASK_POLICY_QOS_KEVENT_OVERRIDE 0x3D 814 #define IMP_TASK_POLICY_QOS_IPC_OVERRIDE IMP_TASK_POLICY_QOS_KEVENT_OVERRIDE /* legacy name */ 815 #define IMP_TASK_POLICY_QOS_SERVICER_OVERRIDE 0x3E 816 817 /* Codes for IMP_ASSERTION */ 818 #define IMP_HOLD 0x2 /* Task holds a boost assertion */ 819 #define IMP_DROP 0x4 /* Task drops a boost assertion */ 820 #define IMP_EXTERN 0x8 /* boost assertion moved from kernel to userspace responsibility (externalized) */ 821 822 /* Codes for IMP_BOOST */ 823 #define IMP_BOOSTED 0x1 824 #define IMP_UNBOOSTED 0x2 /* Task drops a boost assertion */ 825 826 /* Codes for IMP_MSG */ 827 #define IMP_MSG_SEND 0x1 /* boosting message sent by donating task on donating port */ 828 #define IMP_MSG_DELV 0x2 /* boosting message delivered to task */ 829 830 /* Codes for IMP_UPDATE */ 831 #define IMP_UPDATE_TASK_CREATE 0x1 832 833 /* Codes for IMP_USYNCH_QOS_OVERRIDE */ 834 #define IMP_USYNCH_ADD_OVERRIDE 0x0 /* add override for a contended resource */ 835 #define IMP_USYNCH_REMOVE_OVERRIDE 0x1 /* remove override for a contended resource */ 836 837 /* Codes for IMP_DONOR_CHANGE */ 838 #define IMP_DONOR_UPDATE_LIVE_DONOR_STATE 0x0 839 #define IMP_DONOR_INIT_DONOR_STATE 0x1 840 841 /* Code for IMP_SYNC_IPC_QOS */ 842 #define IMP_SYNC_IPC_QOS_APPLIED 0x0 843 #define IMP_SYNC_IPC_QOS_REMOVED 0x1 844 #define IMP_SYNC_IPC_QOS_OVERFLOW 0x2 845 #define IMP_SYNC_IPC_QOS_UNDERFLOW 0x3 846 847 /* Subclasses for Turnstiles (DBG_TURNSTILE) */ 848 #define TURNSTILE_HEAP_OPERATIONS 0x10 849 #define TURNSTILE_PRIORITY_OPERATIONS 0x20 850 #define TURNSTILE_FREELIST_OPERATIONS 0x30 851 852 /* Codes for TURNSTILE_HEAP_OPERATIONS */ 853 #define THREAD_ADDED_TO_TURNSTILE_WAITQ 0x1 854 #define THREAD_REMOVED_FROM_TURNSTILE_WAITQ 0x2 855 #define THREAD_MOVED_IN_TURNSTILE_WAITQ 0x3 856 #define TURNSTILE_ADDED_TO_TURNSTILE_HEAP 0x4 857 #define TURNSTILE_REMOVED_FROM_TURNSTILE_HEAP 0x5 858 #define TURNSTILE_MOVED_IN_TURNSTILE_HEAP 0x6 859 #define TURNSTILE_ADDED_TO_THREAD_HEAP 0x7 860 #define TURNSTILE_REMOVED_FROM_THREAD_HEAP 0x8 861 #define TURNSTILE_MOVED_IN_THREAD_HEAP 0x9 862 #define TURNSTILE_UPDATE_STOPPED_BY_LIMIT 0xa 863 #define THREAD_NOT_WAITING_ON_TURNSTILE 0xb 864 865 /* Codes for TURNSTILE_PRIORITY_OPERATIONS */ 866 #define TURNSTILE_PRIORITY_CHANGE 0x1 867 #define THREAD_USER_PROMOTION_CHANGE 0x2 868 869 /* Codes for TURNSTILE_FREELIST_OPERATIONS */ 870 #define TURNSTILE_PREPARE 0x1 871 #define TURNSTILE_COMPLETE 0x2 872 873 /* Subclasses for MACH Bank Voucher Attribute Manager (DBG_BANK) */ 874 #define BANK_ACCOUNT_INFO 0x10 /* Trace points related to bank account struct */ 875 #define BANK_TASK_INFO 0x11 /* Trace points related to bank task struct */ 876 877 /* Subclasses for MACH ATM Voucher Attribute Manager (ATM) */ 878 #define ATM_SUBAID_INFO 0x10 879 #define ATM_GETVALUE_INFO 0x20 880 #define ATM_UNREGISTER_INFO 0x30 881 882 /* Codes for BANK_ACCOUNT_INFO */ 883 #define BANK_SETTLE_CPU_TIME 0x1 /* Bank ledger(chit) rolled up to tasks. */ 884 #define BANK_SECURE_ORIGINATOR_CHANGED 0x2 /* Secure Originator changed. */ 885 #define BANK_SETTLE_ENERGY 0x3 /* Bank ledger(energy field) rolled up to tasks. */ 886 887 /* Codes for ATM_SUBAID_INFO */ 888 #define ATM_MIN_CALLED 0x1 889 #define ATM_LINK_LIST_TRIM 0x2 890 891 /* Codes for ATM_GETVALUE_INFO */ 892 #define ATM_VALUE_REPLACED 0x1 893 #define ATM_VALUE_ADDED 0x2 894 895 /* Codes for ATM_UNREGISTER_INFO */ 896 #define ATM_VALUE_UNREGISTERED 0x1 897 #define ATM_VALUE_DIFF_MAILBOX 0x2 898 899 /* Kernel Debug Sub Classes for daemons (DBG_DAEMON) */ 900 #define DBG_DAEMON_COREDUET 0x1 901 #define DBG_DAEMON_POWERD 0x2 902 903 /* Subclasses for the user space allocator */ 904 #define DBG_UMALLOC_EXTERNAL 0x1 905 #define DBG_UMALLOC_INTERNAL 0x2 906 907 /**********************************************************************/ 908 909 #define KDBG_MIGCODE(msgid) (((unsigned)DBG_MIG << KDBG_CLASS_OFFSET) | \ 910 ((unsigned)((msgid) & 0x3fffff) << KDBG_CODE_OFFSET)) 911 912 #define MACHDBG_CODE(SubClass, code) KDBG_CODE(DBG_MACH, SubClass, code) 913 #define NETDBG_CODE(SubClass, code) KDBG_CODE(DBG_NETWORK, SubClass, code) 914 #define FSDBG_CODE(SubClass, code) KDBG_CODE(DBG_FSYSTEM, SubClass, code) 915 #define BSDDBG_CODE(SubClass, code) KDBG_CODE(DBG_BSD, SubClass, code) 916 #define IOKDBG_CODE(SubClass, code) KDBG_CODE(DBG_IOKIT, SubClass, code) 917 #define DRVDBG_CODE(SubClass, code) KDBG_CODE(DBG_DRIVERS, SubClass, code) 918 #define TRACEDBG_CODE(SubClass, code) KDBG_CODE(DBG_TRACE, SubClass, code) 919 #define SILICONDBG_CODE(SubClass, code) KDBG_CODE(DBG_SILICON, SubClass, code) 920 #define MISCDBG_CODE(SubClass, code) KDBG_CODE(DBG_MISC, SubClass, code) 921 #define DLILDBG_CODE(SubClass, code) KDBG_CODE(DBG_DLIL, SubClass, code) 922 #define SECURITYDBG_CODE(SubClass, code) KDBG_CODE(DBG_SECURITY, SubClass, code) 923 #define DYLDDBG_CODE(SubClass, code) KDBG_CODE(DBG_DYLD, SubClass, code) 924 #define QTDBG_CODE(SubClass, code) KDBG_CODE(DBG_QT, SubClass, code) 925 #define APPSDBG_CODE(SubClass, code) KDBG_CODE(DBG_APPS, SubClass, code) 926 #define ARIADNEDBG_CODE(SubClass, code) KDBG_CODE(DBG_ARIADNE, SubClass, code) 927 #define DAEMONDBG_CODE(SubClass, code) KDBG_CODE(DBG_DAEMON, SubClass, code) 928 #define CPUPM_CODE(code) IOKDBG_CODE(DBG_IOCPUPM, code) 929 #define MTDBG_CODE(SubClass, code) KDBG_CODE(DBG_MONOTONIC, SubClass, code) 930 #define MTDBG_RESOURCES_ON_PROC_EXIT(code) MTDBG_CODE(DBG_MT_RESOURCES_PROC_EXIT, code) 931 #define MTDBG_RESOURCES_ON_THR_EXIT(code) MTDBG_CODE(DBG_MT_RESOURCES_THR_EXIT, code) 932 933 #define KMEM_ALLOC_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 0) 934 #define KMEM_ALLOC_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 1) 935 #define KMEM_FREE_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 2) 936 #define KMEM_FREE_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 3) 937 #define ZALLOC_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 4) 938 #define ZALLOC_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 5) 939 #define ZFREE_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 6) 940 #define ZFREE_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 7) 941 942 #define PMAP_CODE(code) MACHDBG_CODE(DBG_MACH_PMAP, code) 943 944 #define IMPORTANCE_CODE(SubClass, code) KDBG_CODE(DBG_IMPORTANCE, (SubClass), (code)) 945 #define BANK_CODE(SubClass, code) KDBG_CODE(DBG_BANK, (SubClass), (code)) 946 #define ATM_CODE(SubClass, code) KDBG_CODE(DBG_ATM, (SubClass), (code)) 947 #define TURNSTILE_CODE(SubClass, code) KDBG_CODE(DBG_TURNSTILE, (SubClass), (code)) 948 949 /* Kernel Debug Macros for specific daemons */ 950 #define COREDUETDBG_CODE(code) DAEMONDBG_CODE(DBG_DAEMON_COREDUET, code) 951 #define POWERDDBG_CODE(code) DAEMONDBG_CODE(DBG_DAEMON_POWERD, code) 952 953 /* VFS lookup events for serial traces */ 954 #define VFS_LOOKUP (FSDBG_CODE(DBG_FSRW,36)) 955 #define VFS_LOOKUP_DONE (FSDBG_CODE(DBG_FSRW,39)) 956 957 #endif /* __APPLE_API_UNSTABLE */ 958 959 __END_DECLS 960 961 #if defined(__has_include) && __has_include(<sys/kdebug_private.h>) 962 #include <sys/kdebug_private.h> 963 #endif /* __has_include(<sys/kdebug_private.h>) */ 964 965 #ifdef KERNEL 966 #include <sys/kdebug_kernel.h> 967 #endif /* defined(KERNEL) */ 968 969 #endif /* !defined(BSD_SYS_KDEBUG_H) */