補丁(patch)的製作與應用

此頁由 Linux Wiki用戶Chenxing 於 2011年3月27日 (星期日) 18:51 的最後更改。

出自Linux Wiki

提示:此文已超过 5 年(2084 天)未更新,如发现内容过时或有误,欢迎改进:)

如果hack了開源代碼,為了方便分享(如提交Bug)或自己留存使用,一般都要製作一個補丁(Patch)。在從源碼安裝軟件時,也難免要應用些別人做好的補丁。本文介紹如何製作和應用補丁。[1]

Hint.gif
提示:
本文目前的多數內容是對《Linux下patch的製作和應用》的修正、整理與重新排版。

目錄

命令簡介

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

diff

diff可以比較兩個東西,並可同時記錄下二者的區別。製作補丁時的一般用法和常見選項為:

diff 【选项】 源文件(夹) 目的文件(夹)
-r
遞歸。設置後diff會將兩個不同版本源代碼目錄中的所有對應文件全部都進行一次比較,包括子目錄文件。
-N
選項確保補丁文件將正確地處理已經創建或刪除文件的情況。
-u
輸出每個修改前後的3行,也可以用-u5等指定輸出更多上下文。
-E, -b, -w, -B, --strip-trailing-cr
忽略各種空白,可參見文檔,按需選用。

patch

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 diffgit 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

參考資料

  1. Linux下patch的製作和應用

本文对您有帮助?分享给更多朋友!

反馈与讨论

发现文档不全面、有错误却没时间编辑文档?想分享自己的经验或见解?欢迎在此留言、讨论。
简体繁体转换