更新檔(patch)的制作與應用

如果hack了開源代碼，為了友善分享（如送出Bug）或自己留存使用，一般都要制作一個更新檔（Patch）。在從源碼安裝軟體時，也難免要應用些别人做好的更新檔。本文介紹如何制作和應用更新檔。

指令簡介

用到的兩個指令是diff和patch。

diff

可以比較兩個東西，并可同時記錄下二者的差別。制作更新檔時的一般用法和常見選項為：

diff 【選項】 源檔案（夾） 目的檔案（夾）
      

-r

遞歸。設定後diff會将兩個不同版本源代碼目錄中的所有對應檔案全部都進行一次比較，包括子目錄檔案。

-N

選項確定更新檔檔案将正确地處理已經建立或删除檔案的情況。

-u

輸出每個修改前後的3行，也可以用-u5等指定輸出更多上下文。

-E, -b, -w, -B, --strip-trailing-cr

忽略各種空白，可參見文檔，按需選用。

patch

的作用則是将diff記錄的結果（即更新檔）應用到相應檔案（夾）上。最常見的用法為：

patch -pNUM <patchfile>
      

-p Num

忽略幾層檔案夾，随後詳解。

-E

選項說明如果發現了空檔案，那麼就删除它

-R

取消打過的更新檔。

為了解釋 -p 參數，需要看看如下patch檔案片段：

--- 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 的檔案夾，再在它下面找pcitable。

應用

利用以上指令，處理單個檔案更新檔的方法：

# 産生更新檔
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
prj1name  test1      

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