Skip to content

rsuntk/KernelSU

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo

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.

Latest release Latest LKM release Channel License: GPL v2 GitHub License

How to add RKSU kernel driver into your kernel source

  • main branch
curl -LSs "https://raw.githubusercontent.com/rsuntk/KernelSU/main/kernel/setup.sh" | bash -s main
  • tag
curl -LSs "https://raw.githubusercontent.com/rsuntk/KernelSU/main/kernel/setup.sh" | bash -s v3.0.0-30-legacy
  • susfs branch

Warning

This branch is not always updated.

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

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:

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 (ksud/manager):
    • arm64-v8a, armeabi-v7a, x86_64

Usage

Discussion

Security

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

License

Credits

About

A simple KernelSU fork that aims to support newer and older kernel. (4.4 ~ 6.18+)

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Kotlin 51.4%
  • C 19.9%
  • Rust 17.4%
  • Java 3.8%
  • CSS 2.8%
  • C++ 2.1%
  • Other 2.6%