aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: d156e0049ccf307dafa1e1c6a953b4df78c8360e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
## Kernel-Assisted Superuser for Android

#### KernelSU

Like being able to do quick cycles of `fastboot boot
out/arch/arm64/boot/Image.lz4-dtb`, but annoyed by the lack of root this way?
Well this atrocious idea might be the thing for you! It makes `su` always _just
work_.

#### Possibly the worst idea ever.

This is an awful idea! If you're silly, you'll add this to your kernel, and
then forget to turn it off for production builds, and then very bad things will
happen. This here probably is not for you! If you're reading this sentence,
start backing away slowly! Out, damned spot!

#### Add it to your kernel!

From inside a clean kernel tree of yours:

```
$ curl -LsS "https://git.zx2c4.com/kernel-assisted-superuser/plain/fetch-and-patch.sh" | bash -
```

Then, make sure `CONFIG_ASSISTED_SUPERUSER=y` is enabled.


But don't do it! I take no responsibility for the dumpster fire this will
cause. You'll probably forget to remove this for your release kernels. There
are probably better ways to manage this kind of thing anyway. Don't do it! Just
say "no" to backdoors! N.O.

#### Pop a root shell?

```
thinkpad $ adb shell
crosshatch:/ $ whoami
shell
crosshatch:/ $ su
You are now root.
crosshatch:/ # whoami
root
```

![Screenshot](screenshot.png)