Ubuntu 8.10 下安装 lxr 与 glimpse

前言

Lxr 对指定的源代码文件建立索引数据库，利用 perl 脚本 CGI 动态生成包含源码的 web 页面，可以用任一浏览器查阅。在此 web 页中，所有的变量、常量、函数都以超连接的形式给出，十分方便查阅。

步骤 1 ：安装软件

1）安装 apache2: sudo apt-get install apache2

2）安装 lxr, sudo apt-get install lxr

3）安装 glimpse, 下载最新版本：

tar -xvzf glimpse-latest.tar.gz

cd glimpse- 4.18.5

./configure

make

sudo make install

步骤 2 ：设置 lxr

4）编辑： /usr/share/lxr/http/lxr.conf

baseurl: http://localhost/lxr/http/

其中 localhost 改为您的电脑的 IP 地址。

/lxr/http/ 对应后面在 apache 配置文件中的设置路径。

修改 glimpse 路径：

glimpsebin: /usr/local/bin/glimpse

5） /usr/share/lxr/http/ 下添加文件 .htaccess, 内容为：

SetHandler cgi-script

</Files>

步骤 3 ：建立源码仓库

6） /usr/share/lxr/source 下建立两个文件：

/usr/share/lxr/source/versions,
/usr/share/lxr/source/defversion

很明显， versions 表示所有内核版本的集合，而 defversion 表示缺省使用的版本。我们目前使用 2.6.21 , 所以这两个文件里都写上 2.6.21

7）将内核源代码拷贝到 /usr/share/lxr/source/2.6.21/linux 下。

8） /usr/share/lxr/source/2.6.21 下运行： ( 生成 freetext 交叉索引数据库 )

glimpseindex -H . ./linux

9） /usr/share/lxr/source/2.6.21 下运行：（生成关键字交叉索引数据库）

genxref ./linux

10） /usr/share/lxr/source/2.6.21 下运行：

chmod a+x *

chmod a+x .*

步骤 4 ：设置浏览器

11）编辑， /etc/apache2/sites-available/default ，添加：

Alias /lxr /usr/share/lxr

Options All

AllowOverride All

</Directory>

12）重启 apache2:

service apache2 restart

13）现在可以浏览代码了：

http://192.168.0.137/lxr/http/blurb.html

更进一步：

Lxr 支持多个内核版本，您只需要在 /usr/share/source 下添加相应的目录，并将该版本添加到 /usr/share/lxr/source/versions, 然后按照以上目录生成数据库文件即可。

另外， http://lxr.linux.no/linux+v2.6.27/ 有现成做好的交叉索引。

====

http://blog.csdn.net/zjujoe/article/details/4199025

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

LXR安装详解-ubuntu环境下测试

1.安装apache2
sudo apt-get install apache2

2.安装Glimplse

.Glimplse
# wget http://webglimpse.net/trial/glimpse-latest.tar.gz
# tar xvzf glimpse-latest.tar.gz
# cd glimpse-4.18.6/cd ctags-5.8
# ./configure
# make
# make install

3.安装lxr
sudo apt-get install lxr

4. 在/etc/apache2/httpd.conf 末尾加上以下内容:
Alias /lxr /usr/share/lxr
<Directory /usr/share/lxr>
Options All
AllowOverride All
</Directory>
这样可以达到http://localhost/lxr/ =>/usr/share/lxr

5. 在/usr/share/lxr/http下创建文件 .htaccess, 并写入一下内容:
<Files ~(search|source|ident|diff|find)$>
SetHandler cgi-script
</Files>

6.
sudo /etc/init.d/apache2 restart

linux内核源码下载地址http://www.kernel.org/ 默认下载到/home/louis/下载解压后为linux-2.6.37.2

创建 /usr/share/lxr/source/XX 目录 (XX为版本号)
mkdir /usr/share/lxr/source/2.6.37.2
然后在 /usr/share/lxr/source/2.6.37.2下创建linux符号连接
ln -s /home/louis/下载/linux-2.6.37.2/usr/share/lxr/source/2.6.22/linux
(源码地址)
8. 创建 /usr/share/lxr/source/versions，这里记录所有要看的版本，内容是
2.6.37.2
2.6.22（可有可无）
要保证2.6.37.2 => /usr/share/lxr/source/2.6.37.2
创建 /usr/share/lxr/source/defversion，这里记录缺省要看的版本，内容是
2.6.37.2
之所以是这两个文件，见 /usr/share/lxr/http/lxr.conf里的相关设置

9. 建立索引
cd /usr/share/lxr/source/2.6.37.2 /
sudogenxref 2.6.37.2 //这样会在当前目录生成fileidx和xref
sudo glimpseindex-H /usr/share/lxr/source/2.6.37.2 / /usr/share/lxr/source/2.6.37.2/linux
(需要等待一段时间)
之所以是这个目录( /usr/share/lxr/source/2.6.37.2 / )，见 /usr/share/lxr/http/lxr.conf里的相关设置(database项)

