執行環境：虛擬機器下的Ubuntu 11.04

    結合Graphviz工具，使用CodeViz可以生成直觀和漂亮的C/C++程式函式之間的呼叫關係圖。

    1、安裝graphviz

    在安裝CodeViz之前，必須先安裝它所依賴的工具dot，否則將無法完成./configure操作並提示以下錯誤資訊：

checking for dot...not found
FATAL: The program dot was not in your path. This is probably available for your distribution
       with the graphviz package. Install this before running configure again
 

$ sudo apt-get install graphviz graphviz-dev graphviz-doc

    程式簡要說明：

graphviz - rich set of graph drawing tools
graphviz-dev - transitional package for graphviz-dev rename
graphviz-doc - additional documentation for graphviz
 

    安裝相關庫：

$ sudo apt-get install libgv-*

    相關庫簡要說明： 

libgv-guile - Guile bindings for graphviz
libgv-lua - Lua bindings for graphviz
libgv-ocaml - OCaml bindings for graphviz
libgv-perl - Perl bindings for graphviz
libgv-php5 - Php5 bindings for graphviz
libgv-python - Python bindings for graphviz
libgv-ruby - Ruby bindings for graphviz
libgv-tcl - Tcl bindings for graphviz
 

    2、安裝CodeViz

    然後解壓CodeViz安裝包，並把gcc-3.4.6.tar.gz拷貝到codeviz-1.0.10/compiler目錄下：

$ tar zvxf codeviz-1.0.10.tar.gz
$ cd codeviz-1.0.10/
$ cp ../gcc-3.4.6.tar.gz compilers/  //也可以略過這一步，讓ncftp(Ubuntu預設未安裝)在make執行過程中自動下載gcc-3.4.6.tar.gz
$ ./configure

    Patched GCC預設安裝在/usr/local/gccgraph目錄下。

    在執行make之前，先通過以下命令建立一個連結檔案asm：

$ sudo ln -sf /usr/include/asm-generic/ /usr/include/asm

    否則，在make執行過程中會出現在/usr/include/linux/errno.h檔案中找不到asm/errno.h檔案的錯誤資訊並中止編譯。

    接下來執行make和make install命令即可在/usr/local/gccgraph目錄下建立打過補丁的GCC編譯器以及在/usr/local/bin目錄下建立兩個perl指令碼程式genfull和gengraph。

$ make
$ sudo make install

    3、CodeViz的使用舉例

    例子原始碼如下： 

/* test.c */

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

void func(char *p)
{
    p = (char *)malloc(20);
}

int main(void)
{
    char *str = NULL;

    func(str);

    strcpy(str, "hello world");

    printf("string is %s\n", str);

    return 0;
}

    使用剛生成的編譯器編譯test.c，會相應地生成一個test.c.cdepn檔案。 

$ /usr/local/gccgraph/bin/gcc test.c

    test.c.cdepn檔案資訊： 

F {func} {test.c:6}
C {func} {test.c:7} {malloc}
F {main} {test.c:11}
C {main} {test.c:18} {printf}
C {main} {test.c:16} {strcpy}
C {main} {test.c:14} {func}

    然後執行genfull指令碼生成full.graph。 

$ genfull

    full.graph檔案資訊： 

digraph fullgraph {
node [ fontname=Helvetica, fontsize=12 ];
"func" [label="func\ntest.c:5:"];
"main" [label="main\ntest.c:10:"];
"func" -> "malloc" [label="test.c:7"];
"main" -> "func" [label="test.c:14"];
"main" -> "strcpy" [label="test.c:16"];
"main" -> "printf" [label="test.c:18"];
}

    最後執行gengraph生成函式關係調用圖。 

$ gengraph -f main --output-type "png"

    -f指定最頂層的函式，--output-type指定圖片的輸出格式。

    至於genfull和gengraph的詳細使用說明請參考man手冊，使用以下命令檢視：

$ sudo apt-get install perl-doc //須先安裝perl-doc
$ genfull --man
$ gengraph --man