Something went wrong. Try again.
Cider Isn't Darwin Emulation, Really
Something went wrong. Try again.
61 kB · 1635 lines
C
at android
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636/* * Copyright (c) 2000-2016 Apple Inc. All rights reserved. * * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ * * This file contains Original Code and/or Modifications of Original Code * as defined in and that are subject to the Apple Public Source License * Version 2.0 (the 'License'). You may not use this file except in * compliance with the License. The rights granted to you under the License * may not be used to create, or enable the creation or redistribution of, * unlawful or unlicensed copies of an Apple operating system, or to * circumvent, violate, or enable the circumvention or violation of, any * terms of an Apple operating system software license agreement. * * Please obtain a copy of the License at * http://www.opensource.apple.com/apsl/ and read it before using this file. * * The Original Code and all software distributed under the License are * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. * Please see the License for the specific language governing rights and * limitations under the License. * * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ */
/* * kdebug.h - kernel_debug definitions */
#ifndef BSD_SYS_KDEBUG_H#define BSD_SYS_KDEBUG_H
#include <sys/appleapiopts.h>#include <sys/cdefs.h>__BEGIN_DECLS
#ifdef __APPLE_API_UNSTABLE
#include <mach/clock_types.h>#include <stdint.h>
#ifndef KERNEL#include <Availability.h>#endif
#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 32-bit debugid: * * +----------------+----------------+----------------------------+----+ * | Class (8) | Subclass (8) | Code (14) |Func| * | | | |(2) | * +----------------+----------------+----------------------------+----+ * \_________________________________/ * 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 an interval). */
#define KDBG_CLASS_MASK (0xff000000)#define KDBG_CLASS_OFFSET (24)#define KDBG_CLASS_MAX (0xff)
#define KDBG_SUBCLASS_MASK (0x00ff0000)#define KDBG_SUBCLASS_OFFSET (16)#define KDBG_SUBCLASS_MAX (0xff)
/* 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) \ ((((Class) & 0xff) << KDBG_CLASS_OFFSET) | \ (((SubClass) & 0xff) << KDBG_SUBCLASS_OFFSET) | \ (((Code) & 0x3fff) << KDBG_CODE_OFFSET))/* Deprecated macro using old naming convention. */#define KDBG_CODE(Class, SubClass, Code) \ KDBG_EVENTID(Class, SubClass, Code)
/* Extract pieces of the debug code. */#define KDBG_EXTRACT_CLASS(Debugid) \ ((uint8_t)(((Debugid) & KDBG_CLASS_MASK) >> KDBG_CLASS_OFFSET))#define KDBG_EXTRACT_SUBCLASS(Debugid) \ ((uint8_t)(((Debugid) & KDBG_SUBCLASS_MASK) >> KDBG_SUBCLASS_OFFSET))#define KDBG_EXTRACT_CSC(Debugid) \ ((uint16_t)(((Debugid) & KDBG_CSC_MASK) >> KDBG_CSC_OFFSET))#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 { /* 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; /* name of IOP, NUL-terminated */ char iop_name[8];};
typedef struct kd_callback kd_callback_t;
/* * Registers an IOP for participation in tracing. * * The registered callback function will be called with the * supplied context as the first argument, followed by a * kd_callback_type and an associated void* argument. * * The return value is a nonzero coreid that shall be used in * 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 );
#endif /* KERNEL_PRIVATE */
/* 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_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 * using: * * kdebug_trace(KDBG_CODE(DBG_XPC, 15, 1) | DBG_FUNC_NONE, 1, 2, 3, 4); * * These trace points can be included in production code, since they * use reserved, non-overlapping ranges. The performance impact when * kernel tracing is not enabled is minimal. Classes can be reserved * by filing a Radar in xnu|all. * * 64-bit arguments may be truncated if the system is using a 32-bit * kernel. * * On error, -1 will be returned and errno will indicate the error. */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 * * @discussion * This function emits strings to kdebug trace along with an ID and allows * for previously-traced strings to be overwritten and invalidated. * * To start tracing a string and generate an ID to use to refer to it: * * string_id = kdebug_trace_string(debugid, 0, "string"); * * To replace a string previously traced: * * string_id = kdebug_trace_string(debugid, string_id, "new string"); * * To invalidate a string ID: * * string_id = kdebug_trace_string(debugid, string_id, NULL); * * To check for errors: * * if ((int64_t)string_id == -1) { perror("string error") } * * @param debugid * The `debugid` to check if its enabled before tracing and include as * an argument in the event containing the string. * * Some classes or subclasses are reserved for specific uses and are not * allowed to be used with this function. No function qualifiers are * allowed on `debugid`. * * @param str_id * When 0, a new ID will be generated and returned if tracing is * enabled. * * Otherwise `str_id` must contain an ID that was previously generated * with this function. Clents should pass NULL in `str` if `str_id` * is no longer in use. Otherwise, the string previously mapped to * `str_id` will be overwritten with the contents of `str`. * * @param str * A NUL-terminated 'C' string containing the characters that should be * traced alongside `str_id`. * * If necessary, the string will be truncated at an * implementation-defined length. The string must not be the empty * string, but can be NULL if a valid `str_id` is provided. * * @return * 0 if tracing is disabled or `debugid` is being filtered out of trace. * It can also return (int64_t)-1 if an error occured. Otherwise, * it returns the ID to use to refer to the string in future * kdebug_trace(2) calls. * * The errors that can occur are: * * EINVAL * There are function qualifiers on `debugid`, `str` is empty, or * `str_id` was not generated by this function. * EPERM * The `debugid`'s class or subclass is reserved for internal use. * EFAULT * `str` is an invalid address or NULL when `str_id` is 0. */extern uint64_t kdebug_trace_string(uint32_t debugid, uint64_t str_id, const char *str) __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_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 /* 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 keychord */#define DBG_MACH_ZALLOC 0xA5 /* Zone allocator */
/* Codes for Scheduler (DBG_MACH_SCHED) */#define MACH_SCHED 0x0 /* Scheduler */#define MACH_STACK_ATTACH 0x1 /* stack_attach() */#define MACH_STACK_HANDOFF 0x2 /* stack_handoff() */#define MACH_CALL_CONT 0x3 /* call_continuation() */#define MACH_CALLOUT 0x4 /* callouts */#define MACH_STACK_DETACH 0x5#define MACH_MAKE_RUNNABLE 0x6 /* make thread runnable */#define MACH_PROMOTE 0x7 /* promoted due to resource */#define MACH_DEMOTE 0x8 /* promotion undone */#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_FAILSAFE 0xe /* tripped fixed-pri/RT failsafe */#define MACH_BLOCK 0xf /* thread block */#define MACH_WAIT 0x10 /* thread wait assertion */#define MACH_GET_URGENCY 0x14 /* Urgency queried by platform */#define MACH_URGENCY 0x15 /* Urgency (RT/BG/NORMAL) communicated * to platform */#define MACH_REDISPATCH 0x16 /* "next thread" thread redispatched */#define MACH_REMOTE_AST 0x17 /* AST signal issued to remote processor */#define MACH_SCHED_CHOOSE_PROCESSOR 0x18 /* Result of choose_processor */#define MACH_DEEP_IDLE 0x19 /* deep idle on master processor *//* unused 0x1a was MACH_SCHED_DECAY_PRIORITY */#define MACH_CPU_THROTTLE_DISABLE 0x1b /* Global CPU Throttle Disable */#define MACH_RW_PROMOTE 0x1c /* promoted due to RW lock promotion */#define MACH_RW_DEMOTE 0x1d /* promotion due to RW lock undone */#define MACH_SCHED_MAINTENANCE 0x1f /* periodic maintenance thread */#define MACH_DISPATCH 0x20 /* context switch completed */#define MACH_QUANTUM_HANDOFF 0x21 /* quantum handoff occurred */#define MACH_MULTIQ_DEQUEUE 0x22 /* Result of multiq dequeue */#define MACH_SCHED_THREAD_SWITCH 0x23 /* attempt direct context switch to hinted thread */#define MACH_SCHED_SMT_BALANCE 0x24 /* SMT load balancing ASTs */#define MACH_REMOTE_DEFERRED_AST 0x25 /* Deferred AST started against remote processor */#define MACH_REMOTE_CANCEL_AST 0x26 /* Canceled deferred AST for remote processor */#define MACH_SCHED_CHANGE_PRIORITY 0x27 /* thread sched priority changed */#define MACH_SCHED_UPDATE_REC_CORES 0x28 /* Change to recommended processor bitmask */#define MACH_STACK_WAIT 0x29 /* Thread could not be switched-to because of kernel stack shortage */#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 */
/* Variants for MACH_MULTIQ_DEQUEUE */#define MACH_MULTIQ_BOUND 1#define MACH_MULTIQ_GROUP 2#define MACH_MULTIQ_GLOBAL 3
/* Arguments for vm_fault (DBG_MACH_VM) */#define DBG_ZERO_FILL_FAULT 1#define DBG_PAGEIN_FAULT 2#define DBG_COW_FAULT 3#define DBG_CACHE_HIT_FAULT 4#define DBG_NZF_PAGE_FAULT 5#define DBG_GUARD_FAULT 6#define DBG_PAGEINV_FAULT 7#define DBG_PAGEIND_FAULT 8#define DBG_COMPRESSOR_FAULT 9#define DBG_COMPRESSOR_SWAPIN_FAULT 10
/* Codes for IPC (DBG_MACH_IPC) */#define MACH_TASK_SUSPEND 0x0 /* Suspended a task */#define MACH_TASK_RESUME 0x1 /* Resumed a task */#define MACH_THREAD_SET_VOUCHER 0x2#define MACH_IPC_MSG_SEND 0x3 /* mach msg send, uniq msg info */#define MACH_IPC_MSG_RECV 0x4 /* mach_msg receive */#define MACH_IPC_MSG_RECV_VOUCHER_REFUSED 0x5 /* mach_msg receive, voucher refused */#define MACH_IPC_KMSG_FREE 0x6 /* kernel free of kmsg data */#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 pmap (DBG_MACH_PMAP) */#define PMAP__CREATE 0x0#define PMAP__DESTROY 0x1#define PMAP__PROTECT 0x2#define PMAP__PAGE_PROTECT 0x3#define PMAP__ENTER 0x4#define PMAP__REMOVE 0x5#define PMAP__NEST 0x6#define PMAP__UNNEST 0x7#define PMAP__FLUSH_TLBS 0x8#define PMAP__UPDATE_INTERRUPT 0x9#define PMAP__ATTRIBUTE_CLEAR 0xa#define PMAP__REUSABLE 0xb#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
/* 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 Selective Forced Idle (DBG_MACH_SFI) */#define SFI_SET_WINDOW 0x0#define SFI_CANCEL_WINDOW 0x1#define SFI_SET_CLASS_OFFTIME 0x2#define SFI_CANCEL_CLASS_OFFTIME 0x3#define SFI_THREAD_DEFER 0x4#define SFI_OFF_TIMER 0x5#define SFI_ON_TIMER 0x6#define SFI_WAIT_CANCELED 0x7#define SFI_PID_SET_MANAGED 0x8#define SFI_PID_CLEAR_MANAGED 0x9#define SFI_GLOBAL_DEFER 0xa
/* 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_NETUDP 3 /* User Datagram Protocol */#define DBG_NETTCP 4 /* Transmission Control Protocol */#define DBG_NETICMP 5 /* Internet Control Message Protocol */#define DBG_NETIGMP 6 /* Internet Group Management Protocol */#define DBG_NETRIP 7 /* Routing Information Protocol */#define DBG_NETOSPF 8 /* Open Shortest Path First */#define DBG_NETISIS 9 /* Intermediate System to Intermediate System */#define DBG_NETSNMP 10 /* Simple Network Management Protocol */#define DBG_NETSOCK 11 /* Socket Layer */
/* For Apple talk */#define DBG_NETAARP 100 /* Apple ARP */#define DBG_NETDDP 101 /* Datagram Delivery Protocol */#define DBG_NETNBP 102 /* Name Binding Protocol */#define DBG_NETZIP 103 /* Zone Information Protocol */#define DBG_NETADSP 104 /* Name Binding Protocol */#define DBG_NETATP 105 /* Apple Transaction Protocol */#define DBG_NETASP 106 /* Apple Session Protocol */#define DBG_NETAFP 107 /* Apple Filing Protocol */#define DBG_NETRTMP 108 /* Routing Table Maintenance Protocol */#define DBG_NETAURP 109 /* Apple Update Routing Protocol */
#define DBG_NETIPSEC 128 /* IPsec Protocol */#define DBG_NETVMNET 129 /* VMNet */
/* **** The Kernel Debug Sub Classes for IOKIT (DBG_IOKIT) **** */#define DBG_IOINTC 0 /* Interrupt controller */#define DBG_IOWORKLOOP 1 /* Work from work loop */#define DBG_IOINTES 2 /* Interrupt event source */#define DBG_IOCLKES 3 /* Clock event source */#define DBG_IOCMDQ 4 /* Command queue latencies */#define DBG_IOMCURS 5 /* Memory Cursor */#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_IOSTORAGE 32 /* Storage layers */#define DBG_IONETWORK 33 /* Network layers */#define DBG_IOKEYBOARD 34 /* Keyboard */#define DBG_IOHID 35 /* HID Devices */#define DBG_IOAUDIO 36 /* Audio */#define DBG_IOSERIAL 37 /* Serial */#define DBG_IOTTY 38 /* TTY layers */#define DBG_IOSAM 39 /* SCSI Architecture Model layers */#define DBG_IOPARALLELATA 40 /* Parallel ATA */#define DBG_IOPARALLELSCSI 41 /* Parallel SCSI */#define DBG_IOSATA 42 /* Serial-ATA */#define DBG_IOSAS 43 /* SAS */#define DBG_IOFIBRECHANNEL 44 /* FiberChannel */#define DBG_IOUSB 45 /* USB */#define DBG_IOBLUETOOTH 46 /* Bluetooth */#define DBG_IOFIREWIRE 47 /* FireWire */#define DBG_IOINFINIBAND 48 /* Infiniband */#define DBG_IOCPUPM 49 /* CPU Power Management */#define DBG_IOGRAPHICS 50 /* Graphics */#define DBG_HIBERNATE 51 /* hibernation related events */#define DBG_IOTHUNDERBOLT 52 /* Thunderbolt */
/* 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_DRVWLAN_802_11 23 /* WLAN 802.11 */
/* Backwards compatibility */#define DBG_DRVPOINTING DBG_DRVHID /* OBSOLETE: Use DBG_DRVHID instead */#define DBG_DRVDISK DBG_DRVSTORAGE /* OBSOLETE: Use DBG_DRVSTORAGE instead */
/* **** The Kernel Debug Sub Classes for the DLIL Layer (DBG_DLIL) **** */#define DBG_DLIL_STATIC 1 /* Static DLIL code */#define DBG_DLIL_PR_MOD 2 /* DLIL Protocol Module */#define DBG_DLIL_IF_MOD 3 /* DLIL Interface Module */#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 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_THROTTLE 0x11 /* I/O Throttling events */#define DBG_CONTENT_PROT 0xCF /* Content Protection Events: see bsd/sys/cprotect.h */
/* * For Kernel Debug Sub Class DBG_HFS, state bits for hfs_update event */#define DBG_HFS_UPDATE_ACCTIME 0x01#define DBG_HFS_UPDATE_MODTIME 0x02#define DBG_HFS_UPDATE_CHGTIME 0x04#define DBG_HFS_UPDATE_MODIFIED 0x08#define DBG_HFS_UPDATE_FORCE 0x10#define DBG_HFS_UPDATE_DATEADDED 0x20#define DBG_HFS_UPDATE_MINOR 0x40#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_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_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_JETSAM 2 /* LRU jetsam */#define BSD_MEMSTAT_JETSAM_HIWAT 3 /* highwater jetsam */#define BSD_MEMSTAT_FREEZE 4 /* freeze process */#define BSD_MEMSTAT_LATENCY_COALESCE 5 /* delay imposed to coalesce jetsam reports */#define BSD_MEMSTAT_UPDATE 6 /* priority update */#define BSD_MEMSTAT_IDLE_DEMOTE 7 /* idle demotion fired */#define BSD_MEMSTAT_CLEAR_ERRORS 8 /* reset termination error state */#define BSD_MEMSTAT_DIRTY_TRACK 9 /* track the process state */#define BSD_MEMSTAT_DIRTY_SET 10 /* set the process state */#define BSD_MEMSTAT_DIRTY_CLEAR 11 /* clear the process state */#ifdef PRIVATE#define BSD_MEMSTAT_GRP_SET_PROP 12 /* set group properties */#define BSD_MEMSTAT_DO_KILL 13 /* memorystatus kills */#endif /* PRIVATE */
/* 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_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))
/* 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 */
/* Sub-class codes for CoreGraphics (DBG_CG) are defined in its component. */
/* 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_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_READ 0x02#define DKIO_ASYNC 0x04#define DKIO_META 0x08#define DKIO_PAGING 0x10#define DKIO_THROTTLE 0x20 /* Deprecated, still provided so fs_usage doesn't break */#define DKIO_PASSIVE 0x40#define DKIO_NOCACHE 0x80#define DKIO_TIER_MASK 0xF00#define DKIO_TIER_SHIFT 8
/* Kernel Debug Sub Classes for Applications (DBG_APPS) */#define DBG_APP_LOGINWINDOW 0x03#define DBG_APP_AUDIO 0x04#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
/* Kernel Debug codes for Throttling (DBG_THROTTLE) */#define OPEN_THROTTLE_WINDOW 0x1#define PROCESS_THROTTLED 0x2#define IO_THROTTLE_DISABLE 0x3
/* Subclasses for MACH Importance Policies (DBG_IMPORTANCE) *//* TODO: Split up boost and task policy? */#define IMP_ASSERTION 0x10 /* Task takes/drops a boost assertion */#define IMP_BOOST 0x11 /* Task boost level changed */#define IMP_MSG 0x12 /* boosting message sent by donating task on donating port */#define IMP_WATCHPORT 0x13 /* port marked as watchport, and boost was transferred to the watched task */#define IMP_TASK_SUPPRESSION 0x17 /* Task changed suppression behaviors */#define IMP_TASK_APPTYPE 0x18 /* Task launched with apptype */#define IMP_UPDATE 0x19 /* Requested -> effective calculation */#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 *//* DBG_IMPORTANCE subclasses 0x20 - 0x3F reserved for task policy flavors */
/* Codes for IMP_ASSERTION */#define IMP_HOLD 0x2 /* Task holds a boost assertion */#define IMP_DROP 0x4 /* Task drops a boost assertion */#define IMP_EXTERN 0x8 /* boost assertion moved from kernel to userspace responsibility (externalized) */
/* Codes for IMP_BOOST */#define IMP_BOOSTED 0x1#define IMP_UNBOOSTED 0x2 /* Task drops a boost assertion */
/* Codes for IMP_MSG */#define IMP_MSG_SEND 0x1 /* boosting message sent by donating task on donating port */#define IMP_MSG_DELV 0x2 /* boosting message delivered to task */
/* Codes for IMP_UPDATE */#define IMP_UPDATE_TASK_CREATE 0x1
/* Codes for IMP_USYNCH_QOS_OVERRIDE */#define IMP_USYNCH_ADD_OVERRIDE 0x0 /* add override for a contended resource */#define IMP_USYNCH_REMOVE_OVERRIDE 0x1 /* remove override for a contended resource */
/* Codes for IMP_DONOR_CHANGE */#define IMP_DONOR_UPDATE_LIVE_DONOR_STATE 0x0#define IMP_DONOR_INIT_DONOR_STATE 0x1
/* 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 */
/* Subclasses for MACH ATM Voucher Attribute Manager (ATM) */#define ATM_SUBAID_INFO 0x10#define ATM_GETVALUE_INFO 0x20#define ATM_UNREGISTER_INFO 0x30
/* 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. */
/* Codes for ATM_SUBAID_INFO */#define ATM_MIN_CALLED 0x1#define ATM_LINK_LIST_TRIM 0x2
/* Codes for ATM_GETVALUE_INFO */#define ATM_VALUE_REPLACED 0x1#define ATM_VALUE_ADDED 0x2
/* Codes for ATM_UNREGISTER_INFO */#define ATM_VALUE_UNREGISTERED 0x1#define ATM_VALUE_DIFF_MAILBOX 0x2
/* Kernel Debug Sub Classes for daemons (DBG_DAEMON) */#define DBG_DAEMON_COREDUET 0x1
/* 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) | \ (((msgid) & 0x3fffff) << KDBG_CODE_OFFSET))
#define MACHDBG_CODE(SubClass, code) KDBG_CODE(DBG_MACH, SubClass, code)#define NETDBG_CODE(SubClass, code) KDBG_CODE(DBG_NETWORK, SubClass, code)#define FSDBG_CODE(SubClass, code) KDBG_CODE(DBG_FSYSTEM, SubClass, code)#define BSDDBG_CODE(SubClass, code) KDBG_CODE(DBG_BSD, SubClass, code)#define IOKDBG_CODE(SubClass, code) KDBG_CODE(DBG_IOKIT, SubClass, code)#define DRVDBG_CODE(SubClass, code) KDBG_CODE(DBG_DRIVERS, SubClass, code)#define TRACEDBG_CODE(SubClass,code) KDBG_CODE(DBG_TRACE, SubClass, code)#define MISCDBG_CODE(SubClass,code) KDBG_CODE(DBG_MISC, SubClass, code)#define DLILDBG_CODE(SubClass,code) KDBG_CODE(DBG_DLIL, SubClass, code)#define SECURITYDBG_CODE(SubClass,code) KDBG_CODE(DBG_SECURITY, SubClass, code)#define DYLDDBG_CODE(SubClass,code) KDBG_CODE(DBG_DYLD, SubClass, code)#define QTDBG_CODE(SubClass,code) KDBG_CODE(DBG_QT, SubClass, code)#define APPSDBG_CODE(SubClass,code) KDBG_CODE(DBG_APPS, SubClass, code)#define ARIADNEDBG_CODE(SubClass, code) KDBG_CODE(DBG_ARIADNE, SubClass, code)#define DAEMONDBG_CODE(SubClass, code) KDBG_CODE(DBG_DAEMON, SubClass, code)#define CPUPM_CODE(code) IOKDBG_CODE(DBG_IOCPUPM, code)
#define KMEM_ALLOC_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 0)#define KMEM_ALLOC_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 1)#define KMEM_FREE_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 2)#define KMEM_FREE_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 3)#define ZALLOC_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 4)#define ZALLOC_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 5)#define ZFREE_CODE MACHDBG_CODE(DBG_MACH_LEAKS, 6)#define ZFREE_CODE_2 MACHDBG_CODE(DBG_MACH_LEAKS, 7)
#define PMAP_CODE(code) MACHDBG_CODE(DBG_MACH_PMAP, code)
#define IMPORTANCE_CODE(SubClass, code) KDBG_CODE(DBG_IMPORTANCE, (SubClass), (code))#define BANK_CODE(SubClass, code) KDBG_CODE(DBG_BANK, (SubClass), (code))#define ATM_CODE(SubClass, code) KDBG_CODE(DBG_ATM, (SubClass), (code))
/* Kernel Debug Macros for specific daemons */#define COREDUETDBG_CODE(code) DAEMONDBG_CODE(DBG_DAEMON_COREDUET, code)
/* * 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;
/* * 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_STANDARD 2#define KDEBUG_LEVEL_FULL 3
#if NO_KDEBUG#define KDEBUG_LEVEL KDEBUG_LEVEL_NONE#elif IST_KDEBUG#define KDEBUG_LEVEL KDEBUG_LEVEL_IST // currently configured for the iOS release kernel#elif KDEBUG#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. */#endif
#ifdef XNU_KERNEL_PRIVATE#define KDBG_IMPROBABLE __improbable#else#define KDBG_IMPROBABLE#endif
/* * 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) */
#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)
/* * 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)#endif /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_STANDARD) */
/* * 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)
#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) */
#if NO_KDEBUG#define __kdebug_constant_only __unused#endif
/* * KERNEL_DEBUG events are only traced for DEBUG kernels. */#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)
/* * DO NOT USE THIS MACRO -- see warning above for KERNEL_DEBUG_CONSTANT1. */#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 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) \do { \ uint32_t kdcode__; \ uintptr_t highval__, lowval__, mask__ = 0xffffffff; \ kdcode__ = KDBG_CODE(DBG_ENERGYTRACE,component,opcode)|(lifespan); \ highval__ = ((value) >> 32) & mask__; \ lowval__ = (value) & mask__; \ ENTR_KDTRACEFUNC(kdcode__, id, quality, highval__, lowval__); \} while(0)
/* Trace the association of two existing activations.
An association is traced as a modification to the parent activation. In order to fit the sub-activation's component, activation code, and activation ID into a kdebug tracepoint, the arguments that would hold the value are left separate, and one stores the component and opcode of the sub-activation, while the other stores the pointer-sized activation ID.
arg2 arg3 arg4 +-----------------+ +~+----+----+--------+ +----------+ |kEnTrModAssociate| | | | | | | | +-----------------+ +~+----+----+--------+ +----------+ 8-bits unused sub-activation ID 8-bit sub-component 16-bit sub-opcode
*/#define kEnTrModAssociate (1 << 28)#define ENTR_KDASSOCIATE(par_comp, par_opcode, par_act_id, \ sub_comp, sub_opcode, sub_act_id) \do { \ unsigned sub_compcode = ((unsigned)sub_comp << 16) | sub_opcode; \ ENTR_KDTRACEFUNC(KDBG_CODE(DBG_ENERGYTRACE,par_comp,par_opcode), \ par_act_id, kEnTrModAssociate, sub_compcode, \ sub_act_id); \} while(0)
#else /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_IST) */
#define ENTR_SHOULDTRACE FALSE#define ENTR_KDTRACE(component, opcode, lifespan, id, quality, value) \ do {} while (0)#define ENTR_KDASSOCIATE(par_comp, par_opcode, par_act_id, \ sub_comp, sub_opcode, sub_act_id) \ do {} while (0)
#endif /* (KDEBUG_LEVEL >= KDEBUG_LEVEL_IST) */
#ifdef KERNEL_PRIVATE/* * kernel_debug_string provides the same functionality as the * kdebug_trace_string syscall as a KPI. str_id is an in/out * parameter that, if it's pointing to a string ID of 0, will * receive a generated ID. If it provides a value in str_id, * then that will be used, instead. * * Returns an errno indicating the type of failure. */extern intkernel_debug_string(uint32_t debugid, uint64_t *str_id, const char *str);
/* * 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
/* EnergyTracing opcodes
Activations use DBG_FUNC_START/END. Events are DBG_FUNC_NONE. */
/* Socket reads and writes are uniquely identified by the (sanitized) pointer to the socket struct in question. To associate this address with the user space file descriptor, we have a socket activation with the FD as its identifier and the socket struct pointer as its value.*/#define kEnTrActKernSocket 1#define kEnTrActKernSockRead 2#define kEnTrActKernSockWrite 3
#define kEnTrActKernPoll 10#define kEnTrActKernSelect 11#define kEnTrActKernKQWait 12
// events#define kEnTrEvUnblocked 256
// EnergyTracing flags (the low-order 16 bits of 'quality')#define kEnTrFlagNonBlocking 1 << 0#define kEnTrFlagNoWork 1 << 1
// and now the internal mechanism#ifdef KERNEL_PRIVATE
// 20452597 requests that the trace macros not take an argument it throws away#define KERNEL_DBG_IST_SANE(x, a, b, c, d) \ KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, x, a, b, c, d, \ 0 /*__unused in kernel_debug()*/)#define ENTR_KDTRACEFUNC KERNEL_DBG_IST_SANE
// value is int64_t, quality is uint32_t#define KERNEL_ENERGYTRACE(opcode, lifespan, id, quality, value) \ ENTR_KDTRACE(kEnTrCompKernel, opcode, lifespan, id, \ quality, value)#define KERNEL_ENTR_ASSOCIATE(par_opcode, par_act_id, sub_opcode, sub_act_id) \ ENTR_KDASSOCIATE(kEnTrCompKernel, par_opcode, par_act_id, \ kEnTrCompKernel, sub_opcode, sub_act_id)
// end EnergyTracing
#include <mach/boolean.h>
#define NUMPARMS 23
struct proc;
extern boolean_t kdebug_debugid_enabled(uint32_t debugid);extern uint32_t kdebug_commpage_state(void);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);
extern void kdbg_trace_string(struct proc *proc, long *arg1, long *arg2, long *arg3, long *arg4);
extern void kdbg_dump_trace_to_file(const char *);void kdebug_boot_trace(unsigned int n_events, char *filterdesc);void kdebug_trace_start(unsigned int n_events, const char *filterdesc, boolean_t need_map);struct task;extern 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 /* __APPLE_API_UNSTABLE */__END_DECLS
#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; /* the thread ID */ uint32_t debugid;#if defined(__LP64__) 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 56static inline voidkdbg_set_cpu(kd_buf *kp, int cpu){ kp->timestamp = (kp->timestamp & KDBG_TIMESTAMP_MASK) | (((uint64_t) cpu) << KDBG_CPU_SHIFT);}static inline intkdbg_get_cpu(kd_buf *kp){ return (int) (((kp)->timestamp & KDBG_CPU_MASK) >> KDBG_CPU_SHIFT);}static inline voidkdbg_set_timestamp(kd_buf *kp, uint64_t thetime){ kp->timestamp = thetime & KDBG_TIMESTAMP_MASK;}static inline uint64_tkdbg_get_timestamp(kd_buf *kp){ return kp->timestamp & KDBG_TIMESTAMP_MASK;}static inline voidkdbg_set_timestamp_and_cpu(kd_buf *kp, uint64_t thetime, int cpu){ kp->timestamp = (thetime & KDBG_TIMESTAMP_MASK) | (((uint64_t) cpu) << KDBG_CPU_SHIFT);}#else#define KDBG_TIMESTAMP_MASK 0xffffffffffffffffULLstatic inline voidkdbg_set_cpu(kd_buf *kp, int cpu){ kp->cpuid = cpu;}static inline intkdbg_get_cpu(kd_buf *kp){ return kp->cpuid;}static inline voidkdbg_set_timestamp(kd_buf *kp, uint64_t thetime){ kp->timestamp = thetime;}static inline uint64_tkdbg_get_timestamp(kd_buf *kp){ return kp->timestamp;}static inline voidkdbg_set_timestamp_and_cpu(kd_buf *kp, uint64_t thetime, int cpu){ kdbg_set_timestamp(kp, thetime); kdbg_set_cpu(kp, cpu);}#endif
/* * 2^16 bits (8 kilobytes), one for each possible class/subclass combination */#define KDBG_TYPEFILTER_BITMAP_SIZE ((256 * 256) / 8)
/* * 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 { /* 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 { /* 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;} kd_cpumap_header;
/* cpumap flags */#define KDBG_CPUMAP_IS_IOP 0x1
typedef struct { uint32_t cpu_id; uint32_t flags; char name[8];} kd_cpumap;
/* * TRACE file formats... * * RAW_VERSION0 * * uint32_t #threadmaps * kd_threadmap[] * kd_buf[] * * RAW_VERSION1 * * RAW_header, with version_no set to RAW_VERSION1 * kd_threadmap[] * Empty space to pad alignment to the nearest page boundary. * kd_buf[] * * RAW_VERSION1+ * * RAW_header, with version_no set to RAW_VERSION1 * kd_threadmap[] * kd_cpumap_header, with version_no set to RAW_VERSION1 * kd_cpumap[] * Empty space to pad alignment to the nearest page boundary. * kd_buf[] * * V1+ implementation details... * * It would have been nice to add the cpumap data "correctly", but there were * several obstacles. Existing code attempts to parse both V1 and V0 files. * Due to the fact that V0 has no versioning or header, the test looks like * this: * * // Read header * if (header.version_no != RAW_VERSION1) { // Assume V0 } * * If we add a VERSION2 file format, all existing code is going to treat that * as a VERSION0 file when reading it, and crash terribly when trying to read * RAW_VERSION2 threadmap entries. * * To differentiate between a V1 and V1+ file, read as V1 until you reach * the padding bytes. Then: * * boolean_t is_v1plus = FALSE; * if (padding_bytes >= sizeof(kd_cpumap_header)) { * kd_cpumap_header header = // read header; * if (header.version_no == RAW_VERSION1) { * is_v1plus = TRUE; * } * } * */
typedef struct { int version_no; int thread_count; uint64_t TOD_secs; uint32_t TOD_usecs;} RAW_header;
// Version 3 header// The header chunk has the tag 0x00001000 which also serves as a magic word// that identifies the file as a version 3 trace file. The header payload is// a set of fixed fields followed by a variable number of sub-chunks:/* ____________________________________________________________________________ | Offset | Size | Field | ---------------------------------------------------------------------------- | 0 | 4 | Tag (0x00001000) | | 4 | 4 | Sub-tag. Represents the version of the header. | | 8 | 8 | Length of header payload (40+8x) | | 16 | 8 | Time base info. Two 32-bit numbers, numer/denom, | | | | for converting timestamps to nanoseconds. | | 24 | 8 | Timestamp of trace start. | | 32 | 8 | Wall time seconds since Unix epoch. | | | | As returned by gettimeofday(). | | 40 | 4 | Wall time microseconds. As returned by gettimeofday(). | | 44 | 4 | Local time zone offset in minutes. ( " ) | | 48 | 4 | Type of daylight savings time correction to apply. ( " ) | | 52 | 4 | Flags. 1 = 64-bit. Remaining bits should be written | | | | as 0 and ignored when reading. | | 56 | 8x | Variable number of sub-chunks. None are required. | | | | Ignore unknown chunks. | ----------------------------------------------------------------------------*/// NOTE: The header sub-chunks are considered part of the header chunk,// so they must be included in the header chunk’s length field.// 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;} __attribute__((packed)) kd_header_v3;
typedef struct { uint32_t tag; uint32_t sub_tag; uint64_t length;} __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 V3_CONFIG 0x00001b00#define V3_CPU_MAP 0x00001c00#define V3_THREAD_MAP 0x00001d00#define V3_RAW_EVENTS 0x00001e00#define V3_NULL_CHUNK 0x00002000
// The current version of all kernel managed chunks is 1. The// V3_CURRENT_CHUNK_VERSION is added to ease the simple case// when most/all the kernel managed chunks have the same version.
#define V3_CURRENT_CHUNK_VERSION 1#define V3_HEADER_VERSION V3_CURRENT_CHUNK_VERSION#define V3_CPUMAP_VERSION V3_CURRENT_CHUNK_VERSION#define V3_THRMAP_VERSION V3_CURRENT_CHUNK_VERSION#define V3_EVENT_DATA_VERSION V3_CURRENT_CHUNK_VERSION
// Apis to support writing v3 chunks in the kernelint 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);
/* VFS lookup events for serial traces */#define VFS_LOOKUP (FSDBG_CODE(DBG_FSRW,36))#define VFS_LOOKUP_DONE (FSDBG_CODE(DBG_FSRW,39))
#if defined(XNU_KERNEL_PRIVATE) && (DEVELOPMENT || DEBUG)#define KDEBUG_MOJO_TRACE 1#endif
#endif /* __APPLE_API_PRIVATE */#endif /* PRIVATE */
#endif /* !BSD_SYS_KDEBUG_H */