diff & patch 制作及打补丁

生成patch过程：

1. git branch a

2. git checkout a

3. modify

4. git commit -am

5. git diff master > patch(生成标准patch)/git format-patch -M master 01.patch(生成git专有patch)

应用patch过程：

1. git branch a

2. git checkout a

3. git apply patch(标准)/ git am 01.patch

git提供了两种简单的patch方案。一是用git diff生成的标准patch，二是git format-patch生成的Git专用Patch。

1.git diff生成的标准patch

我们可以首先用git diff制作一个patch。本文示例的工作目录里最初有一个文件a，内容是“This is the file a.”，放置在master分支中。为了修改代码，我们一般的做法是建立一个新分支：

sweetdum@sweetdum-ASUS:~/GitEx$ git branch Fix

sweetdum@sweetdum-ASUS:~/GitEx$ git checkout Fix

Switched to branch 'Fix'

接下来我们在a文件里面追加一行，然后执行git diff。

sweetdum@sweetdum-ASUS:~/GitEx$ echo 'Fix!!!'>>a

sweetdum@sweetdum-ASUS:~/GitEx$ git diff

diff --git a/a b/a

index 4add65f..0d295ac 100644

--- a/a

+++ b/a

@@ -1 +1,2 @@

This is the file a.

+Fix!!!

我们看到了Git diff的输出，这是一个非常典型的Patch式diff。这样我们可以直接把这个输出变为一个Patch：

sweetdum@sweetdum-ASUS:~/GitEx$ git commit -a -m "Fix"

[Fix b88c46b] Fix

1 files changed, 1 insertions(+), 0 deletions(-)

sweetdum@sweetdum-ASUS:~/GitEx$ git diff master > patch

sweetdum@sweetdum-ASUS:~/GitEx$ git checkout master

Switched to branch 'master'

我们现在有一个patch文件，并且签出了master，接下来我们可以使用git apply来应用这个patch。当然了，实际应用中，我们不会这样在一个分支建patch，到另一个分支去应用，因为只有merge一下就好了。我们现 在权当没有这个Fix分支。一般情况下，为了保护master，我们会建立一个专门处理新交来的patch的分支：

sweetdum@sweetdum-ASUS:~/GitEx$ git branch PATCH

sweetdum@sweetdum-ASUS:~/GitEx$ git checkout PATCH

Switched to branch 'PATCH'

sweetdum@sweetdum-ASUS:~/GitEx$ git apply patch

sweetdum@sweetdum-ASUS:~/GitEx$ git commit -a -m "Patch Apply"

[PATCH 9740af8] Patch Apply

1 files changed, 1 insertions(+), 0 deletions(-)

看，现在我们在PATCH分支中应用了这个补丁，我们可以把PATCH分支和Fix比对一下，结果肯定是什么也没有，说明PATCH分支和Fix分支完全一样。patch应用成功。即使有多个文件git diff 也能生成一个patch。

2.git format-patch生成的git专用补丁。

我们同样用上面那个例子的工作目录，这次，我们在Fix分支中的a添加了新行之后，用git format-patch生成一个patch。

sweetdum@sweetdum-ASUS:~/GitEx$ git checkout Fix

Switched to branch 'Fix'

sweetdum@sweetdum-ASUS:~/GitEx$ echo 'Fix!!!'>>a

sweetdum@sweetdum-ASUS:~/GitEx$ git commit -a -m "Fix1"

[Fix 6991743] Fix1

1 files changed, 1 insertions(+), 0 deletions(-)

sweetdum@sweetdum-ASUS:~/GitEx$ git format-patch -M master

0001-Fix1.patch

git format-patch的-M选项表示这个patch要和那个分支比对。现在它生成了一个patch文件，我们看看那是什么：

sweetdum@sweetdum-ASUS:~/GitEx$ cat 0001-Fix1.patch

From 6991743354857c9a6909a253e859e886165b0d90 Mon Sep 17 00:00:00 2001

From: Sweetdumplings <linmx0130@163.com>

Date: Mon, 29 Aug 2011 14:06:12 +0800

Subject: [PATCH] Fix1

---

a | 1 +

