1 // Copyright (c) 2000-2021 Apple Inc. All rights reserved. 2 // 3 // @APPLE_OSREFERENCE_LICENSE_HEADER_START@ 4 // 5 // This file contains Original Code and/or Modifications of Original Code 6 // as defined in and that are subject to the Apple Public Source License 7 // Version 2.0 (the 'License'). You may not use this file except in 8 // compliance with the License. The rights granted to you under the License 9 // may not be used to create, or enable the creation or redistribution of, 10 // unlawful or unlicensed copies of an Apple operating system, or to 11 // circumvent, violate, or enable the circumvention or violation of, any 12 // terms of an Apple operating system software license agreement. 13 // 14 // Please obtain a copy of the License at 15 // http://www.opensource.apple.com/apsl/ and read it before using this file. 16 // 17 // The Original Code and all software distributed under the License are 18 // distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 19 // EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 20 // INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 21 // FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 22 // Please see the License for the specific language governing rights and 23 // limitations under the License. 24 // 25 // @APPLE_OSREFERENCE_LICENSE_HEADER_END@ 26 27 #ifndef BSD_SYS_KDEBUG_H 28 #define BSD_SYS_KDEBUG_H 29 30 #include <sys/appleapiopts.h> 31 #include <sys/cdefs.h> 32 33 __BEGIN_DECLS 34 35 #ifdef __APPLE_API_UNSTABLE 36 37 // kdebug records events occurring in the system. For user space, it has been 38 // replaced by the `os_signpost` interfaces in `<os/signpost.h>`. 39 // 40 // This header reserves "debug IDs", 32-bit values that classify events recorded 41 // by kdebug: 42 // 43 // class subclass code function 44 // ╭──────┬───────┬─────────────┬─╮ 45 // │ 8 │ 8 │ 14 │2│ 46 // ╰──────┴───────┴─────────────┴─╯ 47 // ╰──────────────╯ │ 48 // class-subclass 00│ 49 // ╰──────────────────────────────╯ 50 // │ event ID │ 51 // ╰──────────────────────────────╯ 52 // debug ID 53 // 54 // The event ID is a hierarchical ID, indicating which components an event is 55 // referring to. The debug ID includes an event ID and sets the function 56 // qualifier bits, to determine the structural significance of an event (whether 57 // it starts or ends an interval). 58 59 #pragma mark - Debug ID encoding/decoding 60 61 #define KDBG_CLASS_MASK (0xff000000) 62 #define KDBG_CLASS_OFFSET (24) 63 #define KDBG_CLASS_MAX (0xff) 64 #define KDBG_SUBCLASS_MASK (0x00ff0000) 65 #define KDBG_SUBCLASS_OFFSET (16) 66 #define KDBG_SUBCLASS_MAX (0xff) 67 #define KDBG_CSC_MASK (0xffff0000) 68 #define KDBG_CSC_OFFSET (KDBG_SUBCLASS_OFFSET) 69 #define KDBG_CSC_MAX (0xffff) 70 #define KDBG_CODE_MASK (0x0000fffc) 71 #define KDBG_CODE_OFFSET (2) 72 #define KDBG_CODE_MAX (0x3fff) 73 #define KDBG_EVENTID_MASK (0xfffffffc) 74 #define KDBG_FUNC_MASK (0x00000003) 75 76 // Generate an eventid corresponding to Class, SubClass, and Code. 77 #define KDBG_EVENTID(Class, SubClass, Code) \ 78 (((unsigned)((Class) & 0xff) << KDBG_CLASS_OFFSET) | \ 79 ((unsigned)((SubClass) & 0xff) << KDBG_SUBCLASS_OFFSET) | \ 80 ((unsigned)((Code) & 0x3fff) << KDBG_CODE_OFFSET)) 81 82 // Extract pieces of a debug ID. 83 #define KDBG_EXTRACT_CLASS(Debugid) \ 84 ((uint8_t)(((Debugid) & KDBG_CLASS_MASK) >> KDBG_CLASS_OFFSET)) 85 #define KDBG_EXTRACT_SUBCLASS(Debugid) \ 86 ((uint8_t)(((Debugid) & KDBG_SUBCLASS_MASK) >> KDBG_SUBCLASS_OFFSET)) 87 #define KDBG_EXTRACT_CSC(Debugid) \ 88 ((uint16_t)(((Debugid) & KDBG_CSC_MASK) >> KDBG_CSC_OFFSET)) 89 #define KDBG_EXTRACT_CODE(Debugid) \ 90 ((uint16_t)(((Debugid) & KDBG_CODE_MASK) >> KDBG_CODE_OFFSET)) 91 #define KDBG_CLASS_ENCODE(Class, SubClass) KDBG_EVENTID(Class, SubClass, 0) 92 #define KDBG_CLASS_DECODE(Debugid) (Debugid & KDBG_CSC_MASK) 93 94 // Function qualifiers for debug IDs. 95 #define DBG_FUNC_START 1U 96 #define DBG_FUNC_END 2U 97 #define DBG_FUNC_NONE 0U 98 99 #pragma mark - Class and subclass definitions 100 101 102 #define DBG_MACH 1 103 #define DBG_NETWORK 2 104 #define DBG_FSYSTEM 3 105 #define DBG_BSD 4 106 #define DBG_IOKIT 5 107 #define DBG_DRIVERS 6 108 #define DBG_TRACE 7 109 #define DBG_DLIL 8 110 #define DBG_PTHREAD 9 111 #define DBG_CORESTORAGE 10 112 #define DBG_CG 11 113 #define DBG_MONOTONIC 12 114 #define DBG_MISC 20 115 #define DBG_SECURITY 30 116 #define DBG_DYLD 31 117 #define DBG_QT 32 118 #define DBG_APPS 33 119 #define DBG_LAUNCHD 34 120 #define DBG_SILICON 35 121 #define DBG_PERF 37 122 #define DBG_IMPORTANCE 38 123 #define DBG_BANK 40 124 #define DBG_XPC 41 125 #define DBG_ATM 42 126 #define DBG_ARIADNE 43 127 #define DBG_DAEMON 44 128 #define DBG_ENERGYTRACE 45 129 #define DBG_DISPATCH 46 130 #define DBG_IMG 49 131 #define DBG_UMALLOC 51 132 #define DBG_TURNSTILE 53 133 #define DBG_AUDIO 54 134 135 #define DBG_MIG 255 136 137 #pragma mark DBG_MACH subclasses 138 139 #define DBG_MACH_EXCP_KTRAP_x86 0x02 // Kernel Traps on x86 140 #define DBG_MACH_EXCP_DFLT 0x03 // deprecated name 141 #define DBG_MACH_EXCP_SYNC_ARM 0x03 // arm/arm64 synchronous exception 142 #define DBG_MACH_EXCP_IFLT 0x04 // deprecated name 143 #define DBG_MACH_EXCP_SERR_ARM 0x04 // arm/arm64 SError (async) exception 144 #define DBG_MACH_EXCP_INTR 0x05 // Interrupts 145 #define DBG_MACH_EXCP_ALNG 0x06 // Alignment Exception 146 #define DBG_MACH_EXCP_UTRAP_x86 0x07 // User Traps on x86 147 #define DBG_MACH_EXCP_FP 0x08 // FP Unavail 148 #define DBG_MACH_EXCP_DECI 0x09 // Decrementer Interrupt 149 #define DBG_MACH_CHUD 0x0A // deprecated name 150 #define DBG_MACH_SIGNPOST 0x0A // kernel signposts 151 #define DBG_MACH_EXCP_SC 0x0C // System Calls 152 #define DBG_MACH_EXCP_TRACE 0x0D // Trace exception 153 #define DBG_MACH_EXCP_EMUL 0x0E // Instruction emulated 154 #define DBG_MACH_IHDLR 0x10 // Interrupt Handlers 155 #define DBG_MACH_IPC 0x20 // Inter Process Comm 156 #define DBG_MACH_SUSPENSION 0x21 // Task/thread suspend and resume 157 #define DBG_MACH_RESOURCE 0x25 // tracing limits, etc 158 #define DBG_MACH_EXCLAVES 0x2A // Exclaves 159 #define DBG_MACH_EXCLAVES_SCHEDULER 0x2B // Exclaves Scheduler 160 #define DBG_MACH_EPOCH_SYNC 0x2C // Epoch Sync 161 #define DBG_MACH_VM 0x30 // Virtual Memory 162 #define DBG_MACH_LEAKS 0x31 // alloc/free 163 #define DBG_MACH_WORKINGSET 0x32 // private subclass for working set related debugging 164 #define DBG_MACH_SCHED 0x40 // Scheduler 165 #define DBG_MACH_MSGID_INVALID 0x50 // Messages - invalid 166 #define DBG_MACH_LOCKS 0x60 // new lock APIs 167 #define DBG_MACH_PMAP 0x70 // pmap 168 #define DBG_MACH_CLOCK 0x80 // clock 169 #define DBG_MACH_MP 0x90 // MP related 170 #define DBG_MACH_VM_PRESSURE 0xA0 // Memory Pressure Events 171 #define DBG_MACH_STACKSHOT 0xA1 // Stackshot/Microstackshot subsystem 172 #define DBG_MACH_SFI 0xA2 // Selective Forced Idle (SFI) 173 #define DBG_MACH_ENERGY_PERF 0xA3 // Energy/performance resource stats 174 #define DBG_MACH_SYSDIAGNOSE 0xA4 // sysdiagnose 175 #define DBG_MACH_ZALLOC 0xA5 // Zone allocator 176 #define DBG_MACH_THREAD_GROUP 0xA6 // Thread groups 177 #define DBG_MACH_COALITION 0xA7 // Coalitions 178 #define DBG_MACH_SHAREDREGION 0xA8 // Shared region 179 #define DBG_MACH_SCHED_CLUTCH 0xA9 // Clutch scheduler 180 #define DBG_MACH_IO 0xAA // I/O 181 #define DBG_MACH_WORKGROUP 0xAB // Workgroup subsystem 182 #define DBG_MACH_HV 0xAC // Hypervisor subsystem 183 #define DBG_MACH_KCOV 0xAD // Kernel coverage sanitizer 184 #define DBG_MACH_MACHDEP_EXCP_SC_x86 0xAE // Machine Dependent System Calls on x86 185 #define DBG_MACH_MACHDEP_EXCP_SC_ARM 0xAF // Machine Dependent System Calls on arm 186 #define DBG_MACH_VM_RECLAIM 0xB0 // Deferred Memory Reclamation 187 #define DBG_MACH_VM_LOCK_PERF 0xB1 // Performance of VM Locks 188 #define DBG_MACH_MEMINFO 0xB2 // General system memory information 189 #define DBG_MACH_VM_COMPRESSOR 0xB3 // Mach VM Compressor 190 191 // Codes for DBG_MACH_IO 192 #define DBC_MACH_IO_MMIO_READ 0x1 193 #define DBC_MACH_IO_MMIO_WRITE 0x2 194 #define DBC_MACH_IO_PHYS_READ 0x3 195 #define DBC_MACH_IO_PHYS_WRITE 0x4 196 #define DBC_MACH_IO_PORTIO_READ 0x5 197 #define DBC_MACH_IO_PORTIO_WRITE 0x6 198 199 /* Interrupt type bits for DBG_MACH_EXCP_INTR */ 200 #define DBG_INTR_TYPE_UNKNOWN 0x0 /* default/unknown interrupt */ 201 #define DBG_INTR_TYPE_IPI 0x1 /* interprocessor interrupt */ 202 #define DBG_INTR_TYPE_TIMER 0x2 /* timer interrupt */ 203 #define DBG_INTR_TYPE_OTHER 0x3 /* other (usually external) interrupt */ 204 #define DBG_INTR_TYPE_PMI 0x4 /* performance monitor interrupt */ 205 #define DBG_INTR_TYPE_RSVD1 0x5 /* reserved interrupt kind */ 206 207 /* Codes for Scheduler (DBG_MACH_SCHED) */ 208 #define MACH_SCHED 0x0 /* Scheduler */ 209 #define MACH_STACK_ATTACH 0x1 /* stack_attach() */ 210 #define MACH_STACK_HANDOFF 0x2 /* stack_handoff() */ 211 #define MACH_CALL_CONT 0x3 /* call_continuation() */ 212 #define MACH_CALLOUT 0x4 /* callouts */ 213 #define MACH_STACK_DETACH 0x5 214 #define MACH_MAKE_RUNNABLE 0x6 /* make thread runnable */ 215 #define MACH_PROMOTE 0x7 /* promoted due to resource (replaced by MACH_PROMOTED) */ 216 #define MACH_DEMOTE 0x8 /* promotion undone (replaced by MACH_UNPROMOTED) */ 217 #define MACH_IDLE 0x9 /* processor idling */ 218 #define MACH_STACK_DEPTH 0xa /* stack depth at switch */ 219 #define MACH_MOVED 0xb /* did not use original scheduling decision */ 220 #define MACH_PSET_LOAD_AVERAGE 0xc 221 #define MACH_AMP_DEBUG 0xd 222 #define MACH_FAILSAFE 0xe /* tripped fixed-pri/RT failsafe */ 223 #define MACH_BLOCK 0xf /* thread block */ 224 #define MACH_WAIT 0x10 /* thread wait assertion */ 225 #define MACH_GET_URGENCY 0x14 /* Urgency queried by platform */ 226 #define MACH_URGENCY 0x15 /* Urgency (RT/BG/NORMAL) communicated 227 * to platform 228 */ 229 #define MACH_REDISPATCH 0x16 /* "next thread" thread redispatched */ 230 #define MACH_REMOTE_AST 0x17 /* AST signal issued to remote processor */ 231 #define MACH_SCHED_CHOOSE_PROCESSOR 0x18 /* Result of choose_processor */ 232 #define MACH_DEEP_IDLE 0x19 /* deep idle on master processor */ 233 /* unused 0x1a was MACH_SCHED_DECAY_PRIORITY */ 234 #define MACH_CPU_THROTTLE_DISABLE 0x1b /* Global CPU Throttle Disable */ 235 #define MACH_RW_PROMOTE 0x1c /* promoted due to RW lock promotion */ 236 #define MACH_RW_DEMOTE 0x1d /* promotion due to RW lock undone */ 237 #define MACH_SCHED_MAINTENANCE 0x1f /* periodic maintenance thread */ 238 #define MACH_DISPATCH 0x20 /* context switch completed */ 239 #define MACH_QUANTUM_HANDOFF 0x21 /* quantum handoff occurred */ 240 /* unused MACH_MULTIQ_DEQUEUE 0x22 was: Result of multiq dequeue */ 241 #define MACH_SCHED_THREAD_SWITCH 0x23 /* attempt direct context switch to hinted thread */ 242 #define MACH_SCHED_SMT_BALANCE 0x24 /* SMT load balancing ASTs */ 243 #define MACH_REMOTE_DEFERRED_AST 0x25 /* Deferred AST started against remote processor */ 244 #define MACH_REMOTE_CANCEL_AST 0x26 /* Canceled deferred AST for remote processor */ 245 #define MACH_SCHED_CHANGE_PRIORITY 0x27 /* thread sched priority changed */ 246 #define MACH_SCHED_UPDATE_REC_CORES 0x28 /* Change to recommended processor bitmask */ 247 #define MACH_STACK_WAIT 0x29 /* Thread could not be switched-to because of kernel stack shortage */ 248 #define MACH_THREAD_BIND 0x2a /* Thread was bound (or unbound) to a processor */ 249 #define MACH_WAITQ_PROMOTE 0x2b /* Thread promoted by waitq boost */ 250 #define MACH_WAITQ_DEMOTE 0x2c /* Thread demoted from waitq boost */ 251 #define MACH_SCHED_LOAD 0x2d /* load update */ 252 #define MACH_REC_CORES_FAILSAFE 0x2e /* recommended processor failsafe kicked in */ 253 #define MACH_SCHED_QUANTUM_EXPIRED 0x2f /* thread quantum expired */ 254 #define MACH_EXEC_PROMOTE 0x30 /* Thread promoted by exec boost */ 255 #define MACH_EXEC_DEMOTE 0x31 /* Thread demoted from exec boost */ 256 #define MACH_AMP_SIGNAL_SPILL 0x32 /* AMP spill signal sent to cpuid */ 257 #define MACH_AMP_STEAL 0x33 /* AMP thread stolen or spilled */ 258 #define MACH_SCHED_LOAD_EFFECTIVE 0x34 /* Effective scheduler load */ 259 /* unused MACH_PROMOTED 0x35 was: thread promoted due to mutex priority promotion */ 260 /* unused MACH_UNPROMOTED 0x36 was: thread unpromoted due to mutex priority promotion */ 261 /* unused MACH_PROMOTED_UPDATE 0x37 was: thread already promoted, but promotion priority changed */ 262 #define MACH_QUIESCENT_COUNTER 0x38 /* quiescent counter tick */ 263 #define MACH_TURNSTILE_USER_CHANGE 0x39 /* base priority change because of turnstile */ 264 #define MACH_AMP_RECOMMENDATION_CHANGE 0x3a /* Thread group recommendation change */ 265 #define MACH_AMP_PERFCTL_POLICY_CHANGE 0x3b /* AMP policy for perfctl cluster recommendation */ 266 #define MACH_TURNSTILE_KERNEL_CHANGE 0x40 /* sched priority change because of turnstile */ 267 #define MACH_SCHED_WI_AUTO_JOIN 0x41 /* work interval auto join events */ 268 #define MACH_SCHED_WI_DEFERRED_FINISH 0x42 /* work interval pending finish events for auto-join thread groups */ 269 #define MACH_SET_RT_DEADLINE 0x43 /* set thread->realtime.deadline */ 270 #define MACH_CANCEL_RT_DEADLINE 0x44 /* cancel thread->realtime.deadline */ 271 #define MACH_RT_SIGNAL_SPILL 0x45 /* RT spill signal sent to cpuid */ 272 #define MACH_RT_STEAL 0x46 /* RT thread stolen or spilled */ 273 #define MACH_PENDING_AST_URGENT 0x47 /* CPU pending_AST_URGENT set/cleared */ 274 #define MACH_SCHED_THREAD_SELECT 0x48 /* Result of thread_select */ 275 #define MACH_SCHED_NEXT_PROCESSOR 0x49 /* Result of choose_next_rt_processor_for_IPI */ 276 #define MACH_PSET_AVG_EXEC_TIME 0x50 277 #define MACH_SUSPEND_USERSPACE 0x51 /* userspace threads are suspended */ 278 #define MACH_PREEMPTION_EXPIRED 0x52 /* preemption disable threshold crossed */ 279 #define MACH_FLOOR_PROMOTE 0x53 /* promoted upon request */ 280 #define MACH_FLOOR_DEMOTE 0x54 /* unpromoted upon request */ 281 #define MACH_INT_MASKED_EXPIRED 0x55 /* interrupt masked threshold crossed */ 282 #define MACH_INT_HANDLED_EXPIRED 0x56 /* interrupt handling threshold crossed */ 283 /* unused MACH_RT_RESTRICT_DENIED 0x57 was: Denied a thread becoming realtime (with -time-constraint-policy-restrict boot-arg)*/ 284 #define MACH_UPDATE_POWERED_CORES 0x58 /* CLPC requested cores powerup/powerdown */ 285 #define MACH_MODE_DEMOTE_THROTTLED 0x59 /* Sched mode demotion - throttled */ 286 #define MACH_MODE_DEMOTE_FAILSAFE 0x5a /* Sched mode demotion - failsafe */ 287 #define MACH_MODE_DEMOTE_RT_DISALLOWED 0x5b /* Sched mode demotion - rt not allowed */ 288 #define MACH_MODE_UNDEMOTE_THROTTLED 0x5c /* Sched mode undemotion - throttling */ 289 #define MACH_MODE_UNDEMOTE_FAILSAFE 0x5d /* Sched mode undemotion - failsafe */ 290 #define MACH_MODE_UNDEMOTE_RT_DISALLOWED 0x5e /* Sched mode undemotion - rt not allowed */ 291 #define MACH_INT_MASKED_RESET 0x5f /* interrupt masked threshold reset */ 292 #define MACH_RT_DISALLOWED_WORK_INTERVAL 0x60 /* RT disallowed due to unmet work interval requirements */ 293 #define MACH_SCHED_WI_EXTERNAL_WAKEUP 0x61 /* WI thread woken by a thread outside its same work interval */ 294 #define MACH_SCHED_AST_CHECK 0x62 /* run ast check interrupt handler */ 295 #define MACH_SCHED_PREEMPT_TIMER_ACTIVE 0x63 /* preempt timer is armed */ 296 #define MACH_PROCESSOR_SHUTDOWN 0x64 /* processor was shut down */ 297 #define MACH_SCHED_PSET_BITMASKS 0x65 /* Migration, rotation, and recommendation bitmasks for each pset */ 298 #define MACH_SUSPEND_DRIVERKIT_USERSPACE 0x66 /* one driverkit process is suspended/unsuspended by iokit */ 299 #define MACH_SCHED_PREFERRED_PSET 0x67 /* Recommendation change for a thread group at a specific QoS */ 300 #define MACH_SCHED_ONCORE_PREEMPT 0x68 /* CLPC requested thread preemption */ 301 302 /* Codes for Clutch/Edge Scheduler (DBG_MACH_SCHED_CLUTCH) */ 303 #define MACH_SCHED_CLUTCH_ROOT_BUCKET_STATE 0x0 /* __unused */ 304 #define MACH_SCHED_CLUTCH_TG_BUCKET_STATE 0x1 /* __unused */ 305 #define MACH_SCHED_CLUTCH_THREAD_SELECT 0x2 /* Thread selection events for Clutch scheduler */ 306 #define MACH_SCHED_CLUTCH_THREAD_STATE 0x3 /* __unused */ 307 #define MACH_SCHED_CLUTCH_TG_BUCKET_PRI 0x4 /* Clutch bucket priority update event */ 308 /* Edge Scheduler Tracepoints */ 309 #define MACH_SCHED_EDGE_CLUSTER_OVERLOAD 0x5 /* Cluster experienced overload; migrating threads to other clusters */ 310 #define MACH_SCHED_EDGE_STEAL 0x6 /* Per-cluster avg. thread execution time */ 311 #define MACH_SCHED_EDGE_REBAL_RUNNABLE 0x7 /* Rebalance runnable threads on a foreign cluster */ 312 #define MACH_SCHED_EDGE_REBAL_RUNNING 0x8 /* Rebalance running threads on a foreign cluster */ 313 #define MACH_SCHED_EDGE_SHOULD_YIELD 0x9 /* Edge decisions for thread yield */ 314 #define MACH_SCHED_CLUTCH_THR_COUNT 0xa /* Clutch scheduler runnable thread counts */ 315 #define MACH_SCHED_EDGE_LOAD_AVG 0xb /* Per-cluster load average */ 316 #define MACH_SCHED_EDGE_CLUSTER_SHARED_LOAD 0xc /* Per-cluster shared resource load */ 317 #define MACH_SCHED_EDGE_RSRC_HEAVY_THREAD 0xd /* Resource heavy thread state */ 318 #define MACH_SCHED_EDGE_SHARED_RSRC_MIGRATE 0xe /* Migrating a shared resource thread due to cluster load imbalance */ 319 #define MACH_SCHED_EDGE_STIR_THE_POT 0xf /* Rotate running threads on and off P-cores to share time and make roughly equal forward progress */ 320 321 /* Codes for workgroup interval subsystem (DBG_MACH_WORKGROUP) */ 322 #define WORKGROUP_INTERVAL_CREATE 0x0 /* work interval creation */ 323 #define WORKGROUP_INTERVAL_DESTROY 0x1 /* work interval destruction */ 324 #define WORKGROUP_INTERVAL_CHANGE 0x2 /* thread work interval change */ 325 #define WORKGROUP_INTERVAL_START 0x3 /* work interval start call */ 326 #define WORKGROUP_INTERVAL_UPDATE 0x4 /* work interval update call */ 327 #define WORKGROUP_INTERVAL_FINISH 0x5 /* work interval finish call */ 328 #define WORKGROUP_INTERVAL_SET_WORKLOAD_ID 0x6 /* work interval set workload id */ 329 #define WORKGROUP_INTERVAL_SET_WORKLOAD_ID_NAME 0x7 /* work interval set workload id (name) */ 330 331 /* Codes for coverage sanitizer */ 332 #define KCOV_STKSZ_THRESHOLD_ABOVE 0x0 /* thread stack is above threshold */ 333 #define KCOV_STKSZ_THRESHOLD_BELOW 0x1 /* thread stack is below threshold */ 334 #define KCOV_STKSZ_DELTA 0X2 /* thread stack change is larger than delta. */ 335 336 /* Codes for Mach Virtual Memory (DBG_MACH_VM) */ 337 338 #define DBG_VM_VNODE_PAGEOUT 0x001 339 #define DBG_VM_FAULT_INTERNAL 0x002 340 341 #define DBG_VM_PURGEABLE_TOKEN_ADD 0x040 342 #define DBG_VM_PURGEABLE_TOKEN_DELETE 0x041 343 #define DBG_VM_PURGEABLE_TOKEN_RIPEN 0x042 344 #define DBG_VM_PURGEABLE_OBJECT_ADD 0x048 345 #define DBG_VM_PURGEABLE_OBJECT_REMOVE 0x049 346 #define DBG_VM_PURGEABLE_OBJECT_PURGE 0x04a 347 #define DBG_VM_PURGEABLE_OBJECT_PURGE_ALL 0x04b 348 #define DBG_VM_PURGEABLE_OBJECT_PURGE_ONE 0x04c 349 #define DBG_VM_PURGEABLE_OBJECT_PURGE_LOOP 0x04e 350 351 #define DBG_VM_MAP_PARTIAL_REAP 0x054 352 #define DBG_VM_MAP_WILLNEED 0x055 353 354 #define DBG_VM_FAULT_CHECK_ZFDELAY 0x100 355 #define DBG_VM_FAULT_COWDELAY 0x101 356 #define DBG_VM_FAULT_ZFDELAY 0x102 357 #define DBG_VM_FAULT_COMPRESSORDELAY 0x103 358 359 #define DBG_VM_PAGEOUT_SCAN 0x104 360 #define DBG_VM_PAGEOUT_BALANCE 0x105 361 #define DBG_VM_PAGEOUT_FREELIST 0x106 362 #define DBG_VM_PAGEOUT_PURGEONE 0x107 363 #define DBG_VM_PAGEOUT_CACHE_EVICT 0x108 364 #define DBG_VM_PAGEOUT_THREAD_BLOCK 0x109 365 #define DBG_VM_PAGEOUT_JETSAM 0x10A 366 #define DBG_VM_INFO1 0x10B 367 #define DBG_VM_INFO2 0x10C 368 #define DBG_VM_INFO3 0x10D 369 #define DBG_VM_INFO4 0x10E 370 #define DBG_VM_INFO5 0x10F 371 #define DBG_VM_INFO6 0x110 372 #define DBG_VM_INFO7 0x111 373 #define DBG_VM_INFO8 0x112 374 #define DBG_VM_INFO9 0x113 375 #define DBG_VM_INFO10 0x114 376 #define DBG_VM_INFO11 0x115 377 378 #define DBG_VM_UPL_PAGE_WAIT 0x120 379 #define DBG_VM_IOPL_PAGE_WAIT 0x121 380 #define DBG_VM_PAGE_WAIT_BLOCK 0x122 381 #define DBG_VM_PAGE_SLEEP 0x123 382 #define DBG_VM_PAGE_EXPEDITE 0x124 383 #define DBG_VM_PAGE_EXPEDITE_NO_MEMORY 0x125 384 #define DBG_VM_PAGE_GRAB 0x126 385 #define DBG_VM_PAGE_RELEASE 0x127 386 #define DBG_VM_COMPRESSOR_COMPACT_AND_SWAP 0x128 387 #define DBG_VM_COMPRESSOR_DELAYED_COMPACT 0x129 388 #define DBG_VM_OBJECT_SLEEP 0x12a 389 #define DBG_VM_PAGE_WAKEUP 0x12b 390 #define DBG_VM_PAGE_WAKEUP_DONE 0x12c 391 392 #define DBG_VM_PRESSURE_EVENT 0x130 393 #define DBG_VM_EXECVE 0x131 394 #define DBG_VM_WAKEUP_COMPACTOR_SWAPPER 0x132 395 #define DBG_VM_UPL_REQUEST 0x133 396 #define DBG_VM_IOPL_REQUEST 0x134 397 #define DBG_VM_KERN_REQUEST 0x135 398 #define DBG_VM_UPL_THROTTLE 0x136 399 #define DBG_VM_UPL_COMMIT_FORCE_DEACTIVATE 0x137 400 401 #define DBG_VM_DATA_WRITE 0x140 402 #define DBG_VM_PRESSURE_LEVEL_CHANGE 0x141 403 #define DBG_VM_PHYS_WRITE_ACCT 0x142 404 405 #define DBG_VM_MAP_LOOKUP_ENTRY_FAILURE 0x143 406 407 #if defined(XNU_KERNEL_PRIVATE) 408 #define DBG_VM_REFILL_MTE 0x144 409 #define DBG_VM_PAGE_MTE_WAIT_BLOCK 0x145 410 #define DBG_VM_PAGE_GRAB_MTE 0x146 411 #define DBG_VM_PAGE_RELEASE_MTE 0x147 412 #define DBG_VM_TAG_PAGE_ACTIVE 0x148 413 #define DBG_VM_TAG_PAGE_INACTIVE 0x149 414 #define DBG_VM_TAG_PAGE_CLAIMED 0x14a 415 #define DBG_VM_PAGEOUT_FREE_MTE 0x14b 416 #define DBG_VM_PAGE_MTE_ZFOD 0x14c 417 /* Previously DBG_VM_MTE_INFO* [0x14d,0x150] */ 418 #endif /* defined(XNU_KERNEL_PRIVATE) */ 419 420 #define DBG_VM_FAULT_DEACTIVATE_BEHIND 0x160 421 422 /* 423 * Codes for Working Set Measurement (DBG_MACH_WORKINGSET) 424 */ 425 #define VM_DISCONNECT_ALL_PAGE_MAPPINGS 0x00 426 #define VM_DISCONNECT_TASK_PAGE_MAPPINGS 0x01 427 #define VM_REAL_FAULT_ADDR_INTERNAL 0x02 428 #define VM_REAL_FAULT_ADDR_PURGABLE 0x03 429 #define VM_REAL_FAULT_ADDR_EXTERNAL 0x04 430 #define VM_REAL_FAULT_ADDR_SHAREDCACHE 0x05 431 #define VM_REAL_FAULT_FAST 0x06 432 #define VM_REAL_FAULT_SLOW 0x07 433 #define VM_MAP_LOOKUP_OBJECT 0x08 434 435 /* 436 * Fault Type Enumeration (DBG_MACH_WORKINGSET) 437 * NB: These are *not* trace codes. They comprise an enumeration passed as an 438 * argument to real_fault events. 439 */ 440 #define DBG_ZERO_FILL_FAULT 0x01 441 #define DBG_PAGEIN_FAULT 0x02 442 #define DBG_COW_FAULT 0x03 443 #define DBG_CACHE_HIT_FAULT 0x04 444 #define DBG_NZF_PAGE_FAULT 0x05 445 #define DBG_GUARD_FAULT 0x06 446 #define DBG_PAGEINV_FAULT 0x07 447 #define DBG_PAGEIND_FAULT 0x08 448 #define DBG_COMPRESSOR_FAULT 0x09 449 #define DBG_COMPRESSOR_SWAPIN_FAULT 0x0a 450 #define DBG_COR_FAULT 0x0b 451 452 /* 453 * Codes for VM Compressor (DBG_MACH_VM_COMPRESSOR) 454 */ 455 #define DBG_COMPACT_AND_SWAP 0x03 456 #define DBG_COMPACT_DEFERRED 0x04 457 #define DBG_COMPACT_SPECIAL 0x05 458 #define DBG_PROCESS_SWAPPEDIN 0x06 459 #define DBG_COMPACT_PAUSE 0x07 460 #define DBG_COMPACT_MINOR 0x08 461 #define DBG_COMPACT_MAJOR 0x09 462 #define DBG_COMPACT_COALESCE 0x0a 463 464 /* Codes for IPC (DBG_MACH_IPC) */ 465 /* unused MACH_TASK_SUSPEND 0x0 was: Suspended a task */ 466 /* unused MACH_TASK_RESUME 0x1 was: Resumed a task */ 467 #define MACH_THREAD_SET_VOUCHER 0x2 468 #define MACH_IPC_MSG_SEND 0x3 /* mach msg send, uniq msg info */ 469 #define MACH_IPC_MSG_RECV 0x4 /* mach_msg receive */ 470 #define MACH_IPC_MSG_RECV_VOUCHER_REFUSED 0x5 /* mach_msg receive, voucher refused */ 471 #define MACH_IPC_KMSG_FREE 0x6 /* kernel free of kmsg data */ 472 #define MACH_IPC_VOUCHER_CREATE 0x7 /* Voucher added to global voucher hashtable */ 473 #define MACH_IPC_VOUCHER_CREATE_ATTR_DATA 0x8 /* Attr data for newly created voucher */ 474 #define MACH_IPC_VOUCHER_DESTROY 0x9 /* Voucher removed from global voucher hashtable */ 475 #define MACH_IPC_KMSG_INFO 0xa /* Send/Receive info for a kmsg */ 476 #define MACH_IPC_KMSG_LINK 0xb /* link a kernel kmsg pointer to user mach_msg_header_t */ 477 #define MACH_IPC_PORT_ENTRY_MODIFY 0xc /* A port space gained or lost a port right (reference) */ 478 #define MACH_IPC_DESTROY_GUARDED_DESC 0xd /* Unable to receive a guarded descriptor */ 479 480 /* Codes for Suspension (DBG_MACH_SUSPENSION) */ 481 #define MACH_TASK_SUSPEND 0x0 /* Suspended a task */ 482 #define MACH_TASK_RESUME 0x1 /* Resumed a task */ 483 #define MACH_THREAD_SUSPEND 0x2 /* Suspended a thread */ 484 #define MACH_THREAD_RESUME 0x3 /* Resumed a thread */ 485 486 /* Codes for Exclaves (DBG_MACH_EXCLAVES) */ 487 #define MACH_EXCLAVES_SWITCH 0x0 /* Exclaves world switch (entry/return) */ 488 #define MACH_EXCLAVES_XNUPROXY 0x1 /* Exclaves xnuproxy request */ 489 #define MACH_EXCLAVES_RPC 0x2 /* Exclaves endpoint RPC */ 490 #define MACH_EXCLAVES_UPCALL 0x3 /* Exclaves upcall to an xnu handler */ 491 #define MACH_EXCLAVES_BOOT_TASK 0x4 /* Exclaves boot task */ 492 493 /* Codes for Exclaves Scheduler (DBG_MACH_EXCLAVES_SCHEDULER) */ 494 #define MACH_EXCLAVES_SCHEDULER_YIELD 0x0 /* Exclaves scheduler Yield response */ 495 #define MACH_EXCLAVES_SCHEDULER_SPAWNED 0x1 /* Exclaves scheduler Spawned response */ 496 #define MACH_EXCLAVES_SCHEDULER_TERMINATED 0x2 /* Exclaves scheduler Terminated response */ 497 #define MACH_EXCLAVES_SCHEDULER_WAIT 0x3 /* Exclaves scheduler Wait response */ 498 #define MACH_EXCLAVES_SCHEDULER_WAKE 0x4 /* Exclaves scheduler Wake response */ 499 #define MACH_EXCLAVES_SCHEDULER_SUSPENDED 0x5 /* Exclaves scheduler Suspended response */ 500 #define MACH_EXCLAVES_SCHEDULER_RESUMED 0x6 /* Exclaves scheduler Resumed response */ 501 #define MACH_EXCLAVES_SCHEDULER_INTERRUPTED 0x7 /* Exclaves scheduler Interrupted response */ 502 #define MACH_EXCLAVES_SCHEDULER_NOTHING_SCHEDULED 0x8 /* Exclaves scheduler NothingScheduled response */ 503 #define MACH_EXCLAVES_SCHEDULER_ALL_EXCLAVES_BOOTED 0x9 /* Exclaves scheduler AllExclavesBooted response */ 504 #define MACH_EXCLAVES_SCHEDULER_EARLY_ALLOC 0xa /* Exclaves scheduler PmmEarlyAlloc response */ 505 #define MACH_EXCLAVES_SCHEDULER_WATCHDOG_PANIC_COMPLETE 0xb /* Exclaves scheduler WatchdogPanicComplete response */ 506 #define MACH_EXCLAVES_SCHEDULER_PANICKING 0xc /* Exclaves scheduler Panicking response */ 507 #define MACH_EXCLAVES_SCHEDULER_REQ_RESUME_WITH_HOSTID 0xd /* Exclaves scheduler ResumeWithHostId request */ 508 #define MACH_EXCLAVES_SCHEDULER_REQ_INTERRUPT_WITH_HOSTID 0xe /* Exclaves scheduler InterruptWithHostIdrequest */ 509 #define MACH_EXCLAVES_SCHEDULER_REQ_UPDATE_TIMER_OFFSET 0xf /* Exclaves scheduler UpdateTimerOffset request */ 510 #define MACH_EXCLAVES_SCHEDULER_REQ_BOOT_EXCLAVES 0x10 /* Exclaves scheduler BootExclaves request */ 511 #define MACH_EXCLAVES_SCHEDULER_REQ_PMM_EARLY_ALLOC_RESPONSE 0x11 /* Exclaves scheduler PmmEarlyAllocResponse request */ 512 #define MACH_EXCLAVES_SCHEDULER_REQ_WATCHDOG_PANIC 0x12 /* Exclaves scheduler WatchdogPanic request */ 513 514 515 /* Codes for Epoch Sync (DBG_MACH_EPOCH_SYNC) */ 516 #define MACH_EPOCH_SYNC_WAIT_STALE 0x0 517 #define MACH_EPOCH_SYNC_WAIT 0x1 518 #define MACH_EPOCH_SYNC_WAKE_NO_WAITERS 0x2 519 #define MACH_EPOCH_SYNC_WAKE_ONE 0x3 520 #define MACH_EPOCH_SYNC_WAKE_ALL 0x4 521 #define MACH_EPOCH_SYNC_WAKE_ONE_WITH_OWNER 0x5 522 #define MACH_EPOCH_SYNC_WAKE_THREAD 0x6 523 524 /* Codes for thread groups (DBG_MACH_THREAD_GROUP) */ 525 #define MACH_THREAD_GROUP_NEW 0x0 526 #define MACH_THREAD_GROUP_FREE 0x1 527 #define MACH_THREAD_GROUP_SET 0x2 528 #define MACH_THREAD_GROUP_NAME 0x3 529 #define MACH_THREAD_GROUP_NAME_FREE 0x4 530 #define MACH_THREAD_GROUP_FLAGS 0x5 531 #define MACH_THREAD_GROUP_BLOCK 0x6 532 #define MACH_THREAD_GROUP_PREADOPT 0x7 533 #define MACH_THREAD_GROUP_PREADOPT_NEXTTIME 0x8 534 #define MACH_THREAD_GROUP_PREADOPT_CLEAR 0x9 535 #define MACH_THREAD_GROUP_PREADOPT_NA 0xa 536 537 /* Codes for coalitions (DBG_MACH_COALITION) */ 538 #define MACH_COALITION_NEW 0x0 539 #define MACH_COALITION_FREE 0x1 540 #define MACH_COALITION_ADOPT 0x2 541 #define MACH_COALITION_REMOVE 0x3 542 #define MACH_COALITION_THREAD_GROUP_SET 0x4 543 544 /* Codes for pmap (DBG_MACH_PMAP) */ 545 #define PMAP__CREATE 0x0 546 #define PMAP__DESTROY 0x1 547 #define PMAP__PROTECT 0x2 548 #define PMAP__PAGE_PROTECT 0x3 549 #define PMAP__ENTER 0x4 550 #define PMAP__REMOVE 0x5 551 #define PMAP__NEST 0x6 552 #define PMAP__UNNEST 0x7 553 #define PMAP__FLUSH_TLBS 0x8 554 #define PMAP__UPDATE_INTERRUPT 0x9 555 #define PMAP__ATTRIBUTE_CLEAR 0xa 556 #define PMAP__REUSABLE 0xb /* This appears to be unused */ 557 #define PMAP__QUERY_RESIDENT 0xc 558 #define PMAP__FLUSH_KERN_TLBS 0xd 559 #define PMAP__FLUSH_DELAYED_TLBS 0xe 560 #define PMAP__FLUSH_TLBS_TO 0xf 561 #define PMAP__FLUSH_EPT 0x10 562 #define PMAP__FAST_FAULT 0x11 563 #define PMAP__SWITCH 0x12 564 #define PMAP__TTE 0x13 565 #define PMAP__SWITCH_USER_TTB 0x14 566 #define PMAP__UPDATE_CACHING 0x15 567 #define PMAP__ATTRIBUTE_CLEAR_RANGE 0x16 568 #define PMAP__CLEAR_USER_TTB 0x17 569 #define PMAP__IOMMU_INIT 0x18 570 #define PMAP__IOMMU_IOVMALLOC 0x19 571 #define PMAP__IOMMU_IOVMFREE 0x1a 572 #define PMAP__IOMMU_MAP 0x1b 573 #define PMAP__IOMMU_UNMAP 0x1c 574 #define PMAP__IOMMU_IOCTL 0x1d 575 #define PMAP__IOMMU_GRANT_PAGE 0x1e 576 #define PMAP__BATCH_UPDATE_CACHING 0x1f 577 #define PMAP__COLLECT_CACHE_OPS 0x20 578 #define PMAP__SET_SHARED_REGION 0x21 579 580 /* Codes for clock (DBG_MACH_CLOCK) */ 581 #define MACH_EPOCH_CHANGE 0x0 /* wake epoch change */ 582 #define MACH_BRIDGE_RCV_TS 0x1 /* receive timestamp pair from interrupt handler */ 583 #define MACH_BRIDGE_REMOTE_TIME 0x2 /* calculate remote timestamp */ 584 #define MACH_BRIDGE_RESET_TS 0x3 /* reset timestamp conversion parameters */ 585 #define MACH_BRIDGE_TS_PARAMS 0x4 /* recompute timestamp conversion parameters */ 586 #define MACH_BRIDGE_SKIP_TS 0x5 /* skip timestamp */ 587 #define MACH_BRIDGE_TS_MISMATCH 0x6 /* mismatch between predicted and received remote timestamp */ 588 #define MACH_BRIDGE_OBSV_RATE 0x7 /* out of range observed rates */ 589 590 /* Codes for Stackshot/Microstackshot (DBG_MACH_STACKSHOT) */ 591 #define MICROSTACKSHOT_RECORD 0x0 592 #define MICROSTACKSHOT_GATHER 0x1 593 #define STACKSHOT_RECORD 0x2 /* START/END, syscall stackshot */ 594 #define STACKSHOT_RECORD_SHORT 0x3 /* ran out of space inside stackshot, growing buffer */ 595 #define STACKSHOT_KERN_RECORD 0x4 /* START/END, internal stackshot */ 596 597 /* Codes for sysdiagnose (DBG_MACH_SYSDIAGNOSE) */ 598 #define SYSDIAGNOSE_NOTIFY_USER 0x0 599 #define SYSDIAGNOSE_FULL 0x1 600 #define SYSDIAGNOSE_STACKSHOT 0x2 601 #define SYSDIAGNOSE_TAILSPIN 0x3 602 603 /* Codes for Selective Forced Idle (DBG_MACH_SFI) */ 604 #define SFI_SET_WINDOW 0x0 605 #define SFI_CANCEL_WINDOW 0x1 606 #define SFI_SET_CLASS_OFFTIME 0x2 607 #define SFI_CANCEL_CLASS_OFFTIME 0x3 608 #define SFI_THREAD_DEFER 0x4 609 #define SFI_OFF_TIMER 0x5 610 #define SFI_ON_TIMER 0x6 611 #define SFI_WAIT_CANCELED 0x7 612 #define SFI_PID_SET_MANAGED 0x8 613 #define SFI_PID_CLEAR_MANAGED 0x9 614 #define SFI_GLOBAL_DEFER 0xa 615 616 /* Codes for Zone Allocator (DBG_MACH_ZALLOC) */ 617 #define ZALLOC_ZCRAM 0x0 618 619 /* Codes for Mach resource management (DBG_MACH_RESOURCE) */ 620 /* _K32A/B codes start at double the low nibble */ 621 #define RMON_ENABLE_CPUUSAGE_MONITOR 0x001 622 #define RMON_CPUUSAGE_VIOLATED 0x002 623 #define RMON_CPUUSAGE_SUSPENDED 0x003 624 #define RMON_CPUUSAGE_VIOLATED_K32A 0x004 625 #define RMON_CPUUSAGE_VIOLATED_K32B 0x005 626 #define RMON_CPUUSAGE_RESUMED 0x006 627 #define RMON_DISABLE_CPUUSAGE_MONITOR 0x00f 628 629 #define RMON_ENABLE_CPUWAKES_MONITOR 0x011 630 #define RMON_CPUWAKES_VIOLATED 0x012 631 #define RMON_CPUWAKES_VIOLATED_K32A 0x014 632 #define RMON_CPUWAKES_VIOLATED_K32B 0x015 633 #define RMON_DISABLE_CPUWAKES_MONITOR 0x01f 634 635 #define RMON_ENABLE_IO_MONITOR 0x021 636 #define RMON_LOGWRITES_VIOLATED 0x022 637 #define RMON_PHYSWRITES_VIOLATED 0x023 638 #define RMON_LOGWRITES_VIOLATED_K32A 0x024 639 #define RMON_LOGWRITES_VIOLATED_K32B 0x025 640 #define RMON_DISABLE_IO_MONITOR 0x02f 641 642 /* Codes for x86 Hypervisor (DBG_MACH_HV) */ 643 #define HV_X86_ENTER 0x00 644 #define HV_X86_ENTER_ERROR 0x01 645 #define HV_X86_TRAP_TASK 0x02 646 #define HV_X86_TRAP_THREAD 0x03 647 #define HV_X86_INTERRUPT_INJECT 0x04 648 #define HV_X86_INTERRUPT_RECV 0x05 649 #define HV_X86_INTERRUPT_SEND 0x06 650 #define HV_X86_IPI_SEND 0x07 651 #define HV_X86_NMI_INJECT 0x08 652 #define HV_X86_NMI_SEND 0x09 653 #define HV_X86_LSC_HIT 0x0a 654 #define HV_X86_LSC_INSERT 0x0b 655 #define HV_X86_LSC_INSERT_IMM32 0x0c 656 #define HV_X86_LSC_INVALID 0x0d 657 #define HV_X86_LSC_INVALIDATE 0x0e 658 #define HV_X86_LSC_MISS 0x0f 659 #define HV_X86_TIMER_CANCEL 0x10 660 #define HV_X86_TIMER_FIRE 0x11 661 #define HV_X86_TIMER_SCHEDULE 0x12 662 #define HV_X86_APIC_ACCESS_EXIT 0x13 663 #define HV_X86_APIC_WRITE_EXIT 0x14 664 #define HV_X86_EPT_VIOLATION_EXIT 0x15 665 #define HV_X86_EXC_NMI_EXIT 0x16 666 #define HV_X86_HLT_EXIT 0x17 667 #define HV_X86_IO_EXIT 0x18 668 #define HV_X86_IRQ_EXIT 0x19 669 #define HV_X86_IRQ_WND_EXIT 0x1a 670 #define HV_X86_MOV_DR_EXIT 0x1b 671 #define HV_X86_NMI_WND_EXIT 0x1c 672 #define HV_X86_RDMSR_EXIT 0x1d 673 #define HV_X86_RDPMC_EXIT 0x1e 674 #define HV_X86_TPR_THRESHOLD_EXIT 0x1f 675 #define HV_X86_VMX_TIMER_EXPIRED_EXIT 0x20 676 #define HV_X86_WRMSR_EXIT 0x21 677 #define HV_X86_VCPU_READ_APIC_TRAP 0x22 678 #define HV_X86_VCPU_READ_VMCS_TRAP 0x23 679 #define HV_X86_VCPU_RUN_TRAP 0x24 680 #define HV_X86_VCPU_RUN_UNTIL_TRAP 0x25 681 #define HV_X86_VCPU_WRITE_APIC_TRAP 0x26 682 #define HV_X86_VM_ADDRSPACE_CREATE_TRAP 0x27 683 #define HV_X86_VM_ADDRSPACE_DESTROY_TRAP 0x28 684 #define HV_X86_VM_INTR_MSI_TRAP 0x29 685 #define HV_X86_VM_MAP_TRAP 0x2a 686 #define HV_X86_VM_PROTECT_TRAP 0x2b 687 #define HV_X86_VM_UNMAP_TRAP 0x2c 688 #define HV_X86_TSC_OFFSET_SET 0x2d 689 690 #pragma mark Deferred Memory Reclamation Codes (DBG_MACH_VM_RECLAIM) 691 692 #define VM_RECLAIM_UPDATE_ACCOUNTING 0x01 693 #define VM_RECLAIM_TRIM 0x02 694 #define VM_RECLAIM_CHUNK 0x03 695 #define VM_RECLAIM_ENTRY 0x04 696 #define VM_RECLAIM_DRAIN 0x05 697 698 #define VM_RECLAIM_INIT 0x07 699 #define VM_RECLAIM_SAMPLE 0x08 700 701 #define VM_RECLAIM_RESIZE 0x0a 702 #define VM_RECLAIM_FLUSH 0x0b 703 704 #pragma mark System Memory Info Codes (DBG_MACH_MEMINFO) 705 706 /* system memory state */ 707 #define DBG_MEMINFO_PGCNT1 0x01 708 #define DBG_MEMINFO_PGCNT2 0x02 709 #define DBG_MEMINFO_PGCNT3 0x03 710 #define DBG_MEMINFO_PGCNT4 0x04 711 #define DBG_MEMINFO_PGCNT5 0x05 712 #define DBG_MEMINFO_PGCNT6 0x06 713 #define DBG_MEMINFO_PGCNT7 0x07 714 #define DBG_MEMINFO_PGCNT8 0x08 715 716 /* Page eviction statistics */ 717 #define DBG_MEMINFO_PGOUT1 0x11 718 #define DBG_MEMINFO_PGOUT2 0x12 719 #define DBG_MEMINFO_PGOUT3 0x13 720 #define DBG_MEMINFO_PGOUT4 0x14 721 #define DBG_MEMINFO_PGOUT5 0x15 722 #define DBG_MEMINFO_PGOUT6 0x16 723 724 /* Page demand statistics */ 725 #define DBG_MEMINFO_DEMAND1 0x21 726 #define DBG_MEMINFO_DEMAND2 0x22 727 728 /* Compressor statistics */ 729 #define DBG_MEMINFO_CSEG1 0x31 730 #define DBG_MEMINFO_CSEG2 0x32 731 #define DBG_MEMINFO_CSEG3 0x33 732 #define DBG_MEMINFO_CSEG4 0x34 733 734 /* Compactor/Swapper statistics */ 735 #define DBG_MEMINFO_CSWAP1 0x41 736 #define DBG_MEMINFO_CSWAP2 0x42 737 #define DBG_MEMINFO_CSWAP3 0x43 738 739 #define DBG_MEMINFO_COMPACTOR1 0x46 740 #define DBG_MEMINFO_COMPACTOR2 0x47 741 #define DBG_MEMINFO_COMPACTOR3 0x48 742 743 /* **** The Kernel Debug Sub Classes for Network (DBG_NETWORK) **** */ 744 #define DBG_NETIP 1 /* Internet Protocol */ 745 #define DBG_NETARP 2 /* Address Resolution Protocol */ 746 #define DBG_NETUDP 3 /* User Datagram Protocol */ 747 #define DBG_NETTCP 4 /* Transmission Control Protocol */ 748 #define DBG_NETICMP 5 /* Internet Control Message Protocol */ 749 #define DBG_NETIGMP 6 /* Internet Group Management Protocol */ 750 #define DBG_NETRIP 7 /* Routing Information Protocol */ 751 #define DBG_NETOSPF 8 /* Open Shortest Path First */ 752 #define DBG_NETISIS 9 /* Intermediate System to Intermediate System */ 753 #define DBG_NETSNMP 10 /* Simple Network Management Protocol */ 754 #define DBG_NETSOCK 11 /* Socket Layer */ 755 756 /* For Apple talk */ 757 #define DBG_NETAARP 100 /* Apple ARP */ 758 #define DBG_NETDDP 101 /* Datagram Delivery Protocol */ 759 #define DBG_NETNBP 102 /* Name Binding Protocol */ 760 #define DBG_NETZIP 103 /* Zone Information Protocol */ 761 #define DBG_NETADSP 104 /* Name Binding Protocol */ 762 #define DBG_NETATP 105 /* Apple Transaction Protocol */ 763 #define DBG_NETASP 106 /* Apple Session Protocol */ 764 #define DBG_NETAFP 107 /* Apple Filing Protocol */ 765 #define DBG_NETRTMP 108 /* Routing Table Maintenance Protocol */ 766 #define DBG_NETAURP 109 /* Apple Update Routing Protocol */ 767 768 #define DBG_NETIPSEC 128 /* IPsec Protocol */ 769 #define DBG_NETVMNET 129 /* VMNet */ 770 771 /* **** The Kernel Debug Sub Classes for IOKIT (DBG_IOKIT) **** */ 772 #define DBG_IOINTC 0 /* Interrupt controller */ 773 #define DBG_IOWORKLOOP 1 /* Work from work loop */ 774 #define DBG_IOINTES 2 /* Interrupt event source */ 775 #define DBG_IOCLKES 3 /* Clock event source */ 776 #define DBG_IOCMDQ 4 /* Command queue latencies */ 777 #define DBG_IOMCURS 5 /* Memory Cursor */ 778 #define DBG_IOMDESC 6 /* Memory Descriptors */ 779 #define DBG_IOPOWER 7 /* Power Managerment */ 780 #define DBG_IOSERVICE 8 /* Matching etc. */ 781 #define DBG_IOREGISTRY 9 /* Registry */ 782 #define DBG_IOPORT 10 /* IOPort */ 783 784 /* **** 9-32 reserved for internal IOKit usage **** */ 785 786 #define DBG_IOSTORAGE 32 /* Storage layers */ 787 #define DBG_IONETWORK 33 /* Network layers */ 788 #define DBG_IOKEYBOARD 34 /* Keyboard */ 789 #define DBG_IOHID 35 /* HID Devices */ 790 #define DBG_IOAUDIO 36 /* Audio */ 791 #define DBG_IOSERIAL 37 /* Serial */ 792 #define DBG_IOTTY 38 /* TTY layers */ 793 #define DBG_IOSAM 39 /* SCSI Architecture Model layers */ 794 #define DBG_IOPARALLELATA 40 /* Parallel ATA */ 795 #define DBG_IOPARALLELSCSI 41 /* Parallel SCSI */ 796 #define DBG_IOSATA 42 /* Serial-ATA */ 797 #define DBG_IOSAS 43 /* SAS */ 798 #define DBG_IOFIBRECHANNEL 44 /* FiberChannel */ 799 #define DBG_IOUSB 45 /* USB */ 800 #define DBG_IOBLUETOOTH 46 /* Bluetooth */ 801 #define DBG_IOFIREWIRE 47 /* FireWire */ 802 #define DBG_IOINFINIBAND 48 /* Infiniband */ 803 #define DBG_IOCPUPM 49 /* CPU Power Management */ 804 #define DBG_IOGRAPHICS 50 /* Graphics */ 805 #define DBG_HIBERNATE 51 /* hibernation related events */ 806 #define DBG_IOTHUNDERBOLT 52 /* Thunderbolt */ 807 #define DBG_BOOTER 53 /* booter related events */ 808 #define DBG_IOAUDIO2 54 /* Audio (extended) */ 809 #define DBG_IOAFK 55 /* AppleFirmwareKit */ 810 811 #define DBG_IOSURFACEPA 64 /* IOSurface page mappings */ 812 #define DBG_IOMDPA 65 /* IOMemoryDescriptor page mappings */ 813 #define DBG_IODARTPA 66 /* DART page mappings */ 814 /* **** 67-79 reserved for physical address mapping information **** */ 815 816 /* Backwards compatibility */ 817 #define DBG_IOPOINTING DBG_IOHID /* OBSOLETE: Use DBG_IOHID instead */ 818 #define DBG_IODISK DBG_IOSTORAGE /* OBSOLETE: Use DBG_IOSTORAGE instead */ 819 820 /* **** The Kernel Debug Sub Classes for Device Drivers (DBG_DRIVERS) **** */ 821 #define DBG_DRVSTORAGE 1 /* Storage layers */ 822 #define DBG_DRVNETWORK 2 /* Network layers */ 823 #define DBG_DRVKEYBOARD 3 /* Keyboard */ 824 #define DBG_DRVHID 4 /* HID Devices */ 825 #define DBG_DRVAUDIO 5 /* Audio */ 826 #define DBG_DRVSERIAL 7 /* Serial */ 827 #define DBG_DRVSAM 8 /* SCSI Architecture Model layers */ 828 #define DBG_DRVPARALLELATA 9 /* Parallel ATA */ 829 #define DBG_DRVPARALLELSCSI 10 /* Parallel SCSI */ 830 #define DBG_DRVSATA 11 /* Serial ATA */ 831 #define DBG_DRVSAS 12 /* SAS */ 832 #define DBG_DRVFIBRECHANNEL 13 /* FiberChannel */ 833 #define DBG_DRVUSB 14 /* USB */ 834 #define DBG_DRVBLUETOOTH 15 /* Bluetooth */ 835 #define DBG_DRVFIREWIRE 16 /* FireWire */ 836 #define DBG_DRVINFINIBAND 17 /* Infiniband */ 837 #define DBG_DRVGRAPHICS 18 /* Graphics */ 838 #define DBG_DRVSD 19 /* Secure Digital */ 839 #define DBG_DRVNAND 20 /* NAND drivers and layers */ 840 #define DBG_SSD 21 /* SSD */ 841 #define DBG_DRVSPI 22 /* SPI */ 842 #define DBG_DRVWLAN_802_11 23 /* WLAN 802.11 */ 843 #define DBG_DRVSSM 24 /* System State Manager(AppleSSM) */ 844 #define DBG_DRVSMC 25 /* System Management Controller */ 845 #define DBG_DRVMACEFIMANAGER 26 /* Mac EFI Manager */ 846 #define DBG_DRVANE 27 /* Apple Neural Engine */ 847 #define DBG_DRVETHERNET 28 /* Ethernet */ 848 #define DBG_DRVMCC 29 /* Memory Cache Controller */ 849 #define DBG_DRVACCESSORY 30 /* Accessories */ 850 #define DBG_SOCDIAGS 31 /* SoC Diagnostics */ 851 #define DBG_DRVVIRTIO 32 /* Hypervisor VirtIO */ 852 #define DBG_DRVCELLULAR 33 /* Cellular */ 853 #define DBG_DRVSPMI 34 /* System Power Management Interface */ 854 855 /* Backwards compatibility */ 856 #define DBG_DRVPOINTING DBG_DRVHID /* OBSOLETE: Use DBG_DRVHID instead */ 857 #define DBG_DRVDISK DBG_DRVSTORAGE /* OBSOLETE: Use DBG_DRVSTORAGE instead */ 858 859 /* **** The Kernel Debug Sub Classes for the DLIL Layer (DBG_DLIL) **** */ 860 #define DBG_DLIL_STATIC 1 /* Static DLIL code */ 861 #define DBG_DLIL_PR_MOD 2 /* DLIL Protocol Module */ 862 #define DBG_DLIL_IF_MOD 3 /* DLIL Interface Module */ 863 #define DBG_DLIL_PR_FLT 4 /* DLIL Protocol Filter */ 864 #define DBG_DLIL_IF_FLT 5 /* DLIL Interface FIlter */ 865 866 /* The Kernel Debug Sub Classes for File System (DBG_FSYSTEM) */ 867 #define DBG_FSRW 0x1 /* reads and writes to the filesystem */ 868 #define DBG_DKRW 0x2 /* reads and writes to the disk */ 869 #define DBG_FSVN 0x3 /* vnode operations (inc. locking/unlocking) */ 870 #define DBG_FSLOOOKUP 0x4 /* namei and other lookup-related operations */ 871 #define DBG_JOURNAL 0x5 /* journaling operations */ 872 #define DBG_IOCTL 0x6 /* ioctl to the disk */ 873 #define DBG_BOOTCACHE 0x7 /* bootcache operations */ 874 #define DBG_HFS 0x8 /* HFS-specific events; see the hfs project */ 875 #define DBG_APFS 0x9 /* APFS-specific events; see the apfs project */ 876 #define DBG_SMB 0xA /* SMB-specific events; see the smb project */ 877 #define DBG_MOUNT 0xB /* Mounting/unmounting operations */ 878 #define DBG_EXFAT 0xE /* ExFAT-specific events; see the exfat project */ 879 #define DBG_MSDOS 0xF /* FAT-specific events; see the msdosfs project */ 880 #define DBG_ACFS 0x10 /* Xsan-specific events; see the XsanFS project */ 881 #define DBG_THROTTLE 0x11 /* I/O Throttling events */ 882 #define DBG_DECMP 0x12 /* Decmpfs-specific events */ 883 #define DBG_VFS 0x13 /* VFS layer events */ 884 #define DBG_LIVEFS 0x14 /* LiveFS events; see the FSKit project */ 885 #define DBG_NFS 0x15 /* NFS-specific events; see the nfs project */ 886 #define DBG_CONTENT_PROT 0xCF /* Content Protection Events: see bsd/sys/cprotect.h */ 887 888 /* 889 * For Kernel Debug Sub Class DBG_HFS, state bits for hfs_update event 890 */ 891 #define DBG_HFS_UPDATE_ACCTIME 0x01 892 #define DBG_HFS_UPDATE_MODTIME 0x02 893 #define DBG_HFS_UPDATE_CHGTIME 0x04 894 #define DBG_HFS_UPDATE_MODIFIED 0x08 895 #define DBG_HFS_UPDATE_FORCE 0x10 896 #define DBG_HFS_UPDATE_DATEADDED 0x20 897 #define DBG_HFS_UPDATE_MINOR 0x40 898 #define DBG_HFS_UPDATE_SKIPPED 0x80 899 900 /* 901 * Codes for Kernel Debug Sub Class DBG_VFS 902 */ 903 #define DBG_VFS_IO_COMPRESSION_STATS 0x1000 904 905 /* The Kernel Debug Sub Classes for BSD */ 906 #define DBG_BSD_PROC 0x01 /* process/signals related */ 907 #define DBG_BSD_MEMSTAT 0x02 /* memorystatus / jetsam operations */ 908 #define DBG_BSD_KEVENT 0x03 /* kqueue / kevent related */ 909 #define DBG_BSD_EXCP_SC 0x0C /* System Calls */ 910 #define DBG_BSD_AIO 0x0D /* aio (POSIX async IO) */ 911 #define DBG_BSD_SC_EXTENDED_INFO 0x0E /* System Calls, extended info */ 912 #define DBG_BSD_SC_EXTENDED_INFO2 0x0F /* System Calls, extended info */ 913 #define DBG_BSD_KDEBUG_TEST 0xFF /* for testing kdebug */ 914 915 /* The Codes for BSD subcode class DBG_BSD_PROC */ 916 #define BSD_PROC_EXIT 1 /* process exit */ 917 #define BSD_PROC_FRCEXIT 2 /* Kernel force termination */ 918 #define BSD_PROC_EXEC 3 /* process spawn / exec */ 919 #define BSD_PROC_EXITREASON_CREATE 4 /* exit reason creation */ 920 #define BSD_PROC_EXITREASON_COMMIT 5 /* exit reason commited to a proc */ 921 922 /* Codes for BSD subcode class DBG_BSD_MEMSTAT */ 923 #define BSD_MEMSTAT_SCAN 1 /* memorystatus thread awake */ 924 #define BSD_MEMSTAT_JETSAM 2 /* LRU jetsam */ 925 #define BSD_MEMSTAT_JETSAM_HIWAT 3 /* highwater jetsam */ 926 #define BSD_MEMSTAT_FREEZE 4 /* freeze process */ 927 #define BSD_MEMSTAT_FREEZE_SCAN 5 /* select a process to freeze and freeze it */ 928 #define BSD_MEMSTAT_UPDATE 6 /* priority update */ 929 #define BSD_MEMSTAT_IDLE_DEMOTE 7 /* idle demotion fired */ 930 #define BSD_MEMSTAT_CLEAR_ERRORS 8 /* reset termination error state */ 931 #define BSD_MEMSTAT_DIRTY_TRACK 9 /* track the process state */ 932 #define BSD_MEMSTAT_DIRTY_SET 10 /* set the process state */ 933 #define BSD_MEMSTAT_DIRTY_CLEAR 11 /* clear the process state */ 934 #ifdef PRIVATE 935 #define BSD_MEMSTAT_GRP_SET_PROP 12 /* set group properties */ 936 #define BSD_MEMSTAT_DO_KILL 13 /* memorystatus kills */ 937 #define BSD_MEMSTAT_CHANGE_PRIORITY 14 /* priority changed */ 938 #endif /* PRIVATE */ 939 #define BSD_MEMSTAT_FAST_JETSAM 15 /* Aggressive jetsam ("clear-the-deck") */ 940 #define BSD_MEMSTAT_COMPACTOR_RUN 16 /* run VM compactor after process kill */ 941 #define BSD_MEMSTAT_FREEZE_DISABLE 17 /* disable freeze and kill frozen processes */ 942 #define BSD_MEMSTAT_RELAUNCH_FLAGS 18 /* flags representing jetsam behavior; based on launchd data */ 943 944 /* Codes for BSD subcode class DBG_BSD_KEVENT */ 945 #define BSD_KEVENT_KQ_PROCESS_BEGIN 1 946 #define BSD_KEVENT_KQ_PROCESS_END 2 947 #define BSD_KEVENT_KQWQ_PROCESS_BEGIN 3 948 #define BSD_KEVENT_KQWQ_PROCESS_END 4 949 #define BSD_KEVENT_KQWQ_BIND 5 950 #define BSD_KEVENT_KQWQ_UNBIND 6 951 #define BSD_KEVENT_KQWQ_THREQUEST 7 952 #define BSD_KEVENT_KQWL_PROCESS_BEGIN 8 953 #define BSD_KEVENT_KQWL_PROCESS_END 9 954 #define BSD_KEVENT_KQWL_THREQUEST 10 955 #define BSD_KEVENT_KQWL_THADJUST 11 956 #define BSD_KEVENT_KQ_REGISTER 12 957 #define BSD_KEVENT_KQWQ_REGISTER 13 958 #define BSD_KEVENT_KQWL_REGISTER 14 959 #define BSD_KEVENT_KNOTE_ACTIVATE 15 960 #define BSD_KEVENT_KQ_PROCESS 16 961 #define BSD_KEVENT_KQWQ_PROCESS 17 962 #define BSD_KEVENT_KQWL_PROCESS 18 963 #define BSD_KEVENT_KQWL_BIND 19 964 #define BSD_KEVENT_KQWL_UNBIND 20 965 #define BSD_KEVENT_KNOTE_ENABLE 21 966 #define BSD_KEVENT_KNOTE_VANISHED 22 967 968 /* The Kernel Debug Sub Classes for DBG_TRACE */ 969 #define DBG_TRACE_DATA 0 970 #define DBG_TRACE_STRING 1 971 #define DBG_TRACE_INFO 2 972 973 /* The Kernel Debug events: */ 974 #define TRACE_DATA_NEWTHREAD (TRACEDBG_CODE(DBG_TRACE_DATA, 1)) 975 #define TRACE_DATA_EXEC (TRACEDBG_CODE(DBG_TRACE_DATA, 2)) 976 #define TRACE_DATA_THREAD_TERMINATE (TRACEDBG_CODE(DBG_TRACE_DATA, 3)) 977 #define TRACE_DATA_THREAD_TERMINATE_PID (TRACEDBG_CODE(DBG_TRACE_DATA, 4)) 978 #define TRACE_STRING_GLOBAL (TRACEDBG_CODE(DBG_TRACE_STRING, 0)) 979 #define TRACE_STRING_NEWTHREAD (TRACEDBG_CODE(DBG_TRACE_STRING, 1)) 980 #define TRACE_STRING_EXEC (TRACEDBG_CODE(DBG_TRACE_STRING, 2)) 981 #define TRACE_STRING_PROC_EXIT (TRACEDBG_CODE(DBG_TRACE_STRING, 3)) 982 #define TRACE_STRING_THREADNAME (TRACEDBG_CODE(DBG_TRACE_STRING, 4)) 983 #define TRACE_STRING_THREADNAME_PREV (TRACEDBG_CODE(DBG_TRACE_STRING, 5)) 984 #define TRACE_PANIC (TRACEDBG_CODE(DBG_TRACE_INFO, 0)) 985 #define TRACE_TIMESTAMPS (TRACEDBG_CODE(DBG_TRACE_INFO, 1)) 986 #define TRACE_LOST_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 2)) 987 #define TRACE_WRITING_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 3)) 988 #define TRACE_INFO_STRING (TRACEDBG_CODE(DBG_TRACE_INFO, 4)) 989 #define TRACE_RETROGRADE_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 5)) 990 #define TRACE_PAST_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 6)) 991 992 /* The Kernel Debug Sub Classes for DBG_CORESTORAGE */ 993 #define DBG_CS_IO 0 994 995 /* The Kernel Debug Sub Classes for DBG_SECURITY */ 996 #define DBG_SEC_KERNEL 0 /* raw entropy collected by the kernel */ 997 #define DBG_SEC_SANDBOX 1 998 999 /* Sub-class codes for CoreGraphics (DBG_CG) are defined in its component. */ 1000 1001 /* The Kernel Debug Sub Classes for DBG_MONOTONIC */ 1002 #define DBG_MT_INSTRS_CYCLES 1 1003 #define DBG_MT_DEBUG 2 1004 #define DBG_MT_RESOURCES_PROC_EXIT 3 1005 #define DBG_MT_RESOURCES_THR_EXIT 4 1006 #define DBG_MT_INSTRS_CYCLES_ON_CPU 5 1007 #define DBG_MT_TMPTH 0xfe 1008 #define DBG_MT_TMPCPU 0xff 1009 1010 /* Kernel Debug events for the DBG_MT_RESOURCES_PROC_EXIT subclass */ 1011 #define DBG_MT_INSTRS_CYCLES_PROC_EXIT MTDBG_RESOURCES_ON_PROC_EXIT(0) 1012 #define DBG_MT_P_INSTRS_CYCLES_PROC_EXIT MTDBG_RESOURCES_ON_PROC_EXIT(1) 1013 1014 /* Kernel Debug events for the DBG_MT_RESOURCES_THR_EXIT subclass */ 1015 #define DBG_MT_INSTRS_CYCLES_THR_EXIT MTDBG_RESOURCES_ON_THR_EXIT(0) 1016 #define DBG_MT_P_INSTRS_CYCLES_THR_EXIT MTDBG_RESOURCES_ON_THR_EXIT(1) 1017 1018 /* The Kernel Debug Sub Classes for DBG_MISC */ 1019 #define DBG_MISC_COREBRIGHTNESS 0x01 1020 #define DBG_MISC_VIDEOENG 0x02 1021 #define DBG_EVENT 0x10 1022 #define DBG_MISC_INSTRUMENTS 0x11 1023 #define DBG_MISC_INSTRUMENTSBT 0x12 1024 #define DBG_MISC_RUNLOOP_DETAILS 0x13 1025 #define DBG_MISC_RUNLOOP_BUSY 0x14 1026 #define DBG_MISC_LAYOUT 0x1a 1027 #define DBG_BUFFER 0x20 1028 1029 /* The Kernel Debug Sub Classes for DBG_DYLD */ 1030 #define DBG_DYLD_UUID (5) 1031 1032 /* Kernel Debug codes for the DBG_DYLD_UUID subclass */ 1033 #define DBG_DYLD_UUID_MAP_A (0) 1034 #define DBG_DYLD_UUID_MAP_B (1) 1035 #define DBG_DYLD_UUID_MAP_32_A (2) 1036 #define DBG_DYLD_UUID_MAP_32_B (3) 1037 #define DBG_DYLD_UUID_MAP_32_C (4) 1038 #define DBG_DYLD_UUID_UNMAP_A (5) 1039 #define DBG_DYLD_UUID_UNMAP_B (6) 1040 #define DBG_DYLD_UUID_UNMAP_32_A (7) 1041 #define DBG_DYLD_UUID_UNMAP_32_B (8) 1042 #define DBG_DYLD_UUID_UNMAP_32_C (9) 1043 #define DBG_DYLD_UUID_SHARED_CACHE_A (10) 1044 #define DBG_DYLD_UUID_SHARED_CACHE_B (11) 1045 #define DBG_DYLD_UUID_SHARED_CACHE_32_A (12) 1046 #define DBG_DYLD_UUID_SHARED_CACHE_32_B (13) 1047 #define DBG_DYLD_UUID_SHARED_CACHE_32_C (14) 1048 #define DBG_DYLD_AOT_UUID_MAP_A (15) 1049 #define DBG_DYLD_AOT_UUID_MAP_B (16) 1050 1051 /* The Kernel Debug modifiers for the DBG_DKRW sub class */ 1052 #define DKIO_DONE 0x01 1053 #define DKIO_READ 0x02 1054 #define DKIO_ASYNC 0x04 1055 #define DKIO_META 0x08 1056 #define DKIO_PAGING 0x10 1057 #define DKIO_THROTTLE 0x20 /* Deprecated, still provided so fs_usage doesn't break */ 1058 #define DKIO_PASSIVE 0x40 1059 #define DKIO_NOCACHE 0x80 1060 #define DKIO_TIER_MASK 0xF00 1061 #define DKIO_TIER_SHIFT 8 1062 #define DKIO_TIER_UPGRADE 0x1000 1063 1064 /* Kernel Debug Sub Classes for Applications (DBG_APPS) */ 1065 #define DBG_APP_LOGINWINDOW 0x03 1066 #define DBG_APP_AUDIO 0x04 1067 #define DBG_APP_SYSTEMUI 0x05 1068 #define DBG_APP_SIGNPOST 0x0A 1069 #define DBG_APP_TAL 0x0B 1070 #define DBG_APP_APPKIT 0x0C 1071 #define DBG_APP_UIKIT 0x0D 1072 #define DBG_APP_DFR 0x0E 1073 #define DBG_APP_LAYOUT 0x0F 1074 #define DBG_APP_COREDATA 0x10 1075 #define DBG_APP_RUNLOOP_BASIC 0x11 1076 #define DBG_APP_RUNLOOP_ADVANCED 0x12 1077 #define DBG_APP_SAMBA 0x80 1078 #define DBG_APP_EOSSUPPORT 0x81 1079 #define DBG_APP_MACEFIMANAGER 0x82 1080 #define DBG_APP_ENTERPRISE 0x83 1081 1082 /* Kernel Debug codes for Throttling (DBG_THROTTLE) */ 1083 #define OPEN_THROTTLE_WINDOW 0x1 1084 #define PROCESS_THROTTLED 0x2 1085 #define IO_THROTTLE_DISABLE 0x3 1086 #define IO_TIER_UPL_MISMATCH 0x4 1087 1088 /* Subclasses for MACH Importance Policies (DBG_IMPORTANCE) */ 1089 /* TODO: Split up boost and task policy? */ 1090 #define IMP_ASSERTION 0x10 /* Task takes/drops a boost assertion */ 1091 #define IMP_BOOST 0x11 /* Task boost level changed */ 1092 #define IMP_MSG 0x12 /* boosting message sent by donating task on donating port */ 1093 #define IMP_WATCHPORT 0x13 /* port marked as watchport, and boost was transferred to the watched task */ 1094 #define IMP_THREAD_PROMOTE_ABOVE_TASK 0x15 /* Thread is turnstile boosted above task clamp */ 1095 #define IMP_RUNAWAY_MITIGATION 0x16 /* Runaway mitigation status change */ 1096 #define IMP_TASK_SUPPRESSION 0x17 /* Task changed suppression behaviors */ 1097 #define IMP_TASK_APPTYPE 0x18 /* Task launched with apptype */ 1098 #define IMP_UPDATE 0x19 /* Requested -> effective calculation */ 1099 #define IMP_USYNCH_QOS_OVERRIDE 0x1A /* Userspace synchronization applied QoS override to resource owning thread */ 1100 #define IMP_DONOR_CHANGE 0x1B /* The iit_donor bit changed */ 1101 #define IMP_MAIN_THREAD_QOS 0x1C /* The task's main thread QoS was set */ 1102 #define IMP_SYNC_IPC_QOS 0x1D /* Sync IPC QOS override */ 1103 #define IMP_SET_GPU_ROLE 0x1E /* Update GPU Role */ 1104 #define IMP_QUERY_GPU_ROLE 0x1F /* Driver queries GPU Role */ 1105 1106 /* DBG_IMPORTANCE subclasses 0x20 - 0x50 are reserved for task policy flavors */ 1107 1108 /* thread and task attributes */ 1109 #define IMP_TASK_POLICY_DARWIN_BG 0x21 1110 #define IMP_TASK_POLICY_IOPOL 0x22 1111 #define IMP_TASK_POLICY_IO 0x23 1112 #define IMP_TASK_POLICY_PASSIVE_IO 0x24 1113 1114 /* task only attributes */ 1115 #define IMP_TASK_POLICY_DARWIN_BG_IOPOL 0x27 1116 /* unused, was IMP_TASK_POLICY_TAL 0x28 */ 1117 #define IMP_TASK_POLICY_BOOST 0x29 1118 #define IMP_TASK_POLICY_ROLE 0x2A 1119 /* unused 0x2B */ 1120 #define IMP_TASK_POLICY_TERMINATED 0x2C 1121 #define IMP_TASK_POLICY_NEW_SOCKETS_BG 0x2D 1122 #define IMP_TASK_POLICY_SUP_ACTIVE 0x2E 1123 #define IMP_TASK_POLICY_LATENCY_QOS 0x2F 1124 #define IMP_TASK_POLICY_THROUGH_QOS 0x30 1125 #define IMP_TASK_POLICY_WATCHERS_BG 0x31 1126 1127 #define IMP_TASK_POLICY_SFI_MANAGED 0x34 1128 #define IMP_TASK_POLICY_ALL_SOCKETS_BG 0x37 1129 1130 #define IMP_TASK_POLICY_BASE_LATENCY_AND_THROUGHPUT_QOS 0x39 /* latency as value1, throughput as value2 */ 1131 #define IMP_TASK_POLICY_OVERRIDE_LATENCY_AND_THROUGHPUT_QOS 0x3A /* latency as value1, throughput as value2 */ 1132 1133 /* thread only attributes */ 1134 #define IMP_TASK_POLICY_PIDBIND_BG 0x32 1135 /* unused 0x33 */ 1136 /* reserved 0x35 */ 1137 #define IMP_TASK_POLICY_QOS_OVERRIDE 0x36 1138 #define IMP_TASK_POLICY_QOS_AND_RELPRIO 0x38 /* QoS as value1, relative priority as value2 */ 1139 #define IMP_TASK_POLICY_QOS_WORKQ_OVERRIDE 0x3B 1140 #define IMP_TASK_POLICY_QOS_PROMOTE 0x3C 1141 #define IMP_TASK_POLICY_QOS_KEVENT_OVERRIDE 0x3D 1142 #define IMP_TASK_POLICY_QOS_IPC_OVERRIDE IMP_TASK_POLICY_QOS_KEVENT_OVERRIDE /* legacy name */ 1143 #define IMP_TASK_POLICY_QOS_SERVICER_OVERRIDE 0x3E 1144 #define IMP_TASK_POLICY_IOTIER_KEVENT_OVERRIDE 0x3F 1145 #define IMP_TASK_POLICY_WI_DRIVEN 0x40 1146 1147 #define IMP_TASK_POLICY_RUNAWAY_MITIGATION 0x41 1148 1149 /* Codes for IMP_ASSERTION */ 1150 #define IMP_HOLD 0x2 /* Task holds a boost assertion */ 1151 #define IMP_DROP 0x4 /* Task drops a boost assertion */ 1152 #define IMP_EXTERN 0x8 /* boost assertion moved from kernel to userspace responsibility (externalized) */ 1153 1154 /* Codes for IMP_BOOST */ 1155 #define IMP_BOOSTED 0x1 1156 #define IMP_UNBOOSTED 0x2 /* Task drops a boost assertion */ 1157 1158 /* Codes for IMP_MSG */ 1159 #define IMP_MSG_SEND 0x1 /* boosting message sent by donating task on donating port */ 1160 #define IMP_MSG_DELV 0x2 /* boosting message delivered to task */ 1161 1162 /* Codes for IMP_UPDATE */ 1163 #define IMP_UPDATE_TASK_CREATE 0x1 1164 1165 /* Codes for IMP_USYNCH_QOS_OVERRIDE */ 1166 #define IMP_USYNCH_ADD_OVERRIDE 0x0 /* add override for a contended resource */ 1167 #define IMP_USYNCH_REMOVE_OVERRIDE 0x1 /* remove override for a contended resource */ 1168 1169 /* Codes for IMP_DONOR_CHANGE */ 1170 #define IMP_DONOR_UPDATE_LIVE_DONOR_STATE 0x0 1171 #define IMP_DONOR_INIT_DONOR_STATE 0x1 1172 1173 /* Code for IMP_SYNC_IPC_QOS */ 1174 #define IMP_SYNC_IPC_QOS_APPLIED 0x0 1175 #define IMP_SYNC_IPC_QOS_REMOVED 0x1 1176 #define IMP_SYNC_IPC_QOS_OVERFLOW 0x2 1177 #define IMP_SYNC_IPC_QOS_UNDERFLOW 0x3 1178 1179 /* Subclasses for Turnstiles (DBG_TURNSTILE) */ 1180 #define TURNSTILE_HEAP_OPERATIONS 0x10 1181 #define TURNSTILE_PRIORITY_OPERATIONS 0x20 1182 #define TURNSTILE_FREELIST_OPERATIONS 0x30 1183 1184 /* Codes for TURNSTILE_HEAP_OPERATIONS */ 1185 #define THREAD_ADDED_TO_TURNSTILE_WAITQ 0x1 1186 #define THREAD_REMOVED_FROM_TURNSTILE_WAITQ 0x2 1187 #define THREAD_MOVED_IN_TURNSTILE_WAITQ 0x3 1188 #define TURNSTILE_ADDED_TO_TURNSTILE_HEAP 0x4 1189 #define TURNSTILE_REMOVED_FROM_TURNSTILE_HEAP 0x5 1190 #define TURNSTILE_MOVED_IN_TURNSTILE_HEAP 0x6 1191 #define TURNSTILE_ADDED_TO_THREAD_HEAP 0x7 1192 #define TURNSTILE_REMOVED_FROM_THREAD_HEAP 0x8 1193 #define TURNSTILE_MOVED_IN_THREAD_HEAP 0x9 1194 #define TURNSTILE_UPDATE_STOPPED_BY_LIMIT 0xa 1195 #define THREAD_NOT_WAITING_ON_TURNSTILE 0xb 1196 1197 /* Codes for TURNSTILE_PRIORITY_OPERATIONS */ 1198 #define TURNSTILE_PRIORITY_CHANGE 0x1 1199 #define THREAD_USER_PROMOTION_CHANGE 0x2 1200 1201 /* Codes for TURNSTILE_FREELIST_OPERATIONS */ 1202 #define TURNSTILE_PREPARE 0x1 1203 #define TURNSTILE_COMPLETE 0x2 1204 1205 /* Subclasses for MACH Bank Voucher Attribute Manager (DBG_BANK) */ 1206 #define BANK_ACCOUNT_INFO 0x10 /* Trace points related to bank account struct */ 1207 #define BANK_TASK_INFO 0x11 /* Trace points related to bank task struct */ 1208 1209 /* Subclasses for MACH ATM Voucher Attribute Manager (ATM) */ 1210 #define ATM_SUBAID_INFO 0x10 1211 #define ATM_GETVALUE_INFO 0x20 1212 #define ATM_UNREGISTER_INFO 0x30 1213 1214 /* Codes for BANK_ACCOUNT_INFO */ 1215 #define BANK_SETTLE_CPU_TIME 0x1 /* Bank ledger(chit) rolled up to tasks. */ 1216 #define BANK_SECURE_ORIGINATOR_CHANGED 0x2 /* Secure Originator changed. */ 1217 #define BANK_SETTLE_ENERGY 0x3 /* Bank ledger(energy field) rolled up to tasks. */ 1218 1219 /* Codes for ATM_SUBAID_INFO */ 1220 #define ATM_MIN_CALLED 0x1 1221 #define ATM_LINK_LIST_TRIM 0x2 1222 1223 /* Codes for ATM_GETVALUE_INFO */ 1224 #define ATM_VALUE_REPLACED 0x1 1225 #define ATM_VALUE_ADDED 0x2 1226 1227 /* Codes for ATM_UNREGISTER_INFO */ 1228 #define ATM_VALUE_UNREGISTERED 0x1 1229 #define ATM_VALUE_DIFF_MAILBOX 0x2 1230 1231 /* Kernel Debug Sub Classes for daemons (DBG_DAEMON) */ 1232 #define DBG_DAEMON_COREDUET 0x1 1233 #define DBG_DAEMON_POWERD 0x2 1234 1235 /* Subclasses for the user space allocator */ 1236 #define DBG_UMALLOC_EXTERNAL 0x1 1237 #define DBG_UMALLOC_INTERNAL 0x2 1238 1239 #pragma mark - subsystem event ID macros 1240 1241 #define KDBG_MIGCODE(msgid) (((unsigned)DBG_MIG << KDBG_CLASS_OFFSET) | \ 1242 ((unsigned)((msgid) & 0x3fffff) << KDBG_CODE_OFFSET)) 1243 1244 #define MACHDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_MACH, SubClass, code) 1245 #define NETDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_NETWORK, SubClass, code) 1246 #define FSDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_FSYSTEM, SubClass, code) 1247 #define BSDDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_BSD, SubClass, code) 1248 #define IOKDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_IOKIT, SubClass, code) 1249 #define DRVDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_DRIVERS, SubClass, code) 1250 #define TRACEDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_TRACE, SubClass, code) 1251 #define SILICONDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_SILICON, SubClass, code) 1252 #define MISCDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_MISC, SubClass, code) 1253 #define DLILDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_DLIL, SubClass, code) 1254 #define SECURITYDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_SECURITY, SubClass, code) 1255 #define DYLDDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_DYLD, SubClass, code) 1256 #define QTDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_QT, SubClass, code) 1257 #define APPSDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_APPS, SubClass, code) 1258 #define ARIADNEDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_ARIADNE, SubClass, code) 1259 #define DAEMONDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_DAEMON, SubClass, code) 1260 #define CPUPM_CODE(code) IOKDBG_CODE(DBG_IOCPUPM, code) 1261 #define MTDBG_CODE(SubClass, code) KDBG_EVENTID(DBG_MONOTONIC, SubClass, code) 1262 #define MTDBG_RESOURCES_ON_PROC_EXIT(code) MTDBG_CODE(DBG_MT_RESOURCES_PROC_EXIT, code) 1263 #define MTDBG_RESOURCES_ON_THR_EXIT(code) MTDBG_CODE(DBG_MT_RESOURCES_THR_EXIT, code) 1264 1265 #define KMEM_ALLOC_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 0) 1266 #define KMEM_ALLOC_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 1) 1267 #define KMEM_FREE_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 2) 1268 #define KMEM_FREE_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 3) 1269 #define ZALLOC_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 4) 1270 #define ZALLOC_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 5) 1271 #define ZFREE_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 6) 1272 #define ZFREE_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 7) 1273 1274 #define MEMSTAT_CODE(code) BSDDBG_CODE(DBG_BSD_MEMSTAT, code) 1275 1276 #define VM_RECLAIM_CODE(code) MACHDBG_CODE(DBG_MACH_VM_RECLAIM, code) 1277 #define VMDBG_CODE(code) MACHDBG_CODE(DBG_MACH_VM, code) 1278 #define VM_COMPRESSOR_EVENTID(code) KDBG_EVENTID(DBG_MACH, DBG_MACH_VM_COMPRESSOR, code) 1279 1280 #define PMAP_CODE(code) MACHDBG_CODE(DBG_MACH_PMAP, code) 1281 1282 #define IMPORTANCE_CODE(SubClass, code) KDBG_EVENTID(DBG_IMPORTANCE, (SubClass), (code)) 1283 #define BANK_CODE(SubClass, code) KDBG_EVENTID(DBG_BANK, (SubClass), (code)) 1284 #define ATM_CODE(SubClass, code) KDBG_EVENTID(DBG_ATM, (SubClass), (code)) 1285 #define TURNSTILE_CODE(SubClass, code) KDBG_EVENTID(DBG_TURNSTILE, (SubClass), (code)) 1286 1287 // Kernel Debug Macros for specific daemons 1288 #define COREDUETDBG_CODE(code) DAEMONDBG_CODE(DBG_DAEMON_COREDUET, code) 1289 #define POWERDDBG_CODE(code) DAEMONDBG_CODE(DBG_DAEMON_POWERD, code) 1290 1291 #define MEMINFO_CODE(code) KDBG_EVENTID(DBG_MACH, DBG_MACH_MEMINFO, code) 1292 1293 // VFS lookup events 1294 #define VFS_LOOKUP (FSDBG_CODE(DBG_FSRW,36)) 1295 #define VFS_LOOKUP_DONE (FSDBG_CODE(DBG_FSRW,39)) 1296 1297 // Deprecated macro using legacy naming convention. 1298 #define KDBG_CODE(Class, SubClass, Code) KDBG_EVENTID(Class, SubClass, Code) 1299 1300 /* Kernel trace events associated with timers and timer queues */ 1301 #define DECR_TRAP_LATENCY MACHDBG_CODE(DBG_MACH_EXCP_DECI, 0) 1302 #define DECR_SET_DEADLINE MACHDBG_CODE(DBG_MACH_EXCP_DECI, 1) 1303 #define DECR_TIMER_CALLOUT MACHDBG_CODE(DBG_MACH_EXCP_DECI, 2) 1304 #define DECR_PM_DEADLINE MACHDBG_CODE(DBG_MACH_EXCP_DECI, 3) 1305 #define DECR_TIMER_MIGRATE MACHDBG_CODE(DBG_MACH_EXCP_DECI, 4) 1306 #if defined(i386) || defined(x86_64) 1307 #define DECR_RDHPET MACHDBG_CODE(DBG_MACH_EXCP_DECI, 5) 1308 #define DECR_SET_TSC_DEADLINE MACHDBG_CODE(DBG_MACH_EXCP_DECI, 6) 1309 #define DECR_SET_APIC_DEADLINE MACHDBG_CODE(DBG_MACH_EXCP_DECI, 16) 1310 #endif 1311 #define DECR_TIMER_ENTER MACHDBG_CODE(DBG_MACH_EXCP_DECI, 7) 1312 #define DECR_TIMER_CANCEL MACHDBG_CODE(DBG_MACH_EXCP_DECI, 8) 1313 #define DECR_TIMER_QUEUE MACHDBG_CODE(DBG_MACH_EXCP_DECI, 9) 1314 #define DECR_TIMER_EXPIRE MACHDBG_CODE(DBG_MACH_EXCP_DECI,10) 1315 #define DECR_TIMER_ASYNC_DEQ MACHDBG_CODE(DBG_MACH_EXCP_DECI,11) 1316 #define DECR_TIMER_UPDATE MACHDBG_CODE(DBG_MACH_EXCP_DECI,12) 1317 #define DECR_TIMER_ESCALATE MACHDBG_CODE(DBG_MACH_EXCP_DECI,13) 1318 #define DECR_TIMER_OVERDUE MACHDBG_CODE(DBG_MACH_EXCP_DECI,14) 1319 #define DECR_TIMER_RESCAN MACHDBG_CODE(DBG_MACH_EXCP_DECI,15) 1320 #define DECR_TIMER_PAUSE MACHDBG_CODE(DBG_MACH_EXCP_DECI,17) 1321 #define DECR_TIMER_POSTPONE MACHDBG_CODE(DBG_MACH_EXCP_DECI,18) 1322 #define DECR_TIMER_SHUTDOWN MACHDBG_CODE(DBG_MACH_EXCP_DECI,19) 1323 #define DECR_TIMER_EXPIRE_LOCAL MACHDBG_CODE(DBG_MACH_EXCP_DECI,20) 1324 1325 #endif // __APPLE_API_UNSTABLE 1326 1327 __END_DECLS 1328 1329 #if defined(KERNEL) || defined(PRIVATE) 1330 #include <sys/kdebug_private.h> 1331 #endif // defined(KERNEL) || defined(PRIVATE) 1332 1333 #ifdef KERNEL 1334 #include <sys/kdebug_kernel.h> 1335 #endif // defined(KERNEL) 1336 1337 #endif // !defined(BSD_SYS_KDEBUG_H) 1338