荔园在线

荔园之美,在春之萌芽,在夏之绽放,在秋之收获,在冬之沉淀

[回到开始] [上一篇][下一篇]


发信人: xiaoq.bbs@bbs.cqupt.edu.cn (躲起来,不让你们看到), 信区: Linux
标  题: 阅读源代码的工具介绍
发信站: 幽幽黄桷兰 (Wed Nov 27 22:51:32 2002)
转信站: SZU!news.tiaozhan.com!news.happynet.org!CQUPT

阅读象Linux代码这样的复杂程序令人望而生畏。
它象一个越滚越大的雪球,阅读某个部分经常要用到好几个其他的相关文件,
不久你将会忘记你原来在干什么。所以没有一个好的工具是不行的。

我接触过以下这样3个工具:

1,SourceInsight
这是一个Windows环境下的读代码的工具
安装与一般的软件没有什么区别
它的使用简单介绍如下:
先选择Project菜单下的new,新建一个工程,输入工程名,
接着要求你把欲读的源代码加入(可以整个目录加)后,该软件就分析你所加的源代码。
分析完后,就可以进行阅读了。
对于打开的阅读文件,如果想看某一变量的定义,
先把光标定位于该变量,然后点击工具条上的相应选项,该变量的定义就显示出来。
对于函数的定义与实现也可以同样操作。

就我个人的使用感觉,总体来讲,使用是很方便的,但是有一些定义会找不到,
不知道是我自己的原因(比如设置不对,或者源代码没有找全),还是软件本身能力有限。


2,SourceNavigator
RedHat出的一个Linux环境下的读码工具
感觉功能比SourceInsight强,但是速度很慢。
就安装来说,因为要给所有的文件建立索引,要花费很长的时间
我给Linux内核建立完整的一个工程,至少要2—3个小时
而且X的效率毕竟不如Windows,运行时的速度也比较慢。

3,LXR
LXR(Linux Cross Reference),是一个通用的超文本cross-reference工具。
详细介绍见下面这篇文章:

《阅读linux源代码的工具---lxr和glimpse简介》
---作者: sea_cloud - China Linux Forum中国Linux论坛首页技术论坛|


我们在阅读linux源代码时都有这样的体会:核心的组织相对松散,
在看一个文件时往往要牵涉到其他的头文件、源代码文件。如此来回
跳转寻找变量、常量、函数的定义十分不方便,这样折腾几次,便使
读代码的心情降到了低点。

   lxr(linux cross reference)就是一个解决这个问题的工具:他对
你指定的源代码文件建立索引数据库,利用perl脚本CGI动态生成包含
源码的web页面,你可以用任何一种浏览器查阅。在此web页中,所有
的变量、常量、函数都以超连接的形式给出,十分方便查阅。比如你
在阅读/usr/src/linux/net/socket.c的源代码,发现函数
get_empty_inode不知道是如何以及在哪里定义的,这时候你只要点击
get_empty_inode,lxr将返回此函数的定义、实现以及各次引用是在什
么文件的哪一行,注意,这些信息也是超连接,点击将直接跳转到相应
的文件相应的行。另外lxr还提供标识符搜索、文件搜索,结合程序
glimpse还可以提供对所有的源码文件进行全文检索,甚至包括注释!

   下面将结合实例介绍一下lxr和glimpse的基本安装和使用,由于
glimpse比较简单,就从它开始:


   首先访问站点:http://glimpse.cs.arizona.edu/ 得到glimpse
的源码,比如我得到的是glimpse-4.12.5.tar.gz . 用root登录,在
任一目录下用tar zxvf glimpse-4.12.5.tar.gz解开压缩包,在当前
目录下出现新目录glimpse-4.12.5 .进入该目录,执行make即可。进
入bin目录,将文件glimpse和glimpseindex拷贝到/bin或/usr/bin下
即可。如果单独使用glimpse,那么只要简单的执行glimpseindex foo
即可,其中foo是你想要索引的目录,比如说是/usr/src/linux .glimpseindex
的执行结果是在你的起始目录下产生若干.glimpse*的索引文件。然后
你只要执行glimpse yourstring即可查找/usr/src/linux下所有包含
字符串yourstring的文件。

   对于lxr,你可以访问lxr.linux.no得到它的源代码解包后,遵循如下步骤:

 /*下面的文字来源于lxr的帮助文档以及本人的安装体会*/

   1)修改Makefile中的变量PERLBIN和INSTALLPREFIX,使它们分别为
perl程序的位置和你想lxr安装的位置.在我的机器上,PERLBIN的值为
/usr/bin/perl  .至于INSTALLPREFIX,有如下原则,lxr的安装路径
必须是web服务器能有权限访问。因此它的值简单一点可取
/home/httpd/html/lxr (对于Apache web server)。

   2)执行 make install

   3)修改$INSTALLPREFIX/http/lxr.conf :
       baseurl : http://yourIP/lxr/http/
       htmlhead: /home/httpd/html/lxr/http/template-head
       htmltail: /home/httpd/html/lxr/http/template-tail
       htmldir:  /home/httpd/html/lxr/http/template-dir
       sourceroot : /usr/src/linux    # 假如对linux核心代码索引
       dbdir : /home/httpd/html/lxr/dbdir/  #dbdirk可任意起名,且位置任意
       glimpsebin: /usr/bin/glimpse   #可执行程序glimpse的位置

   4)在$INSTALLPREFIX/http/下增加一个文件.htaccess  内容:
       <Files ~ (source|search|ident|diff|find)$> ***
       SetHandler cgi-script
       </Files>
     上面这个文件保证Apache server将几个perl文件作为cgi-script.

   5)按照lxr.conf中的设置建立dbdir ,按照上例,建立目录
      /home/httpd/html/lxr/dbdir
     进入这个目录执行$INSTALLPREFIX/bin/genxref yourdir
     其中yourdir是源码目录,比如/usr/src/linux
     如果要结合glimpse,则执行glimpseindex -H . yourdir

   6)修改 /etc/httpd/conf/access.conf ,加入
     <Directory /home/httpd/html/lxr/http>
      Options All
      AllowOverride All
      order allow,deny

      allow from all
     </Directory>

   7)进入/etc/rc.d/init.d/  执行
     killall httpd
     ./httpd start
     进入X ,用浏览器 http://yourIP/lxr/http/blurb.html
     大功告成 ,这下你可以舒心的读源码了。 --
--
※ 来源:·幽幽黄桷兰 bbs.cqupt.edu.cn·[FROM: xiaoq.com]


[回到开始] [上一篇][下一篇]

荔园在线首页 友情链接:深圳大学 深大招生 荔园晨风BBS S-Term软件 网络书店