Apple's open-source XNU kernel on Android phones: its own loader and drivers, Metal on the Adreno. Runs from RAM; a reboot gives the phone back to Android.
C
main is the branch: every link and clone without -b hakios; CHANGELOG: the sources a build is made of, at the top
shimoku74bbe70cd5f0c8
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex c5227e1..7dbe6d0 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -3,8 +3,22 @@What changed, newest first. One line a change: the part of the system, then what is different for whoever runs it.The commits say how; `docs/` says why.+## Sources++What a build is made of, and where each part is fetched from. Nothing of these is kept in the repositories but the+changes to it; the scripts named fetch the release and put the changes on.++- the kernel: Apple's [XNU](https://github.com/apple-oss-distributions/xnu), tag `xnu-8796.121.2` (the release the Darwin 16.5 user space was built from) -- `xnu/apply.sh`, the changes in `xnu/hakios.patch` and `xnu/files/`, the drivers in `drivers/`+- the data volume: Apple's [HFS Plus](https://github.com/apple-oss-distributions/hfs), tag `hfs-627.100.6` -- `xnu/hfs/hfs.sh`, the changes in `xnu/hfs/hfs.patch`+- the boot: [U-Boot](https://source.denx.de/u-boot/u-boot) `v2026.07` -- `hakios-uefi/u-boot/apply.sh`, the changes in `hakios-uefi/u-boot/hakios.patch` and `files/`; the device's part in `hakios-sm7325/u-boot/`+- the UEFI (the other way to start): [Project Silicium's Mu-Silicium](https://github.com/Project-Silicium/Mu-Silicium) at `e51cd877e31c` -- `hakios-uefi/apply.sh`+- the GPU's OpenGL ES: [Mesa](https://archive.mesa3d.org/) 25.0.7, the freedreno driver for the Adreno -- `tools/mk-mesa.sh`, the changes in `tools/mesa/`+- the build tools: Apple's [libdispatch](https://github.com/apple-oss-distributions/libdispatch), [libpthread](https://github.com/apple-oss-distributions/libpthread) and [AvailabilityVersions](https://github.com/apple-oss-distributions/AvailabilityVersions), [bootstrap_cmds](https://github.com/markmentovai/bootstrap_cmds), [unifdef](https://github.com/fanf2/unifdef), the [macOS 13.3 SDK](https://github.com/joseluisq/macosx-sdks) and the [iPhoneOS 16.5 SDK](https://github.com/theos/sdks) -- `xnu-deps/setup.sh`+- not fetched by anything here: the Darwin 16.5 user space, which you lay out from your own IPSW (`sysimage/`), and the phone's own firmware, pulled from its Android (`fw-*`)+## 2026-10-30+- repositories: `main` is the branch of `hakios-xnu-kernel` -- what was `hakios` and then `u-boot`; `hakios` is gone, `git clone` needs no `-b`- site: a Changelog page, this file- site: the commands to start with clone the public repository (`hakios-xnu-kernel`, branch `hakios`); `oosexgang/hakios` is private and cloned for nobody- site: the documentation synced, with the guide to installing beside Android and the U-Boot page in the table of contentsdiff --git a/README.md b/README.mdindex 1bdd84d..782f727 100644--- a/README.md+++ b/README.md@@ -42,7 +42,7 @@ back to its own Android. The one thing written by default is the loader's own lo## Quick start```sh-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakioscd hakiosmake doctor # what this machine lacks, and what to domake qemu-open # the open kernel in QEMU: nothing of Apple's, nothing of a phone's@@ -61,7 +61,7 @@ make phone SECS=600 # a 10-minute session on the phone, in RAM| Repository | What ||---|---|-| [hakios-xnu-kernel](https://github.com/oosexgang/hakios-xnu-kernel/tree/hakios) | **common**: the kernel port, every common driver, the loader, user space, the tools, this documentation, and `devices/qemu` |+| [hakios-xnu-kernel](https://github.com/oosexgang/hakios-xnu-kernel/tree/main) | **common**: the kernel port, every common driver, the loader, user space, the tools, this documentation, and `devices/qemu` || [hakios-sm7325](https://github.com/oosexgang/hakios-sm7325) | POCO X5 Pro 5G: its defconfig, status, UEFI platform, firmware script, and its SoC's layer (`soc/`: the Qualcomm SC7280 family) || [hakios-uefi](https://github.com/oosexgang/hakios-uefi) | the firmware that starts the loader: Mu-Silicium with HakiOS's boot path, banner and name, and HakiOS's U-Boot (`u-boot/`) || [hakios-metal](https://github.com/oosexgang/hakios-metal) | Metal's command model on the Adreno, through the kernel's GPU driver |@@ -70,7 +70,7 @@ make phone SECS=600 # a 10-minute session on the phone, in RAMinto `devices/` and `uefi/`. One repository per device: it carries its SoC's layer, and `tools/hakios-device.py new` makes one. [How the repositories fit](docs/porting/repositories.md).```sh-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios && cd hakios+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakios && cd hakiostools/hakios-device.py sync # the SoC, device and UEFI repositories, at the revisions the manifest names```diff --git a/README.uk.md b/README.uk.mdindex 913cbab..98dae45 100644--- a/README.uk.md+++ b/README.uk.md@@ -76,7 +76,7 @@ HakiOS — це адаптація ядра Darwin (відкритий XNU віLinux x86-64, близько 12 ГБ на диску, 7-Zip 23 або новіший, `lz4`, `qemu-system-aarch64`, `edk2-aarch64`.```sh-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakioscd hakiosmake doctor # чого бракує цьому комп'ютеру (дисплей QEMU, UEFI, пам'ять) і що робитиmake unpack IPSW=~/ваш.ipsw # ваш власний IPSW Darwin userland 16.5, потрібне розпаковується (7,4 ГБ)diff --git a/README.zh.md b/README.zh.mdindex 1a380d3..25bf3e8 100644--- a/README.zh.md+++ b/README.zh.md@@ -68,7 +68,7 @@ Linux 电脑上的 QEMU(`virt`,aarch64)里运行,不需要任何 AppleLinux x86-64,约 12 GB 磁盘,7-Zip 23 或更新,`lz4`,`qemu-system-aarch64`,`edk2-aarch64`。```sh-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakioscd hakiosmake doctor # 检查本机缺什么(QEMU 显示设备、UEFI 固件、内存)以及怎么办make unpack IPSW=~/your.ipsw # 你自己获取的 Darwin userland 16.5 IPSW,解包所需部分(7.4 GB)diff --git a/docs/concepts/architecture.md b/docs/concepts/architecture.mdindex b51168c..c3ae7b1 100644--- a/docs/concepts/architecture.md+++ b/docs/concepts/architecture.md@@ -58,7 +58,7 @@ device's. A device's defconfig is three lines: the common kernel, its SoC's frag| `/private/var` | only with `ufs_write=1 var_store=1` | the partition `darwin`, which you create yourself (`tools/userdata-carve.py` prints the commands; it changes nothing) || anything else | never | the loader refuses every other write; `tools/provenance.allow` lists each piece of code that can write, and why |-[LEGAL.md](https://github.com/oosexgang/hakios-xnu-kernel/blob/hakios/LEGAL.md) has the same, with what is and is not distributed.+[LEGAL.md](https://github.com/oosexgang/hakios-xnu-kernel/blob/main/LEGAL.md) has the same, with what is and is not distributed.## Where the code isdiff --git a/docs/devices/qemu.md b/docs/devices/qemu.mdindex 9ecc076..674512a 100644--- a/docs/devices/qemu.md+++ b/docs/devices/qemu.md@@ -9,7 +9,7 @@| SoC | `none` || Configuration | `make qemu_defconfig` || Maintainer | the HakiOS developers (README.md) |-| Repository | [`devices/qemu/`](https://github.com/oosexgang/hakios-xnu-kernel/tree/hakios/devices/qemu) |+| Repository | [`devices/qemu/`](https://github.com/oosexgang/hakios-xnu-kernel/tree/main/devices/qemu) |## What worksdiff --git a/docs/getting-started/qemu.md b/docs/getting-started/qemu.mdindex 5a35f7d..712f61b 100644--- a/docs/getting-started/qemu.md+++ b/docs/getting-started/qemu.md@@ -5,7 +5,7 @@The kernel, a placeholder loader and a tiny raw-syscall user space: **nothing of Apple's and nothing of any phone's**.```sh-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakioscd hakiostools/hakios-device.py sync # the SoC, device and UEFI repositories (the open kernel needs none of them; the rest does)make doctor # what this machine lacks, and what to dodiff --git a/docs/index.md b/docs/index.mdindex 61c9d82..85dd847 100644--- a/docs/index.md+++ b/docs/index.md@@ -46,7 +46,7 @@ Android. What is and is not written to a phone: [Architecture](concepts/architec| Repository | What ||---|---|-| [hakios-xnu-kernel](https://github.com/oosexgang/hakios-xnu-kernel/tree/hakios) | **common**: the kernel port, every common driver, the loader, user space, the tools, this documentation, and `devices/qemu` |+| [hakios-xnu-kernel](https://github.com/oosexgang/hakios-xnu-kernel/tree/main) | **common**: the kernel port, every common driver, the loader, user space, the tools, this documentation, and `devices/qemu` || [hakios-sm7325](https://github.com/oosexgang/hakios-sm7325) | POCO X5 Pro 5G: its defconfig, status, UEFI platform, firmware script, and its SoC's layer (`soc/`: the Qualcomm SC7280 family) || [hakios-uefi](https://github.com/oosexgang/hakios-uefi) | the firmware that starts the loader: Mu-Silicium with HakiOS's boot path, banner and name, and HakiOS's U-Boot (`u-boot/`) || [hakios-metal](https://github.com/oosexgang/hakios-metal) | Metal's command model on the Adreno, through the kernel's GPU driver |diff --git a/docs/porting/drivers.md b/docs/porting/drivers.mdindex a11b809..ccc05c4 100644--- a/docs/porting/drivers.md+++ b/docs/porting/drivers.md@@ -91,5 +91,5 @@ The boot log says `hakios-kernel: N drivers built in (... nt36672 ...)`, and `sy## 5. Write down what it doesThe driver's head says what has been seen (on the phone, in QEMU, compiled only). The device's `device.conf` has a `status` line-for the part it makes work. [docs/driver-review](https://github.com/oosexgang/hakios-xnu-kernel/tree/hakios/docs/driver-review)+for the part it makes work. [docs/driver-review](https://github.com/oosexgang/hakios-xnu-kernel/tree/main/docs/driver-review)holds the audits of the common drivers: a new common driver gets one before it is relied on.diff --git a/tools/docs-gen.py b/tools/docs-gen.pyindex 3e2808d..c5a6c99 100755--- a/tools/docs-gen.py+++ b/tools/docs-gen.py@@ -15,7 +15,7 @@ import sysHERE = os.path.dirname(os.path.abspath(__file__))ROOT = os.path.dirname(HERE)-REPO = "https://github.com/oosexgang/hakios-xnu-kernel/blob/hakios/"+REPO = "https://github.com/oosexgang/hakios-xnu-kernel/blob/main/"MARK = {"works": "works", "partial": "partly", "missing": "no"}HEADER = "<!-- Made by tools/docs-gen.py from %s. Do not edit: change that, then run tools/docs-gen.py. -->\n\n"diff --git a/tools/hakios-device.py b/tools/hakios-device.pyindex 3576778..3fdb454 100755--- a/tools/hakios-device.py+++ b/tools/hakios-device.py@@ -263,7 +263,7 @@ NEW_README = """# {title} ({name})A HakiOS device repository: what is true of this device and of no other. The kernel, the loader, the drivers and the tools arethe common repository's; the {soc} family's facts are in `soc/`, carried with the device. How the three are put together:-[docs/porting/repositories.md](https://github.com/oosexgang/hakios-xnu-kernel/blob/hakios/docs/porting/repositories.md).+[docs/porting/repositories.md](https://github.com/oosexgang/hakios-xnu-kernel/blob/main/docs/porting/repositories.md).| File | What ||---|---|