如果hack了开源代码,为了方便分享(如提交Bug)或自己留存使用,一般都要制作一个补丁(Patch)。在从源码安装软件时,也难免要应用些别人做好的补丁。本文介绍如何制作和应用补丁。[1]


补丁(patch)的制作与应用_开源代码


提示: 


本文目前的多数内容是对《Linux下patch的制作和应用》的修正、整理与重新排版。



目录


[隐藏]




命令简介

用到的两个命令是diff和patch。

diff

diff可以比较两个东西,并可同时记录下二者的区别。制作补丁时的一般用法和常见选项为:


diff 【选项】 源文件(夹) 目的文件(夹)


递归。设置后diff会将两个不同版本源代码目录中的所有对应文件全部都进行一次比较,包括子目录文件。 -N 选项确保补丁文件将正确地处理已经创建或删除文件的情况。 -u 输出每个修改前后的3行,也可以用-u5等指定输出更多上下文。 -E, -b, -w, -B, --strip-trailing-cr 忽略各种空白,可参见文档,按需选用。

patch

patch的作用则是将diff记录的结果(即补丁)应用到相应文件(夹)上。最常见的用法为:


patch -pNUM <patchfile>


忽略几层文件夹,随后详解。 -E 选项说明如果发现了空文件,那么就删除它 -R 取消打过的补丁。

为了解释 -p


--- old/modules/pcitable       Mon Sep 27 11:03:56 1999
+++ new/modules/pcitable       Tue Dec 19 20:05:41 2000


如果使用参数 -p0,那就表示从当前目录找一个叫做old的文件夹,再在它下面寻找 modules/pcitable 文件来执行patch操作。
而如果使用参数 -p1,那就表示忽略第一层目录(即不管old),从当前目录寻找 modules

应用

利用以上命令,处理单个文件补丁的方法:


# 产生补丁
diff -uN from-file to-file >to-file.patch
 
# 打补丁
patch -p0 < to-file.patch
 
# 取消补丁
patch -RE -p0 < to-file.patch


对整个文件夹打补丁的情况:


# 产生补丁
diff -uNr  from-docu  to-docu  >to-docu.patch
 
# 打补丁
cd to-docu
patch -p1 < to-docu.patch
 
# 取消补丁
patch -R -p1 <to-docu.patch


另外,使用版本控制工具时,可以直接用svn diff或git diff生成补丁文件。

值得一提的是,由于应用补丁时的目标代码和生成补丁时的代码未必相同,打补丁操作可能失败。补丁失败的文件会以.rej结尾,下面命令可以找出所有rej文件:


find . -name '*.rej'


patch文件构成

补丁文件里到底存储了哪些信息呢?看看这个例子:


--- test0       2006-08-18 09:12:01.000000000 +0800
+++ test1       2006-08-18 09:13:09.000000000 +0800
@@ -1,3 +1,4 @@
+222222
 111111
-111111
+222222
 111111


补丁头是分别由---/+++开头的两行,用来表示要打补丁的文件。---开头表示旧文件,+++开头表示新文件。 一个补丁文件中的多个补丁 一个补丁文件中可能包含以---/+++开头的很多节,每一节用来打一个补丁。所以在一个补丁文件中可以包含好多个补丁。 块 块是补丁中要修改的地方。它通常由一部分不用修改的东西开始和结束。他们只是用来表示要修改的位置。他们通常以@@开始,结束于另一个块的开始或者一个新的补丁头。 块的缩进 块会缩进一列,而这一列是用来表示这一行是要增加还是要删除的。 块的第一列 +号表示这一行是要加上的。-号表示这一行是要删除的。没有加号也没有减号表示这里只是引用的而不需要修改。

实例分析

单文件补丁

设当前目录有文件 test0


111111
111111
111111


和文件test1


222222
111111
222222
111111


使用diff创建补丁test1.patch


diff -uN test0 test1 > test1.patch


因为是单个文件,故不需要 -r 选项。此命令得到如下补丁:


--- test0       2006-08-18 09:12:01.000000000 +0800
+++ test1       2006-08-18 09:13:09.000000000 +0800
@@ -1,3 +1,4 @@
+222222
 111111
-111111
+222222
 111111


要应用补丁,只需:


$ patch -p0 < test1.patch
patching file test0


此时test0就和test1一样了。

如果要取消补丁做出的更改,恢复旧版本:


$ patch -RE -p0 < test1.patch
patching file test0


文件夹补丁

设有如下环境:


--prj0/ test0 prj0name --prj1/ test1 prj1name


prj0/prj0name内容为如下三行:


-------- prj0/prj0name --------


prj1/prj1name内容为如下三行:


-------- prj1/prj1name --------


用 diff -uNr


diff -uNr prj0 prj1 > prj1.patch


得到的patch文件为:


diff -uNr prj0/prj0name prj1/prj0name
--- prj0/prj0name       2006-08-18 09:25:11.000000000 +0800
+++ prj1/prj0name       1970-01-01 08:00:00.000000000 +0800
@@ -1,3 +0,0 @@
---------
-prj0/prj0name
---------
diff -uNr prj0/prj1name prj1/prj1name
--- prj0/prj1name       1970-01-01 08:00:00.000000000 +0800
+++ prj1/prj1name       2006-08-18 09:26:36.000000000 +0800
@@ -0,0 +1,3 @@
+---------
+prj1/prj1name
+---------
diff -uNr prj0/test0 prj1/test0
--- prj0/test0  2006-08-18 09:23:53.000000000 +0800
+++ prj1/test0  1970-01-01 08:00:00.000000000 +0800
@@ -1,3 +0,0 @@
-111111
-111111
-111111
diff -uNr prj0/test1 prj1/test1
--- prj0/test1  1970-01-01 08:00:00.000000000 +0800
+++ prj1/test1  2006-08-18 09:26:00.000000000 +0800
@@ -0,0 +1,4 @@
+222222
+111111
+222222
+111111


如果要应用此补丁,则:


$ ls
prj0  prj1  prj1.patch
$ cd prj0
$ patch -p1 < ../prj1.patch
patching file prj0name
patching file prj1name
patching file test0
patching file test1


此时可用ls看到打补丁后的结果:


$ ls
prj1name  test1


类似的,如果要回滚补丁操作:


$ patch -R -p1 < ../prj1.patch
patching file prj0name
patching file prj1name
patching file test0
patching file test1
$ ls
prj0name  test0