1 files changed, 1 insertions(+), 0 deletions(-)

diff --git a/a b/a

index 4add65f..0d295ac 100644

--- a/a

+++ b/a

@@ -1 +1,2 @@

This is the file a.

+Fix!!!

--

1.7.4.1

看，这次多了好多东西，不仅有diff的信息，还有提交者，时间等等，仔细一看你会发现，这是个E-mail的文件，你可以直接发送它！这种patch，我们要用git am来应用。

sweetdum@sweetdum-ASUS:~/GitEx$ git checkout master

Switched to branch 'master'

sweetdum@sweetdum-ASUS:~/GitEx$ git branch PATCH

sweetdum@sweetdum-ASUS:~/GitEx$ git checkout PATCH

sweetdum@sweetdum-ASUS:~/GitEx$ git am 0001-Fix1.patch

Applying: Fix1

sweetdum@sweetdum-ASUS:~/GitEx$ git commit -a -m "PATCH apply"

在提交了补丁之后，我们可以再看看目前文件a的情况：

sweetdum@sweetdum-ASUS:~/GitEx$ cat a

This is the file a.

Fix!!!

果然，多了一个Fix!!!

不过要注意的是，如果master与Fix分支中间有多次提交，它会针对每次提交生成一个patch。

3.两种patch的比较：

兼容性：很明显，git diff生成的Patch兼容性强。如果你在修改的代码的官方版本库不是Git管理的版本库，那么你必须使用git diff生成的patch才能让你的代码被项目的维护人接受。
除错功能：对于git diff生成的patch，你可以用git apply --check 查看补丁是否能够干净顺利地应用到当前分支中；如果git format-patch 生成的补丁不能打到当前分支，git am会给出提示，并协助你完成打补丁工作，你也可以使用git am -3进行三方合并，详细的做法可以参考git手册或者《Progit》。从这一点上看，两者除错功能都很强。
版本库信息：由于git format-patch生成的补丁中含有这个补丁开发者的名字，因此在应用补丁时，这个名字会被记录进版本库，显然，这样做是恰当的。因此，目前使用Git的开源社区往往建议大家使用format-patch生成补丁。

在移植或版本升级过程中，手动比对（用比对工具）转换是很费力的事情，特别是发生变化的文件非常多的情况下，“制作补丁、打补丁”可以简化这个过程。主要用到diff和patch。在这里不会把man在线文档上所有的选项都介绍一下，那样也没有必要。在99％的时间里，我们只会用到几个选项。

1、diff

－－－－－－－－－－－－－－－－－－－－

NAME

diff - find differences between two files

SYNOPSIS

diff [options] from-file to-file

from_file to_file can be a directory.

－－－－－－－－－－－－－－－－－－－－

简单的说，diff的功能就是用来比较两个文件的不同，然后记录下来，也就是所谓的diff补丁。

语法格式：diff 【选项】 源文件（夹） 目的文件（夹），就是要给源文件（夹）打个补丁，使之变成目的文件（夹），术语也就是“升级”。

下面介绍三个最为常用选项：

-r 是一个递归选项，设置了这个选项，diff会将两个不同版本源代码目录中的所有对应文件全部都进行一次比较，包括子目录文件。

-N 选项确保补丁文件将正确地处理已经创建或删除文件的情况。

-u 选项以统一格式创建补丁文件，这种格式比缺省格式更紧凑些。

一般 -uN 是一直使用的参数，而 -r 如果是含子目录就使用，不含则不使用。

2、patch

－－－－－－－－－－－－－－－－－－

NAME

patch - apply a diff file to an original

SYNOPSIS

patch [options] [originalfile[patchfile]]

but usually just

patch -pnum < patchfile

带下划线的代表需要根据实际情况替换。比如 -pnum 实际使用时一般为 -p0, -p1。

－－－－－－－－－－－－－－－－－－

简单的说，patch就是利用diff制作的补丁来实现源文件（夹）和目的文件（夹）的转换。这样说就意味着你可以由源文件（夹）――>目的文件（夹），也可以目的文件（夹）――>源文件（夹）。下面介绍几个最常用选项：

