From e4aefbe4bfe209102d9e88fb62e1ba079c47f8bf Mon Sep 17 00:00:00 2001 From: Zhipeng Xie Date: Mon, 11 Jan 2021 01:13:20 -0500 Subject: [PATCH] add OOT module Signed-off-by: Zhipeng Xie --- README.md | 83 +++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 71 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index fc8963a..28b90a5 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,17 @@ -使用指南 +openEuler内核热补丁使用指南 ---------- -## 制作内核热补丁 +支持操作系统： -### 环境准备 +openEuler 20.03 LTS及以上版本 + +架构支持： + +- [x] x86_64 +- [x] aarch64 +- [ ] risc-v + +## 环境准备 安装依赖软件包 @@ -17,7 +25,6 @@ yum install -y make gcc patch bison flex openssl-devel kpatch kpatch-runtime yum install -y kernel-source-`uname -r` kernel-debuginfo-`uname -r` kernel-devel-`uname -r` ``` - 进入热补丁制作目录并准备环境 ```bash @@ -28,6 +35,8 @@ ln -s /usr/src/linux-`uname -r`/.config .config ln -s /usr/lib/debug/lib/modules/`uname -r`/vmlinux vmlinux ``` +## 制作内核热补丁 + 支持两种方式制作内核热补丁 ### 方法1：直接修改源代码的方式 @@ -39,34 +48,84 @@ cd kernel-source cd fs/proc/ cp cmdline.c cmdline.c.new ``` +此处cp操作的后缀.new在后面执行make_hotpatch时会用到 修改cmdline.c.new中的函数 开始制作热补丁 ```bash +cd /opt/patch_workspace/ ./make_hotpatch -d .new -i cmdline ``` -参数说明： - --d 后面跟上前面cp操作时的唯一后缀名。 - --i 后跟补丁ID，可包括字母和数字。 +参数 | 说明| +--------- | --------| +-d |前面cp操作时的唯一后缀名| +-i |补丁ID，可包括字母和数字| ### 方法2：通过patch文件的方式 ```bash +cd /opt/patch_workspace/ ./make_hotpatch -i cmdline -p cmdline.patch ``` -参数说明： - --p patch文件路径 +参数 | 说明| +--------- | --------| +-i |补丁ID，可包括字母和数字| +-p |patch文件路径(patch文件必须支持在kernel-source路径下通过patch -p1的方式修改源码)| 补丁制作完成，补丁文件以压缩包的格式存放于/opt/patch_workspace/hotpatch目录下 +## 制作第三方模块热补丁 + + +支持两种方式制作第三方模块热补丁 + +### 方法1：直接修改源代码的方式 + +进入模块源码目录(下面以https://gitee.com/openeuler/prefetch_tuning模块为例) + +```bash +git clone https://gitee.com/openeuler/prefetch_tuning +cd prefetch_tuning +cp prefetch_mod.c prefetch_mod.c.new +``` + +此处cp操作的后缀.new在后面执行make_hotpatch时会用到 + +修改prefetch_mod.c.new中的函数 + +```bash +cd /opt/patch_workspace/ +./make_hotpatch -d .new -i testmod -m `pwd`/prefetch_tuning/ +``` + +参数 | 说明| +--------- | --------| +-d |前面cp操作时的唯一后缀名| +-i |补丁ID，可包括字母和数字| +-m |第三方模块源码路径| +-f |可选，当第三方模块Makefile不在-m指定的源码目录下时，通过该参数指定Makefile的绝对路径| + +### 方法2：通过patch文件的方式 + +```bash +cd /opt/patch_workspace/ +./make_hotpatch -i testmod -m `pwd`/prefetch_tuning/ -p testmod.patch +``` + +参数 | 说明| +--------- | --------| +-i |补丁ID，可包括字母和数字| +-m |第三方模块源码路径| +-p |patch文件路径(patch文件必须支持在-m参数指定的路径下通过patch -p1的方式修改源码)| +-f |可选，当第三方模块Makefile不在-m指定的源码目录下时，通过该参数指定Makefile的绝对路径| + +第三方模块补丁补丁制作完成，补丁文件以压缩包的格式存放于/opt/patch_workspace/hotpatch目录下 + ## 管理热补丁 ### 加载热补丁