8177afa81e
* Revert "feat: try manual reboot hook (#521)" This reverts commit1853d9decf. * kernel: core_hook: provide a better reboot handler I propose that you pass cmd and arg as reference. this is so we can have much more extendable use of that pointer kernel: core_hook: provide sys_reboot handler -2e2727d56ckernel: kp_ksud: add sys_reboot kp hook -03285886b0I'm proposing passing arg as reference to arg pointer and also pass int cmd we can use it to pass numbers atleast. for advanced usage, we can use it as a delimiter so we can pass a pointer to array. example pass a char *array[] which decays to a char ** and then use cmd as the number of array members. we can pass the pointer of the first member of the array and use cmd as the delimiter (count) of members. for simpler usecase, heres some that I added. kernel: core_hook: expose umount list on sys_reboot interface -352de41e4bkernel: core_hook: expose nuke_ext4_sysfs to sys_reboot interface -83fc684ccbksud: add cmd for add-try-umount, wipe-umount-list and nuke-ext4-sysfs -a4eab4b8c3more usage demos https://github.com/backslashxx/lkm_template/tree/write-pointer-on-pointer https://github.com/backslashxx/lkm_template/tree/pointer-reuse I actually proposed sys_reboot upstream because of this pointer that is very usable. Signed-off-by: backslashxx <118538522+backslashxx@users.noreply.github.com> --------- Signed-off-by: backslashxx <118538522+backslashxx@users.noreply.github.com>
95 lines
3.8 KiB
Markdown
95 lines
3.8 KiB
Markdown
# 集成指导
|
||
|
||
SukiSU 可以集成到 GKI 和 non-GKI 内核中，并且已反向移植到 4.14 版本。
|
||
|
||
<!-- 应该是 3.4 版本，但 backslashxx 的 syscall manual hook 无法在 SukiSU 中使用-->
|
||
|
||
有些 OEM 定制可能导致多达 50% 的内核代码超出内核树代码，而非来自上游 Linux 内核或 ACK。因此，non-GKI 内核的定制特性导致了严重的内核碎片化，而且我们缺乏构建它们的通用方法。因此，我们无法提供 non-GKI 内核的启动映像。
|
||
|
||
前提条件：开源的、可启动的内核。
|
||
|
||
## Hook 方法
|
||
|
||
1. **KPROBES hook:**
|
||
- GKI kernels 的默认 hook 方法。
|
||
- 需要 `# CONFIG_KSU_MANUAL_HOOK is not set`（未设定） & `CONFIG_KPROBES=y`
|
||
- 用作可加载的内核模块 (LKM).
|
||
|
||
2. **Manual hook:**
|
||
|
||
<!-- - backslashxx's syscall manual hook: https://github.com/backslashxx/KernelSU/issues/5 (v1.5 version is not available at the moment, if you want to use it, please use v1.4 version, or standard KernelSU hooks)-->
|
||
- 需要 `CONFIG_KSU_MANUAL_HOOK=y`
|
||
- 需要 [`guide/how-to-integrate.md`](how-to-integrate.md)
|
||
- 需要 [https://github.com/~](https://github.com/tiann/KernelSU/blob/main/website/docs/guide/how-to-integrate-for-non-gki.md#manually-modify-the-kernel-source)
|
||
|
||
3. **Tracepoint Hook:**
|
||
- 自 SukiSU commit [49b01aad](https://github.com/SukiSU-Ultra/SukiSU-Ultra/commit/49b01aad74bcca6dba5a8a2e053bb54b648eb124) 引入的 hook 方法
|
||
- 需要 `CONFIG_KSU_TRACEPOINT_HOOK=y`
|
||
- 需要 [`guide/tracepoint-hook.md`](tracepoint-hook.md)
|
||
|
||
<!-- This part refer to [rsuntk/KernelSU](https://github.com/rsuntk/KernelSU). -->
|
||
|
||
如果您能够构建可启动内核，有两种方法可以将 KernelSU 集成到内核源代码中：
|
||
|
||
1. 使用 `kprobe` 自动集成
|
||
2. 手动集成
|
||
|
||
## 与 kprobe 集成
|
||
|
||
适用：
|
||
|
||
- GKI 内核
|
||
|
||
不适用：
|
||
|
||
- non-GKI 内核
|
||
|
||
KernelSU 使用 kprobe 机制来做内核的相关 hook，如果 _kprobe_ 可以在你编译的内核中正常运行，那么推荐用这个方法来集成。
|
||
|
||
请参阅此文档 [https://github.com/~](https://github.com/tiann/KernelSU/blob/main/website/docs/guide/how-to-integrate-for-non-gki.md#integrate-with-kprobe)。虽然标题为“适用于 non-GKI”，但仅适用于 GKI。
|
||
|
||
替换 KernelSU 添加到内核源代码树的步骤的执行命令为：
|
||
|
||
```sh [bash]
|
||
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s main
|
||
```
|
||
|
||
## 手动修改内核源代码
|
||
|
||
适用：
|
||
|
||
- GKI 内核
|
||
- non-GKI 内核
|
||
|
||
请参考此文档 [https://github.com/~ (non-GKI 内核集成)](https://github.com/tiann/KernelSU/blob/main/website/docs/guide/how-to-integrate-for-non-gki.md#manually-modify-the-kernel-source) 和 [https://github.com/~ (GKI 内核构建)](https://kernelsu.org/zh_CN/guide/how-to-build.html) 进行手动集成。虽然第一个链接的标题是“适用于 non-GKI”，但它也适用于 GKI。两者都可以正常工作。
|
||
|
||
还有另一种集成方法，但是仍在开发中。
|
||
|
||
<!-- 这是 backslashxx 的syscall manual hook，但目前无法使用。 -->
|
||
|
||
将 KernelSU（SukiSU）添加到内核源代码树的步骤的运行命令将被替换为：
|
||
|
||
### GKI 内核
|
||
|
||
```sh [bash]
|
||
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s main
|
||
```
|
||
|
||
### non-GKI 内核
|
||
|
||
```sh [bash]
|
||
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s nongki
|
||
```
|
||
|
||
### 带有 susfs 的 GKI / non-GKI 内核（实验）
|
||
|
||
```sh [bash]
|
||
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s susfs-{{branch}}
|
||
```
|
||
|
||
分支:
|
||
|
||
- `main` (susfs-main)
|
||
- `test` (susfs-test)
|
||
- 版本号 (例如: susfs-1.5.7, 你需要在 [分支](https://github.com/SukiSU-Ultra/SukiSU-Ultra/branches) 里找到它)
|