linux下补丁制作及打补丁实例 | 迟思堂工作室
A-A+

linux下补丁制作及打补丁实例

2014-08-30 17:53 GNU/Linux系统 暂无评论 阅读 4,243 次

搞ARM有一段时日了,期间看了不少开发板的手册,手册的内容多数为教我们如何使用开发板,而不是教我们如何开发。手册中少不了显示linux下的命令,不过对这些命令有几点看法:

1、很多操作都使用了绝对路径,我想大约是为了表示这个路径的关系吧,不然的话,对于新手来说,来回几个cd,就搞不清楚在哪个目录了,这点表示赞同。不过对于我来说,实在不会如此操作;

2、统一使用root用户,因为许多人都使用虚拟机的linux作主机系统,所以想用哪个用户都无所谓,然而在实际开发中却不是这样。因此这点我就不赞同了。linux的权限意识非常强的,如果试过多人工作于同一台服务器的话,就能体会到了。不过话又说回来,对于新手来说,用root可能十分便利,因为不会存在不能访问哪个文件、哪个设备的问题,畅通无阻。最近,boss用root用户在rhel中编译qtopia,出现了使用g++错误的问题:

g++: error trying to exec 'cc1plus': execvp: No such file or directory

我们想了很久,得到一个非权威的解释:rhel不允许root来编译qtopia,用普通用户无此问题。

本文背景:

1、练习制作补丁和打补丁;

2、以以前的程序代码lib-test为例,演示制作补丁和打补丁过程。

lib-test示例见/programming-under-linux/multi-makefile-for-app.html

为了不造成误解,引起误导,本文的假设如下:

1、原工程目录为lib-test-org,修改后的工程目录为lib-test-new,两个目录均在cst目录下:

[latelee@FightNow cst]$ pwd

/home/latelee/cst

2、本文提到的“原始文件”及“原始工程目录”等等,是指未经修改过的工程目录、源代码包等,比如在网上下载qtopia-2.2.0的原始代码包、U-Boot原始代码包、Linux内核原始代码包。

3、由于这里只是测试,因此建立了lib-test-new,并在这个目录下修改文件。

4、实际应用中,一般会提供原始代码包及补丁文件。

 

示例

修改地方如下:

1、在三个头文件中添加如下类似信息:

/**

* @file   foo.h

* @author Late Lee <>

* @date   Thu Apr  7 2011

*

* @brief  none

*

*

*/

2、修改main.c,将头文件包括的双引号(“”)改为尖括号(<>),此外添加一些版权信息及编译命令等等。

3、修改主目录下的Makefile,主要添加:

%.o: %.c

$(CC) $(CFLAGS) -c $^ -I ./configs

即由-I选项指定头文件位置(因此可以在代码中使用尖括号)。

4、其它修改若干。

注:上述修改仅为示例,以实际修改为准。

 

示例过程:

1、制作补丁

在cst目录下(即在两个工程目录的同一目录下)使用diff命令制作补丁:

[latelee@FightNow cst]$ diff -urN lib-test-org/ lib-test-new/ > lib-test.patch

(注:-r表示递归搜索子目录,更多选项,请man diff。)

这样就在该目录下生成了一个叫lib-test.patch的补丁文件。

 

这里分析一下patch文件,以第一块为例:

diff -urN lib-test-org/configs/backtrace.h lib-test-new/configs/backtrace.h

--- lib-test-org/configs/backtrace.h 2011-04-07 09:04:06.000000000 +0800

+++ lib-test-new/configs/backtrace.h 2011-04-07 08:22:55.000000000 +0800

@@ -1,3 +1,13 @@

+/**

+ * @file   backtrace.h

+ * @author Late Lee <http://www.latelee.org>

+ * @date   Thu Apr  7 2011

+ *

+ * @brief  none

+ *

+ *

+ */

+

#ifndef _BACKTRACE_H

#define _BACKTRACE_H

这里分三部分来分析。

第一部分即第1行,文中以粗体字体标示,是制作补丁所使用的命令,后面的是两个工程目录的文件。

第二部分为第2、3行,“---”表示原始文件,“+++”表示修改过的文件。

