As discussed in the chapter Kernel Architecture Overview,OS X provides a kernel extension mechanism as a means of allowingdynamic loading of code into the kernel, without the need to recompileor relink. Because these kernel extensions (KEXTs) provide both modularityand dynamic loadability, they are a natural choice for any relatively self-containedservice that requires access to internal kernel interfaces.
For the BCM94352 flavors, I've been using AirportBrcmFixup.kext and the companion Lilu.kext for WiFi setup and BrcmBluetoothInjector.kext (on 10.13.6+) or BrcmPatchRAM2.kext alongside BrcmFirmwareData.kext - all of the Brcm. kexts are from RehabMan's OS-X-BrcmPatchRAM repo. VoodooHDA.kext-a jack of all trades master of none solution to. Mac OS X - On Mac OS X you will need to be either root or use sudo to run the scripts. This is really only needed if you want to use client versions of Mac OS X. You may need to ensure the contents of the osx folder have execute permissions by running chmod +x against the 3 files. OS X driver for Intel onboard LAN A few days before Christmas I started my latest project, a new driver for recent Intel onboard LAN controllers. My intention was not to replace hnak's AppleIntelE1000e.kext completely but to deliver best performance and stability on recent hardware.
Because KEXTs run in supervisor mode in the kernel’saddress space, they are also harder to write and debug than user-levelmodules, and must conform to strict guidelines. Further, kernelresources are wired(permanently resident in memory) and are thus more costly to usethan resources in a user-space task of equivalent functionality.
In addition, although memory protection keeps applicationsfrom crashing the system, no such safeguards are in place insidethe kernel. A badly behaved kernel extension in OS X can causeas much trouble as a badly behaved application or extension couldin Mac OS 9.
Bugs in KEXTs can have far more severe consequences than bugsin user-level code. For example, a memory access error in a userapplication can, at worst, cause that application to crash. In contrast,a memory access error in a KEXT causes a kernel panic, crashingthe operating system.
Finally, for security reasons, some customersrestrict or don’t permit the use of third-party KEXTs. As a result,use of KEXTs is strongly discouraged in situations where user-level solutionsare feasible. OS X guarantees that threading in applications is just asefficient as threading inside the kernel, so efficiency should notbe an issue. Unless your application requires low-level access tokernel interfaces, you should use a higher level of abstraction whendeveloping code for OS X.
When you are trying to determine if a piece of code shouldbe a KEXT, the default answer is generally no.Even if your code was a system extension in Mac OS 9, that doesnot necessarily mean that it should be a kernel extension in OS X. There are only a few good reasons for a developer to writea kernel extension:
Your codeneeds to take a primary interrupt—that is, something in the (built-in) hardwareneeds to interrupt the CPU and execute a handler.
The primary client of your code is inside the kernel—forexample, a block device whose primary client is a file system.
Your code needs to access kernel interfaces that are not exportedto user space.
Your code has other special requirements that cannot be satisfiedin a user space application.
If your code does not meet any of the above criteria (andpossibly even if it does), you should consider developing it asa library or a user-level daemon, or using one of the user-levelplug-in architectures (such as QuickTimecomponents or the CoreGraphics framework) instead of writing a kernel extension.
If you are writing device drivers or code to support a newvolume format or networking protocol, however, KEXTs may be theonly feasible solution. Fortunately, while KEXTs may be more difficultto write than user-space code, several tools and procedures are availableto enhance the development and debugging process. See Debugging Your KEXT formore information.
This chapter provides a conceptual overview of KEXTs and howto create them. If you are interested in building a simple KEXT,see the Apple tutorials listed in the bibliography. These providestep-by-step instructions for creating a simple, generic KEXT ora basic I/O Kit driver.
Implementation of a KernelExtension (KEXT)
Kernel extensions are implemented asbundles,folders that the Finder treats as single files. See the chapterabout bundles in Mac Technology Overview for a discussion of bundles.The KEXTbundle can contain the following:
Informationproperty list—a text file that describes the contents,settings, and requirements of the KEXT. This file is required. AKEXT bundle need contain nothing more than this file, although mostKEXTs contain one or more kernel modules as well. See the chapterabout software configuration in Mac Technology Overview for further information about propertylists.
KEXT binary—a file in Mach-O format, containing the actualbinary code used by the KEXT. A KEXT binary (also known as a kernelmodule or KMOD)represents the minimum unit of code that can be loaded into thekernel. A KEXT usually contains one KEXT binary. If no KEXT binariesare included, the information property list file must contain areference to another KEXT and change its default settings.
Resources—for example, icons or localizationdictionaries. Resources are optional; they may be useful for a KEXTthat needs to display a dialog or menu. At present, no resourcesare explicitly defined for use with KEXTs.
KEXT bundles—a kext can contain otherKEXTs. This can be used for plug-ins that augment features of aKEXT.
Kernel Extension Dependencies
Any KEXT can declare that it is dependent upon any other KEXT. The developer lists these dependencies in the OSBundleLibraries dictionary in the module’s property list file.
Before a KEXT is loaded, all of its requirements are checked.Those required extensions (and their requirements) are loaded first,iterating back through the lists until there are no more requiredextensions to load. Only after all requirements are met, is therequested KEXT loaded as well.
For example, device drivers (a type of KEXT) are dependentupon (require) certain families (another type of KEXT). When a driveris loaded, its required families are also loaded to provide necessary,common functionality. To ensure that all requirements are met, each devicedriver should list all of its requirements (families and other drivers)in its property list. See the chapter I/O Kit Overview, for an explanationof drivers and families.
It is important to list all dependencies for each KEXT. Ifyour KEXT fails to do so, your KEXT may not load due to unrecognizedsymbols, thus rendering the KEXT useless. Dependencies in KEXTscan be considered analogous to required header files or libraries incode development; in fact, the Kernel Extension Manageruses the standard linker to resolve KEXT requirements.
Building and Testing Your Extension
After creating the necessary property list and C or C++ source files, you use Project Builder tobuild your KEXT. Any errors in the source code are brought to yourattention during the build and you are given the chance to edityour source files and try again.
To test your KEXT, however, you need to leave Project Builderand work in the Terminal application(or in console mode).In console mode, all system messages are written directly to yourscreen, as well as to a log file (/var/log/system.log).If you work in the Terminal application, you must view system messagesin the log file or in the Console application.You also need to login to the root account (or use the su or sudo command), sinceonly the root account can load kernel extensions.
When testing your KEXT, you can load and unload it manually,as well as check the load status. You can use the kextload commandto load any KEXT. A manual page for kextload isincluded in OS X. (On OS X prior to 10.2, you must use the kmodload command instead.)
Note that this command is useful only when developing a KEXT.Eventually, after it has been tested and debugged, you install yourKEXT in one of the standard places (see Installed KEXTs for details).Then, it will be loaded and unloaded automatically at system startupand shutdown or whenever it is needed (such as when a new deviceis detected).
Debugging Your KEXT
KEXT debuggingcan be complicated. Before you can debug a KEXT, you must firstenable kernel debugging, as OS X is not normally configuredto permit debugging the kernel. Only the root account can enablekernel debugging, and you need to reboot OS X for the changesto take effect. (You can use sudo to gainroot privileges if you don’t want to enable a root password.)
Kernel debugging is performed using two OS X computers,called the development or debug host and the debug target. Thesecomputers must be connected over a reliable network connection onthe same subnet (or within a single local network). Specifically, theremust not be any intervening IP routers or other devices that couldmake hardware-based Ethernet addressing impossible.
The KEXT is registered (and loaded and run) on the target.The debugger is launched and run on the debug host. You can alsorebuild your KEXT on the debug host, after you fix any errors youfind.
Debugging must be performed in this fashion because you musttemporarily halt the kernel on the target in order to use the debugger.When you halt the kernel, all other processes on that computer stop.However, a debugger running remotely can continue to run and cancontinue to examine (or modify) the kernel on the target.
Note that bugs in KEXTs may cause the target kernel to freezeor panic. If this happens, you may not be able to continue debugging,even over a remote connection; you have to reboot the target andstart over, setting a breakpoint just before the code where theKEXT crashed and working very carefully up to the crash point.
Developers generally debug KEXTs using gdb,a source-level debugger with a command-line interface. You willneed to work in the Terminal application to run gdb.For detailed information about using gdb,see the documentation included with OS X. You can also use the help commandfrom within gdb.
Some features of gdb areunavailable when debugging KEXTs because of implementation limitations.For example:
You can’tuse
gdbto call a functionor method in a KEXT.You should not use
gdbtodebug interrupt routines.
The former is largely a barrier introduced by the C++ language.The latter may work in some cases but is not recommended due tothe potential for gdb to interrupt something uponwhich kdp (the kernel shim used by gdb)depends in order to function properly.
Use care that you do not halt the kernel for too long whenyou are debugging (for example, when you set breakpoints). In ashort time, internal inconsistencies can appear that cause the targetkernel to panic or freeze, forcing you to reboot the target.
Additional information about debugging can be found in When Things Go Wrong: Debugging the Kernel.
Installed KEXTs
The Kernel Extension Manager (KEXT Manager) is responsiblefor loading and unloading all installed KEXTs (commands such as kextload areused only during development). Installed KEXTs are dynamically addedto the running OS X kernel as part of the kernel’s addressspace. An installed and enabled KEXT is invoked as needed.
Important: Note that KEXTs are only wrappers (bundles) arounda property list, KEXT binaries (or references to other KEXTs), andoptional resources. The KEXT describes what is to be loaded; itis the KEXT binaries that are actually loaded.
KEXTs are usually installed in the folder /System/Libraries/Extensions.The Kernel Extension Manager (in the form of a daemon, kextd),always checks here. KEXTs can also be installed in ROM or insidean application bundle.
Installing KEXTs in an application bundle allows an applicationto register those KEXTs without the need to install them permanentlyelsewhere within the system hierarchy. This may be more convenientand allows the KEXT to be associated with a specific, running application.When it starts, the application can register the KEXT and, if desired,unregister it on exit.
For example, a network packet sniffer application might employa Network Kernel Extension (NKE). A tape backup application wouldrequire that a tape driver be loaded during the duration of thebackup process. When the application exits, the kernel extension isno longer needed and can be unloaded.
Note that, although the application is responsible for registeringthe KEXT, this is no guarantee that the corresponding KEXTs areactually ever loaded. It is still up to a kernel component, suchas the I/O Kit, to determine a need, such as matching a piece ofhardware to a desired driver, thus causing the appropriate KEXTs(and their dependencies) to be loaded.
Copyright © 2002, 2013 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2013-08-08
This contains a list of the kext files I use for my hackintosh. You may eventually need to update your kext files when new versions of macOS comes out for continued support.
Kext Locations:
- If using the Clover method I like to stuff my kexts in/EFI/CLOVER/kexts/Other
- If not you can place non-required kexts in /System/Library/Extensions
Required
These two kexts you should always have in your EFI partition.
FakeSMC.kext – Mantatory kext that emulates a Mac and is required to boot a hackintosh. When you download FakeSMC the folder will also contain Sensor kexts that you can use to monitor your hackintosh read about that here : HWMonitor Sensor Guide
Lilu.kext – Arbitrary kext that is required other kexts to work like AppleALC.kext & NvidiaGraphicsFixup.kext. Some Gigabyte motherboards have trouble with some versions of Lilu.kext breaking audio. I recommend those users use v1.0.0, instead of the latest version.
USB
USBInjectAll.kext – Injects all USB ports
XHCI-200-series-injector.kext – Enables USB 3 device detection and USB 3 speeds on Kaby Lake motherboards. This kext is also recommended to have during the macOS install process so you can use those USB 3 ports and flash drives.
Ethernet
IntelMausiEthernet.kext – Enables ethernet for motherboards using an Intel Ethernet Chipset.
RealtekRTL8111.kext – Enables ethernet for motherboards using a Realtek Ethernet Chipset
AtherosE2200Ethernet.kext – Enables ethernet for motherboards using Killer Lan Ethernet Chipset
Graphics
NvidiaGraphicsFixup.kext – Allows the latest Mac SMBIOS definitions to be used like iMac 17,x and iMac 18,x. You would want to use these SMBIOS defintions if you are using a Skylake or Kabylake CPU respectively. Updating to the latest version may fix black screen issues.
Kext For Mac Os X 10.13
IntelGraphicsFixup.kext – Fixes display and graphical issues when using integrated graphics. I also recommend setting DVMT Pre-Allocated to 128M or higher in BIOS if using the Intel iGPU to enable high resolution displays.
WhateverGreen.kext – Enables AMD graphic cards in macOS 10.12.6 or later. Will require Lilu.kext. Read about it here : How to hackintosh AMD graphics cards in Sierra 10.12.6+
Shiki.kext – Protects against graphical issues with video playback
Audio
AppleALC.kext – Enables audio on a hackintosh. Read about how to enable audio here: Hackintosh Audio Guide. Some gigabyte users have problems with AppleALC.kext not enabling audio. I recommend them using v1.1.0, instead of the latest version.
Remove Kexts Macos
HDMIAudio.kext – May help enable HDMI audio on some graphic cards. Read about it here : Hackintosh HDMI Audio + DisplayPort GFX Card Sound Guide
CodecCommander.kext – Fixes a problem with dim sounding or lower volume audio after sleeping/botting the hackintosh by updating EAPD (External Amplifier) state on HDA.
Spoofs
Kext For Mac Os X 10.10
FAKEPCIID.kext – Enables support for Intel processors on earlier versions of macOS that don’t support that processor by pretending to be a supported processor. Kaby Lake CPU’s are nativily supported as of macOS 10.12.6
FakePCIID_Intel_HD_Graphics.kext – Enables integrated graphics on iGPU’s that are not supported in macOS by mimicking another supported iGPU. Kaby Lake CPU’s with HD 630 are supported nativily in 10.12.6. If you have upgraded to 10.12.6 you can remove this kext.
NullCPUPowerManagement.kext – Used to enabled hackintosh support for Pentium Processors like the G4560