如果hack了开源代码,为了方便分享(如提交Bug)或自己留存使用,一般都要制作一个补丁(Patch)。在从源码安装软件时,也难免要应用些别人做好的补丁。本文介绍如何制作和应用补丁。[1]
提示:
本文目前的多数内容是对《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