diff patch
http://rails-deployment.group.iteye.com/group/wiki/1318-diff-and-patch-10-minutes-guide
情景一:你正尝试从代码编译一个软件包,发现有人已经对代码进行了小小的修改以便在你的系统上编译。他们通过补丁的方式发布自己的成果,但是你却不知道该如何使用它。答案是你使用一个叫做patch(很贴切)的命令行工具将补丁应用到原始代码上。
情景二:你下载了一个开源软件包的代码,花了一个小时左右稍作修改,成功的让它在你的系统上编译通过。你想把自己的成果分享给其他程序员,或者给软件包的作者。现在你就需要创建自己的补丁,你需要的工具是diff。
这是一份diff和patch的快速指南,通过讲解它们最常见的用法来帮你解决上面问题。它告诉你的东西足够让你立刻开始使用。之后,你可以在闲暇的时候用manpage来学习diff和patch的前前后后。我总是乐意听到你们的问题和意见。用联系表单跟我取得联系。
用patch命令应用补丁
要对单个文件应用补丁,进入文件所在的目录并调用patch命令:
patch < foo.patch
这些命令假定补丁是以统一格式分发的,这种格式指明了补丁要应用到的文件。如果不是,你可以在命令行里指定文件:
patch foo.txt < bar.patch
应用补丁到整个目录(这种情况也许更常见)也是类似的,但是你必须注意设置p级别。就是说,在补丁文件里,需要打补丁的文件在你电脑上的路径名跟在创建补丁的电脑上可能不同。p级别告诉patch命令忽略掉路径名的几个部分以正确的识别文件。通常p级别为1就够了,所以你使用:
patch -p1 < bar.patch
运行该命令之前,你应该进入源代码目录的顶层目录。如果补丁级别1不能正确识别任何需要打补丁的文件,检查补丁文件里的文件名。如果你看到这样一个文件名:
/users/stephen/package/src/net/http.c
而你当前正工作在一个包含net/http.c的目录,使用:
patch -p5 < bar.patch
总的来说,对于从路径最开始删除的每个路径分隔符(斜线字符)加一,直到剩下的部分存在于你的工作目录中。最后得到的就是p级别。
要删除补丁,用-R参数,例如:
patch -p5 -R bar.patch
使用diff创建补丁
不论是对于单个文件还是整个源码目录,使用diff都很简单。为单个文件创建补丁,用下面形式:
diff -u original.c new.c > original.patch
为整个源码树创建补丁,复制一份源码树:
cp -R original new
在目录new/里进行必要的修改,然后用下面的命令创建补丁:
diff -rupN original/ new/ > original.patch
这就是diff和patch入门需要的所有知识。要获得更多的信息用:
man diff
man patch
http://blog.csdn.net/wh_19910525/article/details/7515540
说到patch命令,就不得不提到diff命令,也就是制作patch的必要工具。diff命令,在制作patch文件的时候,基本上只需要使用到diff -Nau 这个参数,如果比较的是文件夹,还要加上-r参数,所以一般直接使用Naur参数。
实验的基本步骤。我打算是建立一个级联目录./x/xx/xxx/,在xxx目录下建立两个不同的文件xxx1,xxx2。然后在xxx目录下用diff命令,建立一个补丁文件xxx.patch,在xx目录下建立一个补丁文件xx.patch,在x目录下建立一个补丁文件x.patch。然后在这三个目录下实验。
开始实验:建立实验目录
[King@Fedora ~]$ mkdir -pv x/xx/xxx
mkdir: 已创建目录 “x”
mkdir: 已创建目录 “x/xx”
mkdir: 已创建目录 “x/xx/xxx”
进入xxx目录下创建xxx1,xxx2
[King@Fedora ~]$ cd x/xx/xxx
[King@Fedora xxx]$ cat >> xxx1 << EOF
> 111111
> 111111
> EOF
[King@Fedora xxx]$ cat >> xxx2 << EOF
> 111111
> 222222
> EOF
查看这两个文件
[King@Fedora xxx]$ diff -y xxx1 xxx2
111111 111111
111111 | 222222
一定要注意:打补丁时所在的目录
在xxx目录下创建补丁文件xxx.patch,并查看。
[King@Fedora xxx]$ diff -Naru xxx1 xxx2 > xxx.patch
[King@Fedora xxx]$ cat xxx.patch
- - - xxx1 2009-12-19 22:28:26.582959182 +0800
+++ xxx2 2009-12-19 22:28:42.798928591 +0800
@@ -1,2 +1,2 @@
111111
- 111111
+222222
在xx目录下创建补丁文件xx.patch,并查看
[King@Fedora xxx]$ cd ..
[King@Fedora xx]$ diff -Naru xxx/xxx1 xxx/xxx2 > xx.patch
[King@Fedora xx]$ cat xx.patch
--- xxx/xxx1 2009-12-19 22:28:26.582959182 +0800
+++ xxx/xxx2 2009-12-19 22:28:42.798928591 +0800
@@ -1,2 +1,2 @@
111111
-111111
+222222
在x目录下创建补丁文件x.patch,并查看
[King@Fedora xx]$ cd ..
[King@Fedora x]$ diff -Nu xx/xxx/xxx1 xx/xxx/xxx2 > x.patch
[King@Fedora x]$ cat x.patch
--- xx/xxx/xxx1 2009-12-19 22:28:26.582959182 +0800
+++ xx/xxx/xxx2 2009-12-19 22:28:42.798928591 +0800
@@ -1,2 +1,2 @@
111111
-111111
+222222
现将patch文件都拷贝到xxx目录下去。
[King@Fedora x]$ cp x.patch xx/xxx/
[King@Fedora x]$ cp xx/xx.patch xx/xxx/
进入xxx目录开始实验
[King@Fedora x]$ cd xx/xxx
[King@Fedora xxx]$ ls
x.patch xx.patch xxx1 xxx2 xxx.patch
[King@Fedora xxx]$ patch-p0< xxx.patch #用第二个的 补丁 修改 第一个文件
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
222222
[King@Fedora xxx]$ patch -RE < xxx.patch #用第一个的 补丁 修改 第一个文件
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
111111
[King@Fedora xxx]$ patch -p1 < xx.patch
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
222222
[King@Fedora xxx]$ patch -RE < xxx.patch
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
111111
[King@Fedora xxx]$ patch -p2 < x.patch
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
222222
[King@Fedora xxx]$ patch -RE < x.patch
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
111111
--------------------
[King@Fedora xx]$ patch-p0 < xx.patch # 用第二个的 补丁 修改 第一个文件
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
222222
[King@Fedora xxx]$ patch -RE < xxx.patch #用第一个的 补丁 修改 第一个文件
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
111111
[King@Fedora xxx]$ patch -p1 < x.patch
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
222222
[King@Fedora xxx]$ patch -RE < xxx.patch
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
111111
----------------------------------
[King@Fedora x]$ patch-p0< x.patch # 用第二个的 补丁 修改 第一个文件
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
222222
[King@Fedora xxx]$ patch -RE < xxx.patch #用第一个的 补丁 修改 第一个文件
patching file xxx1
[King@Fedora xxx]$ cat xxx1
111111
111111
这里唯一需要说明的是p0的含义,因为在x.patch补丁文件里的路径信息是这样的:
--- xx/xxx/xxx1
p表示跳过几级目录,因为是在x目录下使用的patch命令,xx目录就在x目录下,所以不必跳过任何目录,而应该使用--- xx/xxx/xxx1 完整路径,所以此时使用的是p0。
注意:patch -p后面是不能带负数 的。不使用p参数的时候,patch命令会 忽略 任何目录,直接使用文件。
[King@Fedora x]$ patch x/xx/xxx/xxx1 < x.patch # 用补丁x.patch 直接修改 文件xxx1,因为没有用p参数,所以 会 忽略掉补丁文件里的 所有目录。
作为程序员,了解diff&patch命令是非常必要的。比如说我们发现某个项目有bug代码,而自己又没有提交权限,那么此时最合适的解决方法就是用diff命令做一个补丁发给项目成员。项目成员通过patch命令可以立刻知道你的意图。有人会说直接传一个新文件不是更简单?不要忘了,一个patch文件尺寸更小传输更快,而且可以明显的看到都做了哪些修改。
保证当前目录是demo名录:
# mkdir demo
# cd demo
先模拟一个项目目录old:
# mkdir -p old/a/b
# vi old/a/b/foo.txt
old_line_1
old_line_2
假设我们发现项目old有bug代码,下面我们先拷贝一个新目录new,并在此修改bug代码:
# cp -r old new
# vi new/a/b/foo.txt
new_line_1
new_line_2
保证old和new两个目录都在当前目录下,下面就可以使用diff命令了,不要使用绝对路径,而应该使用相对路径,至于原因,看到文章结尾你就清楚了:
# LC_ALL=C TZ=UTC0 diff -Naur old new > foo.patch
如果不在意字符集,时差等问题,也可以省略LC_ALL=C TZ=UTC0环境变量:
# diff -Naur old new > foo.patch
内容来自Linuxren.net
其中-Naur参数属于固定用法,大多数时候,在使用diff命令时搭配这个参数就可以了。
大概浏览一下补丁文件:
# cat foo.patch
diff -Naur old/a/b/foo.txt new/a/b/foo.txt
--- old/a/b/foo.txt 2009-12-07 20:40:07.000000000 +0800
+++ new/a/b/foo.txt 2009-12-07 20:41:51.000000000 +0800
@@ -1,2 +1,2 @@
-old_line_1
-old_line_2
+new_line_1
+new_line_2
加减号后面的内容是有用的内容,其他的内容是方便你查阅的相关信息内容,补丁制作完成。
此时的文件目录结构大概如下所示:
#tree
demo
|-- old
| `-- a
| `-- b
| `-- foo.txt
|-- new
| `-- a
| `-- b
| `-- foo.txt
-- foo.patch
下面看看如何使用patch来应用补丁,要注意的是当前目录是demo,试试下面命令:
# patch -p0 < foo.patch
patching file old/a/b/foo.txt
这里唯一需要说明的是p0的含义,因为在foo.patch补丁文件里的路径信息是这样的:
--- old/a/b/foo.txt
p表示跳过几级目录,因为是在demo目录下使用的patch命令,old目录就在demo目录下,所以不必跳过任何目录,而应该使用old/a/b/foo.txt完整路径,所以此时使用的是p0。
查看一下目标文件,你会发现内容已经修改成新的了:
# cat old/a/b/foo.txt
new_line_1
new_line_2
此时如果你再次使用patch命令,系统会问你是否想还原,输入y 还原:
# patch -p0 < foo.patch
patching file old/a/b/foo.txt
Reversed (or previously applied) patch detected! Assume -R? [n] y
查看一下目标文件,你会发现内容已经还原成旧的了:
# cat old/a/b/foo.txt
old_line_1
old_line_2
如果你想严格指定是 应用补丁 可以使用下面命令(就是增加N参数):
# patch -Np0 < foo.patch
如果你想严格指定是 还原补丁 可以使用下面命令(就是增加R参数):
# patch -Rp0 < foo.patch
注释:在本例中,每次应用补丁后,自己还原补丁,以备后用继续试验,我就不多说了。
看到这里如果你对patch的p参数还不太清楚的话,接着往下看,我们改变一下当前路径:
# cd old
此时就应该是p1,而不是p0了,引用foo.patch文件的路径也要相对变一下,因为当前目录已经是old了:Linuxren.net
# patch -p1 < ../foo.patch
patching file a/b/foo.txt
因为此时我们是在old下使用patch命令,和a子目录平级,而补丁文件foo.patch里的路径声明是:
--- old/a/b/foo.txt
也就是说第一个斜线左边的old/部分已经没用了,这就是p1的含义!
继续往深度变换路径,依次测试使用p2,p3参数:
# cd a
# patch -p2 < ../../foo.patch
patching file b/foo.txt
# cd b
# patch -p3 < ../../../foo.patch
patching file foo.txt
在本例中,p3已经是最深目录了,此时可以省略p参数:
# patch < ../../../foo.patch
patching file foo.txt
也就是说,不使用p参数的时候,patch命令会 忽略 任何目录,直接使用文件。
下面接着文章前面说的为什么使用diff命令时最好不要使用绝对路径,而应该使用相对路径?
答:如果你在使用diff的时候使用的是绝对路径,那么补丁文件里的文件路径信息会类似下面的样子:
--- /a/b/c/d/e/f/g/bar.txt
如此一来,当别人想应用你的补丁时,因为目录结构肯定有差异,所以就不得不费力判断到底使用p几。这样一来就很容易出错,相反,如果使用相对路径的话,大多数时候,p0或者p1就足够了,不易出错。