vimer linux kernel 爱好者

debian quilt usage

2022-04-28

本篇文章根据How to prepare patches for Debian packagesUsingQuilt整理而成。

quilt的历史非常悠久,具体可以追溯到Alro?(内核-mm tree的维护者)开发然后被应用到kernel开发中,所以说,Debian社区真的很厉害的。好了,废话不多说,直接说主题。

以下阐述是基于 apt source src-pkg 操作下进行的。apt source xx会自动apply patch根据package里面的配置文件。

quilt基本配置

vimer@unmatched-local:~/04/rust-ring/rust-ring-0.16.9$ cat ~/.quiltrc
QUILT_PATCHES=debian/patches
QUILT_NO_DIFF_INDEX=1
QUILT_NO_DIFF_TIMESTAMPS=1
QUILT_REFRESH_ARGS="-p ab"
QUILT_DIFF_ARGS="--color=auto" # If you want some color when using `quilt diff`.
QUILT_PATCH_OPTS="--reject-format=unified"
QUILT_COLORS="diff_hdr=1;32:diff_add=1;34:diff_rem=1;31:diff_hunk=1;33:diff_ctx=35:diff_cctx=33"
d=. ; while [ ! -d $d/debian -a `readlink -e $d` != / ]; do d=$d/..; done
if [ -d $d/debian ] && [ -z $QUILT_PATCHES ]; then
        # if in Debian packaging tree with unset $QUILT_PATCHES
        QUILT_PATCHES="debian/patches"

        if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi
fi

quilt用法

quilt用于产生新的patch

  1. quilt push
    quilt push -a # applying all patches onto the source code tree
    
  2. Creating a New patch
    quilt new xx.patch # 这个意思是新建一个xx.patch
    
  3. Add file you want to change
    quilt add xx # for example, README, *.c, It can add multi files
    
  4. quilt refresh
    quilt refresh # 更新xx.patch
    
  5. Add descriptions of the patch
    quilt header -e # edits the header in $EDITOR
    
  6. Finish your editing
    quilt pop -a # 退出所有的patch,包括刚才新建的patch
    

    此时这个时候在 debian/patches目录下就会有了刚才我们命名为xx.patch的patch,以及在series文件中也有当前的patch.

修改存在的patch

比如说,我们的前一个patch没有解决问题,那应该怎么办?当然是在前一个patch的基础上去搞定,而不需要新建一个patch。

  1. quilt push xx.patch
  2. git add/modify files
  3. quilt refresh

详解

这里仔细讲解quilt命令的各个用法,这个工具掌握之后,在处理debian的patch时会更加得心用手。

debian/patch/目录下,有几个patch文件和series文件,其中,series文件就是patch文件的记录文件。我们把上面的quiltrc文件写好后,就可以直接使用了。

push

vimer@dev:~/$ ls debian/patches/
Don-t-try-SIMD-on-non-x86-processors-not-implemented-yet.patch  Don-t-use-RPATH.patch  Install-libs-in-multi-arch-path.patch  series

然后 series:

vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt series
Install-libs-in-multi-arch-path.patch
Don-t-use-RPATH.patch
Don-t-try-SIMD-on-non-x86-processors-not-implemented-yet.patch

说明 quilt可以有这些patches进行操作。

quilt push -a

vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt push -a #  push all patch into
File series fully applied, ends at patch Don-t-try-SIMD-on-non-x86-processors-not-implemented-yet.patch
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt applied # display patches that was applied
Install-libs-in-multi-arch-path.patch
Don-t-use-RPATH.patch
Don-t-try-SIMD-on-non-x86-processors-not-implemented-yet.patch
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt unapplied display patches that was unapplied
File series fully applied, ends at patch Don-t-try-SIMD-on-non-x86-processors-not-implemented-yet.patch

如果我们想修改第二个patch: Don-t-use-RPATH.patch怎么办,有两种方式: 方式: quilt push -a && push -f patch xx 这种方式会把 -f patch 之前的patch也打上:

vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt push Don-t-use-RPATH.patch
Applying patch Install-libs-in-multi-arch-path.patch
patching file CMakeLists.txt

Applying patch Don-t-use-RPATH.patch
patching file CMakeLists.txt

Now at patch Don-t-use-RPATH.patch
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt  applied
Install-libs-in-multi-arch-path.patch
Don-t-use-RPATH.patch

quilt top查看在哪个patch上:

vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt top
Don-t-use-RPATH.patch

file

vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt  files Don-t-use-RPATH.patch -lv
[Don-t-use-RPATH.patch] CMakeLists.txt

remove/add

vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt top
Don-t-use-RPATH.patch
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt add Doxyfile.in
File Doxyfile.in added to patch Don-t-use-RPATH.patch
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ vim Doxyfile.in
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt refresh
Refreshed patch Don-t-use-RPATH.patch
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt files Don-t-use-RPATH.patch -vl
[Don-t-use-RPATH.patch] CMakeLists.txt
[Don-t-use-RPATH.patch] Doxyfile.in

如果删除一个文件呢:

vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt top
Don-t-use-RPATH.patch
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt remove Doxyfile.in
File Doxyfile.in removed from patch Don-t-use-RPATH.patch
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt refresh
Refreshed patch Don-t-use-RPATH.patch
vimer@dev:~/build/05/20_wsclean/wsclean-3.0$ quilt files Don-t-use-RPATH.patch -lv
[Don-t-use-RPATH.patch] CMakeLists.txt

则真就把改动的文件删除了。

编辑header

quilt header --dep3 -e 
# to add DEP-3 meta-information to your patch header.

https://dep-team.pages.debian.net/deps/dep3/


Comments

Content