KernelSU (Rapli's Fork)

A Kernel-based root solution for Android devices.

[!NOTE] Official KernelSU support for Non-GKI kernels has been ended.

This is unofficial KernelSU fork, all changes are not guaranteed stable!

All rights reserved to @tiann, the author of KernelSU.

Introduction

KernelSU is a kernel-based root solution for Android GKI devices. It works in kernel mode and grants root permission to userspace applications directly in kernel space.

Features

1. Kernel-based su and root access management.
2. Module system based on Metamodule
3. App Profile: Lock up the root power in a cage.

How to add xxksu kernel driver with MamboSU App Support into your kernel source

• xxksu branch

curl -LSs "https://raw.githubusercontent.com/RapliVx/KernelSU/xxksu/kernel/setup.sh" | bash -s xxksu

Hook method

1. Syscall hook:
   • Used for Loadable Kernel Module (LKM) or GKI with this hook.
   • Default hook method on GKI kernels.
   • Does not support armv7l.
   • Need CONFIG_KSU_SYSCALL_HOOK=y & CONFIG_KPROBES=y, CONFIG_KRETPROBES=y, CONFIG_HAVE_SYSCALL_TRACEPOINTS=y
2. Manual hook:
   • See this repository for more information
   • Default hook method on Non-GKI kernels, with condition that CONFIG_KPROBES off by default.
   • Need CONFIG_KSU_MANUAL_HOOK=y
3. Hookless / MamboHook:
   • Unlike manual hooking, this method does not require patching the kernel source; you simply add the KernelSU driver to the kernel source and enable the CONFIG_KSU and CONFIG_KSU_TAMPER_SYSCALL_TABLE configurations.

Compatibility State

• Kernel compatibility:
  • Android GKI 2.0 (5.10+): aarch64, armv8l, x86_64
  • Android GKI 1.0 (5.4): aarch64, armv8l, armv7l
  • Non-GKI (4.4-4.19): aarch64, armv8l, armv7l
• Application compaibility (ksud/manager):
  • arm64-v8a, armeabi-v7a, x86_64

Usage

• Installation Instruction
• How to build?
• Official Website

Discussion

• MamboSU Telegram Group: @KamiSkizofrenia

Security

For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.

License

• Files under the kernel directory are GPL-2.0-only.
• All other parts except the kernel directory are GPL-3.0-or-later.

Credits

• kernel-assisted-superuser: the KernelSU idea.
• Rissu: Base KernelSU Source Driver
• Magisk: the powerful root tool.
• genuine: apk v2 signature validation.
• Diamorphine: some rootkit skills.
• simonpunk: susfs add-on.
• rifsxd: UI Design