Note
Official KernelSU support for Non-GKI kernels has been ended.
This is unofficial forks, all rights reserved to @tiann
curl -LSs "https://raw.githubusercontent.com/rsuntk/KernelSU/main/kernel/setup.sh" | bash -s main
- KPROBES hook:
- Only support GKI (5.10 - 6.x) Kernels in this fork. All non-GKI kernels must use manual hook.
- Used for Loadable Kernel Module (LKM)
- Default hook method on GKI kernels.
- Need
CONFIG_KPROBES=y
- Manual hook:
- For GKI (5.10 - 6.x) Kernels, add
CONFIG_KSU_MANUAL_HOOK=y
to kernel defconfig make sure to use#ifdef CONFIG_KSU_MANUAL_HOOK
instead of#ifdef CONFIG_KSU
to guard KernelSU hook. - Standard KernelSU hook: https://kernelsu.org/guide/how-to-integrate-for-non-gki.html#manually-modify-the-kernel-source
- backslashxx's syscall manual hook: backslashxx#5
- For GKI (5.10 - 6.x) Kernels, add
- Kernel-based
su
and root access management. - Module system based on 5ec1cff's Magic Mount API on KernelSU
- App Profile: Lock up the root power in a cage.
- Bringing back non-GKI/GKI 1.0 support
KernelSU (before v1.0.0) officially supports Android GKI 2.0 devices (kernel 5.10+). Older kernels (4.14+) are also compatible, but the kernel will have to be built manually.
With this, WSA, ChromeOS, and container-based Android are all supported.
Currently, only arm64-v8a
are supported.
- Official KernelSU Telegram: @KernelSU
For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.
- Files under the
kernel
directory are GPL-2.0-only. - All other parts except the
kernel
directory are GPL-3.0-or-later.
- kernel-assisted-superuser: the KernelSU idea.
- Magisk: the powerful root tool.
- genuine: apk v2 signature validation.
- Diamorphine: some rootkit skills.
- 5ec1cff: magic mount api implementation.