LXR 安裝教學

本教學的OS使用：ubuntu 14.04 64bit(但通常沒有差別)

首先需要的軟體：
LXR 0.3、Glimpse、Apache

Apache安裝：
這部份網路上已有很多的教學文了，主要的是要開啟CGI的功能

sudo a2enmod cgi
sudo service apache2 restart

安裝完後，把網頁的資料放在這個底下便可瀏覽
/var/www/html/(網頁or資料)

可以先把他放在自已方便的地方，這邊就先放在家目錄下的/teach資料夾
並且將它解壓縮：

tar xf glimpse-latest.tar.gz
tar xf lxr-0.3.1.tar.gz

安裝glimpse：

cd glimpse-4.18.6/
./configure
sudo make
sudo make install

安裝LXR：

先進入/lxr-0.3

cd lxr-0.3

檢查perl的版本和路徑

vim Makefile

修改安裝路徑
一定要在/var/www/html/底下

之後開始安裝

make
sudo make install

之後就可以看到/var/www/html/底下會看到lxr2，那就安裝完了~

修改apache2的設定：

cd /etc/apache2
sudo vim apache2.conf

在apache2.conf文件中合適式的地方加入下列的設定文字

<Directory /var/www/html/lxr2/http>
    Options All
    AllowOverride All
    order allow,deny
    allow from all
</Directory>

上方紅字的部份為你安裝LXR的地方

重啟Apache

sudo service apache2 restart

之後開始來設定LXR的設定檔

cd /var/www/html/lxr2/http
sudo vim lxr.conf

這邊會有些不好懂，但我會盡力......的說明

在這個設定檔主要會看到的是下面的文字

variable: v, Version, [/local/lxr/source/versions], [/local/lxr/source/defversion]

在這裡的variable有點像是datatype的在宣告一個變數v

Version則是顯示在網頁上

後面的兩個中括號，前面那個像是list的概念

前面那個則是在list中，哪個為預設值

這裡寫成/local/lxr/source/versions的路徑，是指要去這個路徑下讀versions這個檔案中的清單

variable: a, Architecture, (i386, alpha, m68k, mips, ppc, sparc, sparc64)

而使用小括號則是括號中為list，其中第一個為預設值

baseurl: http://lxr/

這個是你網路的入口

htmlhead: /local/lxr/http/template-head

htmltail: /local/lxr/http/template-tail

htmldir:  /local/lxr/http/template-dir

然後網站的html語法的的template

sourceroot: /local/lxr/source/$v/linux/

srcrootname: Linux

原始碼的位置

incprefix: /include

dbdir: /local/lxr/source/$v/

原始碼資料庫的位置，因為可能不只放一個版本而已

glimpsebin: /local/bin/glimpse

(是不是看不懂......沒關系，和我做一次吧~)

//首先這行

variable: v, Version, [/local/lxr/source/versions], [/local/lxr/source/defversion]

//改成這樣，讓可以讀到versions這個檔案

variable: v, Version, [/var/www/html/lxr2/source/versions], [/var/www/html/lxr2/source/defversion]

//這三行
htmlhead: /local/lxr/http/template-head
htmltail: /local/lxr/http/template-tail
htmldir:  /local/lxr/http/template-dir
//改成這樣
htmlhead: /var/www/html/lxr2/http/template-head
htmltail: /var/www/html/lxr2/http/template-tail
htmldir:  /var/www/html/lxr2/http/template-dir

(是不是有感覺了...)

//這行


sourceroot: /local/lxr/source/$v/linux/

//改成


sourceroot: /var/www/html/lxr2/source/$v/linux/

//其中這邊的$v就是上面有宣告的變數v，好讓使用者可以選擇版本

//這行

dbdir: /local/lxr/source/$v/

//改成

dbdir: /var/www/html/lxr2/source/$v/

//這行

glimpsebin: /local/bin/glimpse

//改成

glimpsebin: /usr/share/bin/glimpse

之後可以先將lxr.conf儲存了~

那開始來解析原始碼吧~

那我們的source都是放在/var/www/html/lxr/source/

cd /var/www/html/lxr/source/

這邊我們下載三個版本做為範例：linux-2.6.32、linux-3.4.109、linux-4.1.10

那要先把各別版本的資料夾創出來

sudo mkdir linux-2.6.32

sudo mkdir linux-3.4.109

sudo mkdir linux-4.1.10

之後進去任一個版本

cd linux-2.6.32

下載Linux kernel

sudo wget https://cdn.kernel.org/pub/linux/kernel/v2.6/longterm/v2.6.32/linux-2.6.32.68.tar.xz

sudo tar xf linux-2.6.32.68.tar.xz
//改名sudo mv linux-2.6.32.68 linux

改名為linux的原因為lxr.conf預設為linux，也可以改名稱，但要與設定檔對得上

接下來我們要來解析原始碼先進到這個目錄

cd /var/www/html/lxr2/source/linux-2.6.32

把genxref設定為可執行檔

sudo chmod a+x ../../bin/genxref

解析原始碼

sudo ../../bin/genxref linux

跑完之後可以在資料夾下看到這兩個檔案fileidx、 xref

把fileidx的權限更改一下

sudo chmod 755 fileidx

(這個要等一些時間......然後其他版本也是這麼做~)

那剛剛有提及要去versions這個檔案讀list，那現在就來製做

剛剛是放在/source底下所以先去那

cd /var/www/html/lxr2/source/

sudo vim versions

輸入下列三行 linux-2.6.32 linux-3.4.109 linux-4.1.10 再來設定預設的值

sudo vim defversion

輸入下列一行
linux-2.6.32

設定Apache的存取權限：

在/var/www/html/lxr2/http/下面加入一個.htaccess的檔案

cd /var/www/html/lxr2/http/

sudo vim .htaccess

加入下最內容

<Files ~ (search|source|ident|diff|find)>     SetHandler cgi-script     Options ExecCGI </Files>

設定LXR的額外功能：

cd /var/www/html/lxr2/source/linux-2.6.32/
sudo glimpseindex -H . .

當出現Size of files being indexed = xxx B, Total #of files = xxx，就可以按ctrl+C

xxx為一組數字

之後會在資料夾下看到一些隱藏檔

.glimpse_index、.glimpse_messages、.glimpse_statistics、.glimpse_tmpi2

更改權限

sudo chmod 755 .glimpse_*

各版本的資料夾都要做一次

之後就可以進去看到了Linux Cross Reference
http://(Your IP)/lxr2/http/source

此外，如果有要調樣版的話，可以在/var/www/html/lxr2/http/底下會有三個template的檔案，裡面是可以調html樣版的。

可以參考我做的設定檔：link