KernelSU (Rissu'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.

How to add

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

Suspicious FS (SusFS) Add-On

Warning

This branch is not always updated.

• susfs-rksu-master: Synced with latest https://gitlab.com/simonpunk/susfs4ksu.git commit(s), for GKI or non-GKI kernel (backport required).

Hook method

1. Syscall hook:
   • Used for Loadable Kernel Module (LKM)
   • Default hook method on GKI kernels.
   • Need # CONFIG_KSU_MANUAL_HOOK is not set & 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.
   • Need CONFIG_KSU_MANUAL_HOOK=y

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.

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:
  • arm64-v8a, armeabi-v7a, x86_64

Usage

• Installation Instruction
• How to build?
• Official Website

Discussion

• Official KernelSU Telegram: @KernelSU
• RKSU Telegram: @rsukrnlsu_grp

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.
• Magisk: the powerful root tool.
• genuine: apk v2 signature validation.
• Diamorphine: some rootkit skills.
• simonpunk: susfs add-on.