/*
- * Copyright (c) 1998-2000 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 1998-2010 Apple Inc. All rights reserved.
*
- * @APPLE_LICENSE_HEADER_START@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
*
- * The contents of this file constitute Original Code as defined in and
- * are subject to the Apple Public Source License Version 1.1 (the
- * "License"). You may not use this file except in compliance with the
- * License. Please obtain a copy of the License at
- * http://www.apple.com/publicsource and read it before using this file.
+ * 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.
*
- * This Original Code and all software distributed under the License are
- * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * 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 OR NON-INFRINGEMENT. Please see the
- * License for the specific language governing rights and limitations
- * under the License.
+ * 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_LICENSE_HEADER_END@
- */
-/*
- * Copyright (c) 1998 Apple Computer, Inc. All rights reserved.
- *
- * HISTORY
- *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
*/
-
#ifndef _IOKIT_IOKITDEBUG_H
#define _IOKIT_IOKITDEBUG_H
public:
static OSObject * diagnostics( void );
- virtual bool serialize(OSSerialize *s) const;
+ virtual bool serialize(OSSerialize *s) const APPLE_KEXT_OVERRIDE;
private:
static void updateOffset( OSDictionary * dict,
- UInt32 value, const char * name );
+ UInt64 value, const char * name );
};
-#endif __cplusplus
+#endif /* __cplusplus */
enum {
-// loggage
- kIOLogAttach = 0x00000001ULL,
- kIOLogProbe = 0x00000002ULL,
- kIOLogStart = 0x00000004ULL,
- kIOLogRegister = 0x00000008ULL,
- kIOLogMatch = 0x00000010ULL,
- kIOLogConfig = 0x00000020ULL,
- kIOLogYield = 0x00000040ULL,
- kIOLogPower = 0x00000080ULL,
- kIOLogMapping = 0x00000100ULL,
- kIOLogCatalogue = 0x00000200ULL,
- kIOLogTracePower = 0x00000400ULL,
-
- kIOLogServiceTree = 0x00001000ULL,
- kIOLogDTree = 0x00002000ULL,
- kIOLogMemory = 0x00004000ULL,
-
-// debug aids - change behaviour
- kIONoFreeObjects = 0x00100000ULL,
- kIOLogSynchronous = 0x00200000ULL, // IOLog completes synchrounsly
+ // loggage
+ kIOLogAttach = 0x00000001ULL,
+ kIOLogProbe = 0x00000002ULL,
+ kIOLogStart = 0x00000004ULL,
+ kIOLogRegister = 0x00000008ULL,
+ kIOLogMatch = 0x00000010ULL,
+ kIOLogConfig = 0x00000020ULL,
+ kIOLogYield = 0x00000040ULL,
+ kIOLogPower = 0x00000080ULL,
+ kIOLogMapping = 0x00000100ULL,
+ kIOLogCatalogue = 0x00000200ULL,
+ kIOLogTracePower = 0x00000400ULL, // Obsolete: Use iotrace=0x00000400ULL to enable now
+ kIOLogDebugPower = 0x00000800ULL,
+ kIOLogServiceTree = 0x00001000ULL,
+ kIOLogDTree = 0x00002000ULL,
+ kIOLogMemory = 0x00004000ULL,
+ kIOLogKextMemory = 0x00008000ULL,
+ kOSLogRegistryMods = 0x00010000ULL, // Log attempts to modify registry collections
+ kIOLogPMRootDomain = 0x00020000ULL,
+ kOSRegistryModsMode = 0x00040000ULL, // Change default registry modification handling - panic vs. log
+// kIOTraceIOService = 0x00080000ULL, // Obsolete: Use iotrace=0x00080000ULL to enable now
+ kIOLogHibernate = 0x00100000ULL,
+ kIOStatistics = 0x04000000ULL,
+ kIOSleepWakeWdogOff = 0x40000000ULL,
+ kIOKextSpinDump = 0x80000000ULL,
+
+ // debug aids - change behaviour
+ kIONoFreeObjects = 0x00100000ULL,
+// kIOLogSynchronous = 0x00200000ULL, // IOLog completes synchronously -- obsolete
+ kIOTracking = 0x00400000ULL,
+ kIOWaitQuietPanics = 0x00800000ULL,
+ kIOWaitQuietBeforeRoot = 0x01000000ULL,
+ kIOTrackingBoot = 0x02000000ULL,
+
+ _kIODebugTopFlag = 0x8000000000000000ULL // force enum to be 64 bits
};
-extern SInt64 gIOKitDebug;
-extern char iokit_version[];
+enum {
+ kIOKitDebugUserOptions = 0
+ | kIOLogAttach
+ | kIOLogProbe
+ | kIOLogStart
+ | kIOLogRegister
+ | kIOLogMatch
+ | kIOLogConfig
+ | kIOLogYield
+ | kIOLogPower
+ | kIOLogMapping
+ | kIOLogCatalogue
+ | kIOLogTracePower
+ | kIOLogDebugPower
+ | kOSLogRegistryMods
+ | kIOLogPMRootDomain
+ | kOSRegistryModsMode
+ | kIOLogHibernate
+ | kIOSleepWakeWdogOff
+ | kIOKextSpinDump
+ | kIOWaitQuietPanics
+};
+
+enum {
+ kIOTraceInterrupts = 0x00000001ULL, // Trace primary interrupts
+ kIOTraceWorkLoops = 0x00000002ULL, // Trace workloop activity
+ kIOTraceEventSources = 0x00000004ULL, // Trace non-passive event sources
+ kIOTraceIntEventSource = 0x00000008ULL, // Trace IOIES and IOFIES sources
+ kIOTraceCommandGates = 0x00000010ULL, // Trace command gate activity
+ kIOTraceTimers = 0x00000020ULL, // Trace timer event source activity
+
+ kIOTracePowerMgmt = 0x00000400ULL, // Trace power management changes
+
+ kIOTraceIOService = 0x00080000ULL, // registerService/termination
+
+ kIOTraceCompatBootArgs = kIOTraceIOService | kIOTracePowerMgmt
+};
+
+extern SInt64 gIOKitDebug;
+extern SInt64 gIOKitTrace;
#ifdef __cplusplus
extern "C" {
#endif
-struct IORegistryPlane;
-extern void IOPrintPlane( const struct IORegistryPlane * plane );
-extern void OSPrintMemory( void );
+#ifdef __cplusplus
+class IORegistryPlane;
+#endif
+
+extern void IOPrintPlane(
+#ifdef __cplusplus
+ const IORegistryPlane * plane
+#else
+ const struct IORegistryPlane * plane
+#endif
+ );
+#ifndef _OSCPPDEBUG_H
+extern void OSPrintMemory( void );
+#endif
#define IOPrintMemory OSPrintMemory
+
+
+#define kIOKitDiagnosticsClientClassName "IOKitDiagnosticsClient"
+
+enum
+{
+ kIOKitDiagnosticsClientType = 0x99000002
+};
+
+
+struct IOKitDiagnosticsParameters
+{
+ size_t size;
+ uint64_t value;
+ uint32_t options;
+ uint32_t tag;
+ uint32_t zsize;
+ uint32_t reserved[8];
+};
+typedef struct IOKitDiagnosticsParameters IOKitDiagnosticsParameters;
+
+enum
+{
+ kIOTrackingCallSiteBTs = 16,
+};
+
+struct IOTrackingCallSiteInfo
+{
+ uint32_t count;
+ pid_t addressPID;
+ mach_vm_address_t address;
+ mach_vm_size_t size[2];
+ pid_t btPID;
+ mach_vm_address_t bt[2][kIOTrackingCallSiteBTs];
+};
+
+#define kIOMallocTrackingName "IOMalloc"
+#define kIOWireTrackingName "IOWire"
+#define kIOMapTrackingName "IOMap"
+
+#if XNU_KERNEL_PRIVATE && IOTRACKING
+
+struct IOTrackingQueue;
+struct IOTrackingCallSite;
+
+struct IOTracking
+{
+ queue_chain_t link;
+ IOTrackingCallSite * site;
+#if !defined(__LP64__)
+ uint32_t flags;
+#endif
+};
+
+struct IOTrackingAddress
+{
+ IOTracking tracking;
+ uintptr_t address;
+ size_t size;
+#if defined(__LP64__)
+ uint32_t flags;
+#endif
+};
+
+struct IOTrackingUser
+{
+ queue_chain_t link;
+ pid_t btPID;
+ uint8_t user32;
+ uint8_t userCount;
+ uintptr_t bt[kIOTrackingCallSiteBTs];
+ uintptr_t btUser[kIOTrackingCallSiteBTs];
+};
+
+enum
+{
+ kIOTrackingQueueTypeDefaultOn = 0x00000001,
+ kIOTrackingQueueTypeAlloc = 0x00000002,
+ kIOTrackingQueueTypeMap = 0x00000004,
+ kIOTrackingQueueTypeUser = 0x00000008,
+};
+
+
+void IOTrackingInit(void);
+IOTrackingQueue * IOTrackingQueueAlloc(const char * name, uintptr_t btEntry,
+ size_t allocSize, size_t minCaptureSize,
+ uint32_t type, uint32_t numSiteQs);
+void IOTrackingQueueFree(IOTrackingQueue * head);
+void IOTrackingAdd(IOTrackingQueue * head, IOTracking * mem, size_t size, bool address, vm_tag_t tag);
+void IOTrackingRemove(IOTrackingQueue * head, IOTracking * mem, size_t size);
+void IOTrackingAddUser(IOTrackingQueue * queue, IOTrackingUser * mem, vm_size_t size);
+void IOTrackingRemoveUser(IOTrackingQueue * head, IOTrackingUser * tracking);
+
+void IOTrackingAlloc(IOTrackingQueue * head, uintptr_t address, size_t size);
+void IOTrackingFree(IOTrackingQueue * head, uintptr_t address, size_t size);
+void IOTrackingReset(IOTrackingQueue * head);
+void IOTrackingAccumSize(IOTrackingQueue * head, IOTracking * mem, size_t size);
+kern_return_t IOTrackingDebug(uint32_t selector, uint32_t options,
+ const char * names, size_t namesLen,
+ size_t size, OSObject ** result);
+
+extern IOTrackingQueue * gIOMallocTracking;
+extern IOTrackingQueue * gIOWireTracking;
+extern IOTrackingQueue * gIOMapTracking;
+
+#endif /* XNU_KERNEL_PRIVATE && IOTRACKING */
+
+enum
+{
+ kIOTrackingExcludeNames = 0x00000001,
+};
+
+enum
+{
+ kIOTrackingGetTracking = 0x00000001,
+ kIOTrackingGetMappings = 0x00000002,
+ kIOTrackingResetTracking = 0x00000003,
+ kIOTrackingStartCapture = 0x00000004,
+ kIOTrackingStopCapture = 0x00000005,
+ kIOTrackingSetMinCaptureSize = 0x00000006,
+ kIOTrackingLeaks = 0x00000007,
+ kIOTrackingInvalid = 0xFFFFFFFE,
+};
+
+
#ifdef __cplusplus
} /* extern "C" */
#endif /* __cplusplus */