10.修改属性
sudo chmod +r -R /usr/share/lxr/source/2.6.37.2/*

11.
sudo /etc/init.d/apache2 restart
http://localhost/lxr/http/blurb.html //成功查看源码

====

http://blog.sina.com.cn/s/blog_6c6d405f0100oq6l.html

关于LXR和glimpse配置实现方便阅读Linux源代码的过程
注：本文主要参考下面的资料                         时间：2010-1-15
参考资料1：
http://hi.baidu.com/fanzier/blog/item/3ad7d7546f58a55dd009066b.html
资料2：
http://blog.csdn.net/zjujoe/archive/2009/05/18/4199025.aspx
其中的相同部分没有做修改，在此声明，有“注意：”的地方是结合自己的情况进行的修改。
(本人机器的OS---Ubuntu 9.10)
1.安装apache2
$sudo apt-get install apache2
2.安装lxr
$sudo apt-get install lxr
编辑修改lxr.conf文件
$sudo vi /usr/share/lxr/http/lxr.conf
修改glimpse的路径
找到 glimpsebin这一行，修改成你机器上glimpse的位置（自己查看使用$whereis glimpse）
glimpsebin: /usr/local/bin/glimpse
注：红色部分是我机器上的glimpse的位置
3. 在/etc/apache2/httpd.conf 末尾加上以下内容:
Alias /lxr /usr/share/lxr
Options All
AllowOverride All
这样可以达到http://localhost/lxr/ =>/usr/share/lxr
4. 在/usr/share/lxr/http下创建文件 .htaccess,
$sudo vi /usr/share/lxr/http/.htaccess
并添加下面的内容:
SetHandler cgi-script
5.
$sudo /etc/init.d/apache2 restart
6. 创建/usr/share/lxr/source/XX目录 (XX为版本号)
$mkdir /usr/share/lxr/source/2.6.30.10
然后在/usr/share/lxr/source/2.6.30.10 下创建linux符号连接
$ln -s /home/my/linux-2.6.30.10  /usr/share/lxr/source/2.6.30.10/linux
注：这里的黄色部分改成你目前的源代码的所在目录，比如 /home/you/linux-2.6.30.10
7. 创建/usr/share/lxr/source/versions，这里记录所有要看的版本
sudo vi /usr/share/lxr/source/versions
将下面的版本号（自己的源代码版本号）添加到versions中
2.6.30.10
2.6.32.3
创建/usr/share/lxr/source/defversion，这里记录缺省要看的版本，
$sudo vi /usr/share/lxr/source/defversion
添加缺省查看的版本号：
2.6.30.10
这里为什么是这两个文件，见/usr/share/lxr/http/lxr.conf里的相关设置
8. 建立索引
$cd /usr/share/lxr/source/2.6.30.10/

$sudo glimpseindex -H ../ ./linux

（Should be $sudo glimpseindex -H . ./linux ）

$sudo genxref ./linux

上面的两个命令运行时间稍微长一些，主要是生成freetext交叉索引数据库（glimpseindex）和关键字交叉索引数据库（genxref），上面两个命令不可颠倒顺序，见下面的注
注：
1. 资料1原文中的顺序是：
$sudo glimpseindex -H /usr/share/lxr/source/2.6.22/ /usr/share/lxr/source/2.6.22/linux
$sudo genxref 2.6.22
自己按照上面实验顺序后，发现最后的源码不能很好的链接上，不可以实现符号跳转，仅仅是显示代码
2. 这里如果没有安装glimpse，运行sudo glimpseindex -H  ../  ./linux ，会提示没有相关的命令glimpseindex
于是安装glimpse，需要到http://webglimpse.net/download.php下载
glimpse-latest.tar.gz
然后在下载文件所在的目录执行
$
tar
-zxvf
glimpse-latest.tar.gz
$
./configure
$
make       //注意这里会提示没有flex命令，需要安装flex ，直接sudo apt-get install
flex
$
sudo
make
install
8.修改属性
$sudo chmod +r -R /usr/share/lxr/source/2.6.30.10/*
9.
$sudo /etc/init.d/apache restart
启动浏览器输入下面的URL即可查看，很方便呀！！
http://localhost/lxr/http/blurb.html
10.  如果还要添加其他的版本源代码，只需要按照顺序从第6步执行一直到第9步，这样就可以查看多个版本的源代码了，比较方便。
11. 附加心得：
最初在网上的找linux下的源代码查看工具，介绍的好几种，最初实验的kscope，有个问题就是他需要依赖下面的软件：
Qt4 version 4.4.0 and above
QScintilla2 (
http://www.riverbankcomputing.co.uk/software/qscintilla/download
)
Standard build tools
安装上面的软件之后，make还是出错，发现提示一些cpp文件中未定义的符号，这个要一个个修改比较麻烦了。
所以后来又试了一下 deb包，安装提示需要libqscintilla2-3，好下载先安装这个libqscintilla2-3，然后安装kscope 的deb包，成功了！！后来发现根本启动不了，提示segmentation fault，这个郁闷坏了，网上有的说的是个bug，然后试着安装低版本的kscope—1.6.2，还是出现同样的segmentation fault，唉，暂时想不出解决反感，只好放弃kscope了。
接着实验global，发现好像是命令行的东西，要是命令行熟悉的话，就用vim+ctags了，只是想找稍微简单一点，我只是想浏览源代码，不想提前记好多命令，呵呵，有点懒啦，只好作罢
   最后选择据说比较难安装的LXR，网上这方面的资料很多，一步一步接着做，然后修改了其中的一些叙说不完善的地方，发现竟然成功了，很好，原来这个复杂的东西不是这么夸张，比前面的要好点，还是幸亏这么完备的网上共享的资料呀，感谢那么多对这些资料做出过补充完善的作者！！
最后的一点缺憾是不能像LXR主站上的服务器上的源代码的那种链接跳转，可能是哪里没有配置正确，不过还是迈出了一大步，下面在继续研究吧！！！----已经解决，就是前面的glimpseindex和genxref运行顺序问题，
12.将来问题
目前发现查看源代码跳转有时还是比较慢，我感觉是数据库查找效率问题，这是算法的问题吧，应该不牵涉浏览器的问题吧？？

欢迎大家提出自己的看法。

====

http://bbs.chinaunix.net/thread-1940161-1-1.html