-pnum 是指查找patch文件中指定的文件时，忽略前num个目录，一个"/"为一层，详细内容下面解释。

-R 选项说明在补丁文件中的“新”文件和“旧”文件现在要调换过来了（实际上就是给新版本打补丁，让它变成老版本）

-E 选项说明如果发现了空文件，那么就删除它

3、patch文件的结构

（1）补丁头

补丁头是分别由---/+++开头的两行，用来表示要打补丁的文件。---开头表示旧文件，+++开头表示新文件。

一个补丁文件中可能包含以---/+++开头的很多节，每一节用来打一个补丁。所以在一个补丁文件中可以包含好多个补丁。

--- linux-2.6.25/arch/alpha/boot/misc.c 2010-05-06 01:56:42.565397700 -0700

+++ linux-2.6.29/arch/alpha/boot/misc.c 2010-05-06 00:51:06.000000000 -0700

（2）块

块是补丁中要修改的地方。它通常由一部分不用修改的东西开始和结束。他们只是用来表示要修改的位置。他们通常以@@开始，结束于另一个块的开始或者一个新的补丁头。

块会缩进一列，这一列是用来表示这一行是要增加还是要删除的。

+号表示这一行是要加上的。

-号表示这一行是要删除的。

没有加号也没有减号表示这里只是引用的而不需要修改。

4、-pnum

我们在生成补丁时，多是对目录进行操作，比如下面我对linux内核25和29两个版本arch目录下的文件做一个diff操作，生成的差异保存在arch.patch中：

diff -uNr linux-2.6.25/arch linux-2.6.29/arch > arch.patch

可以看到arch.patch开始位置的补丁头如下：

--- linux-2.6.25_android/arch/alpha/boot/misc.c 2010-05-06 01:56:42.565397700 -0700 （黄色部分为打patch时命令会查找的文件名）

+++ linux-2.6.29_android/arch/alpha/boot/misc.c 2010-05-06 00:51:06.000000000 -0700

patch -p0 <arch.patch 代表忽略0层目录，即从当前目录中查找linux-2.6.25_android/arch/alpha/boot/misc.c，然后进行patch操作。

patch -p1 <arch.patch 代表忽略一层目录，即从从当前目录中查找arch/alpha/boot/misc.c，然后进行patch操作。为了能找到文件，当前目录应转到arch所属的目录下。

patch -p2 <arch.patch 代表忽略两层目录，即从从当前目录中查找alpha/boot/misc.c，然后进行patch操作。为了能找到文件，当前目录应转到alpha所属的目录下。

以此类推，patch的目录不限，可以指定patch的目录。

这个功能使用的情景是：打补丁时的目录结构/目录名跟现在要打补丁的目录结构/目录名不一样。

比如上面的例子，这个patch很可能是别人打的，打补丁时目录为 linux-2.6.25/arch，而本地的目录可能是linux_kernel_2625，

那打补丁时就可以进入linux_kernel_2625，用命令patch -p1 <arch.patch 忽略第一层目录即可打上补丁而无需修改自己的目录名或结构也不需要修改patch文件。

5、常用命令

（1）单个文件比较

diff –uN from-file to-file > to-file.patch //生成补丁 【因为单个文件，所以不需要-r选项。选项顺序没有关系，即可以是-uN，也可以是-Nu】

patch –p0 < to-file.patch //打补丁

patch –R –p0 < to-file.patch //去除补丁

（2）目录比较

diff –uNr from-dir to-dir > to-dir.patch //生成补丁

cd from-dir

patch –p1 < to-dir.patch //打补丁

patch –R –p1 < to-dir.patch //去除补丁

6、为内核打补丁

（1）首先是解压，因为发布的补丁文件都是使用gzip压缩的。

$gunzip ../setup-dir/ patch-2.4.21-rmk1.gz

（2）然后进入你的内核源代码目录

$cd linux-2.4.21

（3）打补丁

$patch –p1 < ../../setup-dir/patch-2.4.21-rmk1

打完补丁后，需要检查一下有没有拒绝执行的文件，即检查.rej文件的存在。使用命令：

$find -name *.rej

参考文档：http://blog.chinaunix.net/u1/35795/showart_1131705.html