/*
- * Copyright (c) 2000-2014 Apple Inc. All rights reserved.
+ * Copyright (c) 2000-2016 Apple Inc. All rights reserved.
*
* @APPLE_OSREFERENCE_LICENSE_HEADER_START@
*
* @APPLE_OSREFERENCE_LICENSE_HEADER_END@
*/
-/* Copyright (c) 1997 Apple Computer, Inc. All rights reserved.
- *
- * kdebug.h - kernel_debug definitions
- *
+/*
+ * kdebug.h - kernel_debug definitions
*/
#ifndef BSD_SYS_KDEBUG_H
#include <sys/appleapiopts.h>
#include <sys/cdefs.h>
+
__BEGIN_DECLS
#ifdef __APPLE_API_UNSTABLE
#include <Availability.h>
#endif
-#ifdef XNU_KERNEL_PRIVATE
-#include <stdint.h>
-#include <mach/branch_predicates.h>
+#ifdef XNU_KERNEL_PRIVATE
+#include <mach/branch_predicates.h> /* __improbable */
#endif
/*
* Kdebug is a facility for tracing events occurring on a system.
*
- * All events are tagged with a debugid, consisting of the following:
+ * All events are tagged with a 32-bit debugid:
*
* +----------------+----------------+----------------------------+----+
* | Class (8) | Subclass (8) | Code (14) |Func|
* | | | |(2) |
* +----------------+----------------+----------------------------+----+
- * \______________________________________________________________/
- * Eventid
+ * \_________________________________/
+ * ClassSubclass (CSC)
+ * \________________________________________________________________00_/
+ * Eventid
* \___________________________________________________________________/
* Debugid
*
* The eventid is a hierarchical ID, indicating which components an event is
* referring to. The debugid includes an eventid and two function qualifier
* bits, to determine the structural significance of an event (whether it
- * starts or ends a series of grouped events).
+ * starts or ends an interval).
*/
#define KDBG_CLASS_MASK (0xff000000)
/* class and subclass mask */
#define KDBG_CSC_MASK (0xffff0000)
#define KDBG_CSC_OFFSET (KDBG_SUBCLASS_OFFSET)
+#define KDBG_CSC_MAX (0xffff)
#define KDBG_CODE_MASK (0x0000fffc)
#define KDBG_CODE_OFFSET (2)
#define KDBG_CODE_MAX (0x3fff)
#define KDBG_EVENTID_MASK (0xfffffffc)
+#define KDBG_FUNC_MASK (0x00000003)
/* Generate an eventid corresponding to Class, SubClass, and Code. */
#define KDBG_EVENTID(Class, SubClass, Code) \
#define KDBG_EXTRACT_CODE(Debugid) \
((uint16_t)(((Debugid) & KDBG_CODE_MASK) >> KDBG_CODE_OFFSET))
+/* function qualifiers */
+#define DBG_FUNC_START 1
+#define DBG_FUNC_END 2
+#define DBG_FUNC_NONE 0
+
+/*
+ * Definitions to support IOP tracing.
+ */
+
#ifdef KERNEL_PRIVATE
-typedef enum
-{
- KD_CALLBACK_KDEBUG_ENABLED, // Trace is now enabled. No arguments
- KD_CALLBACK_KDEBUG_DISABLED, // Trace is now disabled. No arguments
- KD_CALLBACK_SYNC_FLUSH, // Request the latest entries from the IOP, and block until complete. No arguments
- KD_CALLBACK_TYPEFILTER_CHANGED, // Typefilter is enabled. A read-only pointer to the typefilter is provided, but is only valid while in the callback.
+typedef enum {
+ /* Trace is now enabled; no arguments. */
+ KD_CALLBACK_KDEBUG_ENABLED,
+ /* Trace is now disabled; no arguments. */
+ KD_CALLBACK_KDEBUG_DISABLED,
+ /*
+ * Request the latest entries from the IOP and block until complete; no
+ * arguments.
+ */
+ KD_CALLBACK_SYNC_FLUSH,
+ /*
+ * The typefilter is enabled; a read-only pointer to the typefilter is
+ * provided, valid only while in the callback.
+ */
+ KD_CALLBACK_TYPEFILTER_CHANGED,
} kd_callback_type;
typedef void (*kd_callback_fn) (void* context, kd_callback_type reason, void* arg);
struct kd_callback {
- kd_callback_fn func;
- void* context;
- char iop_name[8]; // null-terminated string with name of core.
+ kd_callback_fn func;
+ void *context;
+ /* name of IOP, NUL-terminated */
+ char iop_name[8];
};
typedef struct kd_callback kd_callback_t;
* kernel_debug_enter() to refer to your IOP. If the allocation
* failed, then 0 will be returned.
*
- *
* Caveats:
* Note that not all callback calls will indicate a change in
* state (e.g. disabling trace twice would send two disable
* notifications).
- *
*/
extern int kernel_debug_register_callback(kd_callback_t callback);
extern void kernel_debug_enter(
- uint32_t coreid,
- uint32_t debugid,
- uint64_t timestamp,
- uintptr_t arg1,
- uintptr_t arg2,
- uintptr_t arg3,
- uintptr_t arg4,
- uintptr_t threadid
+ uint32_t coreid,
+ uint32_t debugid,
+ uint64_t timestamp,
+ uintptr_t arg1,
+ uintptr_t arg2,
+ uintptr_t arg3,
+ uintptr_t arg4,
+ uintptr_t threadid
);
#endif /* KERNEL_PRIVATE */
-/* The Function qualifiers */
-#define DBG_FUNC_START 1
-#define DBG_FUNC_END 2
-#define DBG_FUNC_NONE 0
-
/* The Kernel Debug Classes */
-#define DBG_MACH 1
-#define DBG_NETWORK 2
-#define DBG_FSYSTEM 3
-#define DBG_BSD 4
-#define DBG_IOKIT 5
-#define DBG_DRIVERS 6
-#define DBG_TRACE 7
-#define DBG_DLIL 8
-#define DBG_WORKQUEUE 9
-#define DBG_CORESTORAGE 10
-#define DBG_CG 11
-#define DBG_MISC 20
-#define DBG_SECURITY 30
-#define DBG_DYLD 31
-#define DBG_QT 32
-#define DBG_APPS 33
-#define DBG_LAUNCHD 34
-#define DBG_PERF 37
-#define DBG_IMPORTANCE 38
-#define DBG_BANK 40
-#define DBG_XPC 41
-#define DBG_ATM 42
-#define DBG_ARIADNE 43
-#define DBG_DAEMON 44
-#define DBG_ENERGYTRACE 45
-
-
-#define DBG_MIG 255
+#define DBG_MACH 1
+#define DBG_NETWORK 2
+#define DBG_FSYSTEM 3
+#define DBG_BSD 4
+#define DBG_IOKIT 5
+#define DBG_DRIVERS 6
+#define DBG_TRACE 7
+#define DBG_DLIL 8
+#define DBG_WORKQUEUE 9
+#define DBG_CORESTORAGE 10
+#define DBG_CG 11
+#define DBG_MONOTONIC 12
+#define DBG_MISC 20
+#define DBG_SECURITY 30
+#define DBG_DYLD 31
+#define DBG_QT 32
+#define DBG_APPS 33
+#define DBG_LAUNCHD 34
+#define DBG_PERF 37
+#define DBG_IMPORTANCE 38
+#define DBG_BANK 40
+#define DBG_XPC 41
+#define DBG_ATM 42
+#define DBG_ARIADNE 43
+#define DBG_DAEMON 44
+#define DBG_ENERGYTRACE 45
+#define DBG_DISPATCH 46
+#define DBG_IMG 49
+#define DBG_UMALLOC 51
+
+
+#define DBG_MIG 255
#ifdef PRIVATE
+
+/*
+ * Private kdebug userspace API
+ */
+#ifndef KERNEL
+#include <stdbool.h>
+
/*
* OS components can use the full precision of the "code" field
* (Class, SubClass, Code) to inject events using kdebug_trace() by
*
* On error, -1 will be returned and errno will indicate the error.
*/
-#ifndef KERNEL
-extern int kdebug_trace(uint32_t code, uint64_t arg1, uint64_t arg2, uint64_t arg3, uint64_t arg4) __OSX_AVAILABLE_STARTING(__MAC_10_10_2, __IPHONE_8_2);
-#endif
+extern int kdebug_trace(
+ uint32_t code,
+ uint64_t arg1,
+ uint64_t arg2,
+ uint64_t arg3,
+ uint64_t arg4)
+ __OSX_AVAILABLE(10.10.2) __IOS_AVAILABLE(8.2);
/*!
* @function kdebug_trace_string
* EFAULT
* `str` is an invalid address or NULL when `str_id` is 0.
*/
-#ifndef KERNEL
extern uint64_t kdebug_trace_string(uint32_t debugid, uint64_t str_id,
const char *str)
-__OSX_AVAILABLE_STARTING(__MAC_10_11, __IPHONE_9_0);
-#endif
+ __OSX_AVAILABLE(10.11) __IOS_AVAILABLE(9.0);
+
+/*
+ * Although the performance impact of kdebug_trace() when kernel
+ * tracing is not enabled is minimal, it may require the caller to
+ * perform an expensive calculation/summarization. This cost can be
+ * skipped by checking the kdebug_is_enabled() predicate:
+ *
+ * if (kdebug_is_enabled(KDBG_CODE(DBG_XPC, 15, 1))) {
+ * uint64_t arg1 = ...;
+ * uint64_t arg2 = ...;
+ * kdebug_trace(KDBG_CODE(DBG_XPC, 15, 1) | DBG_FUNC_NONE, arg1, arg2, 0, 0);
+ * }
+ *
+ * If tracing is enabled for the code at the time of the check, 1
+ * will be returned. Otherwise, 0 will be returned.
+ */
+extern bool kdebug_is_enabled(uint32_t code)
+ __OSX_AVAILABLE(10.12) __IOS_AVAILABLE(10.0)
+ __WATCHOS_AVAILABLE(3.0) __TVOS_AVAILABLE(10.0);
+
+/*
+ * Returns a pointer to the userspace typefilter, if one is available.
+ * May return NULL.
+ */
+extern void *kdebug_typefilter(void)
+ __OSX_AVAILABLE(10.12) __IOS_AVAILABLE(10.0)
+ __WATCHOS_AVAILABLE(3.0) __TVOS_AVAILABLE(10.0);
+
+#endif /* !KERNEL (Private kdebug userspace API) */
#endif /* PRIVATE */
#ifdef XNU_KERNEL_PRIVATE
/* Used in early boot to log strings spanning only a single tracepoint. */
-extern void kernel_debug_string_simple(const char *message);
+extern void kernel_debug_string_early(const char *message);
+/* Used to trace strings within kdebug tracepoints on arbitrary eventids. */
+extern void kernel_debug_string_simple(uint32_t eventid, const char *str);
+/* Only used by ktrace to reset kdebug. ktrace_lock must be held. */
+extern void kdebug_reset(void);
#endif /* XNU_KERNEL_PRIVATE */
/* **** The Kernel Debug Sub Classes for Mach (DBG_MACH) **** */
-#define DBG_MACH_EXCP_KTRAP_x86 0x02 /* Kernel Traps on x86 */
-#define DBG_MACH_EXCP_DFLT 0x03 /* Data Translation Fault */
-#define DBG_MACH_EXCP_IFLT 0x04 /* Inst Translation Fault */
-#define DBG_MACH_EXCP_INTR 0x05 /* Interrupts */
-#define DBG_MACH_EXCP_ALNG 0x06 /* Alignment Exception */
-#define DBG_MACH_EXCP_UTRAP_x86 0x07 /* User Traps on x86 */
-#define DBG_MACH_EXCP_FP 0x08 /* FP Unavail */
-#define DBG_MACH_EXCP_DECI 0x09 /* Decrementer Interrupt */
-#define DBG_MACH_CHUD 0x0A /* CHUD */
-#define DBG_MACH_EXCP_SC 0x0C /* System Calls */
-#define DBG_MACH_EXCP_TRACE 0x0D /* Trace exception */
-#define DBG_MACH_EXCP_EMUL 0x0E /* Instruction emulated */
-#define DBG_MACH_IHDLR 0x10 /* Interrupt Handlers */
-#define DBG_MACH_IPC 0x20 /* Inter Process Comm */
-#define DBG_MACH_VM 0x30 /* Virtual Memory */
-#define DBG_MACH_LEAKS 0x31 /* alloc/free */
-#define DBG_MACH_SCHED 0x40 /* Scheduler */
-#define DBG_MACH_MSGID_INVALID 0x50 /* Messages - invalid */
-#define DBG_MACH_LOCKS 0x60 /* new lock APIs */
-#define DBG_MACH_PMAP 0x70 /* pmap */
-#define DBG_MACH_CLOCK 0x80 /* clock */
-#define DBG_MACH_MP 0x90 /* MP related */
-#define DBG_MACH_VM_PRESSURE 0xA0 /* Memory Pressure Events */
-#define DBG_MACH_STACKSHOT 0xA1 /* Stackshot/Microstackshot subsystem */
-#define DBG_MACH_SFI 0xA2 /* Selective Forced Idle (SFI) */
-#define DBG_MACH_ENERGY_PERF 0xA3 /* Energy/performance resource stats */
-#define DBG_MACH_SYSDIAGNOSE 0xA4 /* sysdiagnose keychord */
-#define DBG_MACH_ZALLOC 0xA5 /* Zone allocator */
+#define DBG_MACH_EXCP_KTRAP_x86 0x02 /* Kernel Traps on x86 */
+#define DBG_MACH_EXCP_DFLT 0x03 /* Data Translation Fault */
+#define DBG_MACH_EXCP_IFLT 0x04 /* Inst Translation Fault */
+#define DBG_MACH_EXCP_INTR 0x05 /* Interrupts */
+#define DBG_MACH_EXCP_ALNG 0x06 /* Alignment Exception */
+#define DBG_MACH_EXCP_UTRAP_x86 0x07 /* User Traps on x86 */
+#define DBG_MACH_EXCP_FP 0x08 /* FP Unavail */
+#define DBG_MACH_EXCP_DECI 0x09 /* Decrementer Interrupt */
+#define DBG_MACH_CHUD 0x0A /* deprecated name */
+#define DBG_MACH_SIGNPOST 0x0A /* kernel signposts */
+#define DBG_MACH_EXCP_SC 0x0C /* System Calls */
+#define DBG_MACH_EXCP_TRACE 0x0D /* Trace exception */
+#define DBG_MACH_EXCP_EMUL 0x0E /* Instruction emulated */
+#define DBG_MACH_IHDLR 0x10 /* Interrupt Handlers */
+#define DBG_MACH_IPC 0x20 /* Inter Process Comm */
+#define DBG_MACH_RESOURCE 0x25 /* tracing limits, etc */
+#define DBG_MACH_VM 0x30 /* Virtual Memory */
+#define DBG_MACH_LEAKS 0x31 /* alloc/free */
+#define DBG_MACH_WORKINGSET 0x32 /* private subclass for working set related debugging */
+#define DBG_MACH_SCHED 0x40 /* Scheduler */
+#define DBG_MACH_MSGID_INVALID 0x50 /* Messages - invalid */
+#define DBG_MACH_LOCKS 0x60 /* new lock APIs */
+#define DBG_MACH_PMAP 0x70 /* pmap */
+#define DBG_MACH_CLOCK 0x80 /* clock */
+#define DBG_MACH_MP 0x90 /* MP related */
+#define DBG_MACH_VM_PRESSURE 0xA0 /* Memory Pressure Events */
+#define DBG_MACH_STACKSHOT 0xA1 /* Stackshot/Microstackshot subsystem */
+#define DBG_MACH_SFI 0xA2 /* Selective Forced Idle (SFI) */
+#define DBG_MACH_ENERGY_PERF 0xA3 /* Energy/performance resource stats */
+#define DBG_MACH_SYSDIAGNOSE 0xA4 /* sysdiagnose */
+#define DBG_MACH_ZALLOC 0xA5 /* Zone allocator */
+#define DBG_MACH_THREAD_GROUP 0xA6 /* Thread groups */
+#define DBG_MACH_COALITION 0xA7 /* Coalitions */
+
+/* Interrupt type bits for DBG_MACH_EXCP_INTR */
+#define DBG_INTR_TYPE_UNKNOWN 0x0 /* default/unknown interrupt */
+#define DBG_INTR_TYPE_IPI 0x1 /* interprocessor interrupt */
+#define DBG_INTR_TYPE_TIMER 0x2 /* timer interrupt */
+#define DBG_INTR_TYPE_OTHER 0x3 /* other (usually external) interrupt */
/* Codes for Scheduler (DBG_MACH_SCHED) */
#define MACH_SCHED 0x0 /* Scheduler */
#define MACH_IDLE 0x9 /* processor idling */
#define MACH_STACK_DEPTH 0xa /* stack depth at switch */
#define MACH_MOVED 0xb /* did not use original scheduling decision */
-/* unused 0xc */
-/* unused 0xd */
+#define MACH_PSET_LOAD_AVERAGE 0xc
+#define MACH_AMP_DEBUG 0xd
#define MACH_FAILSAFE 0xe /* tripped fixed-pri/RT failsafe */
#define MACH_BLOCK 0xf /* thread block */
#define MACH_WAIT 0x10 /* thread wait assertion */
#define MACH_THREAD_BIND 0x2a /* Thread was bound (or unbound) to a processor */
#define MACH_WAITQ_PROMOTE 0x2b /* Thread promoted by waitq boost */
#define MACH_WAITQ_DEMOTE 0x2c /* Thread demoted from waitq boost */
+#define MACH_SCHED_LOAD 0x2d /* load update */
+#define MACH_REC_CORES_FAILSAFE 0x2e /* recommended processor failsafe kicked in */
+#define MACH_SCHED_QUANTUM_EXPIRED 0x2f /* thread quantum expired */
+#define MACH_EXEC_PROMOTE 0x30 /* Thread promoted by exec boost */
+#define MACH_EXEC_DEMOTE 0x31 /* Thread demoted from exec boost */
+#define MACH_AMP_SIGNAL_SPILL 0x32 /* AMP spill signal sent to cpuid */
+#define MACH_AMP_STEAL 0x33 /* AMP thread stolen or spilled */
/* Variants for MACH_MULTIQ_DEQUEUE */
#define MACH_MULTIQ_BOUND 1
#define MACH_IPC_VOUCHER_CREATE 0x7 /* Voucher added to global voucher hashtable */
#define MACH_IPC_VOUCHER_CREATE_ATTR_DATA 0x8 /* Attr data for newly created voucher */
#define MACH_IPC_VOUCHER_DESTROY 0x9 /* Voucher removed from global voucher hashtable */
+#define MACH_IPC_KMSG_INFO 0xa /* Send/Receive info for a kmsg */
+#define MACH_IPC_KMSG_LINK 0xb /* link a kernel kmsg pointer to user mach_msg_header_t */
+
+/* Codes for thread groups (DBG_MACH_THREAD_GROUP) */
+#define MACH_THREAD_GROUP_NEW 0x0
+#define MACH_THREAD_GROUP_FREE 0x1
+#define MACH_THREAD_GROUP_SET 0x2
+#define MACH_THREAD_GROUP_NAME 0x3
+#define MACH_THREAD_GROUP_NAME_FREE 0x4
+#define MACH_THREAD_GROUP_FLAGS 0x5
+
+/* Codes for coalitions (DBG_MACH_COALITION) */
+#define MACH_COALITION_NEW 0x0
+#define MACH_COALITION_FREE 0x1
+#define MACH_COALITION_ADOPT 0x2
+#define MACH_COALITION_REMOVE 0x3
+#define MACH_COALITION_THREAD_GROUP_SET 0x4
/* Codes for pmap (DBG_MACH_PMAP) */
#define PMAP__CREATE 0x0
#define PMAP__FLUSH_TLBS 0x8
#define PMAP__UPDATE_INTERRUPT 0x9
#define PMAP__ATTRIBUTE_CLEAR 0xa
-#define PMAP__REUSABLE 0xb
+#define PMAP__REUSABLE 0xb /* This appears to be unused */
#define PMAP__QUERY_RESIDENT 0xc
#define PMAP__FLUSH_KERN_TLBS 0xd
#define PMAP__FLUSH_DELAYED_TLBS 0xe
#define PMAP__FLUSH_TLBS_TO 0xf
#define PMAP__FLUSH_EPT 0x10
+#define PMAP__FAST_FAULT 0x11
/* Codes for clock (DBG_MACH_CLOCK) */
#define MACH_EPOCH_CHANGE 0x0 /* wake epoch change */
-
/* Codes for Stackshot/Microstackshot (DBG_MACH_STACKSHOT) */
#define MICROSTACKSHOT_RECORD 0x0
#define MICROSTACKSHOT_GATHER 0x1
-/* Codes for sysdiagnose */
-#define SYSDIAGNOSE_NOTIFY_USER 0x0
+/* Codes for sysdiagnose (DBG_MACH_SYSDIAGNOSE) */
+#define SYSDIAGNOSE_NOTIFY_USER 0x0
+#define SYSDIAGNOSE_FULL 0x1
+#define SYSDIAGNOSE_STACKSHOT 0x2
+#define SYSDIAGNOSE_TAILSPIN 0x3
/* Codes for Selective Forced Idle (DBG_MACH_SFI) */
#define SFI_SET_WINDOW 0x0
/* Codes for Zone Allocator (DBG_MACH_ZALLOC) */
#define ZALLOC_ZCRAM 0x0
+/* Codes for Mach resource management (DBG_MACH_RESOURCE) */
+/* _K32A/B codes start at double the low nibble */
+#define RMON_ENABLE_CPUUSAGE_MONITOR 0x001
+#define RMON_CPUUSAGE_VIOLATED 0x002
+#define RMON_CPUUSAGE_SUSPENDED 0x003
+#define RMON_CPUUSAGE_VIOLATED_K32A 0x004
+#define RMON_CPUUSAGE_VIOLATED_K32B 0x005
+#define RMON_CPUUSAGE_RESUMED 0x006
+#define RMON_DISABLE_CPUUSAGE_MONITOR 0x00f
+
+#define RMON_ENABLE_CPUWAKES_MONITOR 0x011
+#define RMON_CPUWAKES_VIOLATED 0x012
+#define RMON_CPUWAKES_VIOLATED_K32A 0x014
+#define RMON_CPUWAKES_VIOLATED_K32B 0x015
+#define RMON_DISABLE_CPUWAKES_MONITOR 0x01f
+
+#define RMON_ENABLE_IO_MONITOR 0x021
+#define RMON_LOGWRITES_VIOLATED 0x022
+#define RMON_PHYSWRITES_VIOLATED 0x023
+#define RMON_LOGWRITES_VIOLATED_K32A 0x024
+#define RMON_LOGWRITES_VIOLATED_K32B 0x025
+#define RMON_DISABLE_IO_MONITOR 0x02f
+
/* **** The Kernel Debug Sub Classes for Network (DBG_NETWORK) **** */
#define DBG_NETIP 1 /* Internet Protocol */
#define DBG_NETARP 2 /* Address Resolution Protocol */
#define DBG_IOMDESC 6 /* Memory Descriptors */
#define DBG_IOPOWER 7 /* Power Managerment */
#define DBG_IOSERVICE 8 /* Matching etc. */
+#define DBG_IOREGISTRY 9 /* Registry */
/* **** 9-32 reserved for internal IOKit usage **** */
#define DBG_IOGRAPHICS 50 /* Graphics */
#define DBG_HIBERNATE 51 /* hibernation related events */
#define DBG_IOTHUNDERBOLT 52 /* Thunderbolt */
-
+#define DBG_BOOTER 53 /* booter related events */
/* Backwards compatibility */
#define DBG_IOPOINTING DBG_IOHID /* OBSOLETE: Use DBG_IOHID instead */
#define DBG_IODISK DBG_IOSTORAGE /* OBSOLETE: Use DBG_IOSTORAGE instead */
/* **** The Kernel Debug Sub Classes for Device Drivers (DBG_DRIVERS) **** */
-#define DBG_DRVSTORAGE 1 /* Storage layers */
-#define DBG_DRVNETWORK 2 /* Network layers */
-#define DBG_DRVKEYBOARD 3 /* Keyboard */
-#define DBG_DRVHID 4 /* HID Devices */
-#define DBG_DRVAUDIO 5 /* Audio */
-#define DBG_DRVSERIAL 7 /* Serial */
-#define DBG_DRVSAM 8 /* SCSI Architecture Model layers */
-#define DBG_DRVPARALLELATA 9 /* Parallel ATA */
-#define DBG_DRVPARALLELSCSI 10 /* Parallel SCSI */
-#define DBG_DRVSATA 11 /* Serial ATA */
-#define DBG_DRVSAS 12 /* SAS */
-#define DBG_DRVFIBRECHANNEL 13 /* FiberChannel */
-#define DBG_DRVUSB 14 /* USB */
-#define DBG_DRVBLUETOOTH 15 /* Bluetooth */
-#define DBG_DRVFIREWIRE 16 /* FireWire */
-#define DBG_DRVINFINIBAND 17 /* Infiniband */
-#define DBG_DRVGRAPHICS 18 /* Graphics */
-#define DBG_DRVSD 19 /* Secure Digital */
-#define DBG_DRVNAND 20 /* NAND drivers and layers */
-#define DBG_SSD 21 /* SSD */
-#define DBG_DRVSPI 22 /* SPI */
+#define DBG_DRVSTORAGE 1 /* Storage layers */
+#define DBG_DRVNETWORK 2 /* Network layers */
+#define DBG_DRVKEYBOARD 3 /* Keyboard */
+#define DBG_DRVHID 4 /* HID Devices */
+#define DBG_DRVAUDIO 5 /* Audio */
+#define DBG_DRVSERIAL 7 /* Serial */
+#define DBG_DRVSAM 8 /* SCSI Architecture Model layers */
+#define DBG_DRVPARALLELATA 9 /* Parallel ATA */
+#define DBG_DRVPARALLELSCSI 10 /* Parallel SCSI */
+#define DBG_DRVSATA 11 /* Serial ATA */
+#define DBG_DRVSAS 12 /* SAS */
+#define DBG_DRVFIBRECHANNEL 13 /* FiberChannel */
+#define DBG_DRVUSB 14 /* USB */
+#define DBG_DRVBLUETOOTH 15 /* Bluetooth */
+#define DBG_DRVFIREWIRE 16 /* FireWire */
+#define DBG_DRVINFINIBAND 17 /* Infiniband */
+#define DBG_DRVGRAPHICS 18 /* Graphics */
+#define DBG_DRVSD 19 /* Secure Digital */
+#define DBG_DRVNAND 20 /* NAND drivers and layers */
+#define DBG_SSD 21 /* SSD */
+#define DBG_DRVSPI 22 /* SPI */
+#define DBG_DRVWLAN_802_11 23 /* WLAN 802.11 */
+#define DBG_DRVSSM 24 /* System State Manager(AppleSSM) */
+#define DBG_DRVSMC 25 /* System Management Controller */
+#define DBG_DRVMACEFIMANAGER 26 /* Mac EFI Manager */
/* Backwards compatibility */
#define DBG_DRVPOINTING DBG_DRVHID /* OBSOLETE: Use DBG_DRVHID instead */
#define DBG_DLIL_PR_FLT 4 /* DLIL Protocol Filter */
#define DBG_DLIL_IF_FLT 5 /* DLIL Interface FIlter */
+
/* The Kernel Debug Sub Classes for File System (DBG_FSYSTEM) */
-#define DBG_FSRW 1 /* reads and writes to the filesystem */
-#define DBG_DKRW 2 /* reads and writes to the disk */
-#define DBG_FSVN 3 /* vnode operations (inc. locking/unlocking) */
-#define DBG_FSLOOOKUP 4 /* namei and other lookup-related operations */
-#define DBG_JOURNAL 5 /* journaling operations */
-#define DBG_IOCTL 6 /* ioctl to the disk */
-#define DBG_BOOTCACHE 7 /* bootcache operations */
-#define DBG_HFS 8 /* HFS-specific events; see bsd/hfs/hfs_kdebug.h */
+#define DBG_FSRW 0x1 /* reads and writes to the filesystem */
+#define DBG_DKRW 0x2 /* reads and writes to the disk */
+#define DBG_FSVN 0x3 /* vnode operations (inc. locking/unlocking) */
+#define DBG_FSLOOOKUP 0x4 /* namei and other lookup-related operations */
+#define DBG_JOURNAL 0x5 /* journaling operations */
+#define DBG_IOCTL 0x6 /* ioctl to the disk */
+#define DBG_BOOTCACHE 0x7 /* bootcache operations */
+#define DBG_HFS 0x8 /* HFS-specific events; see the hfs project */
+#define DBG_APFS 0x9 /* APFS-specific events; see the apfs project */
+#define DBG_SMB 0xA /* SMB-specific events; see the smb project */
#define DBG_EXFAT 0xE /* ExFAT-specific events; see the exfat project */
#define DBG_MSDOS 0xF /* FAT-specific events; see the msdosfs project */
#define DBG_ACFS 0x10 /* Xsan-specific events; see the XsanFS project */
#define DBG_HFS_UPDATE_SKIPPED 0x80
/* The Kernel Debug Sub Classes for BSD */
-#define DBG_BSD_PROC 0x01 /* process/signals related */
-#define DBG_BSD_MEMSTAT 0x02 /* memorystatus / jetsam operations */
-#define DBG_BSD_EXCP_SC 0x0C /* System Calls */
-#define DBG_BSD_AIO 0x0D /* aio (POSIX async IO) */
-#define DBG_BSD_SC_EXTENDED_INFO 0x0E /* System Calls, extended info */
-#define DBG_BSD_SC_EXTENDED_INFO2 0x0F /* System Calls, extended info */
-
+#define DBG_BSD_PROC 0x01 /* process/signals related */
+#define DBG_BSD_MEMSTAT 0x02 /* memorystatus / jetsam operations */
+#define DBG_BSD_KEVENT 0x03 /* kqueue / kevent related */
+#define DBG_BSD_EXCP_SC 0x0C /* System Calls */
+#define DBG_BSD_AIO 0x0D /* aio (POSIX async IO) */
+#define DBG_BSD_SC_EXTENDED_INFO 0x0E /* System Calls, extended info */
+#define DBG_BSD_SC_EXTENDED_INFO2 0x0F /* System Calls, extended info */
+#define DBG_BSD_KDEBUG_TEST 0xFF /* for testing kdebug */
/* The Codes for BSD subcode class DBG_BSD_PROC */
-#define BSD_PROC_EXIT 1 /* process exit */
-#define BSD_PROC_FRCEXIT 2 /* Kernel force termination */
+#define BSD_PROC_EXIT 1 /* process exit */
+#define BSD_PROC_FRCEXIT 2 /* Kernel force termination */
+#define BSD_PROC_EXEC 3 /* process spawn / exec */
+#define BSD_PROC_EXITREASON_CREATE 4 /* exit reason creation */
+#define BSD_PROC_EXITREASON_COMMIT 5 /* exit reason commited to a proc */
/* Codes for BSD subcode class DBG_BSD_MEMSTAT */
#define BSD_MEMSTAT_SCAN 1 /* memorystatus thread awake */
#define BSD_MEMSTAT_DO_KILL 13 /* memorystatus kills */
#endif /* PRIVATE */
+/* Codes for BSD subcode class DBG_BSD_KEVENT */
+#define BSD_KEVENT_KQ_PROCESS_BEGIN 1
+#define BSD_KEVENT_KQ_PROCESS_END 2
+#define BSD_KEVENT_KQWQ_PROCESS_BEGIN 3
+#define BSD_KEVENT_KQWQ_PROCESS_END 4
+#define BSD_KEVENT_KQWQ_BIND 5
+#define BSD_KEVENT_KQWQ_UNBIND 6
+#define BSD_KEVENT_KQWQ_THREQUEST 7
+#define BSD_KEVENT_KQWL_PROCESS_BEGIN 8
+#define BSD_KEVENT_KQWL_PROCESS_END 9
+#define BSD_KEVENT_KQWL_THREQUEST 10
+#define BSD_KEVENT_KQWL_THADJUST 11
+#define BSD_KEVENT_KQ_REGISTER 12
+#define BSD_KEVENT_KQWQ_REGISTER 13
+#define BSD_KEVENT_KQWL_REGISTER 14
+#define BSD_KEVENT_KNOTE_ACTIVATE 15
+#define BSD_KEVENT_KQ_PROCESS 16
+#define BSD_KEVENT_KQWQ_PROCESS 17
+#define BSD_KEVENT_KQWL_PROCESS 18
+#define BSD_KEVENT_KQWL_BIND 19
+#define BSD_KEVENT_KQWL_UNBIND 20
+#define BSD_KEVENT_KNOTE_ENABLE 21
+
/* The Kernel Debug Sub Classes for DBG_TRACE */
#define DBG_TRACE_DATA 0
#define DBG_TRACE_STRING 1
#define DBG_TRACE_INFO 2
/* The Kernel Debug events: */
-#define TRACE_DATA_NEWTHREAD (TRACEDBG_CODE(DBG_TRACE_DATA, 1))
-#define TRACE_DATA_EXEC (TRACEDBG_CODE(DBG_TRACE_DATA, 2))
-#define TRACE_DATA_THREAD_TERMINATE (TRACEDBG_CODE(DBG_TRACE_DATA, 3))
-#define TRACE_STRING_GLOBAL (TRACEDBG_CODE(DBG_TRACE_STRING, 0))
-#define TRACE_STRING_NEWTHREAD (TRACEDBG_CODE(DBG_TRACE_STRING, 1))
-#define TRACE_STRING_EXEC (TRACEDBG_CODE(DBG_TRACE_STRING, 2))
-#define TRACE_PANIC (TRACEDBG_CODE(DBG_TRACE_INFO, 0))
-#define TRACE_TIMESTAMPS (TRACEDBG_CODE(DBG_TRACE_INFO, 1))
-#define TRACE_LOST_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 2))
-#define TRACE_WRITING_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 3))
-#define TRACE_INFO_STRING (TRACEDBG_CODE(DBG_TRACE_INFO, 4))
+#define TRACE_DATA_NEWTHREAD (TRACEDBG_CODE(DBG_TRACE_DATA, 1))
+#define TRACE_DATA_EXEC (TRACEDBG_CODE(DBG_TRACE_DATA, 2))
+#define TRACE_DATA_THREAD_TERMINATE (TRACEDBG_CODE(DBG_TRACE_DATA, 3))
+#define TRACE_DATA_THREAD_TERMINATE_PID (TRACEDBG_CODE(DBG_TRACE_DATA, 4))
+#define TRACE_STRING_GLOBAL (TRACEDBG_CODE(DBG_TRACE_STRING, 0))
+#define TRACE_STRING_NEWTHREAD (TRACEDBG_CODE(DBG_TRACE_STRING, 1))
+#define TRACE_STRING_EXEC (TRACEDBG_CODE(DBG_TRACE_STRING, 2))
+#define TRACE_STRING_PROC_EXIT (TRACEDBG_CODE(DBG_TRACE_STRING, 3))
+#define TRACE_STRING_THREADNAME (TRACEDBG_CODE(DBG_TRACE_STRING, 4))
+#define TRACE_STRING_THREADNAME_PREV (TRACEDBG_CODE(DBG_TRACE_STRING, 5))
+#define TRACE_PANIC (TRACEDBG_CODE(DBG_TRACE_INFO, 0))
+#define TRACE_TIMESTAMPS (TRACEDBG_CODE(DBG_TRACE_INFO, 1))
+#define TRACE_LOST_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 2))
+#define TRACE_WRITING_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 3))
+#define TRACE_INFO_STRING (TRACEDBG_CODE(DBG_TRACE_INFO, 4))
+#define TRACE_RETROGRADE_EVENTS (TRACEDBG_CODE(DBG_TRACE_INFO, 5))
/* The Kernel Debug Sub Classes for DBG_CORESTORAGE */
#define DBG_CS_IO 0
/* The Kernel Debug Sub Classes for DBG_SECURITY */
-#define DBG_SEC_KERNEL 0 /* raw entropy collected by the kernel */
+#define DBG_SEC_KERNEL 0 /* raw entropy collected by the kernel */
+#define DBG_SEC_SANDBOX 1
/* Sub-class codes for CoreGraphics (DBG_CG) are defined in its component. */
+/* The Kernel Debug Sub Classes for DBG_MONOTONIC */
+#define DBG_MT_INSTRS_CYCLES 1
+#define DBG_MT_TMPTH 0xfe
+#define DBG_MT_TMPCPU 0xff
+
/* The Kernel Debug Sub Classes for DBG_MISC */
#define DBG_EVENT 0x10
#define DBG_BUFFER 0x20
/* The Kernel Debug Sub Classes for DBG_DYLD */
-#define DBG_DYLD_STRING 5
+#define DBG_DYLD_UUID (5)
+
+/* Kernel Debug codes for the DBG_DYLD_UUID subclass */
+#define DBG_DYLD_UUID_MAP_A (0)
+#define DBG_DYLD_UUID_MAP_B (1)
+#define DBG_DYLD_UUID_MAP_32_A (2)
+#define DBG_DYLD_UUID_MAP_32_B (3)
+#define DBG_DYLD_UUID_MAP_32_C (4)
+#define DBG_DYLD_UUID_UNMAP_A (5)
+#define DBG_DYLD_UUID_UNMAP_B (6)
+#define DBG_DYLD_UUID_UNMAP_32_A (7)
+#define DBG_DYLD_UUID_UNMAP_32_B (8)
+#define DBG_DYLD_UUID_UNMAP_32_C (9)
+#define DBG_DYLD_UUID_SHARED_CACHE_A (10)
+#define DBG_DYLD_UUID_SHARED_CACHE_B (11)
+#define DBG_DYLD_UUID_SHARED_CACHE_32_A (12)
+#define DBG_DYLD_UUID_SHARED_CACHE_32_B (13)
+#define DBG_DYLD_UUID_SHARED_CACHE_32_C (14)
/* The Kernel Debug modifiers for the DBG_DKRW sub class */
#define DKIO_DONE 0x01
#define DKIO_NOCACHE 0x80
#define DKIO_TIER_MASK 0xF00
#define DKIO_TIER_SHIFT 8
+#define DKIO_TIER_UPGRADE 0x1000
/* Kernel Debug Sub Classes for Applications (DBG_APPS) */
#define DBG_APP_LOGINWINDOW 0x03
#define DBG_APP_AUDIO 0x04
-#define DBG_APP_SIGPOST 0x0A
+#define DBG_APP_SYSTEMUI 0x05
+#define DBG_APP_SIGNPOST 0x0A
#define DBG_APP_APPKIT 0x0C
+#define DBG_APP_DFR 0x0E
#define DBG_APP_SAMBA 0x80
+#define DBG_APP_EOSSUPPORT 0x81
+#define DBG_APP_MACEFIMANAGER 0x82
/* Kernel Debug codes for Throttling (DBG_THROTTLE) */
#define OPEN_THROTTLE_WINDOW 0x1
#define PROCESS_THROTTLED 0x2
#define IO_THROTTLE_DISABLE 0x3
+#define IO_TIER_UPL_MISMATCH 0x4
/* Subclasses for MACH Importance Policies (DBG_IMPORTANCE) */
#define IMP_USYNCH_QOS_OVERRIDE 0x1A /* Userspace synchronization applied QoS override to resource owning thread */
#define IMP_DONOR_CHANGE 0x1B /* The iit_donor bit changed */
#define IMP_MAIN_THREAD_QOS 0x1C /* The task's main thread QoS was set */
+#define IMP_SYNC_IPC_QOS 0x1D /* Sync IPC QOS override */
/* DBG_IMPORTANCE subclasses 0x20 - 0x3F reserved for task policy flavors */
/* Codes for IMP_ASSERTION */
#define IMP_DONOR_UPDATE_LIVE_DONOR_STATE 0x0
#define IMP_DONOR_INIT_DONOR_STATE 0x1
+/* Code for IMP_SYNC_IPC_QOS */
+#define IMP_SYNC_IPC_QOS_APPLIED 0x0
+#define IMP_SYNC_IPC_QOS_REMOVED 0x1
+#define IMP_SYNC_IPC_QOS_OVERFLOW 0x2
+#define IMP_SYNC_IPC_QOS_UNDERFLOW 0x3
+
/* Subclasses for MACH Bank Voucher Attribute Manager (DBG_BANK) */
#define BANK_ACCOUNT_INFO 0x10 /* Trace points related to bank account struct */
#define BANK_TASK_INFO 0x11 /* Trace points related to bank task struct */
/* Codes for BANK_ACCOUNT_INFO */
#define BANK_SETTLE_CPU_TIME 0x1 /* Bank ledger(chit) rolled up to tasks. */
+#define BANK_SECURE_ORIGINATOR_CHANGED 0x2 /* Secure Originator changed. */
+#define BANK_SETTLE_ENERGY 0x3 /* Bank ledger(energy field) rolled up to tasks. */
/* Codes for ATM_SUBAID_INFO */
#define ATM_MIN_CALLED 0x1
#define ATM_VALUE_DIFF_MAILBOX 0x2
/* Kernel Debug Sub Classes for daemons (DBG_DAEMON) */
-#define DBG_DAEMON_COREDUET 0x1
+#define DBG_DAEMON_COREDUET 0x1
+#define DBG_DAEMON_POWERD 0x2
+/* Subclasses for the user space allocator */
+#define DBG_UMALLOC_EXTERNAL 0x1
+#define DBG_UMALLOC_INTERNAL 0x2
/**********************************************************************/
#define KDBG_MIGCODE(msgid) ((DBG_MIG << KDBG_CLASS_OFFSET) | \
/* Kernel Debug Macros for specific daemons */
#define COREDUETDBG_CODE(code) DAEMONDBG_CODE(DBG_DAEMON_COREDUET, code)
+#define POWERDDBG_CODE(code) DAEMONDBG_CODE(DBG_DAEMON_POWERD, code)
-/* Usage:
-* kernel_debug((KDBG_CODE(DBG_NETWORK, DNET_PROTOCOL, 51) | DBG_FUNC_START),
-* offset, 0, 0, 0,0)
-*
-* For ex,
-*
-* #include <sys/kdebug.h>
-*
-* #define DBG_NETIPINIT NETDBG_CODE(DBG_NETIP,1)
-*
-*
-* void
-* ip_init()
-* {
-* register struct protosw *pr;
-* register int i;
-*
-* KERNEL_DEBUG(DBG_NETIPINIT | DBG_FUNC_START, 0,0,0,0,0)
-* --------
-* KERNEL_DEBUG(DBG_NETIPINIT, 0,0,0,0,0)
-* --------
-* KERNEL_DEBUG(DBG_NETIPINIT | DBG_FUNC_END, 0,0,0,0,0)
-* }
-*
+/*
+ * To use kdebug in the kernel:
+ *
+ * #include <sys/kdebug.h>
+ *
+ * #define DBG_NETIPINIT NETDBG_CODE(DBG_NETIP, 1)
+ *
+ * void
+ * ip_init(void)
+ * {
+ * KDBG(DBG_NETIPINIT | DBG_FUNC_START, 1, 2, 3, 4);
+ * ...
+ * KDBG(DBG_NETIPINIT);
+ * ...
+ * KDBG(DBG_NETIPINIT | DBG_FUNC_END);
+ * }
+ */
-*/
+#ifdef KERNEL_PRIVATE
+
+/*
+ * The KDBG{,_DEBUG,_RELEASE,_FILTERED} macros are the preferred method of
+ * making tracepoints.
+ *
+ * Kernel pointers must be unslid or permuted using VM_KERNEL_UNSLIDE_OR_PERM.
+ * Do not trace any sensitive data.
+ */
+
+/*
+ * Traced on debug and development (and release OS X) kernels.
+ */
+#define KDBG(x, ...) KDBG_(, x, ## __VA_ARGS__, 4, 3, 2, 1, 0)
+
+/*
+ * Traced on debug and development (and release OS X) kernels if explicitly
+ * requested. Omitted from tracing without a typefilter.
+ */
+#define KDBG_FILTERED(x, ...) KDBG_(_FILTERED, x, ## __VA_ARGS__, 4, 3, 2, 1, 0)
+
+/*
+ * Traced on debug, development, and release kernels.
+ *
+ * Only use this tracepoint if the events are required for a shipping trace
+ * tool.
+ */
+#define KDBG_RELEASE(x, ...) KDBG_(_RELEASE, x, ## __VA_ARGS__, 4, 3, 2, 1, 0)
+
+/*
+ * Traced only on debug kernels.
+ */
+#define KDBG_DEBUG(x, ...) KDBG_(_DEBUG, x, ## __VA_ARGS__, 4, 3, 2, 1, 0)
+
+#define KDBG_(f, x, a, b, c, d, n, ...) KDBG##n(f, x, a, b, c, d)
+#define KDBG0(f, x, a, b, c, d) KERNEL_DEBUG_CONSTANT##f(x, 0, 0, 0, 0, 0)
+#define KDBG1(f, x, a, b, c, d) KERNEL_DEBUG_CONSTANT##f(x, a, 0, 0, 0, 0)
+#define KDBG2(f, x, a, b, c, d) KERNEL_DEBUG_CONSTANT##f(x, a, b, 0, 0, 0)
+#define KDBG3(f, x, a, b, c, d) KERNEL_DEBUG_CONSTANT##f(x, a, b, c, 0, 0)
+#define KDBG4(f, x, a, b, c, d) KERNEL_DEBUG_CONSTANT##f(x, a, b, c, d, 0)
+
+#endif /* defined(KERNEL_PRIVATE) */
extern unsigned int kdebug_enable;
-#define KDEBUG_ENABLE_TRACE 0x1
-#define KDEBUG_ENABLE_ENTROPY 0x2 /* Obsolescent */
-#define KDEBUG_ENABLE_CHUD 0x4
-#define KDEBUG_ENABLE_PPT 0x8
-#define KDEBUG_ENABLE_SERIAL 0x10
/*
- * Infer the supported kernel debug event level from config option.
- * Use (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD) as a guard to protect
- * unaudited debug code.
+ * Bits used by kdebug_enable. These control which events are traced at
+ * runtime.
+ */
+#define KDEBUG_ENABLE_TRACE (1U << 0)
+#define KDEBUG_ENABLE_ENTROPY (1U << 1) /* obsolete */
+#define KDEBUG_ENABLE_CHUD (1U << 2) /* obsolete */
+#define KDEBUG_ENABLE_PPT (1U << 3)
+#define KDEBUG_ENABLE_SERIAL (1U << 4)
+
+#define KDEBUG_TRACE (KDEBUG_ENABLE_TRACE)
+
+/*
+ * Specify KDEBUG_PPT to indicate that the event belongs to the limited PPT set.
+ * PPT is deprecated -- use a typefilter and the PPTDBG class instead.
+ */
+#define KDEBUG_PPT (KDEBUG_ENABLE_PPT)
+#define KDEBUG_COMMON (KDEBUG_ENABLE_TRACE | KDEBUG_ENABLE_PPT)
+
+/*
+ * The kernel debug configuration level. These values control which events are
+ * compiled in under different build configurations.
+ *
+ * Infer the supported kernel debug event level from config option. Use
+ * (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD) as a guard to protect unaudited debug
+ * code.
*/
#define KDEBUG_LEVEL_NONE 0
#define KDEBUG_LEVEL_IST 1
#define KDEBUG_LEVEL KDEBUG_LEVEL_FULL
#else
#define KDEBUG_LEVEL KDEBUG_LEVEL_STANDARD
-/* Currently, all other kernel configurations (development, etc)
- build with KDEBUG_LEVEL_STANDARD. As a result, KERNEL_DEBUG_CONSTANT*()
- are on by default but KERNEL_DEBUG*() are not.
-*/
+/*
+ * Currently, all other kernel configurations (development, etc) build with
+ * KDEBUG_LEVEL_STANDARD. As a result, KERNEL_DEBUG_CONSTANT*() are on by
+ * default but KERNEL_DEBUG*() are not.
+ */
#endif
-#if (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD)
#ifdef XNU_KERNEL_PRIVATE
-#define KERNEL_DEBUG_CONSTANT(x,a,b,c,d,e) \
-do { \
- if (__improbable(kdebug_enable & ~KDEBUG_ENABLE_PPT)) \
- kernel_debug(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \
- (uintptr_t)d,(uintptr_t)e); \
-} while(0)
-
-#define KERNEL_DEBUG_CONSTANT1(x,a,b,c,d,e) \
-do { \
- if (__improbable(kdebug_enable & ~KDEBUG_ENABLE_PPT)) \
- kernel_debug1(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \
- (uintptr_t)d,(uintptr_t)e); \
-} while(0)
+#define KDBG_IMPROBABLE __improbable
+#else
+#define KDBG_IMPROBABLE
+#endif
-#define KERNEL_DEBUG_EARLY(x,a,b,c,d) \
-do { \
- kernel_debug_early((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \
- (uintptr_t)c, (uintptr_t)d); \
-} while(0)
-#else /* XNU_KERNEL_PRIVATE */
-#define KERNEL_DEBUG_CONSTANT(x,a,b,c,d,e) \
-do { \
- if (kdebug_enable & ~KDEBUG_ENABLE_PPT) \
- kernel_debug(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \
- (uintptr_t)d,(uintptr_t)e); \
-} while(0)
+/*
+ * KERNEL_DEBUG_CONSTANT_FILTERED events are omitted from tracing unless they
+ * are explicitly requested in the typefilter. They are not emitted when
+ * tracing without a typefilter.
+ */
+#if (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD)
+#define KERNEL_DEBUG_CONSTANT_FILTERED(x, a, b, c, d, ...) \
+ do { \
+ if (KDBG_IMPROBABLE(kdebug_enable & ~KDEBUG_ENABLE_PPT)) { \
+ kernel_debug_filtered((x), (uintptr_t)(a), (uintptr_t)(b), \
+ (uintptr_t)(c), (uintptr_t)(d)); \
+ } \
+ } while (0)
+#else /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD) */
+#define KERNEL_DEBUG_CONSTANT_FILTERED(type, x, a, b, c, d, ...) do {} while (0)
+#endif /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD) */
-#define KERNEL_DEBUG_CONSTANT1(x,a,b,c,d,e) \
-do { \
- if (kdebug_enable & ~KDEBUG_ENABLE_PPT) \
- kernel_debug1(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \
- (uintptr_t)d,(uintptr_t)e); \
-} while(0)
+#if (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD)
+#define KERNEL_DEBUG_CONSTANT(x, a, b, c, d, e) \
+ do { \
+ if (KDBG_IMPROBABLE(kdebug_enable & ~KDEBUG_ENABLE_PPT)) { \
+ kernel_debug((x), (uintptr_t)(a), (uintptr_t)(b), (uintptr_t)(c), \
+ (uintptr_t)(d),(uintptr_t)(e)); \
+ } \
+ } while (0)
-#define KERNEL_DEBUG_EARLY(x,a,b,c,d) \
-do { \
- kernel_debug_early((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \
- (uintptr_t)c, (uintptr_t)d); \
-} while(0)
-#endif /* XNU_KERNEL_PRIVATE */
+/*
+ * DO NOT USE THIS MACRO -- it breaks fundamental assumptions about ktrace and
+ * is only meant to be used by the pthread kext and other points in the kernel
+ * where the thread ID must be provided explicitly.
+ */
+#define KERNEL_DEBUG_CONSTANT1(x, a, b, c, d, e) \
+ do { \
+ if (KDBG_IMPROBABLE(kdebug_enable & ~KDEBUG_ENABLE_PPT)) { \
+ kernel_debug1((x), (uintptr_t)(a), (uintptr_t)(b), (uintptr_t)(c), \
+ (uintptr_t)(d), (uintptr_t)(e)); \
+ } \
+ } while (0)
+
+#define KERNEL_DEBUG_EARLY(x, a, b, c, d) \
+ do { \
+ kernel_debug_early((uint32_t)(x), (uintptr_t)(a), (uintptr_t)(b), \
+ (uintptr_t)(c), (uintptr_t)(d)); \
+ } while (0)
#else /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD) */
-#define KERNEL_DEBUG_CONSTANT(x,a,b,c,d,e) do { } while(0)
-#define KERNEL_DEBUG_CONSTANT1(x,a,b,c,d,e) do { } while(0)
-#define KERNEL_DEBUG_EARLY(x,a,b,c,d) do { } while(0)
+#define KERNEL_DEBUG_CONSTANT(x, a, b, c, d, e) do {} while (0)
+#define KERNEL_DEBUG_CONSTANT1(x, a, b, c, d, e) do {} while (0)
+#define KERNEL_DEBUG_EARLY(x, a, b, c, d) do {} while (0)
#endif /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD) */
-#ifdef KERNEL_PRIVATE
+/*
+ * KERNEL_DEBUG_CONSTANT_IST (in-system trace) events provide an audited subset
+ * of tracepoints for userland system tracing tools. This tracing level was
+ * created by 8857227 to protect fairplayd and other PT_DENY_ATTACH processes.
+ * It has two effects: only KERNEL_DEBUG_CONSTANT_IST() traces are emitted and
+ * any PT_DENY_ATTACH processes will only emit basic traces as defined by the
+ * kernel_debug_filter() routine.
+ */
+#define KERNEL_DEBUG_CONSTANT_RELEASE(x, a, b, c, d, e) \
+ KERNEL_DEBUG_CONSTANT_IST(~KDEBUG_ENABLE_PPT, x, a, b, c, d, 0)
-// Abbreviated version of above
-#define KDBG(x, ...) KDBG_(x, ## __VA_ARGS__, 5, 4, 3, 2, 1, 0)
-#define KDBG_(x, a, b, c, d, e, n, ...) KDBG##n(x, a, b, c, d, e)
-#define KDBG0(x, a, b, c, d, e) KERNEL_DEBUG_CONSTANT(x, 0, 0, 0, 0, 0)
-#define KDBG1(x, a, b, c, d, e) KERNEL_DEBUG_CONSTANT(x, a, 0, 0, 0, 0)
-#define KDBG2(x, a, b, c, d, e) KERNEL_DEBUG_CONSTANT(x, a, b, 0, 0, 0)
-#define KDBG3(x, a, b, c, d, e) KERNEL_DEBUG_CONSTANT(x, a, b, c, 0, 0)
-#define KDBG4(x, a, b, c, d, e) KERNEL_DEBUG_CONSTANT(x, a, b, c, d, 0)
-#define KDBG5(x, a, b, c, d, e) KERNEL_DEBUG_CONSTANT(x, a, b, c, d, e)
+#if (KDEBUG_LEVEL >= KDEBUG_LEVEL_IST)
+#define KERNEL_DEBUG_CONSTANT_IST(type, x, a, b, c, d, e) \
+ do { \
+ if (KDBG_IMPROBABLE(kdebug_enable & (type))) { \
+ kernel_debug((x), (uintptr_t)(a), (uintptr_t)(b), (uintptr_t)(c), \
+ (uintptr_t)(d), (uintptr_t)(e)); \
+ } \
+ } while (0)
+#else /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_IST) */
+#define KERNEL_DEBUG_CONSTANT_IST(type, x, a, b, c, d, e) do {} while (0)
+#endif /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_IST) */
-#endif // KERNEL_PRIVATE
+#if NO_KDEBUG
+#define __kdebug_constant_only __unused
+#endif
/*
- * Specify KDEBUG_PPT to indicate that the event belongs to the
- * limited PPT set.
+ * KERNEL_DEBUG events are only traced for DEBUG kernels.
*/
-#define KDEBUG_COMMON (KDEBUG_ENABLE_TRACE|KDEBUG_ENABLE_CHUD|KDEBUG_ENABLE_PPT)
-#define KDEBUG_TRACE (KDEBUG_ENABLE_TRACE|KDEBUG_ENABLE_CHUD)
-#define KDEBUG_PPT (KDEBUG_ENABLE_PPT)
+#define KERNEL_DEBUG_CONSTANT_DEBUG(x, a, b, c, d, e) \
+ KERNEL_DEBUG(x, a, b, c, d, e)
+
+#if (KDEBUG_LEVEL >= KDEBUG_LEVEL_FULL)
+#define __kdebug_only
+
+#define KERNEL_DEBUG(x, a, b, c, d, e) \
+ do { \
+ if (KDBG_IMPROBABLE(kdebug_enable & ~KDEBUG_ENABLE_PPT)) { \
+ kernel_debug((uint32_t)(x), (uintptr_t)(a), (uintptr_t)(b), \
+ (uintptr_t)(c), (uintptr_t)(d), (uintptr_t)(e)); \
+ } \
+ } while (0)
/*
- KERNEL_DEBUG_CONSTANT_IST events provide an audited subset of
- tracepoints for userland system tracing tools. This tracing level was
- created by 8857227 to protect fairplayd and other PT_DENY_ATTACH
- processes. It has two effects: only KERNEL_DEBUG_CONSTANT_IST() traces
- are emitted and any PT_DENY_ATTACH processes will only emit basic
- traces as defined by the kernel_debug_filter() routine.
+ * DO NOT USE THIS MACRO -- see warning above for KERNEL_DEBUG_CONSTANT1.
*/
-#if (KDEBUG_LEVEL >= KDEBUG_LEVEL_IST)
-#ifdef XNU_KERNEL_PRIVATE
-#define KERNEL_DEBUG_CONSTANT_IST(type,x,a,b,c,d,e) \
-do { \
- if (__improbable(kdebug_enable & type)) \
- kernel_debug(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \
- (uintptr_t)d,(uintptr_t)e); \
-} while(0)
-#else /* XNU_KERNEL_PRIVATE */
-#define KERNEL_DEBUG_CONSTANT_IST(type,x,a,b,c,d,e) \
-do { \
- if (kdebug_enable & type) \
- kernel_debug(x,(uintptr_t)a,(uintptr_t)b,(uintptr_t)c, \
- (uintptr_t)d,(uintptr_t)e); \
-} while(0)
-#endif /* XNU_KERNEL_PRIVATE */
+#define KERNEL_DEBUG1(x, a, b, c, d, e) \
+ do { \
+ if (KDBG_IMPROBABLE(kdebug_enable & ~KDEBUG_ENABLE_PPT)) { \
+ kernel_debug1((uint32_t)(x), (uintptr_t)(a), (uintptr_t)(b), \
+ (uintptr_t)(c), (uintptr_t)(d), (uintptr_t)(e)); \
+ } \
+ } while (0)
+#else /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_FULL) */
+#define __kdebug_only __unused
+
+#define KERNEL_DEBUG(x,a,b,c,d,e) do {} while (0)
+#define KERNEL_DEBUG1(x,a,b,c,d,e) do {} while (0)
+#endif /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_FULL) */
+
+
+extern void kernel_debug(
+ uint32_t debugid,
+ uintptr_t arg1,
+ uintptr_t arg2,
+ uintptr_t arg3,
+ uintptr_t arg4,
+ uintptr_t arg5);
+
+extern void kernel_debug1(
+ uint32_t debugid,
+ uintptr_t arg1,
+ uintptr_t arg2,
+ uintptr_t arg3,
+ uintptr_t arg4,
+ uintptr_t arg5);
+
+extern void kernel_debug_filtered(
+ uint32_t debugid,
+ uintptr_t arg1,
+ uintptr_t arg2,
+ uintptr_t arg3,
+ uintptr_t arg4);
+
+extern void kernel_debug_early(
+ uint32_t debugid,
+ uintptr_t arg1,
+ uintptr_t arg2,
+ uintptr_t arg3,
+ uintptr_t arg4);
+
+/*
+ * EnergyTracing macros.
+ */
+
+#if (KDEBUG_LEVEL >= KDEBUG_LEVEL_IST)
// whether to bother calculating EnergyTracing inputs
-// could chnage in future to see if DBG_ENERGYTRACE is active
+// could change in future to see if DBG_ENERGYTRACE is active
#define ENTR_SHOULDTRACE kdebug_enable
// encode logical EnergyTracing into 32/64 KDebug trace
#define ENTR_KDTRACE(component, opcode, lifespan, id, quality, value) \
#else /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_IST) */
-#define KERNEL_DEBUG_CONSTANT_IST(type,x,a,b,c,d,e) do { } while(0)
#define ENTR_SHOULDTRACE FALSE
#define ENTR_KDTRACE(component, opcode, lifespan, id, quality, value) \
do {} while (0)
#endif /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_IST) */
-#if NO_KDEBUG
-#define __kdebug_constant_only __unused
-#endif
-
-extern void kernel_debug(
- uint32_t debugid,
- uintptr_t arg1,
- uintptr_t arg2,
- uintptr_t arg3,
- uintptr_t arg4,
- uintptr_t arg5);
-
-extern void kernel_debug1(
- uint32_t debugid,
- uintptr_t arg1,
- uintptr_t arg2,
- uintptr_t arg3,
- uintptr_t arg4,
- uintptr_t arg5);
-
-extern void kernel_debug_early(
- uint32_t debugid,
- uintptr_t arg1,
- uintptr_t arg2,
- uintptr_t arg3,
- uintptr_t arg4);
-
#ifdef KERNEL_PRIVATE
/*
* kernel_debug_string provides the same functionality as the
*/
extern int
kernel_debug_string(uint32_t debugid, uint64_t *str_id, const char *str);
-#endif
-
-#if (KDEBUG_LEVEL >= KDEBUG_LEVEL_FULL)
-#ifdef XNU_KERNEL_PRIVATE
-#define KERNEL_DEBUG(x,a,b,c,d,e) \
-do { \
- if (__improbable(kdebug_enable & ~KDEBUG_ENABLE_PPT)) \
- kernel_debug((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \
- (uintptr_t)c, (uintptr_t)d, (uintptr_t)e); \
-} while(0)
-
-#define KERNEL_DEBUG1(x,a,b,c,d,e) \
-do { \
- if (__improbable(kdebug_enable & ~KDEBUG_ENABLE_PPT)) \
- kernel_debug1((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \
- (uintptr_t)c, (uintptr_t)d, (uintptr_t)e); \
-} while(0)
-
-#define __kdebug_only
-#else /* !XNU_KERNEL_PRIVATE */
-#define KERNEL_DEBUG(x,a,b,c,d,e) \
-do { \
- if (kdebug_enable & ~KDEBUG_ENABLE_PPT) \
- kernel_debug((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \
- (uintptr_t)c, (uintptr_t)d, (uintptr_t)e); \
-} while(0)
-
-#define KERNEL_DEBUG1(x,a,b,c,d,e) \
-do { \
- if (kdebug_enable & ~KDEBUG_ENABLE_PPT) \
- kernel_debug1((uint32_t)x, (uintptr_t)a, (uintptr_t)b, \
- (uintptr_t)c, (uintptr_t)d, (uintptr_t)e); \
-} while(0)
-#endif /* XNU_KERNEL_PRIVATE */
-
-#else /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_FULL) */
-
-#define KERNEL_DEBUG(x,a,b,c,d,e) do {} while (0)
-#define KERNEL_DEBUG1(x,a,b,c,d,e) do {} while (0)
-#define __kdebug_only __unused
-#endif /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_FULL) */
+/*
+ * kernel_debug_disable disables event logging, but leaves any buffers
+ * intact.
+ */
+extern void kernel_debug_disable(void);
+#endif
+/*
+ * Bits set in the comm page for kdebug.
+ */
+#define KDEBUG_COMMPAGE_ENABLE_TRACE 0x1
+#define KDEBUG_COMMPAGE_ENABLE_TYPEFILTER 0x2 /* Forced to false if ENABLE_TRACE is 0 */
// for EnergyTracing user space & clients
#define kEnTrCompKernel 2
struct proc;
-extern void kdebug_lookup_gen_events(long *dbg_parms, int dbg_namelen, void *dp, boolean_t lookup);
-extern void kdbg_trace_data(struct proc *proc, long *arg_pid);
+/*
+ * Returns false if the debugid is disabled by filters, and true if the
+ * debugid is allowed to be traced. A debugid may not be traced if the
+ * typefilter disables its class and subclass, it's outside a range
+ * check, or if it's not an allowed debugid in a value check. Trace
+ * system events bypass this check.
+ */
+boolean_t kdebug_debugid_enabled(uint32_t debugid);
+
+/*
+ * Returns true only if the debugid is explicitly enabled by filters. Returns
+ * false otherwise, including when no filters are active.
+ */
+boolean_t kdebug_debugid_explicitly_enabled(uint32_t debugid);
-extern void kdbg_trace_string(struct proc *proc, long *arg1, long *arg2, long *arg3, long *arg4);
+uint32_t kdebug_commpage_state(void);
+void kdebug_lookup_gen_events(long *dbg_parms, int dbg_namelen, void *dp, boolean_t lookup);
+void kdbg_trace_data(struct proc *proc, long *arg_pid, long *arg_uniqueid);
-extern void kdbg_dump_trace_to_file(const char *);
-void start_kern_tracing(unsigned int, boolean_t);
-void start_kern_tracing_with_typefilter(unsigned int, boolean_t, unsigned int);
+void kdbg_trace_string(struct proc *proc, long *arg1, long *arg2, long *arg3, long *arg4);
+
+void kdbg_dump_trace_to_file(const char *);
+void kdebug_init(unsigned int n_events, char *filterdesc);
+void kdebug_trace_start(unsigned int n_events, const char *filterdesc, boolean_t at_wake);
+void kdebug_free_early_buf(void);
struct task;
-extern void kdbg_get_task_name(char*, int, struct task *task);
-void disable_wrap(uint32_t *old_slowcheck, uint32_t *old_flags);
+void kdbg_get_task_name(char*, int, struct task *task);
+boolean_t disable_wrap(uint32_t *old_slowcheck, uint32_t *old_flags);
void enable_wrap(uint32_t old_slowcheck, boolean_t lostevents);
void release_storage_unit(int cpu, uint32_t storage_unit);
int allocate_storage_unit(int cpu);
#define KDBG_CLASS_ENCODE(Class, SubClass) KDBG_EVENTID(Class, SubClass, 0)
#define KDBG_CLASS_DECODE(Debugid) (Debugid & KDBG_CSC_MASK)
-
-#endif /* KERNEL_PRIVATE */
-
-
+#endif /* KERNEL_PRIVATE */
#endif /* __APPLE_API_UNSTABLE */
__END_DECLS
-
-#ifdef PRIVATE
+#ifdef PRIVATE
#ifdef __APPLE_API_PRIVATE
/*
* private kernel_debug definitions
*/
typedef struct {
- uint64_t timestamp;
- uintptr_t arg1;
- uintptr_t arg2;
- uintptr_t arg3;
- uintptr_t arg4;
- uintptr_t arg5; /* will hold current thread */
- uint32_t debugid;
+ uint64_t timestamp;
+ uintptr_t arg1;
+ uintptr_t arg2;
+ uintptr_t arg3;
+ uintptr_t arg4;
+ uintptr_t arg5; /* the thread ID */
+ uint32_t debugid;
#if defined(__LP64__)
- uint32_t cpuid;
- uintptr_t unused;
+ uint32_t cpuid;
+ uintptr_t unused;
#endif
} kd_buf;
#if !defined(__LP64__)
-#define KDBG_TIMESTAMP_MASK 0x00ffffffffffffffULL
-#define KDBG_CPU_MASK 0xff00000000000000ULL
-#define KDBG_CPU_SHIFT 56
+#define KDBG_TIMESTAMP_MASK 0x00ffffffffffffffULL
+#define KDBG_CPU_MASK 0xff00000000000000ULL
+#define KDBG_CPU_SHIFT 56
static inline void
kdbg_set_cpu(kd_buf *kp, int cpu)
{
}
#endif
-/* 2^16 bits (8 kilobytes), one for each possible class/subclass combination */
-#define KDBG_TYPEFILTER_BITMAP_SIZE ( (256 * 256) / 8 )
-
-/* Debug Flags */
-#define KDBG_INIT 0x001
-#define KDBG_NOWRAP 0x002
-#define KDBG_FREERUN 0x004
-#define KDBG_WRAPPED 0x008
-#define KDBG_USERFLAGS (KDBG_FREERUN|KDBG_NOWRAP|KDBG_INIT)
-#define KDBG_PIDCHECK 0x010
-#define KDBG_MAPINIT 0x020
-#define KDBG_PIDEXCLUDE 0x040
-#define KDBG_LOCKINIT 0x080
-#define KDBG_LP64 0x100
+/*
+ * 2^16 bits (8 kilobytes), one for each possible class/subclass combination
+ */
+#define KDBG_TYPEFILTER_BITMAP_SIZE ((256 * 256) / 8)
-typedef struct {
- unsigned int type;
- unsigned int value1;
- unsigned int value2;
- unsigned int value3;
- unsigned int value4;
+/*
+ * Bits for kd_ctrl_page.flags, KERN_KD{D,E}FLAGS.
+ */
+#define KDBG_INIT (1U << 0) /* obsolete */
+/* disable tracing when buffers are full */
+#define KDBG_NOWRAP (1U << 1)
+#define KDBG_FREERUN (1U << 2) /* obsolete */
+/* buffer has wrapped */
+#define KDBG_WRAPPED (1U << 3)
+/* flags that are allowed to be set by user space */
+#define KDBG_USERFLAGS (KDBG_FREERUN | KDBG_NOWRAP | KDBG_INIT)
+/* only include processes with kdebug bit set in proc */
+#define KDBG_PIDCHECK (1U << 4)
+/* thread map is initialized */
+#define KDBG_MAPINIT (1U << 5)
+/* exclude processes based on kdebug bit in proc */
+#define KDBG_PIDEXCLUDE (1U << 6)
+/* whether the kdebug locks are intialized */
+#define KDBG_LOCKINIT (1U << 7)
+/* word size of the kernel */
+#define KDBG_LP64 (1U << 8)
+
+/* bits for kd_ctrl_page.flags and kbufinfo_t.flags */
+
+/* only trace events within a range */
+#define KDBG_RANGECHECK 0x00100000U
+/* only trace at most 4 types of events, at the code granularity */
+#define KDBG_VALCHECK 0x00200000U
+/* check class and subclass against the typefilter */
+#define KDBG_TYPEFILTER_CHECK 0x00400000U
+/* kdebug trace buffers are initialized */
+#define KDBG_BUFINIT 0x80000000U
+
+/* bits for the type field of kd_regtype */
+#define KDBG_CLASSTYPE 0x10000
+#define KDBG_SUBCLSTYPE 0x20000
+#define KDBG_RANGETYPE 0x40000
+#define KDBG_TYPENONE 0x80000
+#define KDBG_CKTYPES 0xF0000
+typedef struct {
+ unsigned int type;
+ unsigned int value1;
+ unsigned int value2;
+ unsigned int value3;
+ unsigned int value4;
} kd_regtype;
-typedef struct
-{
- int nkdbufs;
- int nolog;
- int flags;
- int nkdthreads;
- int bufid;
+typedef struct {
+ /* number of events that can fit in the buffers */
+ int nkdbufs;
+ /* set if trace is disabled */
+ int nolog;
+ /* kd_ctrl_page.flags */
+ unsigned int flags;
+ /* number of threads in thread map */
+ int nkdthreads;
+ /* the owning pid */
+ int bufid;
} kbufinfo_t;
typedef struct {
- uintptr_t thread;
- int valid;
- char command[20];
+ /* the thread ID */
+ uintptr_t thread;
+ /* 0 for invalid, otherwise the PID (or 1 for kernel_task) */
+ int valid;
+ /* the name of the process owning the thread */
+ char command[20];
} kd_threadmap;
typedef struct {
- uint32_t version_no;
- uint32_t cpu_count;
+ uint32_t version_no;
+ uint32_t cpu_count;
} kd_cpumap_header;
/* cpumap flags */
#define KDBG_CPUMAP_IS_IOP 0x1
typedef struct {
- uint32_t cpu_id;
- uint32_t flags;
- char name[8];
+ uint32_t cpu_id;
+ uint32_t flags;
+ char name[8];
} kd_cpumap;
/*
// The CPU map is an optional sub-chunk of the header chunk. It provides
// information about the CPUs that are referenced from the trace events.
typedef struct {
- uint32_t tag;
- uint32_t sub_tag;
- uint64_t length;
- uint32_t timebase_numer;
- uint32_t timebase_denom;
- uint64_t timestamp;
- uint64_t walltime_secs;
- uint32_t walltime_usecs;
- uint32_t timezone_minuteswest;
- uint32_t timezone_dst;
- uint32_t flags;
-} kd_header_v3;
+ uint32_t tag;
+ uint32_t sub_tag;
+ uint64_t length;
+ uint32_t timebase_numer;
+ uint32_t timebase_denom;
+ uint64_t timestamp;
+ uint64_t walltime_secs;
+ uint32_t walltime_usecs;
+ uint32_t timezone_minuteswest;
+ uint32_t timezone_dst;
+ uint32_t flags;
+} __attribute__((packed)) kd_header_v3;
typedef struct {
uint32_t tag;
uint32_t sub_tag;
uint64_t length;
-} kd_chunk_header_v3;
+} __attribute__((packed)) kd_chunk_header_v3;
#define RAW_VERSION0 0x55aa0000
#define RAW_VERSION1 0x55aa0101
#define RAW_VERSION2 0x55aa0200 /* Only used by kperf and Instruments */
-#define RAW_VERSION3 0x00001000
+#define RAW_VERSION3 0x00001000
#define V3_CONFIG 0x00001b00
#define V3_CPU_MAP 0x00001c00
int kdbg_write_v3_chunk_header_to_buffer(void *buffer, uint32_t tag, uint32_t sub_tag, uint64_t length);
int kdbg_write_v3_chunk_to_fd(uint32_t tag, uint32_t sub_tag, uint64_t length, void *payload, uint64_t payload_size, int fd);
-#define KDBG_CLASSTYPE 0x10000
-#define KDBG_SUBCLSTYPE 0x20000
-#define KDBG_RANGETYPE 0x40000
-#define KDBG_TYPENONE 0x80000
-#define KDBG_CKTYPES 0xF0000
-
-#define KDBG_RANGECHECK 0x100000
-#define KDBG_VALCHECK 0x200000 /* Check up to 4 individual values */
-
-#define KDBG_TYPEFILTER_CHECK ((uint32_t) 0x400000) /* Check class and subclass against a bitmap */
-
-#define KDBG_BUFINIT 0x80000000
-
-/* Minimum value allowed when setting decrementer ticks */
-#define KDBG_MINRTCDEC 2500
-
/* VFS lookup events for serial traces */
#define VFS_LOOKUP (FSDBG_CODE(DBG_FSRW,36))
#define VFS_LOOKUP_DONE (FSDBG_CODE(DBG_FSRW,39))
-#ifdef XNU_KERNEL_PRIVATE
-#if (DEVELOPMENT || DEBUG)
+#if !CONFIG_EMBEDDED
+#if defined(XNU_KERNEL_PRIVATE) && (DEVELOPMENT || DEBUG)
#define KDEBUG_MOJO_TRACE 1
#endif
#endif
#endif /* __APPLE_API_PRIVATE */
-#endif /* PRIVATE */
+#endif /* PRIVATE */
#endif /* !BSD_SYS_KDEBUG_H */
projects / apple / xnu.git / blobdiff