15.6K ·GitHub
What is this?
OpenCorePkg is OpenCore, a UEFI bootloader bundled with a development SDK, best known for booting and patching macOS on non-Apple hardware, while also providing shared UEFI libraries used by other Acidanthera projects.
OpenCorePkg is OpenCore, a UEFI bootloader bundled with a development SDK, best known for booting and patching macOS on non-Apple hardware, while also providing shared UEFI libraries used by other Acidanthera projects.Is this just the bootloader binary, or also a code library?Both: it's the OpenCore bootloader itself plus a reusable set of UEFI support libraries (disk image loading, ACPI/SMBIOS tools, crypto primitives, PE loading, text/graphics output) that other Acidanthera projects link against.
Both: it's the OpenCore bootloader itself plus a reusable set of UEFI support libraries (disk image loading, ACPI/SMBIOS tools, crypto primitives, PE loading, text/graphics output) that other Acidanthera projects link against.Do I need Clang specifically to enable the extra safety checks?Yes, for OcGuardLib's optional UBSan runtime: it requires the Clang compiler built with the -fsanitize=undefined flag, since the undefined-behavior sanitizer is a Clang feature.
Yes, for OcGuardLib's optional UBSan runtime: it requires the Clang compiler built with the -fsanitize=undefined flag, since the undefined-behavior sanitizer is a Clang feature.Does this only work on real Macs, or any PC with UEFI?OpenCore is most widely used to make non-Apple PCs with UEFI firmware boot macOS (Hackintosh), while its Apple-specific libraries (secure boot code, PE signature checks) also back other Acidanthera tools used with genuine Mac hardware.
OpenCore is most widely used to make non-Apple PCs with UEFI firmware boot macOS (Hackintosh), while its Apple-specific libraries (secure boot code, PE signature checks) also back other Acidanthera tools used with genuine Mac hardware.What is OcGuardLib?It is the library in this repo that implements basic safety recommendations for the project, such as fast overflow-checked integer arithmetic, type-alignment checking, and the optional Clang UBSan runtime.
It is the library in this repo that implements basic safety recommendations for the project, such as fast overflow-checked integer arithmetic, type-alignment checking, and the optional Clang UBSan runtime.Where did this codebase originally come from?Its early history traces back to AppleSupportPkg and the PicoLib library set created by The HermitCrabs Lab, with later contributions referencing hints and legacy from the Chameleon and Clover bootloader teams.
Its early history traces back to AppleSupportPkg and the PicoLib library set created by The HermitCrabs Lab, with later contributions referencing hints and legacy from the Chameleon and Clover bootloader teams.What low-level tasks does the bundled SDK handle for me?The shared libraries cover things like ACPI/SMBIOS patching, plist configuration parsing, PNG rendering, zlib/lzss/lzvn decompression, XNU kernel driver injection and patching, and PE image loading that avoids conflicting with UEFI Secure Boot.
The shared libraries cover things like ACPI/SMBIOS patching, plist configuration parsing, PNG rendering, zlib/lzss/lzvn decompression, XNU kernel driver injection and patching, and PE image loading that avoids conflicting with UEFI Secure Boot.Does it include any cryptography out of the box?Yes, it ships cryptographic primitives such as SHA-256 and RSA, used for things like Apple PE image signature verification and secure boot supplemental code.
Yes, it ships cryptographic primitives such as SHA-256 and RSA, used for things like Apple PE image signature verification and secure boot supplemental code.What are similar projects?nvidia-macos-driver, ReBarUEFI, PCILeechGen, OpenCore-Legacy-Patcher, darwin-xnu, zephyr, rt-thread, os-tutorial
nvidia-macos-driver, ReBarUEFI, PCILeechGen, OpenCore-Legacy-Patcher, darwin-xnu, zephyr, rt-thread, os-tutorial