patch [选项] [原始文件 [补丁文件]]
功能
给 文件1
应用补丁文件变成另外一个 文件2
(需要先用 diff 文件1 文件2
生成补丁文件)。
举例
单个文件的
文件内容
首先将两个文件的内容显示如下
$cat test0
00000000
00000000
00000000
$cat test1
00000000
11111111
00000000
生成补丁
$ diff -uN test0 test1 >test1.patch
这样将通过比较,生成 test1
的补丁文件。这里选项 u
表示使用同一格式输出这样产生的输出便于阅读易于修改, N
表示把不存在的文件看做 empty
的.就算文件 test0
不存在,也会生成补丁。
把 test0
通过打补丁变成 test1
文件
$ patch -p0
或
$patch
这样, test0
的内容将和 test1
的内容一样,但是文件名称还是 test0
。关于 patch
的选项见后面多文件有说明。当前目录下可以有 test1
, 如果比较的时候 test0
是不存在的,那么这时候会生成一个 test0
文件。
把打过补丁的 test0
还原
$ patch -RE -p0
或
$patch -R
这样, test0
的内容将还原为原来没有打过补丁的状态。当前目录下可以有 test1
, 这里的 -E
选项是要求 patch
在文件为空的时候删除文件,这个选项是不必要的因为 patch
是根据时间戳来判断一个文件是否存在。如果比较的时候 test0
是不存在的,这将会删除 test0
文件。
多个文件的
文件结构
首先查看文件结构如下:
1.外层目录列表:
$ls -p
prj0/ prj1/
2.子目录 prj0
列表:
$ls -p prj0
prj0name test0
3.子目录 prj1
列表:
$ls -p prj1
prj1name test1
4.文件 prj0/prj0name
:
$cat prj0/prj0name
--------
prj0/prj0name
--------
5.文件 prj1/prj1name
:
$cat prj1/prj1name
---------
prj1/prj1name
---------
6.文件 prj0/test0
:
$cat prj0/test0
0000000
0000000
0000000
0000000
0000000
0000000
0000000
7.文件 prj1/test1
:
$cat prj1/test1
1111111
1111111
1111111
1111111
1111111
1111111
1111111
创建补丁
$diff -uNr prj0 prj1 > prj1.patch
这里项 u
表示使用同一格式输出这样产生的输出便于阅读易于修改, N
表示把不存在的文件看做 empty
的, r
表示递归地比较子目录,比较的结果被标准重定向到文件 prj1.patch
中了。
运行之后,输出的就是一个补丁,描述了两个文件的不同,这个补丁就是把 diff
参数的第一个文件打补丁变成第二个文件的补丁文件。
实际过程依次比较两个目录下的同名文件,如果这里不加 -N
就会指明 prj0name
和 test0
只在 prj0
中存在, prj1name
和 test1
只在 prj1
中存在,这就无法比较了,所以这里为了能够比较,加上了 -N
选项。
为了便于理解,这里给出 prj1.patch
文件的内容:
$ cat prj1.patch
diff -uNr prj0/prj0name prj1/prj0name
--- prj0/prj0name 2009-08-24 10:44:19.000000000 +0800
+++ prj1/prj0name 1970-01-01 08:00:00.000000000 +0800
@@ -1,5 +0,0 @@
---------
-
-prj0/prj0name
-
---------
diff -uNr prj0/prj1name prj1/prj1name
--- prj0/prj1name 1970-01-01 08:00:00.000000000 +0800
+++ prj1/prj1name 2009-08-24 10:45:05.000000000 +0800
@@ -0,0 +1,5 @@
+---------
+
+prj1/prj1name
+
+---------
diff -uNr prj0/test0 prj1/test0
--- prj0/test0 2009-08-24 11:21:12.000000000 +0800
+++ prj1/test0 1970-01-01 08:00:00.000000000 +0800
@@ -1,7 +0,0 @@
-0000000
-0000000
-0000000
-0000000
-0000000
-0000000
-0000000
diff -uNr prj0/test1 prj1/test1
--- prj0/test1 1970-01-01 08:00:00.000000000 +0800
+++ prj1/test1 2009-08-24 11:21:33.000000000 +0800
@@ -0,0 +1,7 @@
+1111111
+1111111
+1111111
+1111111
+1111111
+1111111
+1111111
将 prj0
中的所有文件打补丁成为 prj1
中的所有文件
步骤如下:
$cp prj1.patch ./prj0
$cd prj0
$patch -p1 < prj1.patch
这里,把补丁文件复制到了 prj0
下面,然后将该文件夹下面的文件"变成" prj1
下的文件了.
$ ls -p
prj1name prj1.patch test1
关于 patch
命令的 -p
选项接数字 n
,意思是去掉补丁文件里指定路径的前 n
个 /
前缀.
例如补丁文件中指定路径是 /u/howard/src/blurfl/blurfl.c
,那么 p0
选项处理之后的路径还是原来路径不变,而 p1
选项处理之后的路径是 u/howard/src/blurfl/blurfl.c
,同理 p4
处理之后的路径是: blurfl/blurfl.c
注意:如果在外层目录运行这个命令,那么会在外层目录创建两个 prj1name
和 test1
文件。
将打好补丁的 prj0
中的所有文件还原成为原来打补丁之前的文件
$ patch -R -p1 < prj1.patch
运行之后文件变成原来的文件了,如下:
$ ls -p
prj0name prj1.patch test0
将 prj1
中的所有文件反向打补丁成为 prj0
中的所有文件
$ patch -R -p1 < prj1.patch
运行之后 prj1
中的文件变成 prj0
的文件了,如下:
$ ls -p
prj0name prj1.patch test0
将 prj1
中反打补丁后的文件还原成原来的 prj1
中的文件
$ patch -p1 < prj1.patch
运行之后, prj1
中的文件被还原了,如下:
$ ls -p
prj1name prj1.patch test1
在外层目录把 prj0
的内容打补丁成 prj1
的内容
$ls -p
prj0/ prj1.patch
$patch -p0
这样 prj0
中的内容变成了 prj1
中的内容,但是 prj0
的目录名仍旧是 prj0
,如下:
$ls -p prj0
prj1name test1
注意:当前文件夹下面不能 prj1
目录,否则会出现一些警告提示。
在外层目录把 prj0
的内容反打补丁还原成原来 prj0
的内容
$ patch -R -p0
这样原来的文件如下:
$ ls -p prj0
prj0name test0
描述
patch
命令读取如何更改文件的源文件指示信息,然后应用这些更改。源文件包含由 diff
命令产生的差别列表(或者 diff
列表)。差异列表是比较两个文件和构建关于如何纠正差别的指示信息的结果。缺省情况下, patch
命令使用从标准输入读入的源文件,但是使用 -i
标志和 PatchFile
变量可以覆盖此设置。
差异列表有三种格式:正常、上下文或者是 ed
编辑器风格。 patch
命令确定差异列表格式,除非被 -c
、 -e
或 -n
标志否决。
缺省情况下,文件的打过补丁的版本替换原始版本。指定 -b
标志时,每个补丁文件的原文件保存在同名的文件中,只是在文件名后附加了后缀 .orig
。使用 -o
标志也可以指定输出的目的地。
常用项:
-
-r
是一个递归选项,设置了这个选项,diff
会将两个不同版本源代码目录中的所有对应文件全部都进行一次比较,包括子目录文件。 -
-N
选项确保补丁文件将正确地处理已经创建或删除文件的情况。 -
-u
选项以统一格式创建补丁文件,这种格式比缺省格式更紧凑些。 -
-p0
选项从当前目录查找目的文件(夹)(直接使用补丁文件里面指定的路径) -
-p1
选项忽略掉第一层目录,从当前目录查找(去掉补丁文件指定路径最左的第1
个/
及前面所有内容)。 -
-E
选项说明如果发现了空文件,那么就删除它 -
-R
选项说明在补丁文件中的“新”文件和“旧”文件现在要调换过来了(实际上就是给新版本打补丁,让它变成老版本)