1853d9decf
* feat: try manual reboot hook * refactor: move ksu_handle_reboot to supercalls.c for ShirkNeko ---------
125 lines
4.7 KiB
Markdown
125 lines
4.7 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。两者都可以正常工作。
|
||
|
||
并且手动修改 kernel/reboot.c, 进行手动 reboot hook
|
||
|
||
```diff[reboot.c]
|
||
diff --git a/kernel/reboot.c b/kernel/reboot.c
|
||
index 8f08af3a7d04..3809b8aa6213 100644
|
||
--- a/kernel/reboot.c
|
||
+++ b/kernel/reboot.c
|
||
@@ -302,6 +302,9 @@ EXPORT_SYMBOL_GPL(kernel_power_off);
|
||
|
||
DEFINE_MUTEX(system_transition_mutex);
|
||
|
||
+#ifdef CONFIG_KSU
|
||
+extern void ksu_handle_reboot(int magic1, int magic2, void __user * arg);
|
||
+#endif
|
||
/*
|
||
* Reboot system call: for obvious reasons only root may call it,
|
||
* and even root needs to set up some magic numbers in the registers
|
||
@@ -317,6 +320,10 @@ SYSCALL_DEFINE4(reboot, int, magic1, int, magic2, unsigned int, cmd,
|
||
char buffer[256];
|
||
int ret = 0;
|
||
|
||
+#ifdef CONFIG_KSU
|
||
+ ksu_handle_reboot(magic1, magic2, arg);
|
||
+#endif
|
||
+
|
||
/* We only trust the superuser with rebooting the system. */
|
||
if (!ns_capable(pid_ns->user_ns, CAP_SYS_BOOT))
|
||
return -EPERM;
|
||
```
|
||
|
||
还有另一种集成方法，但是仍在开发中。
|
||
|
||
<!-- 这是 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) 里找到它)
|