WSL内核维护笔记

维护自己的 WSL 内核也快一年了，前几天也拿到了第 16 个 star其中有一个是我自己，把一些积累的经验整理一下放到这里罢。

在桌面一直放个txt还是有点蠢...

如何 clone 巨大仓库中指定的 commit/tag

正常的流程是先git clone到本地，然后git checkout到指定的 commit 或者 tag. 但是如果这个仓库很大（比如说 linux 的源码），那你就不得不把一百万个 commit 都给 clone 下来，然后才能 checkout，这通常来说不是并很美妙。

关于 tag，状况是类似的。git clone xxx -b tag_name会拉取整个代码树的，并不能起到只拉取到打了 tag 的那一个 commit 的效果。

Off Topic: Linux 内核开发不需要整个代码树

Linux 开发依赖于邮件列表和各种 patch. Patch 本质上就是格式化成邮件格式的 diff 文件而已，只需要最近的 commit 然后使用git format-patch就可以制作 patch 了。把所有 commit 都拉下来除了浪费时间和磁盘之外并没有什么太大的意义。

但是依赖于现代代码托管平台的项目一般都需要拉取整个代码树才能开发（比如 LLVM），因为 PR 是需要整个代码树的。

因为我需要从 WSL2 官方的内核里提取 patch，又不想把所有 commit 都 clone 下来。毕竟我只需要最新 commit 到我想提取的 commit 之间的历史就行了，前面的历史记录 clone 下来也没用。

在网上搜索了一圈，最后在一篇日文博客中找到了解决方案。

解决方案

建一个空的 git 仓库，把 remote 设置为想要 clone 的远程仓库。

git init
git remote add origin xxx/yyy/test.git

然后利用git fetch拉取指定的 commit，如果想要提取多个 commit 为一个 patch，那么可以修改 fetch 的深度。

git fetch --depth 1 origin [SHA]

最后使用git reset --hard FETCH_HEAD把 git 仓库的HEAD指向拉取的 commit，这样就完成啦。

使用 patch

使用 patch

git apply # 应用修改，但不add也不commit，需要自己写提交信息，不保留原作者信息
# 或者
git am  # 直接把commit加到代码树上，保留原作者和commit消息，但遇到合并冲突会比较麻烦

git am要是因为冲突失败了，那么先git appy --reject，然后手动解决冲突，删掉所有*.rej文件，把修改全部暂存之后，最后使用git am --continue完成操作。

或者直接git am --abort放弃掉这次操作。否则会一直处于am的过程中，无法进行其他 git 操作。

把多个 commit 合成一个 patch

# 直到指定commit(不含该commit)为止，将多个commit导出为一个patch
git format-patch [SHA] --stdout > xxx.patch

内核构建

罗列常用命令：

make LLVM=1 LLVM_IAS=1 nconfig       # 打开tui配置界面（比menuconfig好看好用）
make LLVM=1 LLVM_IAS=1 savedefconfig # 从.config生成defconfig
make LLVM=1 LLVM_IAS=1 xxx_defconfig # 直接用arch/<对应架构>/config下的xxx_defconfig生成配置
make LLVM=1 LLVM_IAS=1 -j$(nproc)    # 编译

# 生成compile_commands.json给clangd用（如果你要手动改内核源码）
scripts/clang-tools/gen_compile_commands.py
# 直接命令行修改.config
scripts/config

如果要使用 clang 编译，那么 configure 阶段必须带着LLVM=1 LLVM_IAS=1，不然会变成 gcc 的配置... 另外如果想要开 LTO，那么也必须带上，否则 LTO 选项在配置界面中不可见。（因为依赖于 clang）