剩下的是第三部分,“@@ -1,3 +1,13 @@”中的“-1,3”表示原始文件的第1行到第3行,“+1,13”表示修改过的文件的第1行到第13行。两者之差的内容即为修改的内容,其中减号(“-”)表示删除,加号(“+”)表示添加。

下面看一下backtrace.h文件。

 

backtrace.h完整的原始代码如下(注意该文件的第1行到第3行内容):

 1  #ifndef _BACKTRACE_H

#define _BACKTRACE_H

3

 /* Even complicated programs rather seldom have a nesting

5   * level of more than, say, 50 and with 200 possible entries

6   * probably all programs should be covered. -- from glibc manual

7   */

 /* here, we let it be 30 */

#define NEST        30

10  void print_trace(int sig);

11  void print_trace_fd(int sig);

12  void print_trace_file(int sig);

13

14  #endif  /* _BACKTRACE_H */

修改后的代码如下(注意该文件的第1行到第13行内容):

 1    /**

2    * @file   backtrace.h

3    * @author Late Lee

4    * @date   Thu Apr  7 2011

 5    *

6    * @brief  none

 7    *

8    *

9    */

10

11   #ifndef _BACKTRACE_H

12   #define _BACKTRACE_H

13

14    /* Even complicated programs rather seldom have a nesting

15    * level of more than, say, 50 and with 200 possible entries

16    * probably all programs should be covered. -- from glibc manual

17    */

18    /* here, we let it be 30 */

19   #define NEST        30

20   void print_trace(int sig);

21   void print_trace_fd(int sig);

22   void print_trace_file(int sig);

23

24   #endif  /* _BACKTRACE_H */

应该看到了区别了吧?因此,所谓打补丁的大约意思可以这么说:

将原来的backtrace.h文件的第1行到第3行内容用“下面”的内容代替,行数从第1行到第13行。

其中的“下面”就是指那些“+”、“-”的内容了。

 

2、打补丁

进入lib-test-org目录下,使用patch命令打补丁:

[latelee@FightNow lib-test-org]$ patch -p1 < ../lib-test.patch

patching file configs/backtrace.h

patching file configs/bar.h

patching file configs/foo.h

patching file main.c

patching file Makefile

patching file nomain.c

 

一般地,都将patch文件放到与原始工程目录同一级目录中。

在man patch中有一句话:but usually just patch -pnum <patchfile

实际中常用的是-p1,网上说法是忽略第一个目录,看了一下man手册,准确说法是忽略第一个斜杠(“/”),比如/u/howard/src/blurfl/blurfl.c,如果是-p1的话,表示u/howard/src/blurfl/blurfl.c,用-p4的话,表示blurfl/blurfl.c,等等。

以上述patch片段的第一行为例:

diff -urN lib-test-org/configs/backtrace.h lib-test-new/configs/backtrace.h

如果用-p1,则表示configs/backtrace.h,这个是相对于工程目录路径,无论是在lib-test-org,还是lib-test-xxx中,也不管这个lib-test-org在哪个目录,路径依然不改变(当然,我们的前提是两者是同一事物,比如内核树、u-boot)。

上面的提示信息表示正在给哪个文件打补丁。打完补丁后,两个目录的内容就一致了。不信的话,可以再次用diff命令测试一下:

 

[latelee@FightNow cst]$ ls -l lib-test.patch

-rw-r--r-- 1 latelee root 4137 04-07 09:05 lib-test.patch

[latelee@FightNow cst]$ diff -urN lib-test-org/ lib-test-new/ > lib-test-new.patch

[latelee@FightNow cst]$ ls -l lib-test-new.patch

-rw-r--r-- 1 latelee root 0 04-07 09:07 lib-test-new.patch

 

可以看到,lib-test-new.patch大小为0,证明两个目录内容无差别。

 

本文语法高亮工具由迟思堂工作室(www.latelee.org)参考网上资料使用lex工具编写,代码添加行号由awk语句完成。语句如下:

$ awk '{printf("%2d   %2sn", FNR, $0)}' backtrace.h > test.h

行文过程中并未过度引用网上资料,因此存在非权威解释,术语使用不当等问题,然而却由实践而来,具有实际操作性。



如果本文对阁下有帮助,不妨赞助笔者以输出更多好文章,谢谢!
donate




给我留言